出力フォーマット
[{"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になる場合があります。
|
出力例
[通常出力例]
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":"東京都千代田区丸の内１丁目９−１",
"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になる例]
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":"埼玉県加須市常泉７３",
"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になる例]
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":"静岡県三島市４７４５-４５８",
"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}]} //枝番