Google Maps Reviews
Отзывы Google Maps — это публичные записи обратной связи о местах, которые могут содержать текст, ссылку на автора, оценку, ссылки на источник и объект отзыва, время публикации и сбора, а также медиафайлы. На их основе можно строить датасеты отзывов с привязкой к источнику и сравнивать известные места или периоды сбора.
Возможности Google Maps Reviews API
- Пакетный ввод известных URLОтправляйте один или несколько поддерживаемых URL на google.com или goo.gl в одной асинхронной задаче, без поиска мест через отдельный сервис идентификаторов.
- Необязательное окно в дняхПрименяйте одно положительное значение days_limit ко всем строкам отправленных URL, когда сценарию нужны только недавние отзывы.
- Стабильные записи отзывовПолучайте идентификатор отзыва, текст, поля автора, оценку, ссылки на место, метки времени, исходный URL и доступные медиафайлы по схеме review v1.0.
Параметры Google Maps Reviews API
| Параметры | Обязательный | Описание |
|---|---|---|
urls | Обязательный | Один или несколько непустых URL на google.com, любом поддомене google.com, goo.gl или поддомене goo.gl, разделенных запятыми или переводами строки. Для сбора отзывов используйте известные URL мест Google Maps. |
days_limit | Необязательный | Необязательное положительное целое число, которое применяется к каждой входной строке провайдера как окно давности отзывов. Не указывайте его, чтобы не передавать фильтр по дням. |
results_limit | Необязательный | Необязательное целое число от 1 до 2 000, ограничивающее общее число отзывов, сохраняемых для задачи. По умолчанию 100; при ограниченной доступности источника строк может быть меньше. |
Как использовать Google Maps Reviews API
Отправьте известные URL Google Maps, отслеживайте асинхронную задачу и читайте сохраненные записи отзывов через курсор результатов задачи.
- Подготовьте один или несколько поддерживаемых URL мест Google Maps на google.com или goo.gl.
- Отправьте urls и при необходимости days_limit и results_limit методом POST на /v1/google-maps/reviews.
- Опрашивайте /v1/tasks/{task_id}, пока status не станет succeeded или failed.
- Читайте /v1/tasks/{task_id}?limit=50 и продолжайте с results.next_cursor, пока results.has_more равно true.
curl -X POST "https://api.socq.ai/v1/google-maps/reviews" \
-H "Authorization: Bearer $SOCQ_API_KEY" \
-H "Content-Type: application/json" \
-d '{"urls":["https://www.google.com/maps/place/Coffee%20Project%20New%20York%20%7C%20East%20Village/data=!4m7!3m6!1s0x89c2599b5a24d7fd:0x9e354f6cf514b9fc!8m2!3d40.7270884!4d-73.9893820!16s%2Fg%2F11c3svpqld!19sChIJ_dckWptZwokR_LkU9WxPNZ4?authuser=0&hl=en&rclk=1"],"days_limit":3650,"results_limit":3}'
# Poll GET /v1/tasks/{task_id}, then request
# GET /v1/tasks/{task_id}?limit=50&cursor={results.next_cursor}.Сценарии использования Google Maps Reviews API
- Датасеты отзывов об известных местах: Готовьте тексты отзывов, оценки, время публикации и ссылки на источник для заданного набора публичных URL мест.
- Исследование авторов с учетом источника: Сохраняйте доступные имена авторов, имена пользователей, ссылки на профили и URL отзывов, чтобы записи можно было проследить до их публичного контекста.
- Сравнение недавних периодов: Запускайте один и тот же набор мест с задокументированными значениями days_limit в разное время, чтобы сравнивать ограниченные выборки, не претендуя на полноту истории.
- Архивы отзывов с медиафайлами: Храните доступные медиафайлы отзывов рядом с текстом, оценкой, ссылкой на место и временем сбора в нормализованной исследовательской записи.
Практические советы по Google Maps Reviews API
- Отправляйте разрешимые URL Maps на google.com или goo.gl; одно лишь название места, аккаунт Google Business Profile или Place ID не принимается как элемент urls.
- Используйте days_limit, только когда окно в целых положительных днях имеет смысл; без него строка провайдера отправляется без этого фильтра.
- Воспринимайте results_limit как единый общий потолок сохраненных результатов для всего пакета URL, а не как обещание для каждого URL.
- Не путайте results_limit при отправке с limit при чтении задачи: последний задает размер страницы от 1 до 500 и работает с непрозрачным курсором.
- Допускайте отсутствие текста, атрибутов автора, оценки, ссылок на объект, меток времени и медиафайлов, если публичный источник их не показывает.
Связанные API
Помимо Google Maps Reviews API, используйте эти API, когда нужен другой тип публичных данных Google Maps.
- Google Maps Search API — Ищите публичные места Google Maps по запросу и местоположению: нормализованные название, адрес, контакты, рейтинг, число отзывов, URL и координаты.
- Google Maps Place Details API