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で得られるデータは上記のデータを利用していますが、問い合わせ は応答内容を含め、国土地理院及び国土交通省ではなく、お問い合わせページ よりご連絡ください。又、上記のデータに変更がなくとも、変更、改良によ り、応答内容が変更されることがあります。予めご了承ください。

コメントする