ポリラインでの周辺のPOI情報検索

API名: 
poi/polyline
概要: 
リクエストパラメータで指定されるポリラインを元に周辺のPOI情報を返却します。

ポリライン距離が長くなるほど検索速度は遲くなります。1回のリクエストでの距離上限は 4km 程度を推奨します。

URI: 
http://core.its-mo.com/zmaps/api/apicore/core/v1_0/poi/polyline
 
<API使用例>
http://core.its-mo.com/zmaps/api/apicore/core/v1_0/poi/polyline?if_clientid=JSZxxxxxxxxxx|xxxxx&if_auth_type=ip&line=35.6618472,139.76095,35.661605,139.760819,35.661480,139.760747&buffer=20
リクエストパラメータ
パラメータ 必須 デフォルト値 説明
line - ポリライン
緯度経度を2点以上で指定します。
※routeid パラメータと同時指定はできません。
word   - 検索ワード
検索範囲を指定の施設名称に限定します。
複数値指定で AND または OR 検索ができます。
複数値指定の上限は50件で1語句の上限は1024文字です。
srchtype   and 検索タイプ
word パラメータを複数値指定した場合の検索タイプを指定します。
and AND 検索
or OR 検索
poitype   all POI情報検索範囲指定
周辺のPOI情報の検索範囲を指定します。
all を指定した場合はポリライン周辺、corner を指定した場合はポリライン上の曲がり角が検索範囲になります。
buffer   20 検索範囲
クエリパラメータpoitype に all を指定した場合、ポリラインからどのくらいの範囲を検索対象とするか、
片側の幅をメートル単位で指定します。
指定可能な幅は0~200です。
cornerradius   50 検索範囲メートル指定
クエリパラメータpoitype に corner を指定した場合、検索範囲の半径をメートル単位で指定します。
指定可能な幅は0 ~200です。
cornerangle   120 検索範囲角度指定
クエリパラメータpoitype に corner を指定した場合、角判定を行う角度を指定します。
指定した角度以下の角を「角」とします。
指定可能な範囲は0~180です。
datum   TOKYO 測地系
返却される住所代表点の測地系を指定します。
limit   0,100 検索結果取得件数
検索結果取得件数を指定します。
取得件数の指定範囲は 1~1000 です。1000件以上の指定をした場合は1000件指定と同様の結果となります。
llunit   dec 緯度経度形式
緯度経度形式を指定します。

出力データ
出力フォーマット
{"status":{"code":"0000",
           "text":"OK"},
 "info":{"hit":5},
 "item":[{"poi":{"text":"ローソン銀座三丁目店",
                 "code":"1561370",
                 "point":{"lat":35.672075,
                          "lon":139.7678331},
                 "kana":"ロ-ソンギンザサンチョウメテン",
                 "addressText":"東京都中央区銀座3丁目8-1",
                 "zipcode":"104-0061",
                 "phoneNumber":"03-3563-3731",
                 "genre":null,
                 "detaul":null,

                 "language":null,
                 "arrvalInfo":[]},
          "side":"right"},
          ...]}
キー名 データ型 説明
status     object ステータス情報が入ります。
info     object 検索結果の情報が入ります。
  hit   number 入力された条件に対してヒットした件数が入ります。
item     array 検索結果の配列が入ります。
検索結果が0件の場合は空の配列となります。
  poi   object POI情報が入ります。
  side   string ポリライン方向に対して、POIの位置が右側または左側にあることを表します。
right ポリライン方向に対してPOIの位置が右側
left ポリライン方向に対してPOIの位置が左側

出力例

[通常出力例]
http://core.its-mo.com/zmaps/api/apicore/core/v1_0/poi/polyline?if_clientid=JSZxxxxxxxxxx|xxxxx&if_auth_type=ip&line=35.6618472,139.76095,35.661605,139.760819,35.661480,139.760747&buffer=20

{"status":{"code":"0000",
           "text":"OK"},
 "info":{"hit":2},
 "item":[{"poi":{"text":"ドトールコーヒーショップ新橋西口通り店",
                 "code":"00000000000001800091",
                 "point":{"lat":35.6616417,
                          "lon":139.7606778},
                 "kana":"ドトールコーヒーショップシンバシニシグチドオリテン",
                 "addressText":"東京都港区新橋3-19-4",
                 "zipcode":"105-0004",
                 "phoneNumber":"03-5473-8507",
                 "genre":null,
                 "detaul":null,
                 "language":null,
                 "arrvalInfo":[]
},
          "side":"right"},
         {"poi":{"text":"マンボー新橋2号店",
                 "code":"00000000000002684064",
                 "point":{"lat":35.6614722,
                          "lon":139.7609861},
                 "kana":"マンボーシンバシニゴウテン",
                 "addressText":"東京都港区新橋3丁目23-1",
                 "zipcode":"105-0004",
                 "phoneNumber":"03-5733-3949",
                 "genre":null,
                 "
detaul":null,
                 "language":null,
                 "arrvalInfo":[]},
          "side":"left"}]}



[検索結果が0件の例]

{"status":{"code":"0000",
           "text":"OK"},
 "info":{"hit":0},
 "item":[]}