2013/12/9 1 / 2 1 オープンデータ 1.1 オープンデータ取得概要オープンデータ取得 API /opendata/(:(.:format)) /opendata/od(:(_:date)(.:format)) オープンデータとしてまとめられている場所リストを返

(1)

1 / 1 ページ

東京大学,　株式会社　リマージュアーツ

座標変換基盤API 承認ページ APIインターフェース仕様書熊谷　潤 2013/12/9 更新日付座標変換基盤API 作成者松原　剛更新者

座標変換基盤API インターフェース仕様書

第 1.0 版

(2)

1 / 2 ページ

1 オープンデータ

1.1 オープンデータ取得 1.1.1 パラメータ拡張子フォーマット文字コード html html5 UTF-8 kml kml UTF-8

json GeoJSON UTF-8

csv excel互換 SJIS 1.1.2 返却値オープンデータの識別子オープンデータ名称オープンデータ名称の読み（ひらがな）オープンデータの説明文オープンデータを作成した団体、部署、人オープンデータのライセンス以下の提供データを参照し座標付与基盤を使用して作成されました。\r\nhttp://geocoding.tky1.biz/places/licenses オープンデータの作成日時　(システムによって自動的に付与される）オープンデータの更新日時　(システムによって自動的に付与される） 1.1.3 レスポンスステータス 1.1.4 リクエストサンプル 1.1.5 備考

note × string opendata

オープンデータメタ情報 metadata ライセンス license name kana 出力フォーマット format × 日付 date /opendata/od1234_20131122.csv 場所情報 places 識別子フォーマット指定（KML形式で返却）座標ページ URL 備考 places string オープンデータを一意に特定するための値ＵＲＬ /opendata/od(:id(_:date)(.:format)) 出力フォーマットを指定 (未指定の場合は html ) 返却上限件数：　1000件データ型：　ruby on rails の型に準拠 integer 場所識別子 id /opendata/1234 /opendata/1234.json /opendata/1234.kml integer 識別子名称 name ＩＤのみ（html形式で返却）備考オープンデータ取得API /opendata/(:id(.:format)) オープンデータとしてまとめられている場所リストを返却するデータソース opendata Not Found opendata opendata ▽ 繰り返し： 0-1000 ○ places OK Bad Request ○ string opendata opendata 備考フォーマット指定（GeoJSON形式で返却） × opendata 名称 ○ × × opendata string description 500 名称（読み） datetime coordinates × ステータスコード 200 説明文作成者備考 ○ ○ 必須 × string × string ダウンロード時のファイル名として使用する（APIとしては無視される） data_creator データ型 ▽ 繰り返し：1回のみ備考パラメータ名データ型項目名オープンデータ識別子必須項目名 places 座標変換基盤API id 物理名名称概要 id updated_at 作成日時 404 ○ 400 正常不正なパラメータが渡された場合指定されたIDが存在しない場合。閲覧権限がない場合場所名称　（地名、施設名等） geometry 熊谷　潤 text created_at ファイル名指定（ダウンロードファイル名をユニークにしたい場合に使用）例外発生により処理が継続できない場合 ○ integer opendata 2013/12/9 座標変換基盤API ステータスメッセージ更新日時場所の座標表現（ coordinate ( 経度 , 緯度 ) ) 更新者 datetime 承認更新日付 string string 作成者松原　剛 APIインターフェース仕様書

(3)

2 / 2 ページページ座標変換基盤API 熊谷　潤 2013/12/9 座標変換基盤API 更新者更新日付承認作成者松原　剛 APIインターフェース仕様書

1.2 レスポンスサンプル

サンプルKML サンプルGeoJSON サンプルCSV { "type": "FeatureCollection", "metadata": { "id": 435, "name": "災害時避難場所", "kana": "", "description": "※　災害の種類によっては避難場所が異なる場合もありますのでご注意ください", "data_creator":"浦安市", "license":"CC0", "note":"以下の提供データを参照し座標付与基盤を使用して作成されました。\r\nhttp://geocoding.tky1.biz/places/licenses", "created_at": "2013-10-31T10:32:33.722Z", "updated_at": "2013-10-31T10:32:33.723Z" }, "features": [ { "type": "Feature", "geometry": { "type": "Point", "coordinates": [ 139.8923894, 35.65673424 ] }, "properties": { "id": 39035, "name": "南小学校地区児童育成クラブ分室" } }, { "type": "Feature", "geometry": { "type": "Point", "coordinates": [ 　　　　　　　140.1508700583496, 　　　　　　　35.60328155205004 ] }, "properties": { "id": 29438, "name": "葛城中学校 } }, 　　　　　　　　： id,場所名,経度,緯度 8516,ニセコアンヌプリ国際スキー場,140.64771938428748,42.84916324036368 8517,安比高原,140.96821116982028,40.00210894401827 8518,志賀高原サンバレースキー場,138.48712921142578,36.71425617316473 <?xml version="1.0" encoding="UTF-8"?> <kml xmlns="http://earth.google.com/kml/2.2"> <Document> <name> <![CDATA[スキー場]]> </name> <description> <![CDATA[全国のスキー場のリスト　・　規模が大きく、有名な箇所　・　大規模な大会の会場となった箇所　]]> </description> <styleUrl>#meta-style</styleUrl> <Style id="meta-style"> <BalloonStyle><text> <![CDATA[ <h2>スキー場</h2> <h4>全国のスキー場のリスト　・　規模が大きく、有名な箇所　・　大規模な大会の会場となった箇所　</h4> <table><tr><th>ID</th><td>8</td></tr> <tr><th>作成者</th><td>日本ウィンタースポーツ協会</td></tr> <tr><th>ライセンス</th><td>CC0</td></tr> <tr><th>備考</th><td>以下の提供データを参照し座標付与基盤を使用して作成されました。 http://geocoding.tky1.biz/places/licenses</td></tr> <tr><th>作成日</th><td>2013-12-09T10:07:46Z</td></tr> <tr><th>更新日</th><td>2013-12-09T10:07:46Z</td></tr> </table>]]></text> </BalloonStyle> </Style> <ExtendedData> <Data name="od_id"> <value>8</value> </Data> <Data name="kana"> <value> <![CDATA[]]> </value> </Data> <Data name="data_creator"> <value> <![CDATA[日本ウィンタースポーツ協会]]> </value> </Data> <Data name="license"> <value> <![CDATA[CC0]]> </value> </Data> <Data name="note"> <value> <![CDATA[以下の提供データを参照し座標付与基盤を使用して作成されました。 http://geocoding.tky1.biz/places/licenses]]> </value> </Data> <Data name="created_at"> <value>2013-12-09T10:07:46Z</value> </Data> <Data name="updated_at"> <value>2013-12-09T10:07:46Z</value> </Data> </ExtendedData> <Placemark> <name> <![CDATA[ニセコアンヌプリ国際スキー場]]> </name> <ExtendedData> <Data name="p_id"> <displayName>ID</displayName> <value> <id>19887</id> </value> </Data> </ExtendedData> <Point> <coordinates>139.91457968261716,35.6580986655828</coordinates> </Point> </Placemark> </Document> </kml>

(4)

1 / 3 ページ

2 地名辞書

2.1 施設情報取得

2.1.1 パラメータ拡張子フォーマット文字コード html html5 UTF-8

json GeoJSON UTF-8

2.1.2 返却値 2.1.3 レスポンスステータス 2.1.4 リクエストサンプル 2.1.5 備考 format × string 出力フォーマット備考ＵＲＬ

座標 coordinates ○ geometry places

出力フォーマット　json のみ指定可能 (未指定の場合は html) integer 必須項目名地名情報取得API /places/(:id(.:format)) 識別子を指定して場所情報を返却する備考場所情報を一意に特定するための値データ型 id ○

Internal Server Error ステータスメッセージ Bad Request × string 情報ソース（提供元） 400 データソース必須物理名データ型場所情報 places datetime string string datetime integer id name kana 識別子 ▽ 繰り返し：1回のみ × data_creator 404 ライセンス名称名称（読み）情報ソース（作成日）指定されたIDが存在しない場合概要パラメータ名 Not Found data_date license created_at ステータスコード 200 座標変換基盤API 作成者松原　剛更新者熊谷　潤名称ページ APIインターフェース仕様書座標変換基盤API 更新日付 2013/12/3 承認 updated_at 例外発生により処理が継続できない場合場所識別子場所名称　（地名、施設名等）場所名称の読み（ひらがな）場所の座標表現（ coordinate ( 経度 , 緯度 ) ) ○ ○ places places places places 場所情報の提供元場所情報が作成された日付場所情報のライセンス場所レコードの作成日時　(システムによって自動付与されるため変更不可） × places string places places places × ○ ○ 備考場所レコードの更新日時　(システムによって自動付与されるため変更不可）不正なパラメータが渡された場合 datetime 正常 500 返却上限件数：　1000件項目名場所情報識別子作成日時更新日時 OK URL 備考 /places/1234 ＩＤのみ（html形式） /places/1234.json 出力フォーマット指定（GeoJSON形式）

(5)

2 / 3 ページ座標変換基盤API 作成者松原　剛更新者熊谷　潤ページ APIインターフェース仕様書座標変換基盤API 更新日付 2013/12/3 承認

2.2 地名辞書検索

2.2.1 パラメータ 2.2.2 返却値 2.2.3 レスポンスステータス 2.1.4 リクエストサンプル 2.2.5 備考 URL 備考 /places/search?query=浦安+高等学校「浦安」と「高校」の2語が含まれている地名を検索正常場所レコードの作成日時　(システムによって自動付与されるため変更不可）検索したい場所の一部（または全て）をUTF-8 形式の URL Encode して入力

半角スペースで区切ることにより複数の候補をＡＮＤ検索する。 ※　出力は json (UTF-8) のみ

integer

場所の座標表現（coordinate ( 経度 , 緯度 ) )

404 Not Found 指定されたIDが存在しない場合。閲覧権限がない場合

場所レコードの更新日時　(システムによって自動付与されるため変更不可）ステータスコードステータスメッセージ 200 備考場所情報のライセンス項目名名称必須型場所名称の一部をキーに検索を行う備考 ○ string 検索文字列必須備考項目名パラメータ名 ○ ▽ 繰り返し： 0-1000 型場所名称　（地名、施設名等） places データソース物理名

Internal Server Error データベース接続エラーなど

不正なパラメータが渡された場合 400 Bad Request 場所識別子 OK 情報ソース（提供元）場所情報の提供元場所情報が作成された日付返却上限件数：1000件 data_creator query 地名辞書検索API places 名称(読み) 500 概要 id kana 場所名称の読み（ひらがな）場所情報 places 識別子名称 × string places places 座標 /places/search?query={query} places name ○ string 更新日時情報ソース（作成日） places license × string × datetime places places places updated_at ○ string × ○ datetime ライセンス coordinates ○ geometry data_date 作成日時 datetime ＵＲＬ created_at

(6)

3 / 3 ページ座標変換基盤API 作成者松原　剛更新者熊谷　潤ページ APIインターフェース仕様書座標変換基盤API 更新日付 2013/12/3 承認

2.3 レスポンスサンプル

サンプルJSON (/places/1234.json) { "type": "FeatureCollection", "features": [ { "type": "Feature", "geometry": { "type": "Point", "coordinates": [ 139.9169347, 35.62998231 ] }, "properties": { "id": 36386, "name": "千葉県立浦安南高等学校", "kana": null, "data_creator": "浦安市", "data_date": "2013-10-22T09:23:37.713Z", "license": "CC-BY-SA", "created_at": "2013-10-22T09:23:37.713Z", "updated_at": "2013-10-22T09:23:37.713Z" } }, { "type": "Feature", "geometry": { "type": "Point", "coordinates": [ 139.9129413, 35.64002915 ] }, "properties": { "id": 36377, "name": "学校法人鎌形学園東京学館浦安高等学校東京学館浦安中学校", "kana": null, "data_creator": "浦安市", "data_date": "2013-10-22T09:23:37.670Z", "license": "CC-BY-SA", "created_at": "2013-10-22T09:23:37.671Z", "updated_at": "2013-10-22T09:23:37.671Z" } }, 　　　　　　：サンプルJSON (/places/search?query=浦安+高等学校) { "type": "FeatureCollection", "features": [ { "type": "Feature", "geometry": { "type": "Point", "coordinates": [ 139.908199, 35.660744 ] }, "properties": { "id": 31553, "name": "県立浦安高等学校", "kana": null, "data_creator": "国土数値情報", "data_date": "2013-10-22T09:20:34.034Z", "license": "CC0", "created_at": "2013-10-22T09:20:34.034Z", "updated_at": "2013-10-22T09:20:34.034Z" } } ] }

2013/12/9 1 / 2 1 オープンデータ 1.1 オープンデータ 取 得 概 要 オープンデータ 取 得 API /opendata/(:(.:format)) /opendata/od(:(_:date)(.:format)) オープンデータとしてまとめられている 場 所 リストを 返

東京大学, 株式会社 リマージュアーツ