緯度経度での交差点検索

API名: 
intersection/latlon
概要: 
入力緯度経度から該当する交差点情報を検索します。

※この機能を利用するには別途契約が必要です。

URI: 

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

<API使用例>
http://core.its-mo.com/zmaps/api/apicore/core/v1_0/intersection/latlon?if_clientid=JSZxxxxxxxxxx|xxxxx&if_auth_type=ip&word=寺,町,&addrcode=11,13&limit=1,3

リクエストパラメータ
パラメータ 必須 デフォルト値 説明
latlon - 緯度経度
緯度経度指定します。
本項目は必須項目であるため、未指定の場合はエラーとなります。
word   - 絞込み検索ワード
検索結果を絞り込む語句を指定します。
複数値指定で AND または OR 検索ができます。
複数値指定の上限は5件で、1語句の上限は1024文字です。
srchtype   and 検索タイプ
word パラメータを複数値指定した場合の検索タイプを指定します。
and AND 検索
or OR 検索
radius   500 検索範囲
検索範囲の半径をメートル指定します。
0~10000の間で設定してください。
※半径を広範囲に指定すると、レスポンスが遅くなります。
trafficlight   off 信号機
信号機の有無を指定します。
off 信号機有無の絞込みを行わない
none 信号機なし交差点を取得
exist 信号機あり交差点を取得
datum   TOKYO 測地系
返却される住所代表点の測地系を指定します。
limit   0,100 検索結果取得件数
検索結果取得件数を指定します。
指定可能値はそれぞれ以下です。
取得開始位置 0~1000
取得件数 1~1000
llunit   dec 緯度経度形式
緯度経度形式を指定します。
sort   dist 出力順
出力順を指定します。
複数値指定できます。
デフォルトは昇順で、降順指定の場合、ソートキーの前方にマイナス(-)を付加します。
dist 距離
score マッチングスコア
※word指定時のみ有効
nm 交差点名称
kn 交差点カナ
tod 都道府県コード
nmlen 名称の文字数

出力データ
出力フォーマット
{"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 ステータスコードが入ります。
OK 正常終了
ERR_FORCED_
TERMINATION
タイムアウトが発生またはデータサイズが
制限値を超えたため処理が中断された
  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 距離が入ります。

出力例

[通常出力例]
http://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=2,2&sort=dist&srchtype=and&datum=TOKYO

{"status":{"code":"OK",
           "text":"正常終了"},
 "info":{"hit":32,
         "facet":{"tod":{"27":32},
                  "shk":{"27111":17,
                         "27128":15}}},
 "item":[{"code":"7-22-50-25-5260984",
          "name":"信号機A",
          "kana":"シンゴウキエー",
          "point":{"lat":34.6642667,
                   "lon":135.5015361},
          "addressText":"大阪府大阪市",
          "addressCode":"27128",
          "trafficLight":true,
          "distance":244},
         {"code":"7-22-50-155-32562836",
          "name":"信号機B",
          "kana":"シンゴウキビー",
          "point":{"lat":34.664725,
                   "lon":135.5026889},
          "addressText":"大阪府大阪市",
          "addressCode":"27128",
          "trafficLight":false,
          "distance":249}]}

[検索結果が0件の例]
http://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":[]}