ホットペッパーのリクエストURL

ホットペッパーグルメサーチAPIで近隣レストラン表示

グルメサーチAPIでは
リクエストWebサービスのAPIキー
keyの指定が必須になります

近隣レストラン表示するには
address
住所
で検索するか

緯度 lat
経度 lng
周辺範囲 range
を指定します

こらを元に、リクエストURLを作成てきます

作成するには
ほかのAPIと同じで
ベースURLへパラメータをつなげて、
データ取得用URLを組み立てます

今回は、緯度経度と範囲で指定する方法です

指定の緯度経度から500m以内にあるお店を
ホットペッパーのおすすめ順に並べ替え、
5件表示します

半径500m以内にするには
range=1

ホットペッパーのおすすめ順にするには
order=4

5件だけ表示するなら
count=5

となるので、あとはこれを組み立てます

http://webservice.recruit.co.jp/hotpepper/gourmet/v1/?key=リクエストWebサービスのAPIキー&lat=緯度&lng=経度&range=1&order=4&count=5

ホットペッパーグルメサーチAPIの仕様

ホットペッパーグルメサーチAPIの仕様

詳しいリファレンスは
http://webservice.recruit.co.jp/hotpepper/reference.html

ベースURLは
http://webservice.recruit.co.jp/hotpepper/gourmet/v1/

リクエストパラメータは必須なのが
key
これは、APIキーの指定

その他としては
name
店名

address
住所

keyword
キーワードで検索
ただし、URLエンコードする必要があります
半角スペースをあけることで
AND検索が可能になります

GenreCD
ジャンルをコード番号で指定

lat
緯度

lng
経度

range
検索する周辺範囲を番号で指定
1=300m
2=500m
3=1km
4=2km
5=3km

order
結果の並び順を変更
これも番号で指定します
1=店名を仮名順で
2=ジャンルコード番号順
3=小エリアコード順
4=おすすめ順
ただし、現在地など、位置から検索すると
距離順がデフォルトになります

count
最大出力データ数の指定

続いて、レスポンスフィールド
results_returned
検索結果のお店の数
これをifで比較して、0なら検索してなかったことになります

shop->name
店名

shop->logo_image
ロゴ画像URL

shop->address
住所

shop->station_name
最寄り駅

shop->genre->name
ジャンル

shop->genre->catch
ジャンルキャッチ

shop->budget->average
平均予算

shop->->budget_memo
予算備考

shop->catch
キャッチコピー

shop->capacity
総席数

shop->access
交通アクセス

shop->urls->pc
PC用のHotpepperサイトのURL

shop->urls->mobile
携帯用のHotpepperサイトのURL

shop->urls->qr
QRコード画像URL

shop->open
営業日、営業時間

shop->photo->pc
PCでの店舗画像のurl

shop->photo->mobile
携帯用の店舗画像のurl

shop->wifi
Wi-Fiの有無

shop->course
コースの有無

shop->free_drink
飲み放題の有無

shop->free_food
食べ放題の有無

shop->private_room
個室対応

shop->horigotatu
掘りごたつの有無

shop->tatami
座敷の有無

shop->card
カード利用の可否

shop->non_smoking
禁煙席の有無

shop->charter
貸切の可否

shop->parking
駐車場

shop->barrier_free
バリアフリー

shop->other_memo
その他設備

shop->english
英語メニュー

shop->pet
ペットの可否

shop->lunch
ランチ

shop->midnight
23時以降の営業

shop->coupon_urls->pc
PC向けクーポンURL

shop->coupon_urls->mobile
携帯向けクーポンURL

shop->coupon_urls->sp
スマートフォン向けクーポンURL
たぶん、これが使うことが多そう

shop->coupon_urls->qr
クーポンQRコード画像URL