地図
ローカルサーチ
Version 1
リクエストURL
XML
http://map.yahooapis.jp/LocalSearchService/V1/LocalSearch
ローカルサーチAPIでは、キーワード検索、周辺検索の機能を提供します。キーワード検索は、住所・郵便番号・施設を指定して、その位置情報(緯度、経度)を出力します。周辺検索は、位置情報(緯度、経度)、範囲を指定すると、その範囲内に含まれる施設情報を出力します。
リクエストパラメータ
「RESTリクエストの構築(GET)」をご参照ください。
| パラメータ | 値 | 説明 |
| appid(必須) | string | アプリケーションID。詳細はこちらをご覧ください。 |
| p(必須) | string | (UTF-8エンコードされた)検索キーワード |
| lat(必須) | - | 緯度 |
| lon(必須) | - | 経度 |
| dist(必須) | float | 距離(単位km) |
| category | address, zipcode, landmark, station, courpon | 検索対象カテゴリ:
デフォルトは、address、zipcode、landmark、stationを対象に検索します。 Yahoo!クーポンは周辺検索でのみ検索対象となります。Yahoo!クーポンについてはこちらをご参照ください。 |
| b | integer: 1(デフォルト) | 表示開始位置。最終位置(b + n - 1)は、100を超えられません。 |
| n | integer: 10(デフォルト), 100(最大) | 表示件数 |
| o | xml(デフォルト), json | 出力タイプ |
| datum | tky(デフォルト), wgs | 指定した緯度経度の測地系:
|
| al | 1, 2, 3 | 住所レベルの絞り込み:
|
リクエストパラメータで、p(検索キーワード)か、lat(緯度)・lon(経度)・dist(距離)は、どちらか一方が必須となります。
緯度経度で使用できる書式は以下のとおりです。
- 度.分.秒形式(35.39.26.180,139.43.56.868)
- 度/分/秒形式(35/39/26.180,139/43/56.868)
- 度形式(35.657272,139.732463)
サンプルリクエストURL
東京都港区六本木6-10-1を検索
http://map.yahooapis.jp/LocalSearchService/V1/LocalSearch?
六本木ヒルズを検索
http://map.yahooapis.jp/LocalSearchService/V1/LocalSearch?
緯度:35.65678、経度:139.733555、半径5km以内のYahoo!クーポンを検索
http://map.yahooapis.jp/LocalSearchService/V1/LocalSearch?
レスポンスフィールド
ローカルサーチWeb APIのスキーマの記述は、以下のURLをご覧ください。
http://map.yahooapis.jp/LocalSearchService/V1/LocalSearchResponse.xsd
| フィールド | 説明 |
| Count | 検索一致件数 |
| ViewCount | 検索出力件数 |
| Query | 検索キーワード |
| Category | 検索カテゴリ:
|
| Title | 名称 |
| Address | 住所(施設は市区町村レベル) |
| AddressLevel | 住所レベル:
|
| DatumTky97 | 日本測地系緯度経度:
|
| DatumWgs84 | 世界測地系経度経度:
|
| Url | 詳細ページへのURL |
サンプルレスポンス
以下は、六本木6-10-1 のクエリーの結果です。
エラー
ローカルサーチWeb APIはYahoo! JAPAN Web APIに共通のエラーメッセージおよびコードを返します。
利用制限
ローカルサーチAPIは、24時間中1IPアドレスにつき50000件のリクエストが上限となっています。