ホ−ム » クラスリファレンス » ZDC.Search

ZDC.Search

下記の検索が利用できます。
※)search.jsが必要です。
実装例

分類名称メソッド名説明
住所検索文字列で住所検索ZDC.Search.getAddrByWordV2()文字列(カナを含む)で住所を検索します
ZDC.Search.getAddrByWord()文字列で住所を検索します
郵便番号で住所検索ZDC.Search.getAddrByZipcode()郵便番号で住所を検索します
緯度経度で住所検索ZDC.Search.getAddrByLatLon()緯度経度で住所を検索します
住所コードで住所リスト検索ZDC.Search.getAddrListByAddrCode()住所コードで住所リストを検索します
POI検索文字列でPOI検索ZDC.Search.getPoiByWord()文字列でPOIを検索します
緯度経度POI検索ZDC.Search.getPoiByLatLon()緯度経度で周辺のPOIを検索します
文字列で駅検索ZDC.Search.getStationByWord()文字列で駅を検索します
緯度経度で駅検索ZDC.Search.getStationByLatLon()緯度経度で周辺の駅を検索します
路線コードで駅検索ZDC.Search.getStationByLineCode()路線コードで駅を検索します
ポリラインでPOI検索ZDC.Search.getPoiByPolyline()ポリライン沿いのPOIを検索します
ジャンルコードPOI検索ZDC.Search.getPoiByGenrecode()ジャンルコードPOIを検索します
緯度経度検索住所で緯度経度検索ZDC.Search.getLatLonByAddr()住所で緯度経度を検索します
ルート探索自動車ルート探索ZDC.Search.getRouteByDrive()自動車のルート探索を行います
歩行者ルート探索ZDC.Search.getRouteByWalk()歩行者のルート探索を行います
その他住所コードで路線検索ZDC.Search.getRailLineByAddrCode()住所コードで路線を検索します
文字列で路線検索ZDC.Search.getRailLineByWord()文字列で路線を検索します
緯度経度で標高検索ZDC.Search.getElevationByLatLon()緯度経度で標高を検索します
GPS点列補正ZDC.Search.getRoadLinkByLatlons()緯度経度の点列から移動した経路を推定し、
道路リンクオブジェクトを返却します
住所ポリゴンを検索ZDC.Search.getAddrPolygon()住所コード緯度経度の矩形範囲で
住所のポリゴンを検索します
高精度測地系変換ZDC.Search.convertDatum()緯度経度測地系を高精度変換します

使用方法

検索のメソッドは全て引数にqueryとfuncが必要です。

引数タイプ説明
queryobject検索に必要なクエリーオブジェクト。検索によって異なる
funcfunction検索終了後に実行するコールバックメソッド

戻り値の第一引数には検索のステータスオブジェクト、第二引数には結果オブジェクトが入ります。

ステータスオブジェクトは全ての検索のメソッドで共通です。

プロパティタイプ説明
codestring検索が成功した場合には'000'。失敗した場合は下記のコード
100:パラメータエラーなど
101:内部エラー
102:その他のエラー
textstring検索が成功した場合には'ok'。
失敗した場合はその旨のメッセージ

デフォルトのタイムアウトは15秒です。
なお、検索はHTTPのGETで行われるためブラウザのURL文字列長制限(IEの2083文字 http://support.microsoft.com/?id=208427)を受けます。

メソッド

object ZDC.Search.getAddrByLatLon(query, func)

緯度経度で住所を検索します。
動作確認

クエリーオブジェクト

プロパティタイプデフォルト説明
latlonsarray(ZDC.LatLon)-地点の緯度経度を配列で指定。上限は100地点
datumstringTOKYO入出力緯度経度測地系を指定

結果オブジェクト
※結果オブジェクトは配列で返却されます

プロパティタイプ説明
address住所オブジェクト住所オブジェクト
zipcodestring郵便番号
aroundbooleantrueの場合、周辺の住所(指定地点が海上などの場合周辺の住所)を取得したことを意味する

例)

 [{"address":{"text":"東京都千代田区丸の内1丁目9−1",
            "code":"131010550010000900001",
            "latlon":{"lat":35.679777777778,
                     "lon":139.77165},
            "parts":["東京都","千代田区","丸の内","1丁目","9","1"],
            "kana":"トウキヨウトチヨダクマルノウチ",
            "end":null},
 "zipcode":"100-0005",
 "around":false}]



object ZDC.Search.getAddrByWordV2(query, func) ,
object ZDC.Search.getAddrByWord(query, func)

住所名称で住所を検索します。

※)ZDC.Search.getAddrByWordV2()はZDC.Search.getAddrByWord()と検索結果が異なることがあります。
動作確認

クエリーオブジェクト

プロパティタイプデフォルト説明
wordstring-必須項目。検索語句を指定。検索語句は正規化される
・ZDC.Search.getAddrByWordV2
 読み仮名での検索やand条件の複数指定が可能
 複数指定する場合は半角スペースまたはカンマ区切り
 複数指定の上限は50件で1語句の上限は1024文字

・ZDC.Search.getAddrByWord
 上限は1024文字。複数語句、読み仮名での検索はできない。Ver 1.11と同じ検索結果

※検索結果の違いはを参照
datumstringTOKYO返却されるPOI代表点緯度経度測地系
limitstring0,100検索結果取得件数。"取得開始位置,取得件数"で指定。
取得件数の上限は1000件。1001件以上の指定をした場合は1000件指定と同様の結果。
addrcodestring-検索範囲を指定の住所コードに限定する。例えば13を指定した場合東京都内で検索する
・ZDC.Search.getAddrByWordV2
 複数指定はできない

・ZDC.Search.getAddrByWord
 カンマ区切りで複数指定が可能。上限は50件

※正規化ルールはZDC.Search.getAddrByWordV2とZDC.Search.getAddrByWordで違います。
 詳細は住所検索時の入力パラメータ(フリーワード)正規化仕様を参照して下さい。

検索結果例

検索文字列ZDC.Search.getAddrByWordV2ZDC.Search.getAddrByWord
検索する住所の一部が
間違っている場合
東京都千代田区丸の内99990件"東京都千代田区丸の内"のみ1件
読み仮名で検索する場合マルノウチ"東京都千代田区丸の内"など30件0件

結果オブジェクト

プロパティタイプ説明
infoオブジェクト検索条件に一致した件数が"hit"というプロパティで取得できる
itemarray(住所オブジェクト)住所の配列。検索結果が0件の場合は空の配列

例)

 {"info":{"hit":3},
  "item":[{"text":"東京都港区新橋",
         "code":"13103016",
         "latlon":{"lat":35.663211111111,
                  "lon":139.75929722222},
         "parts":["東京都","港区","新橋"],
         "kana":"トウキヨウトミナトクシンバシ",
         "end":false,
         "level":"oaz"},
          :
        {"text":"東京都港区東新橋",
         "code":"13103023",
         "latlon":{"lat":35.658358333333,
                  "lon":139.75991388889},
         "parts":["東京都","港区","東新橋"],
         "kana":"トウキヨウトミナトクヒガシシンバシ",
         "end":false,
         "level":"oaz"}]}



object ZDC.Search.getAddrByZipcode(query, func)

郵便番号で住所を取得します。
動作確認

クエリーオブジェクト

プロパティタイプデフォルト説明
zipcodestring-7桁の郵便番号。ハイフンの有無は問わない
datumstringTOKYO返却される住所の代表点緯度経度測地系
limitstring0,100検索結果取得件数。"取得開始位置,取得件数"で指定

結果オブジェクト

プロパティタイプ説明
infoオブジェクト検索条件に一致した件数が"hit"というプロパティで取得できる
itemarray(住所オブジェクト)住所オブジェクトの配列。検索結果が0件の場合は空の配列

例)

 {"info":{"hit":1},
  "item":[{"text":"東京都港区東新橋1丁目9−1",
         "code":"131030230010000900001",
         "latlon":{"lat":35.659922222222,
                  "lon":139.76443611111},
         "parts":["東京都","港区","東新橋","1丁目","9","1"],
         "kana":"トウキヨウトミナトクヒガシシンバシ",
         "end":null}]}



object ZDC.Search.getAddrListByAddrCode(query, func)

住所コードで住所リストを検索します。
addrcodeに指定した住所の1つ下位の階層に属する住所がない場合、検索結果は0件となります。
動作確認

クエリーオブジェクト

プロパティタイプデフォルト説明
addrcodestring都道府県のリストを取得住所コード。指定がない場合、都道府県のリストを取得
datumstringTOKYO返却される住所の代表点緯度経度測地系
limitstring0,100検索結果取得件数。"取得開始位置,取得件数"で指定。
取得件数の上限は1000件。1001件以上の指定をした場合は1000件指定と同様の結果。

結果オブジェクト

プロパティタイプ説明
infoobject検索条件に一致した件数が"hit"というプロパティで取得できる
itemarray(住所オブジェクト)住所オブジェクトの配列。検索結果が0件の場合は空の配列

例)

 {"info":{"hit":6},
  "item":[{"text":"東京都港区新橋1丁目",
         "code":"13103016001",
         "latlon":{"lat":35.665008333333,
                  "lon":139.76125833333},
         "parts":["東京都","港区","新橋","1丁目"],
         "kana":"トウキヨウトミナトクシンバシ",
         "end":false},
         :
        {"text":"東京都港区新橋6丁目",
         "code":"13103016006",
         "latlon":{"lat":35.658852777778,
                  "lon":139.756725},
         "parts":["東京都","港区","新橋","6丁目"],
         "kana":"トウキヨウトミナトクシンバシ",
         "end":false}]}



object ZDC.Search.getLatLonByAddr(query, func)

住所で緯度経度を検索します。
動作確認

クエリーオブジェクト

プロパティタイプデフォルト説明
addressstring-住所文字列を指定。複数指定する場合はカンマ区切り。上限は1000件
(前方一致の検索となる。ただし、都道府県の省略は可能。)
datumstringTOKYO入出力緯度経度測地系を指定
levelstring-マッチングさせる住所階層

結果オブジェクト

タイプ説明
array(住所オブジェクト)住所オブジェクトの配列

例)

 [{"text":"東京都港区東新橋1丁目6−1",
   "code":"131030230010000600001",
   "latlon":{"lat":35.661163888889,
             "lon":139.76317777778},
   "parts":["東京都","港区","東新橋","1丁目","6","1"],
   "kana":"トウキヨウトミナトクヒガシシンバシ",
   "end":true},
  null,  //マッチしなかった場合は null
  {"text":"東京都港区東新橋2丁目6",
   "code":"1310302300200006",
   "latlon":{"lat":35.658725,
             "lon":139.76022222222},
   "parts":["東京都","港区","東新橋","2丁目","6"],
   "kana":"トウキヨウトミナトクヒガシシンバシ",
   "end":false}]



object ZDC.Search.getPoiByLatLon(query, func)

緯度経度で周辺のPOIを検索します。
動作確認

クエリーオブジェクト

プロパティタイプデフォルト説明
latlonZDC.LatLon-必須項目。緯度経度
radiusnumber500検索範囲の半径をメートルで指定。範囲は0〜10000
datumstringTOKYO入出力緯度経度測地系
wordstring-施設名称での絞り込み。上限は1024文字
genrecodestring-絞込みジャンルコード。複数指定する場合はカンマ区切り
検索範囲を指定のジャンルコードに限定5桁または10桁のコードで指定
複数指定かつ10桁で指定する場合上位5桁を同じコードにする必要がある
limitstring0,100検索結果取得件数。"取得開始位置,取得件数"で指定

結果オブジェクト

プロパティタイプ説明
infoobject検索条件に一致した件数が"hit"、ジャンルオブジェクトが"facet"というプロパティで取得できる
itemarray(object)POIオブジェクトが"poi"、検索地点とPOI代表点との距離(メートル単位)が"distance"で取得できる

例)

 {"info":{"hit":3,
        "facet":{"genre":{"0014000180":{"text":"買い物/コンビニ",
                                        "count":3}}}},
 "item":[{"poi":{"text":"ローソン新橋1丁目店",
                "code":"00000000000000183526",
                "latlon":{"lat":35.66485,
                         "lon":139.76050555556},
                "kana":"ローソンシンバシイッチョウメテン",
                "addressText":"東京都港区新橋1丁目15−7",
                "zipcode":"105-0004",
                "phoneNumber":"03-3502-8988",
                "genre":{"code":"0014000180",
                         "text":"買い物/コンビニ"}},
         "distance":177},
         :
        {"poi":{"text":"ローソン東新橋一丁目店",
                "code":"00000000000000186998",
                "latlon":{"lat":35.661158333333,
                         "lon":139.76214444444},
                "kana":"ローソンヒガシシンバシイッチョウメテン",
                "addressText":"東京都港区東新橋1丁目3−1",
                "zipcode":"105-0021",
                "phoneNumber":"03-3573-7228",
                "genre":{"code":"0014000180",
                         "text":"買い物/コンビニ"}},
         "distance":247}]}



object ZDC.Search.getPoiByWord(query, func)

文字列でPOIを検索します。
動作確認

クエリーオブジェクト

プロパティタイプデフォルト説明
wordstring-必須項目。検索語句を指定。上限1024文字。
datumstringTOKYO返却されるPOI代表点緯度経度測地系
addrcodestring-検索範囲を指定の住所コードに限定。複数指定する場合はカンマ区切り
複数指定かつ5桁で指定する場合は上位2桁を同じコードにする必要がある
genrecodestring-絞込みジャンルコード。複数指定する場合はカンマ区切り
検索範囲を指定のジャンルコードに限定5桁または10桁のコードで指定
複数指定かつ10桁で指定する場合上位5桁を同じコードにする必要がある
limitstring0,100検索結果取得件数。"取得開始位置,取得件数"で指定

結果オブジェクト

プロパティタイプ説明
infoobject検索条件に一致した件数が"hit"、その他件数情報が"facet"というプロパティで取得できる
itemarray(POIオブジェクト)POIオブジェクトの配列を取得できる

facet

プロパティタイプ説明
todnumber都道府県コード毎の件数
shknumber市町村コード毎の件数
genreジャンルオブジェクト

例)

{"info":{"hit":2,
        "facet":{"tod":{"13":2},
                 "shk":{"13107":1,
                        "13210":1},
                 "genre":{"0022000120":{"text":"文化施設/博物館",
                                        "count":2}}}},
"item":[{"text":"東京都江戸東京博物館分館・江戸東京たてもの園",
         "code":"00000000000000160822",
         "latlon":{"lat":35.712652777778,
                  "lon":139.51613055556},
         "kana":"トウキョウトエドトウキョウハクブツカンブンカンエドトウキョウタ テモノエン",
         "addressText":"東京都小金井市桜町3丁目7−1",
         "zipcode":"184-0005",
         "phoneNumber":"042-388-3300",
         "genre":{"code":"0022000120",
                  "text":"文化施設/博物館"}},
        {"text":"東京都江戸東京博物館",
         "code":"00000000000000160368",
         "latlon":{"lat":35.693319444444,
                  "lon":139.79917777778},
         "kana":"トウキョウトエドトウキョウハクブツカン",
         "addressText":"東京都墨田区横網1丁目4−1",
         "zipcode":"130-0015",
         "phoneNumber":"03-3626-9974",
         "genre":{"code":"0022000120",
                  "text":"文化施設/博物館"}}]}



object ZDC.Search.getRailLineByAddrCode(query, func)

住所コードで路線情報を検索します。
動作確認

クエリーオブジェクト

プロパティタイプデフォルト説明
addrcodestring-検索する地域を住所コードで指定。都道府県(2桁)または市区町村(5桁)で指定
limitstring0,100検索結果取得件数。"取得開始位置,取得件数"で指定

結果オブジェクト

プロパティタイプ説明
infoobject検索条件に一致した件数が"hit"、住所が"addressText"で取得できる
itemarray(object)路線のコードが"code"、路線名が"text"で取得できる。
注)それぞれラインオブジェクトで取得できる値と一致しない

例)

{"info":{"hit":15,
        "addressText":"東京都台東区"},
"item":[{"code":"28",
         "text":"JR京浜東北線"},
         :
        {"code":"448",
         "text":"東武伊勢崎線"}]}



object ZDC.Search.getRailLineByWord(query, func)

文字列で路線を検索します。
動作確認

クエリーオブジェクト

プロパティタイプデフォルト説明
wordstring-検索語句。上限1024文字
addrcodestring-検索範囲を指定の住所コードに限定。複数指定する場合はカンマ区切り
市区町村までのコード(2桁または5桁)を指定できる。
市区町村を複数指定する場合は同一都道府県に限定される
limitstring0,100検索結果取得件数。"取得開始位置,取得件数"で指定

結果オブジェクト

プロパティタイプ説明
infoobject検索条件に一致した件数が"hit"というプロパティで取得できる
itemarray(ラインオブジェクト)路線コードを"code"、路線名称を"text"で取得できる

例)

 {
     "info":{
            "hit":1
      },
     "item":[
              {
               "code":"0052",
               "text":"JR 東北本線"
              },
              :
      ]
 }



object ZDC.Search.getRouteByDrive(query , func)

自動車のルートを探索します。
動作確認

クエリーオブジェクト

プロパティタイプデフォルト説明
fromZDC.LatLon-出発地点の緯度経度
toZDC.LatLon-到着地点の緯度経度
datumstringTOKYO入出力緯度経度測地系
mpointsarray(ZDC.LatLon)-経由地点の緯度経度。複数点指定できる。上限は20地点
tollbooleantruetrueの場合有料道路を探索対象とする
searchtypestringtime検索タイプを指定。
dist:距離を優先して検索を行う
time:時間を優先して検索を行う
straightbooleanfalsetrueの場合右左折回数が少なくなるように探索する
cartypestringnormal通行料金算出に使用される車種を指定。
light:軽自動車
normal普通車
middle:中型車
large:大型車
big:特大車
smarticbooleanfalsetrueの場合スマートICを利用する
zoomnumber指定されたマップタイプに
おける縮尺レベルの最大値
ルート点列を間引く縮尺レベル。大きいほど精細なルートを描画
mapTypestring-マップタイプ。ルート点列を間引く場合は必須

結果オブジェクト

route

プロパティタイプ説明
tollnumberトータルの通行料金。有料道路を全く通過しない場合にはnull
timenumberトータルの走行時間(分単位)。走行時間が不明な場合はnull
distancenumberトータルの距離(メートル単位)
linkarray(object)リンク情報。詳細は下記リンク情報オブジェクト参照

リンク情報オブジェクト

プロパティタイプ説明
roadTypestring道路種別
tollFlagboolean有料道路に該当するか否か
distancenumber距離(メートル単位)
timenumber走行時間(秒単位)。走行時間が不明な場合はnull
tollnumber通行利用料金。通行料金算出不能な場合はnull
linearray(ZDC.LatLon)緯度経度の配列
guidanceobject誘導情報。誘導情報が存在しない場合はnull。現在は地点型誘導情報のみ対応している。
詳細はガイダンス情報オブジェクト参照
guidanceHighwayobject地点名情報。地点名情報が存在しない場合はnull。
詳細はガイダンスハイウェイ情報オブジェクト参照

ガイダンス情報オブジェクト

プロパティタイプ説明
crossNamestring交差点名称。データが存在しない場合はnull
roadNamestring道路名称。データが存在しない場合はnull
guideTypestring誘導区分(交差点拡大図/ハイウェイモード/直進交差点案内/画像誘導)
anglenumber進入道路に対する脱出道路の方向(角度)を記述する。
方向は進入道路の直進方向を0度とし、右回りに0〜359度の値をとる。データが存在しない場合はnull
straightFlagbooleantrueの場合進入道路に対する脱出道路が道なりを表す。データが存在しない場合はnull
crossImageUristring交差点画像(JCT画像/3D交差点画像)。データが存在しない場合はnull
signboardImageUristring方面看板画像。データが存在しない場合はnull
etcImageUristringETCレーン誘導画像。データが存在しない場合はnull

ガイダンスハイウェイ情報オブジェクト

プロパティタイプ説明
pointTypeobject地点種別オブジェクト。以下のプロパティを持つ。それぞれの値はbooleanです。
 ic : 地点がICの場合 true
 sa : 地点がサービスエリアの場合 true
 pa : 地点がパーキングエリアの場合 true
 jct : 地点がジャンクションの場合 true
複数 true となる場合があります(ic と jct等)。すべて falseとなる場合があります(料金所等)。
pointNamestring地点名称。データが存在しない場合はnull

例)

{"route":{"toll":120,
         "time":76,
         "distance":60128,
         "link":[{"roadType":"道路外",
                  "tollFlag":false,
                  "distance":14,
                  "time":0,
                  "toll":0,
                  "line":[{"lat":35.672382777778,"lon":139.77129083333},
                          {"lat":35.672516111111,"lon":139.77134638889}],
                  "guidance":null},
                 {"roadType":"国道",
                  "tollFlag":false,
                  "distance":22,
                  "time":5,
                  "toll":0,
                  "line":[{"lat":35.684316944444,"lon":139.34589861111},
                          {"lat":35.684494722222,"lon":139.34602083333}],
                  "guidance":{"crossName":"左入橋",
                              "roadName":"国道16号線",
                              "guideType":"交差点拡大図",
                              "angle":4,
                              "straightFlag":false,
                              "crossImageUri":null,
                              "signboardImageUri":"http://apicore/core/v1_0/cache/c2d0cd2e497f2f969c45e041fdba5caa.png",
                              "etcImageUri":null},
                  "guidanceHighway":{"pointType":{"ic":false,
                                                  "sa":false,
                                                  "pa":false,
                                                  "jct":false},
                                     "pointName":"加賀料金所(上り入口)"}
                  }]
         }
}

道路種別

道路種別
高速道路
都市高速道路
国道
主要地方道
都道府県道
一般道路(幹線)
一般道路(その他)
導入路
細街路(主要)
細街路(詳細)
フェリー航路
道路外

object ZDC.Search.getRouteByWalk(query , func)

歩行者のルートを探索します。
動作確認

クエリーオブジェクト

プロパティタイプデフォルト説明
fromZDC.LatLon-出発地点の緯度経度
toZDC.LatLon-到着地点の緯度経度
datumstringTOKYO入出力緯度経度測地系
mpointsarray(ZDC.LatLon)-経由地点の緯度経度を指定。複数点指定できる。上限は20点。
(経由地点の指定は無し。常に立ち寄り地点とする)
searchtypestringtime検索タイプを指定。
dist:距離を優先する
time:時間を優先する
easy:楽な道を優先する
roof:屋根がある道を優先する
highway:幹線道路を優先する
maxdistnumber5検索距離の上限を指定。
5:5キロメートル
10:10キロメートル

結果オブジェクト

route

プロパティタイプ説明
distancenumberトータルの距離(メートル単位)
linkarray(object)リンク情報。詳細は下記リンク情報オブジェクト参照

リンク情報オブジェクト

プロパティタイプ説明
typestring通路種別
structureTypestring構造種別
roofbooleantrueの場合は屋根がある
distancenumber距離(メートル単位)
linearray(ZDC.LatLon)緯度経度の配列

例)

{"route":{"distance":499,
         "link":[{"type":"通路外",
                  "structureType":"通常",
                  "roof":false,
                  "distance":5,
                  "line":[{"lat":35.664,"lon":139.756},
                          {"lat":35.664022222222,"lon":139.75595}],
                 {"type":"通常通路",
                  "structureType":"通常",
                  "roof":false,
                  "distance":30,
                  "line":[{"lat":35.664024722222,"lon":139.75595083333},
                          {"lat":35.663896944444,"lon":139.75588416667},
                          {"lat":{35.663763611111,"lon":139.7558175}]
                  }
                ]
       }
}

通路種別

通路種別
通常通路
横断歩道
横断通路
歩道橋
踏切内通路
連絡通路
建物内通路
敷地内通路
乗換リンク
通路外

構造種別

構造種別
通常
階段
エスカレーター
エレベーター
スロープ
動く歩道
段差

object ZDC.Search.getStationByLatLon(query , func)

緯度経度で周辺の駅を検索します。
動作確認

クエリーオブジェクト

プロパティタイプデフォルト説明
latlonZDC.LatLon緯度経度
radiusnumber500検索範囲の半径をメートルで指定。0〜10000
datumstringTOKYO返却されるPOI代表点緯度経度測地系
limitstring0,100検索結果取得件数。"取得開始位置,取得件数"で指定

結果オブジェクト

プロパティタイプ説明
infoobject検索条件に一致した件数が"hit"で取得できる
itemarray(object)POIオブジェクトが"poi"、ラインオブジェクトが"line"、検索地点とPOI代表点との距離(メートル単位)が"distance"で取得できる

例)

{"info":{"hit":4},
 "item":[{"poi":{"text":"日本橋駅(東京メトロ 銀座線)",
                "code":"00000000000000203820",
                "latlon":{"lat":35.678672222222,
                         "lon":139.77654722222},
                "kana":"ニホンバシエキ",
                "addressText":"東京都中央区日本橋1丁目3−11",
                "zipcode":"103-0027",
                "phoneNumber":"03-3271-2768",
                "genre":null},
         "line":{"code":"0508",
                 "text":"東京地下鉄 3号銀座線"},
         "distance":133},
         :
        {"poi":{"text":"三越前駅(東京メトロ 半蔵門線)",
                "code":"00000000000000204151",
                "latlon":{"lat":35.68165,
                         "lon":139.77639444444},
                "kana":"ミツコシマエエキ",
                "addressText":"東京都中央区日本橋室町1丁目2",
                "zipcode":"103-0022",
                "phoneNumber":"03-3279-3164",
                "genre":null},
         "line":{"code":"0510",
                 "text":"東京地下鉄 11号半蔵門線"},
         "distance":452}]}



object ZDC.Search.getPoiByPolyline(query, func)

ポリライン沿いのPOIを検索します。

動作確認

クエリーオブジェクト

プロパティタイプデフォルト説明
latlonsarray(ZDC.LatLon)-2点以上の緯度経度からなるポリライン
wordstring-施設名称での絞り込み。上限は1024文字
複数指定する場合はカンマもしくはセミコロン区切り
srchtypestringand施設名称を複数指定した場合の検索タイプ
and:全てANDで検索を行う
or:全てORで検索を行う
buffernumber20指定のポリラインからの検索対象範囲をメートルで指定。範囲は0~200
limitstring0,100検索結果取得件数。"取得開始位置,取得件数"で指定
datumstringTOKYO入出力緯度経度測地系を指定

結果オブジェクト

プロパティタイプ説明
infoobject検索条件に一致した件数が"hit"というプロパティで取得できる
itemarray(object)POIオブジェクトが"poi"、POIの位置は"side"で取得できる。
"side"の値は、POIの位置がポリラインに対して右側の場合はright、左側の場合はleftとなる。
ポリラインの方向は、latlonsの配列順である

例)

   {
      "info":{
              "hit":1
      },
      "item":[
              {
               "poi":{
                      "text":"ローソン銀座三丁目店",
                      "code":"1561370",
                      "latlon":{
                                "lat":35.672075,
                                "lon":139.7678331
                      },
                      "kana":"ロ−ソンギンザサンチョウメテン",
                      "addressText":"東京都中央区銀座3丁目8−1",
                      "zipcode":"104-0061",
                      "phoneNumber":"03-3563-3731",
                      "genre":null
              },
              "side":"right"
            },
           :
      ]
   }



object ZDC.Search.getPoiByGenrecode(query, func)

ジャンルコードPOIを検索します。
動作確認

クエリーオブジェクト

プロパティタイプデフォルト説明
genrecodestring-必須項目。検索範囲を指定のジャンルコードに限定。
複数指定する場合はカンマ区切り
5桁または10桁のコードで指定、複数指定かつ10桁で指定する場合上位5桁を同じコードにする必要がある
wordstring-施設名称での絞り込み。上限は1024文字
addrcodestring-検索範囲を指定の住所コードに限定。複数指定する場合はカンマ区切り
複数指定かつ5桁で指定する場合は上位2桁を同じコードにする必要がある
srchtypestringand施設名称を複数指定した場合の検索タイプ。
and:全てANDで検索を行う
or:全てORで検索を行う
datumstringTOKYO返却されるPOI代表点緯度経度測地系
limitstring0,100検索結果取得件数。"取得開始位置,取得件数"で指定

結果オブジェクト

プロパティタイプ説明
infoobject検索条件に一致した件数が"hit"、その他件数情報が"facet"というプロパティで取得できる
itemarray(POIオブジェクト)POIオブジェクトの配列を取得できる

facet

プロパティタイプ説明
todnumber都道府県コード毎の件数
shknumber市町村コード毎の件数
genreジャンルオブジェクト

例)

{
   "info":{
          "hit":29,
          "facet":{
                  "tod":{
                        "13":29
                  },
                 "shk":{
                       "13106":29
                  },
                 "genre":{
                          "0014000240":{
                                       "text":"買い物/本屋",
                                       "count":27
                         },
                        "0014000250":{
                                     "text":"買い物/ビデオ・CD",
                                     "count":2
                        }
                 }
         }
    },
   "item":[
          {
            "text":"(株)亜東書店",
            "code":"00000000000002526943",
            "latlon":{
                      "lat":35.707108333333,
                      "lon":139.78035277778
            },
            "kana":"アトウショテン",
            "addressText":"東京都台東区東上野2丁目18−7",
            "zipcode":"110-0015",
            "phoneNumber":"03-3835-7091",
            "genre":{
                     "code":"0014000240",
                     "text":"買い物/本屋"
            }
         },
         :
   ]
}



object ZDC.Search.getElevationByLatLon(query , func)

緯度経度で標高を検索します。
動作確認

クエリーオブジェクト

プロパティタイプデフォルト説明
latlonsarray(ZDC.LatLon)-緯度経度(上限は300点)
meshTypestringN05m,N10m,D50m検索する精度を指定。複数指定する場合はカンマ区切り
複数指定した場合、N05m,N10m,D50mの順で検索し最初に取得できた値が返却される
N05m : 5平方メートルの精度の標高データ
N10m : 10平方メートルの精度の標高データ
D50m : 50平方メートルの精度の水深データ

結果オブジェクト

タイプ説明
array(標高オブジェクト)標高オブジェクトの配列



object ZDC.Search.getRoadLinkByLatlons(query, func)

緯度経度の点列から移動した経路を推定し、道路リンクデータを返却します。
GPS点列などの補正に利用できます。
動作確認

クエリーオブジェクト

プロパティタイプデフォルト説明
latlonsarray(ZDC.LatLon)-緯度経度(上限は50点)
codestring-リンクコード。前回のリクエスト結果に繋げる場合は、前回の結果オブジェクトに含まれる
lastプロパティのcodeを指定する。指定がない場合、latlonsで指定した最初の点に一番近い
リンクを取得する
orderstring-接続情報。前回のリクエスト結果に繋げる場合は、前回の結果オブジェクトに含まれる
lastプロパティのorderを指定する
datumstringTOKYO入出力緯度経度測地系を指定
nearlimitnumber300code の指定がない場合に、検索範囲をメートルで指定。範囲は0~500
edgeadjuststringneither調整コードを指定。latlonsの一点目と最初のリンクの距離が最小になるリンク上の点を始点
にする。latlonsの最後の点と最終リンクの距離が最小になるリンク上の点を終点にする。
返却されるリンクデータ数が1つの場合、本パラメータは無効になる。
neither:始点、終点ともに調整しない
start:始点のみ調整する。code が指定されている場合は無効になる
end:終点のみ調整する
both:始点、終点ともに調整する。code が指定されている場合は始点調整は無効になる
使用例は下記のedgeadjustの使用例で示す
roundpathbooleanfalse往復路となっているリンク部分を削除する

結果オブジェクト

プロパティタイプ説明
lastobject道路リンク最後のリンクコードを"code"、道路リンク最後の接続情報を"order"で取得できる
itemarray(object)前回のリクエスト結果と接続しているかどうかの真偽値が"connection"、道路リンクオブジェクトが"roadLink"
というプロパティで取得できる

道路リンクオブジェクト

プロパティタイプ説明
codestringリンクコード
distancenumberリンク距離(メートル)
latlonsarray(ZDC.LatLon)緯度経度の配列
roadTypeobject道路種別。種別コードを"code"、種別名称を"text"で取得できる

例)

 {
     "last":{
            "code":"7417648",
            "order":"OE"
     },
     "item":[
               {
                 "roadLink":{
                          "code":"7417647",
                          "distance":48,
                          "latlons":[
                                         {
                                          "lat":35.6658528,
                                          "lon":139.7538528
                                         },
                                         {
                                           "lat":35.6656189,
                                           "lon":139.7537383
                                         }
                          ],
                          "roadType":{
                                  "code":"6",
                                  "text":"一般道路(その他)"
                         }
                   },
                   "connection":false
                },
                :
     ]
 }


道路種別

種別コード種別名称
0高速道路
1都市高速道路
2国道
3主要地方道
4都道府県道
5一般道路(幹線)
6一般道路(その他)
7導入路
8細道路(幹線)
9細道路(その他)
10フェリー航路
15道路外

注)こちらの道路種別と自動車ルート検索の道路種別は別物である。


object ZDC.Search.getAddrPolygon(query, func)

緯度経度の矩形範囲や住所コードで住所のポリゴンを検索します。
動作確認

クエリーオブジェクト

プロパティタイプデフォルト説明
boxZDC.LatLonBox-緯度経度の矩形範囲を指定
※addrcdプロパティとは同時には指定できない
addrcdstring-字丁目までの住所コードを指定
※boxプロパティとは同時には指定できない
複数指定の場合は、都道府県または市区町村の住所コード
カンマ区切りで指定可能。ただし桁数は2桁または5桁かつ同一にする
例) 「01,10,35」「01101,35101」
meshlvlnumber5指定したメッシュレベルの単位の精度で住所のポリゴンが返却される
4 : 1/2地域メッシュ(約500m)
5 : 1/4地域メッシュ(約250m)
6 : 1/8地域メッシュ(約125m)
※カッコ内はメッシュの一辺の距離を示す
addrlvlnumber1住所のポリゴンを取得する単位を指定
1:都道府県
2:市区町村
datumstringTOKYO入出力緯度経度測地系
limitstring1,100検索結果取得件数。"取得開始位置,取得件数"で指定。上限は5000件。

結果オブジェクト

プロパティタイプ説明
addrobject住所文字列が"text"、住所コードが"code"、住所階層毎に分割された文字列が"parts"プロパティで取得できる
geomGeoJSONGeoJSON形式で取得

例)

{
  "item": [
       {
           "addr": {
              "text": "神奈川県足柄下郡箱根町木賀",
              "code": "14382003000",
              "parts": ["神奈川県","足柄下郡箱根町","木賀",null]
           },
           "geom": {
               "coordinates": [
                   [
                       [
                           [
                               139.05, 
                               35.252083333333
                           ], 
                          :
                       ]
                   ], 
                   :
               ], 
               "type": "MultiPolygon"
           }
       },
       :
   ]}



矩形オブジェクト

プロパティタイプ説明
neobject矩形の左上の緯度経度。緯度が"lat"、経度が"lon"で取得できる
swobject矩形の右下の緯度経度。緯度が"lat"、経度が"lon"で取得できる

例)

{
   "ne": {
       "lat": 35.692598888889, 
       "lon": 139.70946527778
   }, 
   "sw": {
       "lat": 35.690515277778, 
       "lon": 139.70634
   } 
}



object ZDC.Search.getStationByWord(query , func)

駅名称での駅情報の検索をおこないます。
動作確認

クエリーオブジェクト

プロパティタイプデフォルト説明
wordstring-検索語句。上限1024文字。複数語句での検索はできない
datumstringTOKYO返却されるPOI代表点緯度経度測地系
addrcodestring-検索範囲を指定の住所コードに限定。複数指定する場合はカンマ区切り
市区町村までのコード(2桁または5桁)を指定できる。
市区町村を複数指定する場合は同一都道府県に限定される
sortstring-score出力順を指定。デフォルトは昇順で、降順指定の場合、ソートキーの前方にマイナス(-)を付加する
score:マッチングスコア
nm:施設名称
kn:施設名カナ
tod:都道府県コード
line:路線コード
fnm:完全一致
limitstring0,100検索結果取得件数。"取得開始位置,取得件数"で指定

結果オブジェクト

プロパティタイプ説明
infoobject検索条件に一致した件数が"hit"で取得できる
itemarray(object)POIオブジェクトが"poi"、ラインオブジェクトが"line"で取得できる

例)

{"info":{"hit":8,
        "facet":{"tod":{"13":5,
                        "27":3},
                 "shk":{"13102":5,
                        "27128":3}}},
 "item":[{"poi":{"text":"近鉄日本橋駅(近鉄 難波線)",
                "code":"00000000000000389709",
                "latlon":{"lat":34.663691666667,
                         "lon":135.50862777778},
                "kana":"キンテツニッポンバシエキ",
                "addressText":"大阪府大阪市中央区日本橋1丁目5−12",
                "zipcode":"542-0073",
                "phoneNumber":"06-6213-2390",
                "genre":null},
         "line":{"code":"0276",
                 "text":"近畿日本鉄道 難波線"}},
         :
        {"poi":{"text":"日本橋駅(東京メトロ 東西線)",
                "code":"00000000000000203821",
                "latlon":{"lat":35.678672222222,
                         "lon":139.77654722222},
                "kana":"ニホンバシエキ",
                "addressText":"東京都中央区日本橋1丁目3−11",
                "zipcode":"103-0027",
                "phoneNumber":"03-3271-2768",
                "genre":null},
         "line":{"code":"0506",
                 "text":"東京地下鉄 5号東西線"}}]}



object ZDC.Search.getStationByLineCode(query , func)

路線コードでの駅情報の検索をおこないます。
動作確認

クエリーオブジェクト

プロパティタイプデフォルト説明
linecodestring-路線コード。複数コードでの検索はできない
wordstring-駅名称での絞込み(カナ指定可)。上限1024文字。複数語句の指定はできない
addrcodestring-検索範囲を指定の住所コードに限定。複数指定する場合はカンマ区切り
市区町村までのコード(2桁または5桁)を指定できる。
市区町村を複数指定する場合は同一都道府県に限定される
datumstringTOKYO返却されるPOI代表点緯度経度測地系
limitstring0,100検索結果取得件数。"取得開始位置,取得件数"で指定

結果オブジェクト

プロパティタイプ説明
infoobject検索条件に一致した件数が"hit"で取得できる
itemarray(object)POIオブジェクトが"poi"、ラインオブジェクトが"line"で取得できる

例)

{
   "info": {
       "hit": 1
   },
   "item": [
       {
           "poi": {
               "text": "都立大学駅(東急 東横線)",
               "code": "20000000000000003352",
               "latlon": {
                   "lat": 35.6145917,
                   "lon": 139.6796167
               },
               "kana": "トリツダイガクエキ",
               "addressText": "東京都目黒区中根4丁目",
               "zipcode": "152-0031",
               "phoneNumber": null,
               "genre": null
           },
           "line": {
               "code": "0499",
               "text": "東京急行電鉄 東横線"
           }
       }
   ]

}


object ZDC.Search.convertDatum(query, func)

緯度経度測地系を高精度変換します。
高精度変換できない地点は 通常精度で変換した緯度経度を返します。
※ 精度を求めない場合はZDC.tkyTowgs/ZDC.wgsTotky(課金対象外)をご利用ください。
動作確認

クエリーオブジェクト

プロパティタイプデフォルト説明
latlonsarray(ZDC.LatLon)-地点の緯度経度を配列で指定。上限は200点
modestringtkywgs測地系の変換パターンを指定。
tkywgs:日本測地‌系から世界測地‌系に変換
wgstky:世界測地‌系から日本測地‌系に変換

結果オブジェクト

タイプ説明
array(ZDC.LatLon)ZDC.LatLonオブジェクトの配列

例)

[
  {"lat":35.6902403,
   "lon":139.7529608},
  {"lat":35.6901333,
   "lon":139.7527208},
  {"lat":35.6900364,
   "lon":139.7524806}
]


関連事項

検索オブジェクト

検索の実行時に取得し、検索を中止するabort()メソッドを実行できます。
このメソッドの戻り値はステータスオブジェクト です。

実行例)
var obj = ZDC.Search.getAddrByWord({…}, function() {…});
obj.abort();

POIオブジェクト

プロパティタイプ説明
textstringPOIの名称
codestringPOIのコード
latlonZDC.LatLon代表点緯度経度
kanastring住所文字列のカナ表記
addressTextstring住所文字列
zipcodestring郵便番号
phoneNumberstring電話番号
genreジャンルオブジェクトジャンルオブジェクト
detail詳細図オブジェクト詳細図情報がない場合はNULL
arrivalInfoarray(到着地点オブジェクト)到着地点情報がない場合は空の配列

例)

{"text":"ローソン新橋1丁目店",
 "code":"00000000000000183526",
 "latlon":{"lat":35.66485,
          "lon":139.76050555556},
 "kana":"ローソンシンバシイッチョウメテン",
 "addressText":"東京都港区新橋1丁目15−7",
 "zipcode":"105-0004",
 "phoneNumber":"03-3502-8988",
 "genre":{"code":"0014000180",
         "text":"買い物/コンビニ"}

ジャンルオブジェクト

ジャンルコードをプロパティとして下記のオブジェクトを取得できる

プロパティタイプ説明
textstringジャンルコードの説明
countnumberジャンルコード毎の件数

例)

 {"0022000120":{
           "text":"文化施設/博物館",
           "count":2},
  "0014000180":{
           "text":"買い物/コンビニ",
           "count":3}}

詳細図オブジェクト

プロパティタイプ説明
areaidstringエリアID
areanamestringエリア名称
detailidstring詳細図シーケンス番号
detailnamestring詳細図名称
floornamestringフロア名称
levelstring階層レベル

例)

 "detail": {
                   "areaid": "003",
                   "areaname": "秋葉原・東京・有楽町・銀座・新橋エリア",
                   "detailid": "00000005",
                   "detailname": "JR東京駅",
                   "floorname": "2階",
                   "level": "1"
               }

到着地点オブジェクト

プロパティタイプ説明
textstring到着地点名称
kanastring到着地点カナ
exittypeobject到着地点出入口種別オブジェクト
種別コードが"code"、種別名称が"text"で取得できる
arrivalpointZDC.LatLon到着地点緯度経度(自動車到着地点緯度経度)
exitpointZDC.LatLon出入り口緯度経度

例)

 "arrivalInfo": [
                   {
                       "text": "正面",
                       "kana": "ショウメン",
                       "exittype": {
                           "code": "03",
                           "text": "出入口"
                       },
                       "arrivalpoint": {
                           "lat": 34.4264361,
                           "lon": 133.1926
                       },
                       "exitpoint": {
                           "lat": 34.4264806,
                           "lon": 133.1925333
                       }
                   }
               ]

ラインオブジェクト

プロパティタイプ説明
codestring路線コード
textstring路線名称

注)それぞれZDC.Search.getRailLineByAddrCode()で取得できる値と一致しない

例)

 {"code":"0506",
  "text":"東京地下鉄 5号東西線"}

住所オブジェクト

プロパティタイプ説明
textstring住所表記文字列
codestring住所コード
latlonZDC.LatLon代表点緯度経度
partsarray(string)住所階層毎に分割された文字列
kanastring住所読み仮名
endboolean or null住所にさらに下の階層がある場合はfalse、そうでない場合はtrue。不明の場合はnullとなる
kanaPartsstring住所階層毎に分割されたカナ文字列
levelstring住所階層

例)

{"text":"東京都千代田区丸の内1丁目9−1",
 "code":"131010550010000900001",
 "latlon":{"lat":35.679777777778,
         "lon":139.77165},
 "parts":["東京都","千代田区","丸の内","1丁目","9","1"],
 "kana":"トウキヨウトチヨダクマルノウチ",
 "end":true}

標高オブジェクト

プロパティタイプ説明
elevationnumber標高値(メートル単位)。水深部はマイナスの値が返却される
meshTypestring最初に値が取得できた精度。詳細はクエリーオブジェクトのmeshTypeを参照

例)

{"elevation":38.5,
 "meshType":"N05m"}