John Metro

アプリケーションマニュアル

操作手順

トイレの検索
トイレの詳細情報
トイレの評価
トイレのラクガキ

対応ブラウザ

Android
iOS
PC

Tips

ホーム画面に追加 (iOS のみ)
駅名ゆらぎ対策
アルファベット対応
無効文字除外

制限事項

全般
簡易時刻表表示機能
評価機能
ラクガキ機能

付録

利用 API
利用ファイル
利用オープンソースソフトウェア
実行環境
開発環境
開発支援サービス

操作手順

基本的な操作手順を説明します。操作画面のイメージは Android スマートフォンの標準ブラウザ (バージョン 4.2) のものですが、iOS やその他のデバイス・ブラウザでもほぼ同様です (ただし、レイアウト等が異なることがあります)。

トイレの検索

ブラウザで https://jm.tasktoys.com/ を開きます。
"東京メトロの駅名を入力..." と書かれた入力欄に駅名 (漢字またはアルファベット) を入力します。
入力すると、駅名の候補が一覧表示されるので、候補から検索したい駅名をタップすると検索できます。
入力した駅名が完全なものであれば、候補を選ばずに [Search] ボタンをタップすることでも検索できます。
プラットフォームの一覧が表示されるので、路線と方面を参考に降車するプラットフォームを選択します。
プラットフォームを選択すると、トイレの一覧が表示されます。選択したプラットフォームに最寄りのトイレがない場合は、別のプラットフォームを探すと良いでしょう。

トイレの詳細情報

トイレを選択すると、次のようなトイレの詳細情報をまとめたダイアログが表示されます。車いす対応設備、ベイビーチェア、おむつ交換台、そしてオストメイト対応設備の設置状況を取得できます。
ダイアログを閉じてほかのトイレの情報の調査に移りたいときは、ダイアログ右下の [閉じる] をタップします。

トイレの評価

前述のトイレの詳細情報をまとめたダイアログには、トイレの評価情報として以下のアイコンが表示されています:
- (気に入った)
- (気に入らない)
それぞれのアイコンをタップすることで、自分の評価をこのトイレに反映することができます。
評価ボタンが正常に登録されると、次のような評価完了ダイアログが表示されます。
[閉じる] をタップすると、ダイアログが閉じられてページが再読み込みされます。
投票頂いた評価は、ダイアログの評価情報に加え、トイレ一覧ページの評価ステータスの算出にも利用されます。

評価ステータスは (気に入った数 / 評価総数) * 3 の小数点を四捨五入した値です。

トイレのラクガキ

前述のトイレの詳細情報をまとめたダイアログの下部にはラクガキ欄があり、このトイレにラクガキがあれば最新 5 件が表示されています。
新たなラクガキを残すには、入力欄をタップして記入します。入力できる文字数は 80 文字以内となっています。
HTMLタグや特殊文字指定子等は利用できず、エスケープされて (入力したまま) 表示されます。
入力後 [書込む] をタップすると、確認ダイアログが表示されます。ラクガキとはいえ、公衆の場ですから公序良俗に反する内容はお控え願います。
確認が終わり、正常に送信されると画面が再読み込みされます。再度同じトイレを探してダイアログを開くと、書込んだラクガキが表示されているはずです。

対応ブラウザ

本アプリは HTML5, JavaScript に対応しているモダンブラウザであれば、スマートフォン、タブレット、PC問わず利用できるように設計されています。テスト済のブラウザは以下の通りです。

Android

Android 4.2 標準ブラウザ
Google Chrome 38

iOS

iOS 8 Safari (iPhone)
iOS 8 Safari (iPad)
Google Chrome 38

PC

Internet Explorer 11
Google Chrome 38
Mozilla Firefox 33
Safari 8.0 (Mac OS X のみ)

Tips

ホーム画面に追加 (iOS のみ)

iOS では、Safari ブラウザの「ホーム画面に追加」機能があり、John Metro はこれに対応しています。トップページ、検索結果のどちらにおいてもホーム画面に追加することが可能です。

トップページをホーム画面に追加するには、以下の手順に従います。

Safari で https://jm.tasktoys.com/ を開き、画面下部の真ん中のアイコンをタップします。
[ホーム画面に追加] をタップします。
確認画面が表示されます。タイトルを変更することもできます。確認したら右上の [追加] をタップします。
ホーム画面に追加されました。これで John Metro のアイコンをタップすればすぐにトイレ検索を始められます。

検索結果をホーム画面に追加するには、以下の手順に従います。

John Metro で検索を実行し、画面下部の真ん中のアイコンをタップします。
[ホーム画面に追加] をタップします。
確認画面が表示されます。タイトルを変更することもできます。確認したら右上の [追加] をタップします。
ホーム画面に追加されました。これで検索結果をいつでも呼び出すことができます。なお、簡易時刻表は開くたびに再検索されます。

駅名ゆらぎ対策

以下の入力は自動的に John Metro が扱う駅名に変換されます。

入力	結果
四谷, 四ッ谷	四ツ谷
麹町	麴町
雑司ヶ谷, 雑司ケ谷	雑司が谷
市ヶ谷	市ケ谷
霞ヶ関, 霞が関	霞ケ関
南阿佐ヶ谷	南阿佐ケ谷
西ヶ原	西ケ原
お茶の水, 御茶の水	御茶ノ水
押上	押上〈スカイツリー前〉
明治神宮前	明治神宮前〈原宿〉

アルファベット対応

駅名は漢字のほかアルファベット表現での入力にも対応します。大文字・小文字は同一として扱います。

例1: 「AkasakaMitsuke」→「赤坂見附」で検索

例2: 「akasakamitsuke」→「赤坂見附」で検索

アルファベットと漢字の対応表には metro_stationDict.json を利用しています。

無効文字除外

入力に以下の文字が含まれる場合、全て無視して検索します。

「駅」 (末尾につく場合のみ)
「」(半角スペース)
「　」(全角スペース)
「-」
「_」

無視例1: 「新宿駅」→「新宿」で検索

無視例2: 「六本木一丁目」→「六本木一丁目」で検索

無視例3: 「Akasaka-mitsuke」→「赤坂見附」で検索

制限事項

全般

本アプリを正しく表示するためにはブラウザで JavaScript を有効にしておく必要があります。
本アプリはさくら VPS 石狩リージョンで運用しています。サービスレベルは当該サービスに準じます。

簡易時刻表表示機能

ホームが東京メトロとしての終点だった場合、時刻表は表示できません。
まれに (負荷状況等により) 簡易時刻表の一部が取得できず "(取得失敗)" と表示されることがあります。これは、多数のプラットフォームの時刻表を同時に取得しようとする本アプリの特性による制約となります (対策は施していますが、限界があります)。

評価機能

一度実行した評価を取り消すことはできません。
片方に評価を入れたあともう片方に評価を入れても、最初の評価は取り消されません。

ラクガキ機能

一度投稿したラクガキをユーザー自身の手で削除することはできません。
ラクガキは HTML タグ、特殊文字等で装飾することはできません。※セキュリティ対策

付録

利用 API

odpt:Station (駅情報)
odpt:StationFacility (駅施設情報)
odpt:StationTimetable (簡易時刻表)

利用ファイル

metro_stationDict.json (駅名辞書)
路線マーク画像

利用オープンソースソフトウェア

John Metro では以下のオープンソースソフトウェアを利用しています。

Spring Boot 2
Spring Data MongoDB
jQuery
jUqery UI
normalize.css

実行環境

サービスの運用には以下を利用しています。

Heroku
JDK 17
MongoDB Atlas

開発環境

開発には以下を利用しています。

IntelliJ IDEA Ultimate
JDK 17
Gradle

OS, ブラウザは世の中で一般的な様々なものを利用・テストしています。

開発支援サービス

開発に利用したオンラインサービスは以下の通りです。

Amazon Web Services
GitHub
Bitbucket
Nulab Cacoo