Google Hotel Details
Googleホテルの詳細ページには、住所、電話番号、チェックイン時刻、設備一覧に加えて、星ごとの評価の割合、立地や朝食といった話題ごとの好意的・否定的な言及数、他の口コミサイトの評価まで、宿泊者の声が集約されています。同じ宿泊に対する各予約サイトとホテル公式サイトの料金と合わせれば、料金の整合性チェック、競合ホテルとの比較、ホテル紹介ページの充実に使えます。
Google Hotel Details API の主な機能
- 予約サイトごとの料金offers には各販売元の1泊料金と予約リンクが入り、is_official、is_sponsored、free_cancellation_until で公式料金、広告枠、無料キャンセル可能なプランを区別できます。
- 宿泊者が話題にしていることreview_topics は Wellness や Breakfast などの話題ごとに positive_count、negative_count、mentions_count を返し、滞在のどの部分が好評か不評かがわかります。
- 評価の分布と他サイトの評価rating_distribution は星ごとの口コミの割合、other_reviews は Tripadvisor などのサイトの評価、口コミ件数、抜粋を返します。
- 周辺エリアの評価location_scores は総合、観光・アクティビティ、飲食店、交通、空港アクセスを1〜5で評価し、エリア名と座標も付きます。
- ホテルの基本情報を1行でaddress、phone、website、check_in_time、check_out_time、利用できる設備、紹介文、写真がまとめて返ります。
- 指定日程の料金check_in、check_out、currency で料金の対象となる宿泊を指定でき、日程を省略すると明日から1泊の料金になります。
Google Hotel Details API のパラメータ
| パラメータ | 必須 | 説明 |
|---|---|---|
hotel_id | 必須 | Google Hotels API の結果の id フィールドにあるホテルID。 |
check_in | 任意 | チェックイン日(YYYY-MM-DD、今日以降)。check_out と一緒に指定します。どちらも省略すると明日から1泊の料金になります。 |
check_out | 任意 | チェックアウト日(YYYY-MM-DD)。check_in より後で、最長30泊までです。 |
currency | 任意 | 料金に使う3文字の通貨コード(USD、EUR など)。 |
location_code | 任意 | 検索市場のロケーションコード。既定値は2840(米国)です。 |
language_code | 任意 | ホテル詳細の言語コード。既定値は en です。 |
Google Hotel Details API の使い方
ホテル検索で得たホテルIDを送り、そのホテルを1行で読み取ります。
- {"hotel_id": "ChoIyKbJ6puqvPf8ARoNL2cvMTFqNHR2MjczeBAB", "currency": "USD"} を /v1/google-hotels/hotel-details に POST します。
- status が succeeded になるまで GET /v1/tasks/{task_id} をポーリングします。
- results.items からホテルを読み取ります。has_more と results.next_cursor は通常のページングルールに従い、この1行の結果では空になります。
curl -X POST "https://api.socq.ai/v1/google-hotels/hotel-details" \
-H "Authorization: Bearer $SOCQ_API_KEY" \
-H "Content-Type: application/json" \
-d '{"hotel_id":"ChoIyKbJ6puqvPf8ARoNL2cvMTFqNHR2MjczeBAB","currency":"USD"}'Google Hotel Details API の主なユースケース
- 料金の整合性チェック: is_official の公式料金と、同じ日程のオンライン旅行会社の料金を比べ、公式より安く出している販売元を見つけます。
- 競合ホテルとの比較: 近隣ホテルの rating_distribution、review_topics、location_scores を並べ、どこで優位か、どこで劣るかを確認します。
- ホテル紹介ページの充実: 住所、設備、チェックイン時刻、写真、周辺エリアの評価を1回の照会で取得し、旅行サービスのホテルページに反映します。
- 宿泊者の声の分析: review_topics を negative_count の多い順に並べ、騒音や朝食など不満の多い項目を洗い出します。
Google Hotel Details API 活用のヒント
- 最近の Google Hotels API 検索で得たホテルIDを使えば、1回2クレジットのリクエストで目的のホテルを確実に取得できます。
- 検索時と同じ check_in、check_out、currency を指定すると、予約サイトの料金が検索結果の料金とそろいます。
- 販売元を比べる前に is_sponsored で広告枠を除くと、比較結果が偏りません。
- 評価の分布をグラフにするときは、rating_distribution.share を0〜1の割合として扱います。
関連API
Google Hotel Details API 以外に別の種類の公開Google Hotelsデータが必要な場合は、これらのAPIをご利用ください。
- Google Hotels API — 目的地でGoogleホテルを検索し、各ホテルの指定日程の1泊料金、星評価、宿泊者評価、口コミ件数、座標、ホテルIDを返します。
- Hotel Price Tracker API — ホテルIDでGoogleホテルの料金カレンダーを取得し、この先およそ6〜8週間のチェックイン日ごとの最安1泊料金を返します。