緯度経度での住所検索

API名: 
location
概要: 

リクエストパラメータで指定された緯度経度の住所情報を返却します。

URI: 

https://test.core.its-mo.com/zmaps/api/apicore/core/v1_0/location

<API使用例>
https://test.core.its-mo.com/zmaps/api/apicore/core/v1_0/location?if_clientid=JSZxxxxxxxxxx|xxxxx&if_auth_type=ip&latlon=35.6781444,139.7693167

リクエストパラメータ
パラメータ 必須 デフォルト値 説明
latlon ○ - 緯度経度
取得したい地点の緯度経度を指定します。
本項目は必須項目であるため、未指定の場合はエラーとなります。
100件まで複数値指定できますが、URLの長さ制限の影響を受けます。
複数値指定した場合、PVカウントは指定緯度経度1件につき1PVです。
datum   TOKYO 測地系
入出力緯度経度の測地系を指定します。
llunit   dec 緯度経度形式
緯度経度形式を指定します。

出力データ
出力フォーマット
[{"address":{"text":"東京都千代田区丸の内１丁目９−１",
             "code":"131010550010000900001",
             "point":{"lat":35.67855,
                      "lon":139.7699944},
             "parts":["東京都","千代田区","丸の内","１丁目","９","１"],
             "kana":"トウキヨウトチヨダクマルノウチ",
             "end":null,
             "bounds":null,
             "kanaParts":["トウキヨウト","チヨダク","マルノウチ","","",""],
             "level":"tbn",
             "language":null},
  "zipcode":"100-0005",
  "around":false,
  "addressPoints":[{"lat":35.6863167,
                    "lon":139.6950472},
                   {"lat":35.6908056,
                    "lon":139.7568194},
                   {"lat":35.6734139,
                    "lon":139.7683556},
                   {"lat":35.6803806,
                    "lon":139.7696861},
                   {"lat":35.6771611,
                    "lon":139.7704111},
                   {"lat":35.67855,
                    "lon":139.7699944}]}
 ...]
キー名 データ型 説明
address object 緯度経度で指定された地点の住所が入ります。
zipcode string 緯度経度で指定された地点の郵便番号が入ります。
around boolean 周辺住所かどうかのフラグが入ります。
この値が true の場合、指定した地点が海上など住所の取得できない場所であったため近傍の住所を取得したことを示します。
addressPoints array 住所階層毎の代表点座標が緯度経度の配列で入ります。
配列数は出力データaddress->partsの配列数と一致します。
本配列の要素は出力データaddress->partsの該当階層が住所が無い場合、nullとなります。
また、枝番はあるが地番が無い住所が存在する(地番及び枝番はそれぞれ固有の建物を指す)ため、枝番の代表点は返却されるが地番の代表点はnullになる場合があります。

出力例

[通常出力例]
https://test.core.its-mo.com/zmaps/api/apicore/core/v1_0/location?if_clientid=JSZxxxxxxxxxx|xxxxx&if_auth_type=ip&latlon=35.6781444,139.7693167

[{"address":{"text":"東京都千代田区丸の内１丁目９−１",
             "code":"131010550010000900001",
             "point":{"lat":35.67855,
                      "lon":139.7699944},
             "parts":["東京都","千代田区","丸の内","１丁目","９","１"],
             "kana":"トウキヨウトチヨダクマルノウチ",
             "end":null,
             "bounds":null,
             "kanaParts":["トウキヨウト","チヨダク","マルノウチ","","",""],
             "level":"tbn",
             "language":null},
  "zipcode":"100-0005",
  "around":false,
  "addressPoints":[{"lat":35.6863167,
                    "lon":139.6950472},
                   {"lat":35.6908056,
                    "lon":139.7568194},
                   {"lat":35.6734139,
                    "lon":139.7683556},
                   {"lat":35.6803806,
                    "lon":139.7696861},
                   {"lat":35.6771611,
                    "lon":139.7704111},
                   {"lat":35.67855,
                    "lon":139.7699944}]}]

[当該階層の住所がない場合要素がnullになる例]
https://test.core.its-mo.com/zmaps/api/apicore/core/v1_0/location?if_clientid=JSZxxxxxxxxxx|xxxxx&if_auth_type=ip&latlon=36.1028525,139.6051278

{"address":{"text":"埼玉県加須市常泉７３",
            "code":"112100260000000000014",
            "point":{"lat":36.1028525,
                     "lon":139.6051278},
            "parts":["埼玉県","加須市","常泉","","","７３"],
            "kana":"サイタマケンカゾシツネズミ",
            "kanaParts":["サイタマケン","カゾシ","ツネズミ","","",""],
            "level":"tbn"},
 "zipcode":"411-0000",
 "around":false,
 "addressPoints":[{"lat":35.8537417,
                   "lon":139.6521139}, //都道府県
                  {"lat":36.1282611,
                   "lon":139.6049583}, //市区町村
                  {"lat":36.1028525,
                   "lon":139.6051278}, //町・大字
                  null,                //字・丁目なし
                  null,                //街区なし
                  {"lat":36.1028525,
                   "lon":139.6051278}] //地番}

[枝番の代表点が返却されるが 地番の代表点がnullになる例]
https://test.core.its-mo.com/zmaps/api/apicore/core/v1_0/location?if_clientid=JSZxxxxxxxxxx|xxxxx&if_auth_type=ip&latlon=35.1490389,138.9893972

{"address":{"text":"静岡県三島市４７４５-４５８",
             "code":"22206A20000000000001000003",
             "point":{"lat":35.1490389,
                      "lon":138.9893972},
             "parts":["静岡県","三島市","","","","４７４５","４５８"],
             "kana":"シズオカケンミシマシ",
             "end":null,
             "bounds":null,
             "kanaParts":["シズオカケン","ミシマシ","","","","",""],
             "level":"ebn",
             "language":null},
  "zipcode":"411-0000",
  "around":false,
  "addressPoints":[{"lat":34.9734639,
                    "lon":138.3862306},  //都道府県
                   {"lat":35.1489222,
                    "lon":138.9893778},  //市区町村
                   null,                 //町・大字
                   null,                 //字・丁目
                   null,                 //街区
                   null,                 //地番の代表点がnull
                   {"lat":35.1490389,
                    "lon":138.9893972}]} //枝番