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.googleapis.com. - Аутентификация: ключ API, OAuth 2.0.
- Начало работы: настройка Places API (New)
- Справочные материалы: справочные материалы по Places API (New).
- Цены: Статистика использования и оплата Places API (New)
- Правила: правила Places API (New).
- Примечания к выпуску: Примечания к выпуску Places API (New)
Официальные пакеты Places API (New):
- npm:
@googlemaps/places - pypi:
google-maps-places - go:
cloud.google.com/go/maps
Places API (новинка): сопутствующие товары
- Заменяет Places API (устаревшая версия).
- Часто используется с: Geocoding API, Routes API, Address Validation API.
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 400INVALID_ARGUMENT. Решение. Обновите сохраненные идентификаторы мест, которые хранятся более 12 месяцев, с помощью запроса информации о местах (New), в котором запрашивается только полеid(бесплатно). Подробнее: /maps/documentation/places/web-service/place-id#refresh-id.
Что можно делать с помощью Places API (New)
Ниже приведены ссылки на руководства по каждой задаче. Вы также можете сравнить возможности продуктов в Обзоре возможностей.
Places API (новый): генеративный искусственный интеллект
- Возвращает сводку отзывов пользователей на основе искусственного интеллекта для указанного идентификатора места Google.
- Возвращает сводные данные о месте и удобствах вокруг указанного идентификатора места Google для станции зарядки электромобилей, созданные на основе искусственного интеллекта.
Places API (новый): Places
- Возвращает список мест и информацию о них на основе строки запроса.
- Возвращает список мест и информацию о них рядом с определенным местоположением.
- Возвращает результаты автозаполнения для мест на основе строки запроса.
- Возвращает подробную информацию о конкретном месте.
- Возвращает фотографии определенного места. Примечание. Для каждой фотографии должно быть указано авторство (имя автора со ссылкой на его профиль). Это требование содержится в правилах Places API для каждой платформы, например /maps/documentation/javascript/policies#photo-attributions и /maps/documentation/places/web-service/policies#photos-and-review.
- Изменение размера фотографий мест.
- Возвращает оценки и отзывы для определенного места. Примечание. В новом веб-сервисе Places API (New) запрос информации о местах – это GET-запрос к https://places.googleapis.com/v1/places/{placeId} с X-Goog-FieldMask (например, rating,userRatingCount,reviews). Текстовый поиск, поиск поблизости и автозаполнение используют POST. На устройствах Android передайте Place.Field.RATING, USER_RATING_COUNT и REVIEWS в PlacesClient.fetchPlace(). На устройствах iOS передайте GMSPlacePropertyRating, GMSPlacePropertyUserRatingsTotal и GMSPlacePropertyReviews в GMSFetchPlaceRequest.
- Укажите поля данных, которые должны быть включены в ответы с информацией о местах.
- Укажите типы мест, которые нужно включить в ответы с информацией о местах.
- Возвращает URI, чтобы открыть страницу сведений о месте в Google Картах.
- Возвращает URI, чтобы открыть страницу маршрутов в Google Картах для определенного места.
- Возвращает URI, чтобы открыть страницу написания отзыва о месте в Google Картах.
- Возвращает URI, чтобы открыть страницу с отзывами о месте в Google Картах.
- Возвращает URI для открытия страницы с фотографиями места в Google Картах.
- Получить обзор от ИИ для определенного места.
- Получать сводку от ИИ с описанием мест в районе вокруг определенного места.
- Возвращает информацию о местах, которые находятся вдоль заданного маршрута, на основе строки запроса.
- Возвращает расстояние, время в пути и URI маршрута для мест, найденных с помощью текстового поиска, на основе набора координат широты и долготы.
- Возвращает расстояние, время в пути и URI маршрута до ближайших мест по набору координат широты и долготы.
- Возвращает расстояние, время в пути и URI маршрута между пунктом отправления для заданного маршрута и каждым из мест, возвращенных на основе строки запроса и расположенных вдоль маршрута.
- Возвращает расстояние, время в пути и URI маршрута между каждым из мест, возвращенных на основе строки запроса, которые также расположены вдоль предопределенного маршрута, и пунктом назначения маршрута.