Google Hotels
Googleホテルの検索結果1件には、ホテル名・星評価・地図上の位置に加えて、宿泊者評価、口コミ件数、写真、そして選んだ日程と通貨での最安1泊料金がまとめて載っています。これらを横に並べると、目的地のホテル供給を比べたり、料金と評価のバランスを見たり、個別のホテルを調べる前に候補を絞り込んだりできます。
Google Hotels API の主な機能
- 旅行者と同じ言い方で検索query には hotels in new york のような目的地やホテル名を指定でき、Googleホテルが表示する順にホテルが返り、rank に各ホテルの順位が入ります。
- 実際の宿泊日程で料金を取得check_in、check_out、currency で知りたい宿泊の条件を指定でき、各行にその日程と price.amount、price.currency、整形済みの料金が入ります。
- 並べ替えと1泊料金の範囲指定sort_by で relevance、lowest_price、highest_rating、most_reviewed を切り替え、min_price と max_price で予算内のホテルだけに絞れます。
- 全ホテルに評価の指標stars はホテルのクラス、rating は1〜5の宿泊者平均評価、reviews_count はその評価のもとになった口コミ件数です。
- 座標と写真location に緯度・経度、images にGoogleが表示するホテル写真のURLが入ります。
- 詳細照会に使えるホテルID各行の id はそのまま Google Hotel Details API と Hotel Price Tracker API に渡せ、url はGoogleホテルの該当ページを指します。
- 1回で最大140軒results_limit は1〜140で指定でき、is_sponsored で広告枠のホテルを通常の掲載と分けて扱えます。
Google Hotels API のパラメータ
| パラメータ | 必須 | 説明 |
|---|---|---|
query | 必須 | 目的地またはホテルの検索語。例:hotels in new york、ホテル名。 |
check_in | 任意 | チェックイン日(YYYY-MM-DD、今日以降)。check_out と一緒に指定します。どちらも省略すると明日から1泊の料金になります。 |
check_out | 任意 | チェックアウト日(YYYY-MM-DD)。check_in より後で、最長30泊までです。 |
currency | 任意 | 料金と料金範囲に使う3文字の通貨コード(USD、EUR など)。 |
sort_by | 任意 | 並び順:relevance、lowest_price、highest_rating、most_reviewed のいずれか。 |
min_price | 任意 | 1泊料金の下限(currency の通貨)。 |
max_price | 任意 | 1泊料金の上限(currency の通貨)。min_price を下回る値は指定できません。 |
location_code | 任意 | 検索市場のロケーションコード。既定値は2840(米国)です。 |
language_code | 任意 | 結果の言語コード。既定値は en です。 |
results_limit | 任意 | 返すホテル数(1〜140)。既定値は18です。 |
Google Hotels API の使い方
目的地で検索し、1行ずつホテルを読み取ります。
- {"query": "hotels in new york", "currency": "USD", "results_limit": 18} を /v1/google-hotels/search に POST します。
- status が succeeded になるまで GET /v1/tasks/{task_id} をポーリングします。
- results.items からホテルを読み取り、has_more が true なら results.next_cursor で次のページを取得します。
curl -X POST "https://api.socq.ai/v1/google-hotels/search" \
-H "Authorization: Bearer $SOCQ_API_KEY" \
-H "Content-Type: application/json" \
-d '{"query":"hotels in new york","currency":"USD","results_limit":18}'Google Hotels API の主なユースケース
- 目的地の料金相場を把握: 同じ日程で price.amount を stars や rating と並べ、都市ごとにホテルのクラス別の料金水準をつかみます。
- 候補ホテルの絞り込み: 料金範囲内で rating と reviews_count が基準を満たすホテルを残し、その id を詳細照会や料金照会に回します。
- 旅行日程の比較: 同じ query を check_in と check_out を変えて実行し、id で結合して日程ごとの料金の動きを比べます。
- ホテル分布の地図化: location の緯度・経度に stars と料金を重ね、エリア内で手頃なホテルと高級ホテルがどこに集まるかを確認します。
Google Hotels API 活用のヒント
- 比較に使う検索では毎回 currency を明示し、price.amount の単位をそろえましょう。
- check_in と check_out は必ずセットで指定します。30泊を超える日程やチェックイン前のチェックアウトは、タスク作成前に弾かれます。
- 後続の照会はホテル名ではなく id で結合しましょう。同じ都市のチェーンホテルは名前がよく似ています。
- 返されたホテル1軒ごとに0.15クレジットかかるため、results_limit は実際に確認する件数に合わせましょう。
関連API
Google Hotels API 以外に別の種類の公開Google Hotelsデータが必要な場合は、これらのAPIをご利用ください。
- Google Hotel Details API — ホテルIDでGoogleホテル上のプロフィールを取得し、連絡先、設備、周辺エリアの評価、評価の分布、口コミの話題、予約サイトごとの料金を返します。
- Hotel Price Tracker API — ホテルIDでGoogleホテルの料金カレンダーを取得し、この先およそ6〜8週間のチェックイン日ごとの最安1泊料金を返します。