フリーワードでの駅検索

API名: 
jorudan/station_word
概要: 
リクエストパラメータで指定される駅名称を元に該当する駅情報(ジョルダンデータ)を返却します。

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

URI: 

http://core.its-mo.com/zmaps/api/apicore/core/v1_0/jorudan/station_word

<API使用例>
http://core.its-mo.com/zmaps/api/apicore/core/v1_0/jorudan/station_word?if_clientid=JSZxxxxxxxxxx|xxxxx&if_auth_type=ip&word=品川

リクエストパラメータ
パラメータ 必須 デフォルト値 説明
word - 検索ワード
検索語句を指定します。
検索語句はカナ指定もできます。
検索語句の文字数の上限は1024文字です。
本項目は必須項目であるため、未指定の場合はエラーとなります。
datum   TOKYO 測地系
返却される住所代表点の測地系を指定します。
addrcode   - 絞込み住所コード
検索範囲を指定の住所コードに限定します。市区町村までのコード(2桁または5桁)を指定できます。
複数指定できますが、市区町村を指定する場合は同一都道府県に限定されます。
linecode   - 絞込み路線コード
検索範囲を指定の路線コードに限定します。
sort   -score 検索結果並び順
検索結果の並び順を指定します。
検索結果並び順は複数値指定できます。
 
[並び替え用文字列一覧]
score マッチングスコア順(昇順)
-score マッチングスコア順(降順)
nm 施設名称順(昇順)
-nm 施設名称順(降順)
kn 施設名カナ順(昇順)
-kn 施設名カナ順(降順)
tod 都道府県コード順(昇順)
-tod 都道府県コード順(降順)

 
[例]

sort=tod,-score

limit   0,100 検索結果取得件数
検索結果取得件数を指定します。
llunit   dec 緯度経度形式
緯度経度形式を指定します。
 

出力データ
出力フォーマット
{"status":{"code":"0000",
           "text":"OK"},
 "info":{"hit":3,
         "facet":{"tod":{"13:東京都":3},
                  "shk":{"13:東京都:103:港区":1,
                         "13:東京都:109:品川区":2}}},
 "item":[{"text":"品川",
          "point":{"lat":35.6269106,
                   "lon":139.7436697},
          "kana":"しながわ",
          "line":["ひたち","横須賀線","京浜東北線","山手線","成田エクスプレス","東海道・山陽新幹線","東海道本線(東日本)","京急本線"],
          "corp":["JR","京浜急行電鉄"]},
         {"text":"品川シーサイド",
          "point":{"lat":35.6052778,
                   "lon":139.7527778},
          "kana":"しながわしーさいど",
          "line":["りんかい線"],
          "corp":["りんかい線"]},
         {"text":"北品川",
          "point":{"lat":35.6197306,
                   "lon":139.74248},
          "kana":"きたしながわ",
          "line":["京急本線"],
          "corp":["京浜急行電鉄"]}]}
キー名 データ型 説明
status     object ステータス情報が入ります。
info     object 検索結果の情報が入ります。
  hit   number 入力された条件に対してヒットした件数が入ります。
  facet   object ファセット情報が入ります。
    tod object 都道府県毎の件数が入ります。
    shk object 市区町村毎の件数が入ります。
item     array 検索結果の配列が入ります。検索結果が0件の場合は空の配列となります。
  text   string 駅名称が入ります。
  point   object 代表点緯度経度
  kana   string 駅名かなが入ります。
  line   array 配列形式で路線名が入ります。
  corp   array 配列形式で鉄道会社名が入ります。 

出力例

[通常出力例]
http://core.its-mo.com/zmaps/api/apicore/core/v1_0/jorudan/station_word?if_clientid=JSZxxxxxxxxxx|xxxxx&if_auth_type=ip&word=品川

{"status":{"code":"0000",
           "text":"OK"},
 "info":{"hit":3,
         "facet":{"tod":{"13:東京都":3},
                  "shk":{"13:東京都:103:港区":1,
                         "13:東京都:109:品川区":2}}},
 "item":[{"text":"品川",
          "point":{"lat":35.6269106,
                   "lon":139.7436697},
          "kana":"しながわ",
          "line":["ひたち","横須賀線","京浜東北線","山手線","成田エクスプレス","東海道・山陽新幹線","東海道本線(東日本)","京急本線"],
          "corp":["JR","京浜急行電鉄"]},
         {"text":"品川シーサイド",
          "point":{"lat":35.6052778,
                   "lon":139.7527778},
          "kana":"しながわしーさいど",
          "line":["りんかい線"],
          "corp":["りんかい線"]},
         {"text":"北品川",
          "point":{"lat":35.6197306,
                   "lon":139.74248},
          "kana":"きたしながわ",
          "line":["京急本線"],
          "corp":["京浜急行電鉄"]}]}

[検索結果が0件の例]
http://core.its-mo.com/zmaps/api/apicore/core/v1_0/jorudan/station_word?if_clientid=JSZxxxxxxxxxx|xxxxx&if_auth_type=ip&word=品山

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