緯度経度での交差点検索
API名:
intersection/latlon
概要:
入力緯度経度から該当する交差点情報を検索します。
※この機能を利用するには別途契約が必要です。
URI:
https://test.core.its-mo.com/zmaps/api/apicore/core/v1_0/intersection/latlon
<API使用例>
リクエストパラメータ
| パラメータ | 必須 | デフォルト値 | 説明 | ||||||||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
| latlon | ○ | - |
緯度経度 緯度経度指定します。 本項目は必須項目であるため、未指定の場合はエラーとなります。 |
||||||||||||||
| word | - |
絞込み検索ワード 検索結果を絞り込む語句を指定します。 複数値指定で AND または OR 検索ができます。 複数値指定の上限は5件で、1語句の上限は1024文字です。 |
|||||||||||||||
| srchtype | and |
検索タイプ word パラメータを複数値指定した場合の検索タイプを指定します。
|
|||||||||||||||
| radius | 500 |
検索範囲 検索範囲の半径を指定します。(単位:m) 指定できる半径は 0～10000 です。 ※半径を広範囲に指定した場合、応答時間の大きな遅延が発生する可能性がありますのでご注意ください。 |
|||||||||||||||
| trafficlight | off |
信号機 信号機の有無を指定します。
|
|||||||||||||||
| datum | TOKYO |
測地系 返却される住所代表点の測地系を指定します。 |
|||||||||||||||
| limit | 0,100 |
検索結果取得件数 検索結果取得件数を指定します。 取得開始位置の指定範囲は 0～10000 です。 10001 以上の指定をした場合は10000 指定と同様の結果となります。 取得件数の指定範囲は 1~1000 です。 1001以上の指定をした場合は1000指定と同様の結果となります。 |
|||||||||||||||
| llunit | dec |
緯度経度形式 緯度経度形式を指定します。 |
|||||||||||||||
| sort | dist |
出力順 出力順を指定します。 複数値指定できます。 デフォルトは昇順で、降順指定の場合、ソートキーの前方にマイナス(-)を付加します。
|
出力データ
出力フォーマット
{"status":{"code":"OK",
"text":"正常終了"},
"info":{"hit":3,
"facet":{"tod":{"13":2},
"shk":{"13107":1,
"13210":1}},
"item":[{"code":"30000000000000009425",
"name":"表参道交差点",
"kana":"オモテサンドウコウサテン",
"point":{"lat":35.6619698,
"lon":139.71568771},
"addressText":"東京都港区",
"addressCode":"13103",
"trafficLight":true}
...]}| キー名 | データ型 | 説明 | ||||||
|---|---|---|---|---|---|---|---|---|
| status | object | ステータス情報が入ります。 | ||||||
| code | string |
ステータスコードが入ります。
|
||||||
| text | string | ステータス内容に関するテキスト情報が入ります。 | ||||||
| info | object | 検索結果の情報が入ります。 | ||||||
| hit | number | 入力された条件に対してヒットした件数が入ります。 | ||||||
| facet | object | ファセット情報が入ります。 | ||||||
| tod | object |
都道府県毎の件数が入ります。 形式は{"都道府県コード":件数}です。 |
||||||
| shk | object |
市区町村毎の件数が入ります。 形式は{"市区町村コード":件数}です。 |
||||||
| item | array |
検索結果の配列が入ります。 検索結果が0件の場合は空の配列となります。 不明な項目についてはnullで返却します。 |
||||||
| code | string | 交差点コードが入ります。 | ||||||
| name | string | 交差点名称が入ります。 | ||||||
| kana | string | 交差点カナが入ります。 | ||||||
| point | object | 代表点緯度経度が入ります。 | ||||||
| addressText | string | 住所名称が入ります。 | ||||||
| addressCode | string | 住所コードが入ります。 | ||||||
| trafficLight | boolean | 信号機の有無が入ります。 | ||||||
| distance | number | 距離が入ります。 | ||||||
出力例
[通常出力例]
https://test.core.its-mo.com/zmaps/api/apicore/core/v1_0/intersection/latlon?if_clientid=JSZxxxxxxxxxx|xxxxx&if_auth_type=ip&latlon=34.66645413,135.50081815&word=難波&limit=0,1&sort=dist&srchtype=and&datum=TOKYO
{"status":{"code":"OK",
"text":"正常終了"},
"info":{"hit":2,
"facet":{"tod":{"27":2},
"shk":{"27128":2}}},
"item":[{"code":"513574-28316",
"name":"難波",
"kana":"なんば",
"point":{"lat":34.6640183,
"lon":135.5031475},
"addressText":"大阪府大阪市中央区難波１丁目９－８",
"addressCode":"27128",
"trafficLight":true,
"distance":333}]}
[検索結果が0件の例]
https://test.core.its-mo.com/zmaps/api/apicore/core/v1_0/intersection/latlon?if_clientid=JSZxxxxxxxxxx|xxxxx&if_auth_type=ip&word=町,新宿&addrcode=23,24&limit=1,50
{"status":{"code":"OK",
"text":"正常終了"},
"info":{"hit":0,
"facet":null},
"item":[]}