GeocoderAPI
LocoSticker Geocode (緯度経度変換サービス) API
GeocodeAPIは、住所やスポット名を入力すると緯度経度をJSON形式で返す APIです。
LocoSticker Geocode体験
リクエストURL
http://api.locosticker.jp/v1/geocode/
リクエストパラメータ
| パラメータ | 説明 |
|---|---|
| text | 住所又はスポット名(utf-8でURLエンコードされたもの) |
| type | 検索対象 a=住所,s=スポット名 (省略可,省略時には スポット名→住所の順に検索) |
| lng | 経度(省略可,世界測地系・小数点表記: (例) 135.527859) |
| lat | 緯度(省略可,世界測地系・小数点表記: (例) 34.685452) |
| limit | 検索上限(最大100件、100以上の値を設定した場合、 及び省略した場合は100件になります) |
| callback | 省略可,JSONP形式で結果を返す場合のコールバッ クの名前 |
- text以外は省略可能です。
- 文字列のエンコード(ASCII, UTF8)はチェックされません。指定以外のエ ンコードで入力された場合の動作は未定義です。
レスポンス
JSON(callbackを指定した場合はJSONP)形式による連想配列(Content-type: application/json; charset=utf-8)です。
{"results":
[
{
"attribute": "属性( address, station, ... )",
"info": "付加情報",
"lng": "経度1(世界測地系・小数点表記: (例)135.527859)",
"lat": "緯度1(世界測地系・小数点表記: (例)34.685452) ",
"address": "住所表記(廃止予定)",
"distance": "指定位置からの距離(m)"},
※条件を満たすn個を繰り返し
]
}
※住所表記(address)は緯度経度を返したデータに対応するものになります。
例えば字名まで指定して検索した場合でも、緯度経度データが町村レベルま でしかない場合はその町村レベルまでの住所を返します。
スポット名で検索した場合は、住所の一部又は”"(空)となります。
※緯度経度を指定すると、その位置からの距離を”distance”も返します。また 近い順に並べ替えます。
緯度経度を指定した場合のみ、”distance”が結果に含まれます。
リクエストとレスポンスの例
大阪府大阪市中央区本町1-5
http://api.locosticker.jp/v1/geocode/?text=%E5%A4%A7%E9%98%AA%E5%BA%9C%E5%A4%A7%E9%98%AA%E5%B8%82%E4%B8%AD%E5%A4%AE%E5%8C%BA%E6%9C%AC%E7%94%BA1-5
(textは「大阪府大阪市中央区本町1-5」をURLエンコードしたもの)
{"results":
[
{
"attribute: "address",
"info": "大阪府大阪市中央区本町1丁目5",
"lng": "135.507969",
"lat": "34.683773",
"address": "大阪府大阪市中央区本町1丁目5",
}
]
}
銀座(住所限定)
http://api.locosticker.jp/v1/geocode/?text=%E9%8A%80%E5%BA%A7&type=a
(textは「銀座」をURLエンコードしたもの)
{"results":[
{"attribute": "address","lng": "139.748356","lat": "36.565116","address": "栃木県鹿沼市銀座"},
{"attribute": "address","lng": "139.184812","lat": "36.238518","address": "埼玉県本庄市銀座"},
{"attribute": "address","lng": "139.393722","lat": "36.143091","address": "埼玉県熊谷市銀座"},
{"attribute": "address","lng": "139.768469","lat": "35.674979","address": "東京都中央区銀座"},
{"attribute": "address","lng": "138.052395","lat": "36.066017","address": "長野県岡谷市銀座"},
{"attribute": "address","lng": "137.827421","lat": "35.515894","address": "長野県飯田市銀座"},
{"attribute": "address","lng": "138.487229","lat": "35.019000","address": "静岡県静岡市清水区銀座"},
{"attribute": "address","lng": "136.993667","lat": "34.988849","address": "愛知県刈谷市銀座"},
{"attribute": "address","lng": "131.804213","lat": "34.051590","address": "山口県周南市銀座"},
{"attribute": "address","lng": "134.548687","lat": "34.068693","address": "徳島県徳島市銀座""},
{"attribute": "address","lng": "130.819079","lat": "33.897302","address": "福岡県北九州市戸畑区銀座"}
]}
銀座(スポット限定)
http://api.locosticker.jp/v1/geocode/?text=%E9%8A%80%E5%BA%A7&type=s
(textは「銀座」をURLエンコードしたもの)
{"results":[
{"attribute": "station", "info": "東京地下鉄", "lng": "139.764008","lat": "35.671979"}
]}
※スポット検索で各路線の銀座(駅)の緯度経度を結果としています。
金閣寺(スポット名限定)
http://api.locosticker.jp/v1/geocode/?text=%E9%87%91%E9%96%A3%E5%AF%BA&limit=10&type=s
(textは「金閣寺」をURLエンコードしたもの)
{"results":[
{"attribute": "misc","lng": "135.729144","lat": "35.039722"}
]}
日本橋(緯度経度指定)
http://api.locosticker.jp/v1/geocode/?text=%E6%97%A5%E6%9C%AC%E6%A9%8B&lng=135.0&lat=35.0
(textは「日本橋」をURLエンコードしたもの)
{"results":[
{"attribute": "misc","lng": "139.764008","lat": "35.671979","distance":"59266.8332516557"}
]}
注意:
このAPIを利用したサービスを提供、公開する際には本APIを利用している ことを明示してください。
このAPIで得られたデータの内容の一部又は全部を短期間のキャッシュを除き 保存蓄積することはご遠慮ください。また、そのような形態での利用は許可で きませんのでご了承ください。
この地図の作成に当たっては、国土地理院長の承認を得て、同院発行の数値地 図25000(空間データ基盤)及び数値地図2500(空間デー基盤)を使用してい ます。(承認番号 平19総使、第349号)
この地図の作成に当たっては、国土交 通省が提供する国 土数値情報の空港データ(2007 年度)、 鉄道データ(2005年度)、行政区域データ (2007年度)を使用しています。
この地図の作成に当たっては、国土交 通省が提供する国 土数値情報の街 区レベル位置参照情報を使用しています。
このAPIで得られるデータは上記のデータを利用していますが、問い合わせ は応答内容を含め、国土地理院及び国土交通省ではなく、お問い合わせページ よりご連絡ください。又、上記のデータに変更がなくとも、変更、改良によ り、応答内容が変更されることがあります。予めご了承ください。

