Google Maps Place Details
На публичных страницах мест в Google Maps могут быть указаны название, категории, описание, адрес, контактные данные, рейтинг, число отзывов, сайт и географический контекст. Нормализованные записи упрощают использование этих видимых полей для ведения реестров локаций, исследования заведений, обогащения каталогов и мониторинга состояния на определенный момент.
Возможности Google Maps Place Details API
- Пакетный сбор сведений по URLОтправьте один или несколько известных URL Google Maps: каждый непустой входной URL становится одной строкой сведений у провайдера, а внутренний лимит равен числу отправленных URL.
- Стабильные записи местВозвращает идентификатор, исходный URL, название, описание, категорию, адрес, телефон, сайт, рейтинг и число отзывов по схеме PlaceItem.
- Структурированный географический контекстХранит доступные название локации, город, регион, страну, широту и долготу вместе, без разбора отображаемого текста.
- Оплата по результатамПредварительная оценка — 0,15 кредита за каждый отправленный URL, итоговое списание — 0,15 кредита за каждую успешно возвращенную стандартную запись места; за пустые результаты плата не взимается.
Параметры Google Maps Place Details API
| Параметры | Обязательный | Описание |
|---|---|---|
urls | Обязательный | Обязательный непустой массив адресов, из которых парсер может извлечь имя хоста. Среда выполнения принимает google.com, goo.gl и их поддомены по имени хоста; допускается любая схема с компонентом authority, а также адреса относительно протокола, и определенный шаблон пути не требуется. |
Как использовать Google Maps Place Details API
Отправьте известные URL Google Maps, отслеживайте асинхронную задачу и читайте все сохраненные PlaceItem через стандартную обертку результатов с курсором.
- Подготовьте один или несколько адресов, у которых разобранное имя хоста — google.com, goo.gl или поддомен одного из этих хостов.
- Отправьте urls методом POST на /v1/google-maps/place-details и сохраните возвращенный task_id.
- Опрашивайте /v1/tasks/{task_id}, пока задача не завершится успешно или с ошибкой.
- Читайте data.results.items и переходите по next_cursor, пока has_more равно true; в самом запросе на отправку поля results_limit нет.
curl -X POST "https://api.socq.ai/v1/google-maps/place-details" \
-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"]}'
# Poll GET /v1/tasks/{task_id}
# Read data.results.items and follow next_cursor while has_more is trueСценарии использования Google Maps Place Details API
- Обогащение каталога локаций: Добавляйте к известным URL мест нормализованные поля категории, адреса, телефона, сайта, рейтинга, числа отзывов и координат.
- Аудит заведений и филиалов: Повторно обрабатывайте контролируемый список URL, чтобы сравнивать видимые данные о месте, контакты, рейтинг и географические значения на заданные моменты сбора.
- Сверка записей мест: Используйте возвращенные ID, исходные URL, названия, адреса и координаты, чтобы сопоставлять публичные места с внутренними записями о локациях.
Практические советы по Google Maps Place Details API
- Отправляйте полные абсолютные URL Maps, чтобы парсер мог определить допустимое имя хоста; голые имена хостов без схемы не дают имени хоста в парсере среды выполнения.
- Не добавляйте Place ID, ключи Google API, маски полей или results_limit: в спецификации этого запроса SocQ таких полей нет.
- Считайте каждый отправленный URL кандидатом на получение сведений, а не гарантированным результатом: из-за недоступных или непригодных строк источника элементов может оказаться меньше, чем URL.
- Сохраняйте допускающие null телефон, сайт, рейтинг, число отзывов, описание, время публикации и члены location, а не подставляйте выдуманные значения по умолчанию.
- Переходите по next_cursor, пока has_more равно true: пагинация действует при чтении сохраненных результатов задачи, хотя лимит провайдера определяется числом URL.
Связанные API
Помимо Google Maps Place Details API, используйте эти API, когда нужен другой тип публичных данных Google Maps.
- Google Maps Search API — Ищите публичные места Google Maps по запросу и местоположению: нормализованные название, адрес, контакты, рейтинг, число отзывов, URL и координаты.
- Google Maps Reviews API