Google Hotels
Результат поиска в Google Hotels объединяет название, звёздность и расположение отеля с оценкой гостей, числом отзывов, фотографиями и самой низкой ценой за ночь на выбранные даты в выбранной валюте. Если сопоставить эти данные, видно, чем различается гостиничное предложение в разных городах, как соотносятся цена и оценка и какие отели стоит изучить подробнее.
Возможности Google Hotels API
- Поиск так, как ищут путешественникиquery принимает направление вроде hotels in new york или название отеля; отели возвращаются в том порядке, в каком их показывает Google Hotels, а rank содержит позицию каждого.
- Цены для реальной поездкиcheck_in, check_out и currency задают нужное проживание; каждая строка содержит эти даты, а также price.amount, price.currency и отформатированную цену.
- Сортировка и диапазон ценsort_by переключает relevance, lowest_price, highest_rating и most_reviewed, а min_price и max_price оставляют только отели в рамках бюджета.
- Показатели качества для каждого отеляstars — категория отеля, rating — средняя оценка гостей от 1 до 5, reviews_count — число отзывов, на которых она основана.
- Координаты и фотографииlocation содержит широту и долготу, images — фотографии, которые Google показывает для отеля.
- ID отеля для следующих запросовid каждой строки можно передать без изменений в Google Hotel Details API и Hotel Price Tracker API, а url ведёт на страницу отеля в Google Hotels.
- До 140 отелей за запросresults_limit принимает значения от 1 до 140, а is_sponsored отделяет рекламные размещения от обычной выдачи.
Параметры Google Hotels API
| Параметры | Обязательный | Описание |
|---|---|---|
query | Обязательный | Поисковый запрос по направлению или отелю, например hotels in new york или название отеля. |
check_in | Необязательный | Дата заезда (YYYY-MM-DD, сегодня или позже). Указывается вместе с check_out; без обеих дат цены даются за одну ночь начиная с завтрашнего дня. |
check_out | Необязательный | Дата выезда (YYYY-MM-DD). Должна быть позже check_in; не более 30 ночей. |
currency | Необязательный | Трёхбуквенный код валюты для цен и диапазона цен, например USD или EUR. |
sort_by | Необязательный | Порядок сортировки: relevance, lowest_price, highest_rating или most_reviewed. |
min_price | Необязательный | Минимальная цена за ночь в валюте из currency. |
max_price | Необязательный | Максимальная цена за ночь в валюте из currency. Не может быть меньше min_price. |
location_code | Необязательный | Код местоположения поискового рынка. По умолчанию 2840 (США). |
language_code | Необязательный | Код языка результатов. По умолчанию en. |
results_limit | Необязательный | Количество возвращаемых отелей (1–140). По умолчанию 18. |
Как использовать Google Hotels API
Выполните поиск по направлению и читайте отели построчно.
- Отправьте {"query": "hotels in new york", "currency": "USD", "results_limit": 18} методом POST на /v1/google-hotels/search.
- Опрашивайте GET /v1/tasks/{task_id}, пока status не станет succeeded.
- Читайте отели из 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, чтобы увидеть, как меняются цены в зависимости от дат.
- Карта гостиничного предложения: Наложите stars и цены на координаты из location и посмотрите, где в районе сосредоточены недорогие и премиальные отели.
Практические советы по Google Hotels API
- Всегда указывайте currency в поисках, которые собираетесь сравнивать, чтобы price.amount был в одной валюте.
- Передавайте check_in и check_out только вместе. Проживание дольше 30 ночей или выезд раньше заезда отклоняются ещё до создания задачи.
- Связывайте последующие запросы по id, а не по названию: отели одной сети в городе часто называются почти одинаково.
- Каждый возвращённый отель стоит 0,15 кредита, поэтому задавайте results_limit по числу отелей, которые действительно будете изучать.
Связанные API
Помимо Google Hotels API, используйте эти API, когда нужен другой тип публичных данных Google Hotels.
- Google Hotel Details API — Получайте по ID карточку отеля в Google Hotels с контактами, удобствами, оценками района, распределением оценок, темами отзывов и предложениями сайтов бронирования.
- Hotel Price Tracker API — Получайте по ID отеля его календарь цен в Google Hotels с самой низкой ценой за ночь на каждую дату заезда примерно на 6–8 недель вперёд.