1. 概要

このドキュメントは、オープンデータを利活用する際のガイドラインです。利用規約では規定していない、アプリケーションでの細かい取り扱いに関しての規定を行います。

2. 実装ルール

本システムで規定するルールを以降で示します。本ガイドラインに必ず従ってください。

2.1. アクセストークンの取り扱い

アクセストークンは第三者に開示しないようにしてください。サンプルコードをブログ等で第三者に開示される場合などにも、アクセストークンをacl:consumerKey=ACL_CONSUMERKEYと置き換えるなど、取り扱いにご注意ください。

2.2. 時刻の表示

リアルタイム情報に関してはデータに含まれている、dc:dateを必ず画面に表示してください。

2.3. 配布

公共交通データAPIのデータを使ってサービスを提供する場合、エンドユーザ全てに対して公共交通データAPIのサービスに直接アクセスさせてはいけません。データは一時的にサーバ上に保持し、エンドユーザには保持したデータにアクセスさせるようにしてください。

2.4. タイムリーな更新

リアルタイムなデータはタイムリーに取得して表示しなければなりません。データにはタイムリーに表示するために必要な、以降に示すタグが含まれています。
odpt:frequencyに指定されている時間間隔で更新しなければなりません。時間間隔は秒単位で指定されます。
dct:valid を超えた場合は表示を切り替えなければなりません。
上書きのメッセージが存在した場合は、前のメッセージは表示してはいけません。

2.5. 方面の表示

列車ロケーション情報は、プロパティとして方面（odpt:railDirection）と終着駅(odpt:terminalStation)が必ず入っています。
終着駅として取得される駅名は、各路線の終着駅でなく、直通運転で乗り入れた路線の駅名や、東京メトロ線内の途中駅の場合がございます。
アプリケーションを利用されるお客様に誤認されることがございませんように、必ず方面名（odpt.RailDirection から始まるIDではなく、自然言語で表すこと）と終着駅名（odpt.Station から始まるIDではなく、自然言語で表すこと）をアプリケーション内で表示しなければなりません。
参考として、本ドキュメント末尾に方面リストを示します。

3. サポート

質問がある場合は、開発者サイトのドキュメントを参照してください。もし該当する内容がなければ、フォーラムでの投稿を通じて質問をしてください。回答に関しては可能な限りで行うこととします。

参考 各路線毎の方面の一覧

路線	方面（自然言語表記）	方面（プロパティodpt:railDirectionの値）	進行方向
銀座線	渋谷方面	odpt.RailDirection:TokyoMetro.Shibuya	浅草 → 渋谷
銀座線	浅草方面	odpt.RailDirection:TokyoMetro.Asakusa	渋谷 → 浅草
丸ノ内線	荻窪方面	odpt.RailDirection:TokyoMetro.Ogikubo	池袋 → 荻窪
丸ノ内線	荻窪方面	odpt.RailDirection:TokyoMetro.Ogikubo	方南町 → 荻窪
丸ノ内線	池袋方面	odpt.RailDirection:TokyoMetro.Ikebukuro	荻窪 → 池袋
丸ノ内線	池袋方面	odpt.RailDirection:TokyoMetro.Ikebukuro	方南町 → 池袋
丸ノ内線	方南町方面	odpt.RailDirection:TokyoMetro.Honancho	池袋 → 方南町
丸ノ内線	方南町方面	odpt.RailDirection:TokyoMetro.Honancho	荻窪 → 方南町
丸ノ内線	中野坂上方面	odpt.RailDirection:TokyoMetro.NakanoSakaue	池袋 → 中野坂上
丸ノ内線	中野坂上方面	odpt.RailDirection:TokyoMetro.NakanoSakaue	荻窪 → 中野坂上
丸ノ内線	中野坂上方面	odpt.RailDirection:TokyoMetro.NakanoSakaue	方南町 → 中野坂上
日比谷線	中目黒方面	odpt.RailDirection:TokyoMetro.NakaMeguro	北千住 → 中目黒
日比谷線	北千住方面	odpt.RailDirection:TokyoMetro.KitaSenju	中目黒 → 北千住
東西線	西船橋方面	odpt.RailDirection:TokyoMetro.NishiFunabashi	中野 → 西船橋
東西線	中野方面	odpt.RailDirection:TokyoMetro.Nakano	西船橋 → 中野
千代田線	代々木上原方面	odpt.RailDirection:TokyoMetro.YoyogiUehara	綾瀬 → 代々木上原
千代田線	綾瀬方面	odpt.RailDirection:TokyoMetro.Ayase	代々木上原 → 綾瀬
千代田線	綾瀬方面	odpt.RailDirection:TokyoMetro.Ayase	北綾瀬 → 綾瀬
千代田線	北綾瀬方面	odpt.RailDirection:TokyoMetro.KitaAyase	綾瀬 → 北綾瀬
有楽町線	池袋方面	odpt.RailDirection:TokyoMetro.Ikebukuro	和光市 → 池袋
有楽町線	新木場方面	odpt.RailDirection:TokyoMetro.ShinKiba	池袋 → 新木場
有楽町線	和光市方面	odpt.RailDirection:TokyoMetro.Wakoshi	新木場 → 和光市
有楽町線	小竹向原方面	odpt.RailDirection:TokyoMetro.KotakeMukaihara	新木場 → 小竹向原 → 西武線
副都心線	池袋方面	odpt.RailDirection:TokyoMetro.Ikebukuro	和光市 → 池袋
副都心線	渋谷方面	odpt.RailDirection:TokyoMetro.Shibuya	和光市 → 渋谷
副都心線	和光市方面	odpt.RailDirection:TokyoMetro.Wakoshi	渋谷 → 和光市
副都心線	小竹向原方面	odpt.RailDirection:TokyoMetro.KotakeMukaihara	渋谷 → 小竹向原 → 西武線
半蔵門線	押上方面	odpt.RailDirection:TokyoMetro.Oshiage	渋谷 → 押上
半蔵門線	渋谷方面	odpt.RailDirection:TokyoMetro.Shibuya	押上 → 渋谷
南北線	赤羽岩淵方面	odpt.RailDirection:TokyoMetro.AkabaneIwabuchi	目黒 → 赤羽岩淵
南北線	白金高輪方面	odpt.RailDirection:TokyoMetro.ShirokaneTakanawa	目黒 → 白金高輪 → 都営三田線
南北線	目黒方面	odpt.RailDirection:TokyoMetro.Meguro	赤羽岩淵 → 目黒

以上