Geocodeのおためしページ
住所やスポット名を入力すると緯度経度をJSON形式で返します。

入力テスト
住所やスポット名に対応する緯度経度を応答します。
住所文字列(text)
緯度経度(lng, lat) ,
最大候補数(limit)(省略可)
検索対象(type) 住所 スポット名 (省略可) (省略時は、スポット名を検索し、該当がなければ住所を検索します)
結果をhtmlで表示

API仕様
リクエストURL
http://api.locosticker.jp/v1/geocode/

指定した住所またはスポットの緯度経度を返します。
パラメータ説明
text住所又はスポット名,255文字以下のutf-8テキスト。
type検索対象,1文字のASCIIテキスト。 a =住所 又は s =スポット名。省略時にはスポット名→住所の順に検索。
lng経度,-180.0~180.0 の世界測地系小数点表記。(例:135.5278)
lat緯度,-90.0~90.0 の世界測地系小数点表記。(例:34.685427)
limit検索上限,1~100の正数。省略時は100件になります。
callbackJSONP形式で結果を返す場合のコールバックの名前,255文字以下のASCIIテキスト。

  • text以外は省略可能です。
  • 文字列のエンコード(ASCII, UTF8)はチェックされません。指定以外のエンコードで入力された場合の動作は未定義です。




レスポンス
正常時:
 HTTPの応答で 200 (OK) のステータスコードと共に、JSON(callbackを指定した場合はJSONP)形式による連想配列(Content-type: application/json; charset=utf-8)を返します。
{"results":
 [
  {"attribute":"属性",
   "info":"付加情報(付加情報が存在する場合のみ)",
   "address":"住所表記(廃止予定)",

   "distance": "指定位置からの距離(m)緯度経度指定時のみ",
   "lng": "経度1(世界測地系・小数点表記: (例)135.527859)",
   "lat": "緯度1(世界測地系・小数点表記: (例)34.685452) "
  }
 ※条件を満たすn個を繰り返し
 ]
}
異常時:
 パラメータ指定に誤りがある場合は HTTP の応答で 400 (Bad Request) のステータスコードを返します。
 データベースのメンテナンス等により、一時的にサービスが利用できない場合は HTTP の応答で 503 (Service Unavailable) のステータスコードを返します。
  • "attribute"が"address"の場合、"info"には緯度経度を返したデータに対応する住所を返します。例えば字名まで指定して検索した場合でも、緯度経度データが町村レベルまでしかない場合はその町村レベルまでの住所を返します。
  • 互換性維持のため"address"が応答に含まれますが、これは次の版で廃止します。
  • 緯度経度を指定した場合のみ"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"}
 ]
}
銀座(住所限定)
http://api.locosticker.jp/v1/geocode/?text=%E9%8A%80%E5%BA%A7&type=a
(textは「銀座」をURLエンコードしたもの)
{"results":[
{"attribute":"address","info":"栃木県鹿沼市銀座","lng":"139.748356","lat":"36.565116"},
{"attribute":"address","info":"埼玉県熊谷市銀座","lng":"139.393722","lat":"36.143091"},
{"attribute":"address","info":"埼玉県本庄市銀座","lng":"139.184812","lat":"36.238518"},
{"attribute":"address","info":"東京都中央区銀座","lng":"139.768469","lat":"35.674979"},
{"attribute":"address","info":"長野県岡谷市銀座","lng":"138.052395","lat":"36.066017"},
{"attribute":"address","info":"長野県飯田市銀座","lng":"137.827421","lat":"35.515894"},
{"attribute":"address","info":"静岡県静岡市清水区銀座","lng":"138.487229","lat":"35.019"},
{"attribute":"address","info":"愛知県刈谷市銀座","lng":"136.993667","lat":"34.988849"},
{"attribute":"address","info":"山口県周南市銀座","lng":"131.804213","lat":"34.05159"},
{"attribute":"address","info":"徳島県徳島市銀座","lng":"134.548687","lat":"34.068693"},
{"attribute":"address","info":"福岡県北九州市戸畑区銀座","lng":"130.819079","lat":"33.897302"}
]}
金閣寺(スポット名限定)
http://api.locosticker.jp/v1/geocode/?text=%E9%87%91%E9%96%A3%E5%AF%BA&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":"address","info":"大阪府大阪市中央区日本橋","distance":"59139.83","lng":"135.50668","lat":"34.668469"},
{"attribute":"address","info":"大阪府大阪市浪速区日本橋","distance":"59863.32","lng":"135.506917","lat":"34.658396"},
{"attribute":"address","info":"東京都中央区日本橋","distance":"439561.70","lng":"139.773628","lat":"35.683845"}
]}

注意:

このAPIを利用したサービスを提供、公開する際には本APIを利用していることを明示してください。
このAPIで得られたデータの内容の一部又は全部を短期間のキャッシュを除き保存蓄積することはご遠慮ください。また、そのような形態での利用は許可できませんのでご了承ください。

この地図の作成に当たっては、国土地理院長の承認を得て、同院発行の数値地図25000(空間データ基盤)及び数値地図2500(空間デー基盤)を使用したものである。(承認番号 平19総使、第349号)

この地図の作成に当たっては、国土交通省が提供する国土数値情報空港データ(2007年度)鉄道データ(2005年度)行政区域データ(2007年度)を使用したものである。

この地図の作成に当たっては、国土交通省が提供する国土数値情報街区レベル位置参照情報を使用したものである。

このAPIで得られるデータは上記のデータを利用していますが、問い合わせは応答内容を含め、国土地理院及び国土交通省ではなく、OkiLab.jp にコメントください。又、上記のデータに変更がなくとも、変更、改良により、応答内容が変更されることがございます。予めご了承ください。


(C) OKI UPC Ubiquitous Technology Department-2