Краткий справочник по Places API (новинка)

Places API (New) – это веб-сервис, который возвращает данные о местоположении организаций, географических местоположениях и объектах инфраструктуры в формате JSON. Она поддерживает новые версии текстового поиска, поиска поблизости, автозаполнения, информации о местах и фотографий мест.

Places API (новый): основные факты

  • Продукт: Places API (новый).
  • Также называется: Places API.
  • Категория: Места
  • Платформа: веб-сервис (REST).
  • Где выполняется: на сервере (код бэкенда).
  • Стадия запуска: GA
  • Жизненный цикл: активно.
  • Обзор: Обзор Places API (New)
  • Регионы: все страны. Для проектов с платежными адресами в ЕЭЗ действуют Условия использования платформы Google Карт в ЕЭЗ (вступают в силу 8 июля 2025 г.), согласно которым контент Places API, кроме широты, долготы и идентификаторов мест, можно использовать только на картах, созданных с помощью Places UI Kit. Сводки мест, отзывов и районов, созданные искусственным интеллектом, доступны только на поддерживаемых языках и в поддерживаемых регионах.

Places API (новинка): когда использовать

Используйте Places API (New), если:

  • Вам нужно искать места с сервера по текстовому запросу (новый текстовый поиск) или вокруг местоположения (новый поиск поблизости).
  • Вам нужны подсказки мест или запросов, которые появляются по мере ввода текста, из серверной части через Autocomplete (New).
  • У вас есть идентификатор места, и вам нужны такие сведения, как адрес, номер телефона, оценка, отзывы или фотографии.
  • Вам нужны сводки о месте, районе или отзывах, созданные искусственным интеллектом.

Когда не следует использовать Places API (новый)

  • Вы разрабатываете нативное приложение для Android. Используйте Places SDK для Android.
  • Вы создаете нативное приложение для iOS. Используйте Places SDK для iOS.
  • Вы создаете веб-приложение для браузера и хотите загрузить библиотеку Places в JavaScript. Используйте Maps JavaScript API.

Places API (новый): настройка

Официальные пакеты Places API (New):

  • npm: @googlemaps/places
  • pypi: google-maps-places
  • go: cloud.google.com/go/maps

Places API (новый): распространенные ошибки

  • Проблема. В информации о местах (New), поиске поблизости (New) и текстовом поиске (New) нет списка возвращаемых полей по умолчанию. Запросы без маски полей возвращают ошибку. Решение. Передайте маску поля ответа с параметром fields или $fields или заголовком X-Goog-FieldMask. Подробнее: /maps/documentation/places/web-service/choose-fields.
  • Проблема. Если токен сеанса Autocomplete (New) не указан или используется повторно после завершения сеанса, каждый запрос оплачивается отдельно по коду Autocomplete Requests. Решение. Создавайте новый токен сеанса (рекомендуется UUID v4) для каждого сеанса и завершайте его запросом информации о местах (New) или Address Validation. Подробнее /maps/documentation/places/web-service/place-session-tokens…
  • Проблема. Существующий или созданный ИИ код, который вызывает Places API (Legacy) или Maps JavaScript API PlacesService в проекте, где не включен устаревший API, возвращает ошибку LegacyApiNotActivatedMapError. Решение. Перенесите вызовы в Places API (New) и добавьте обязательную маску поля. Подробнее: /maps/legacy#LegacyApiNotActivatedMapError.
  • Проблема. Сохраненные идентификаторы мест могут устареть. В этом случае информация о местах (New) возвращает ошибку NOT_FOUND (HTTP 404), а при использовании неверно сформированных или усеченных идентификаторов – ошибку HTTP 400 INVALID_ARGUMENT. Решение. Обновите сохраненные идентификаторы мест, которые хранятся более 12 месяцев, с помощью запроса информации о местах (New), в котором запрашивается только поле id (бесплатно). Подробнее: /maps/documentation/places/web-service/place-id#refresh-id.

Что можно делать с помощью Places API (New)

Ниже приведены ссылки на руководства по каждой задаче. Вы также можете сравнить возможности продуктов в Обзоре возможностей.

Places API (новый): генеративный искусственный интеллект

Places API (новый): Places