Yahoo!ローカルサーチAPIYOLP(地図)Yahoo!ローカルサーチAPI【重要】常時SSL(AOSSL)対応にともないリクエストURLが変更されています。詳しくはこちらをご確認ください。概要Yahoo!ローカルサーチAPI(以下、ローカルサーチAPI)は、店舗、イベント、クチコミ情報などの地域・拠点情報(POI)を検索するためのAPIです。検索対象は、全国の店舗を網羅した電話帳データおよび店舗オーナーなどからの投稿データです。ローカルサーチAPIの主な機能は以下の通りです。地域・拠点情報の名称および業種をキーワードで検索できます。中心位置を指定して円範囲で絞り込めます。矩形範囲を指定して絞り込めます。今すぐローカルサーチAPIを利用するアプリケーションIDの取得ローカルサーチAPIを利用するためには、アプリケーションIDの取得が必要です。以下の手順に従ってアプリケーションIDを取得してください。IDをお持ちでない場合は、こちらから取得してください。次に、こちらからアプリケーションIDを登録してください。アプリケーションIDは、API利用者、またその使用状況を把握し、スパム行為などの妨害行為を防ぐために使用されます。登録したアプリケーションIDはこちらで管理できます。施設名称やカテゴリー名称などのキーワードで検索するローカルサーチAPIでは、リクエストパラメータ(query)に施設名称やカテゴリー名称などのキーワードを指定して、地域・拠点情報を検索できます。以下は「ラーメン」で指定した場合のサンプルリクエストです。<あなたのアプリケーションID>には、ご自身のアプリケーションIDを入れてください。Platform(YOLP)の施設情報には、施設の種類を分類できるように、業種コードが登録されています。リクエストパラメータの業種コード(gc)で対象を指定して、検索できます。業種コードについては、YOLP業種コードをご覧ください。以下は、0115001(業種名:カフェ)を指定した場合のサンプルリクエストです。0401)を指定して、都道府県や市区町村ごとの情報を検索できます。都道府県は二桁、市区町村の場合は五桁で指定します。リクエストパラメータの住所コード(ac)で対象を指定して、検索できます。以下は、13103(住所コード:東京都港区)を指定した場合のサンプルリクエストです。https://map.yahooapis.jp/search/local/V1/localSearch?appid=<あなたのアプリケーションID>&ac=13103範囲を指定して検索する中心の緯度経度と検索範囲を指定して、そのエリアの地域・拠点情報を検索できます。リクエストパラメータの緯度(lat)と経度(lon)で中心の緯度経度を指定し、リクエストパラメータ(dist)で半径の距離を指定します。リクエストパラメータ(bbox)で、緯度経度を2点(左下と右上)指定して、矩形にエリアを指定できます。2つ目は、矩形エリア左下の緯度:35.663782、経度:139.727685、矩形エリア右上の緯度:35.669378、経度:139.734251(東京ミッドタウン周辺)を指定し、グルメの業種:gc=01で検索した場合です。https://map.yahooapis.jp/search/local/V1/localSearch?appid=<あなたのアプリケーションID>&lat=35.665662327484&lon=139.73091159273&dist=3https://map.yahooapis.jp/search/local/V1/localSearch?appid=<あなたのアプリケーションID>&gc=01&bbox=139.727685,35.663782,139.734251,35.669378検索結果のソート順を指定する検索結果のソート順を指定できます。範囲を指定して検索する場合は、中心点から近い順にソートするとより便利に検索結果を活用できます。以下はよく利用されるソート順です。他にも多くのソート順がありますので、詳しくはリクエストパラメータをご覧ください。した場合のサンプルリクエストです。「RESTリクエストの構築(GET)」をご参照ください。アプリケーションID。詳細はこちらをご覧ください。APIの結果をモバイル端末に掲載する場合は「mobile」を指定してください。モバイル端末で掲載できない情報が非表示になります。(UTF-8でエンコードされた)検索クエリーです。業種(カセットによってはない場合があります)です。カセットIDを用いて店舗データを検索できます。コンマ「,」区切りで複数指定が可能です。電話帳のcidは「d8a23e9e64a4c817227ab09858bc1330」です。指定しない場合は、公開されているカセット全体が検索対象です。コンマ「,」区切りで複数指定できます。名寄せされた店舗IDです。コンマ「,」区切りで複数指定が可能です。カセット内で設定されたIDです。コンマ「,」区切りで複数指定が可能です。※カセットID(cid)と併せてご利用ください。コンマ「,」区切りで複数指定が可能です。※ビルIDは変更になる場合があります。gidを指定すると名寄せされた同一店舗をまとめて表示します。※名寄せされた店舗の中でsortで指定した並び順の上位一件のみ表示されます。※すべての店舗が必要な場合はdistinct=falseを指定してください。group=gid時に重複レコードの表示を指定します。デフォルトはtrueです。名寄せされた店舗すべてが必要な場合にfalseをセットしてください。場合、リクエストパラメータのresultsは店舗のユニークの件数となるため、リクエストパラメータのresultsとレスポンスの<Count>の件数が異なります。ソートの方法を指定します:ratingは、星の数順にソートします。scoreは、スコア順にソートします。hybridは、口コミ件数や星の数などを重み付けした値の順にソートします。reviewは、口コミ件数にソートします。kanaは、アイウエオ順にソートします。priceは、金額順にソートします。distは、2点間の直線距離順にソートします。(geoより高速です)geoは、球面三角法による2点間の距離順にソートします。※距離順(dist/geo)を有効にするためには、lat,lonを指定してください。matchは、適合度順にソートします。デフォルトは昇順で、先頭に"-"(半角マイナス)を付けることで降順になります。取得開始位置を指定します(最大3000)。取得件数を指定します(最大100)。出力項目数を増減できます。詳細はこちらをご覧ください。JSONPとして出力する際のコールバック関数名を入力するためのパラメータ。UTF-8でエンコードした文字列を入力します。