緯度経度での住所検索

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

緯度経度形式
緯度経度形式を指定します。

d2d

到着地点情報(D2D)
到着地点情報(D2D)を取得するかどうかを真偽値で指定します。
※本機能を利用する場合には別途契約が必要です。

指定値	説明
T	到着地点情報(D2D)を出力する
F	到着地点情報(D2D)を出力しない

出力データ

出力フォーマット

[{"address":{"text":"東京都千代田区丸の内１丁目９−１",
"code":"131010550010000900001",
"point":{"lat":35.67855,
"lon":139.7699944},
"parts":["東京都","千代田区","丸の内","１丁目","９","１"],
"kana":"トウキヨウトチヨダクマルノウチ",
"zipcode":null,
"match":null,
"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}]}
"d2d":[{"code":"01",
"point":{"lat":35.67925,
"lon":139.7689861}}]}];
...]

キー名

データ型

説明

address

object

緯度経度で指定された地点の住所が入ります。

text

string

住所表記文字列が入ります。

code

string

住所コードが入ります。

point

object

代表点緯度経度が入ります。

parts

array

住所階層毎に分割された文字列(string型)の配列が入ります。

kana

string

住所読み仮名が入ります。

zipcode

現在この出力値は使用されておりません。
常にnullが入ります。

match

現在この出力値は使用されておりません。
常にnullが入ります。

end

boolean

住所にさらに下の階層がある場合は false, そうでない場合は trueが入ります。
不明の場合は null となります。

bounds

object

行政界ポリゴンの緯度経度矩形範囲が入ります。
データは街区までで、街区以上の住所でもない場合があります。
データがない場合は null となります。行政界ポリゴンデータは住宅地図ベースのものしかないため、データ更新時期によっては住所とずれる場合があります。

kanaParts

array

住所階層毎に分割された住所読み仮名(string型)の配列が入ります。

level

string

住所階層コードが入ります。

language

現在この出力値は使用されておりません。
常にnullが入ります。

zipcode

string

緯度経度で指定された地点の郵便番号が入ります。

around

boolean

周辺住所かどうかのフラグが入ります。
この値が true の場合、指定した地点が海上など住所の取得できない場所であったため近傍の住所を取得したことを示します。

addressPoints

array

住所階層毎の代表点座標が緯度経度の配列で入ります。
配列数は出力データaddress->partsの配列数と一致します。
本配列の要素は出力データaddress->partsの該当階層が住所が無い場合、nullとなります。

また、枝番はあるが地番が無い住所が存在する(地番及び枝番はそれぞれ固有の建物を指す)ため、枝番の代表点は返却されるが地番の代表点はnullになる場合があります。

d2d

array

到着地点情報のオブジェクトが配列で入ります。
到着地点情報がない場合、空の配列となります。
配列形式となっていますが、現状複数件の地点が返却されることはありません。

code

string

到着地点の種別が入ります。

自動車用到着地点1

point

LatLon

到着地点の緯度経度が入ります。

出力例

[通常出力例]
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":"トウキヨウトチヨダクマルノウチ",
"zipcode":null,
"match":null,
"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":"サイタマケンカゾシツネズミ",
"zipcode":null,
"match":null,
"end":null,
"bounds":null,
"kanaParts":["サイタマケン","カゾシ","ツネズミ","","",""],
"level":"tbn",
"language":null},
"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":"シズオカケンミシマシ",
"match":null,
"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}]}] //枝番

[d2d=Tを指定時の例]
https://test.core.its-mo.com/zmaps/api/apicore/core/v1_0/location?if_clientid=JSZxxxxxxxxxx|xxxxx&if_auth_type=ip&latlon=36.224327162,139.982884817&d2d=T

[{"address":{"text":"茨城県下妻市若柳丙３４９",
"code":"082100510000000000246",
"point":{"lat":36.2244528,
"lon":139.9822028},
"parts":["茨城県","下妻市","若柳","","","丙３４９"],
"kana":"イバラキケンシモツマシワカヤナギ",
"zipcode":null,
"match":null,
"end":null,
"bounds":null,
"kanaParts":["イバラキケン","シモツマシ","ワカヤナギ","","",""],
"level":"tbn",
"language":null},
"zipcode":"304-0012",
"around":false,
"addressPoints":[{"lat":36.3386667,
"lon":140.4501417},
{"lat":36.1813333,
"lon":139.9706444},
{"lat":36.2205,
"lon":139.9804778},
null,
null,
{"lat":36.2244528,
"lon":139.9822028}],
"d2d":[{"code":"01",
"point":{"lat":36.2242417,
"lon":139.9822333}}]}]

[指定された地点に該当するデータが存在しない場合]

https://test.core.its-mo.com/zmaps/api/apicore/core/v1_0/location?if_clientid=JSZxxxxxxxxxx|xxxxx&if_auth_type=ip&latlon=35.445514167,140.774265556

[
null
]

ヘッダー用問い合わせリンク

メインメニュー

API マニュアル

緯度経度での住所検索

検索フォーム

ヘッダー用問い合わせリンク

メインメニュー

現在地

API マニュアル

緯度経度での住所検索