С октября 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-backend.googleapis.com. - Аутентификация: ключ API.
- Цены: Использование и оплата Places API (Legacy)
- Правила: правила Places API (Legacy).
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 (устаревший): устаревшие и не поддерживаемые функции
- Поле ответа
permanently_closedне поддерживается с 26 мая 2020 г. Замена: полеbusiness_status. Ознакомьтесь с руководством по переносу. - Поле ответа
referenceне поддерживается с 3 сентября 2019 г. Замена: полеplace_id. Ознакомьтесь с руководством по переносу. - Параметр запроса Nearby Search (Legacy)
name: устарел. Замена: параметрkeyword. Ознакомьтесь с руководством по переносу.