google-maps/
place-details

Собирайте сведения по известным публичным URL Google Maps: нормализованные данные о месте, категория, адрес, контакты, рейтинг, число отзывов, сайт и географические поля.

Google Maps Place Details API

Известные URL Maps
Сведения о месте
Нормализованные локации
0,15 кредита за результат
Готово
Готово

Введите параметры и отправьте запрос. Здесь появятся статус задачи и нормализованные результаты.

README

Автор: SocQ · Обновлено

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 через стандартную обертку результатов с курсором.

  1. Подготовьте один или несколько адресов, у которых разобранное имя хоста — google.com, goo.gl или поддомен одного из этих хостов.
  2. Отправьте urls методом POST на /v1/google-maps/place-details и сохраните возвращенный task_id.
  3. Опрашивайте /v1/tasks/{task_id}, пока задача не завершится успешно или с ошибкой.
  4. Читайте 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.

Помимо Google Maps Place Details API, используйте эти API, когда нужен другой тип публичных данных Google Maps.

  • Google Maps Search API — Ищите публичные места Google Maps по запросу и местоположению: нормализованные название, адрес, контакты, рейтинг, число отзывов, URL и координаты.
  • Google Maps Reviews API

Другие платформы

Объединяйте данные Google Maps с публичными данными других поддерживаемых соцсетей.

Google Maps Place Details API — FAQ

Google Maps Place Details API преобразует известные публичные URL Google Maps в нормализованные записи PlaceItem. Эндпоинт возвращает доступные поля идентичности, категории, контактов, рейтинга, числа отзывов, адреса, сайта и местоположения.

Отправляйте адреса, у которых разобранное имя хоста — google.com, goo.gl или поддомен одного из них. Принимается любая схема при наличии authority и имени хоста, адреса относительно протокола тоже принимаются, а определенный путь /maps/place не требуется.

Нет. Запрос принимает известные публичные URL Google Maps через SocQ и не принимает официальный Place ID, ключ Google API, учетные данные OAuth или маску полей.

Нет. Входные данные провайдера содержат по одной строке сведений на каждый непустой URL и внутренний лимит, равный числу этих строк; results_limit не является публичным полем запроса.

Исходный URL может быть недоступен, вернуть строку с ошибкой или не дать пригодной нормализованной записи места. Остальные отправленные URL обрабатываются независимо.

Опрашивайте GET /v1/tasks/{task_id}, после успешного завершения читайте data.results.items и запрашивайте следующую страницу с next_cursor, пока has_more равно true.

Предварительная оценка — 0,15 кредита SocQ за каждый непустой отправленный URL. Итоговое списание — 0,15 кредита за каждую успешно возвращенную стандартную запись места, а пустой набор результатов стоит ноль кредитов.