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

С октября 2026 г. устаревший Places API больше нельзя будет включить для новых облачных проектов Google Cloud. Существующие проекты по-прежнему полностью поддерживаются. Чтобы получить доступ к новым функциям и повысить производительность, перейдите на Places API (New).

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

  • Продукт: Places API (Legacy).
  • Другие названия: Places API (устаревший веб-сервис), веб-сервис Places API (maps/api/place).
  • Категория: Места
  • Платформа: веб-сервис (REST).
  • Где выполняется: на сервере (код бэкенда).
  • Стадия запуска: GA
  • Жизненный цикл: устаревший
  • Замена: Places API (New).
  • Обзор: Обзор Places API (Legacy)

Places API (устаревший): когда использовать

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

  • У вас есть проект, в котором уже включен Places API (Legacy) и вызываются конечные точки maps.googleapis.com/maps/api/place.
  • Вам нужно, чтобы существующие вызовы Find Place, Nearby Search, текстовый поиск, Details, Photos или Autocomplete (Legacy) продолжали работать во время переноса.

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

  • Вы создаете новый проект Google Cloud. С октября 2026 г. Places API (Legacy) нельзя будет включить для новых проектов. Используйте вместо него Places API (новый).
  • Вам нужны новые функции, аутентификация OAuth или маски полей в поиске поблизости и текстовом поиске, чтобы платить только за запрашиваемые поля. Используйте вместо него Places API (новый).
  • Вам нужно использовать Find Place (устаревшая версия) или Query Autocomplete (устаревшая версия) в новом коде. Их заменяют текстовый поиск (новая версия) и автозаполнение (новая версия). Используйте вместо него Places API (новый).

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

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

  • Проблема. Если в запросе информации о местах (устаревшая версия) не указан параметр fields или не заданы поля, API возвращает все поля и выставляет за них счет. Решение. Всегда задавайте параметр fields или перейдите на информацию о местах (New) с маской поля. Подробнее: /maps/documentation/places/web-service/legacy/details.
  • Проблема. Устаревшие версии поиска поблизости и текстового поиска не поддерживают указание полей, которые должны возвращаться в результатах. Они всегда возвращают фиксированный набор полей (подмножество полей информации о местах) и активируют коды Basic Data, Contact Data и Atmosphere Data. Решение. Перейдите на поиск поблизости (New) или текстовый поиск (New) с маской поля или используйте найти место (Legacy) с параметром fields, чтобы запрашивать и оплачивать только нужные поля. Подробнее: /maps/billing-and-pricing/sku-details/legacy#places_nearby-search-legacy-pro-sku.
  • Проблема. photo_reference нельзя кешировать, и срок его действия может истечь, поэтому сохраненные ссылки перестают работать. Решение. Перед запросом фотографии получите новый photo_reference из ответа с информацией о местах, Find Place, Nearby Search или текстового поиска. Подробнее: /maps/documentation/places/web-service/legacy/photos.
  • Проблема. Вызовы Places API (Legacy) из проекта, в котором он не включен, возвращают REQUEST_DENIED с сообщением об ошибке "Вы вызываете устаревший API, который не включен для вашего проекта…" LegacyApiNotActivatedMapError. С октября 2026 г. Places API (Legacy) нельзя будет включить для новых проектов. Решение. Используйте Places API (New) для новых проектов и перенесите существующие приложения. Пока вы выполняете перенос, вы можете запросить краткосрочную активацию устаревшего API через форму обратной связи на устаревшей странице. Подробнее: /maps/legacy#LegacyApiNotActivatedMapError.

Places API (устаревший): устаревшие и не поддерживаемые функции