緯度経度での住所検索

API名: 
location
概要: 
リクエストパラメータで指定された緯度経度の住所情報を返却します.。
URI: 

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

<API使用例>
http://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点まで複数指定ができます。
本項目は必須項目であるため、未指定の場合はエラーとなります。
datum   TOKYO 測地系
返却される住所代表点の測地系を指定します。
llunit   dec 緯度経度形式
緯度経度形式を指定します。

出力データ
出力フォーマット
[{"address":{"text":"東京都千代田区丸の内1丁目9−1",
             "code":"131010550010000900001",
             "point":{"lat":35.67855,
                      "lon":139.7699944},
             "parts":["東京都","千代田区","丸の内","1丁目","9","1"],
             "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になる場合があります。

出力例

[通常出力例]
http://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":"東京都千代田区丸の内1丁目9−1",
             "code":"131010550010000900001",
             "point":{"lat":35.67855,
                      "lon":139.7699944},
             "parts":["東京都","千代田区","丸の内","1丁目","9","1"],
             "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になる例]
http://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":"埼玉県加須市常泉73",
            "code":"112100260000000000014",
            "point":{"lat":36.1028525,
                     "lon":139.6051278},
            "parts":["埼玉県","加須市","常泉","","","73"],
            "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になる例]
http://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":"静岡県三島市4745-458",
             "code":"22206A20000000000001000003",
             "point":{"lat":35.1490389,
                      "lon":138.9893972},
             "parts":["静岡県","三島市","","","","4745","458"],
             "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}]} //枝番