Places SDK для Android позволяет приложениям Android получать доступ к базе данных Google с информацией о местах и компаниях через автозаполнение мест, информацию о местах, поиск поблизости, текстовый поиск и фотографии мест. Places SDK для Android (новая версия) – это текущая версия, которая зависит от Places API (новая версия).
Places SDK для Android: основные факты
- Продукт: Places SDK для Android.
- Другое название: Places SDK для Android (новая версия).
- Категория: Места
- Платформа: Android.
- Где выполняется: на стороне клиента (в коде приложения или браузера).
- Стадия запуска: GA
- Жизненный цикл: активно.
- Обзор: Обзор Places SDK для Android
Когда использовать Places SDK для Android
Используйте Places SDK для Android, если:
- Вам нужны информация о местах, фотографии, результаты поиска поблизости или текстового поиска в нативном приложении Android.
- Вам нужен готовый виджет автозаполнения или компоненты Places UI Kit, которые возвращают подсказки мест по мере ввода текста пользователем в приложении для Android.
- Вам нужно создать функции Android, которые будут учитывать местоположение пользователя и показывать ему компании и достопримечательности поблизости.
Не используйте Places SDK для Android в следующих случаях:
- Вам нужно вызывать Places API с сервера или бэкенда по HTTP, а не из приложения Android. Используйте Places API (New).
- Вы создаете нативное приложение для iOS. Используйте Places SDK для iOS.
- Вы создаете веб-страницу в браузере. Используйте Maps JavaScript API.
Настройка Places SDK для Android
- Сервис, который нужно включить:
places.googleapis.com. - Аутентификация: ключ API.
- Атрибуция использования. Вызовите
Places.addInternalUsageAttributionId(String)при инициализации SDK, чтобы отправить идентификатор атрибуции использования. Чтобы отказаться, удалите вызов или передайте пустую строку. - Начало работы: настройка Places SDK для Android
- Справочная информация: справочник по Places SDK для Android.
- Цены: Использование и оплата Places SDK для Android
- Правила: правила Places SDK для Android.
- Примечания к выпуску: примечания к выпуску Places SDK для Android.
Официальные пакеты Places SDK для Android:
- maven:
com.google.android.libraries.places:places
Places SDK для Android: сопутствующие товары
- Часто используется с Maps SDK для Android.
Places SDK для Android: распространенные ошибки
- Проблема. Запросы Nearby Search без списка полей (маски поля) или с пустым списком возвращают ошибку. Решение. Передайте хотя бы одно значение
Place.Fieldв списке полейSearchNearbyRequest. Подробнее: /maps/documentation/places/android-sdk/nearby-search. - Проблема. Запросы информации о местах (New), Nearby Search (New) и Autocomplete (New) не выполняются, если в ключе API отсутствует Places API (New). В SDK 5.x и более ранних версиях это происходит, когда приложение вызывает
Places.initialize(). В версии 6.0.2 удален методPlaces.initialize(), поэтому код, вызывающий его, не компилируется после обновления. Решение. Включите Places API (New), добавьте его в список разрешенных API ключа и инициализируйте с помощьюPlaces.initializeWithNewPlacesApiEnabled(). Подробнее: /maps/documentation/places/android-sdk/legacy/migrate-overview. - Проблема.
Place, возвращенныйfetchPlace(), не имеетPhotoMetadata(поэтому разрешать нечего), если в списке полей отсутствуетPHOTO_METADATAS. Решение. ДобавьтеPlace.Field.PHOTO_METADATASв список полей. ПосколькуfetchResolvedPhotoUri()больше не поддерживается, используйте для показа фотографий компонент Place Details из Places UI Kit. Подробнее: /maps/documentation/places/android-sdk/place-photos. - Проблема. Приложения, в которых показываются информация о местах, фотографии или отзывы без указания авторства и сторонних источников, нарушают правила. Решение. Показывайте сведения об авторстве, возвращаемые с объектами
Place,PhotoMetadataиReview. Подробнее: /maps/documentation/places/android-sdk/policies.
Places SDK для Android: устаревшие и прекратившие поддержку функции
- Функции Places SDK для Android (устаревшая версия) и Places API (устаревшая версия) (автозаполнение, текущее место, информация о месте, устаревшая версия функции "Фотографии мест"): устаревшие с 1 марта 2025 г. Замена. Функции Places SDK для Android (новая версия) на основе Places API (новая версия), инициализированные с помощью
Places.initializeWithNewPlacesApiEnabled(). Проблема. С октября 2026 г. в новых облачных проектах нельзя будет включить Places API (Legacy). Существующие проекты будут поддерживаться. В SDK 6.0.2 удалены устаревшие методы, которые существуют только в версии 5.x и более ранних. Ознакомьтесь с руководством по переносу. Places.initialize(): выведен из эксплуатации 30 сентября 2026 г. Замена:Places.initializeWithNewPlacesApiEnabled(). Признак. Метод удален из SDK в версии 6.0.2. Код, который его вызывает, больше не компилируется. Ознакомьтесь с руководством по переносу.PlacesClient.findCurrentPlace()иawaitFindCurrentPlace()(Current Place, устаревшие): выведены из эксплуатации 30 сентября 2026 г. Замена:PlacesClient.searchNearby()(Nearby Search (New)). Признак. Методы и классыFindCurrentPlaceRequest/FindCurrentPlaceResponseудалены в версии 6.0.2. Ознакомьтесь с руководством по переносу.PlacesClient.fetchPhoto()иawaitFetchPhoto(): выведены из эксплуатации 30 сентября 2026 г. Замена. Компонент информации о местах в Places UI Kit (PlacesClient.fetchResolvedPhotoUri()больше не поддерживается). Признак. Методы и классыFetchPhotoRequest/FetchPhotoResponseудалены в версии 6.0.2. Ознакомьтесь с руководством по переносу.- Виджет автозаполнения Places API (Legacy) (
Autocomplete,AutocompleteSupportFragment,AutocompleteActivityMode) выведен из эксплуатации 30 сентября 2026 г. Замена: виджет автозаполнения мест (New) (PlaceAutocomplete) илиPlacesClient.findAutocompletePredictions(). Проблема. Из SDK удалены классы в версии 6.0.2. Ознакомьтесь с руководством по переносу. - Библиотека совместимости с Places (
com.google.android.libraries.places:places-compat). Поддержка прекращена 31 марта 2022 г. Замена: Places SDK для Android (com.google.android.libraries.places:places). Признак: заморожена на версии 2.6.0; новые функции и исправления ошибок не добавляются. - Класс
AutocompleteFragmentвыведен из эксплуатации 25 сентября 2025 г. Замена: виджет автозаполнения мест (новый) (PlaceAutocomplete). Проблема: класс удален из SDK в версии 5.0.0 (AutocompleteSupportFragmentтакже удален в версии 6.0.2).
Что можно делать с помощью Places SDK для Android
Ниже приведены ссылки на руководства по каждой задаче. Вы также можете сравнить возможности продуктов в Обзоре возможностей.
Places SDK для Android: генеративный ИИ
- Возвращает сводку отзывов пользователей на основе искусственного интеллекта для указанного идентификатора места Google.
- Возвращает сводные данные о месте и удобствах вокруг указанного идентификатора места Google для станции зарядки электромобилей, созданные на основе искусственного интеллекта.
Places SDK для Android: 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 Картах.
- Возвращает информацию о месте, где сейчас находится устройство пользователя. Примечание. Устаревшие методы Current Place были удалены из Places SDK для Android версии 6.0 и выше и Places SDK для iOS версии 11.0 и выше. Получите координаты устройства из сервисов геолокации платформы и вызовите Nearby Search.
- Получить обзор от ИИ для определенного места.
- Получать сводку от ИИ с описанием мест в районе вокруг определенного места.
- Возвращает информацию о местах, которые находятся вдоль заданного маршрута, на основе строки запроса.
- Возвращает расстояние, время в пути и URI маршрута для мест, найденных с помощью текстового поиска, на основе набора координат широты и долготы.
- Возвращает расстояние, время в пути и URI маршрута до ближайших мест по набору координат широты и долготы.
- Возвращает расстояние, время в пути и URI маршрута между пунктом отправления для заданного маршрута и каждым из мест, возвращенных на основе строки запроса и расположенных вдоль маршрута.
- Возвращает расстояние, время в пути и URI маршрута между каждым из мест, возвращенных на основе строки запроса, которые также расположены вдоль предопределенного маршрута, и пунктом назначения маршрута.
Places SDK для Android: Places UI Kit
- Примените стиль CSS к элементу интерфейса с данными о месте. Примечание. Пользовательские свойства CSS применяются к элементам Places UI Kit в Maps JavaScript API. Places SDK для Android и Places SDK для iOS программно настраивают стили представлений Place UI Kit с помощью атрибутов темы и стиля. ТРЕБОВАНИЕ ДЛЯ СОБЛЮДЕНИЯ ЗАКОНОДАТЕЛЬСТВА ЕЭЗ. Чтобы показывать данные о местах на карте в Европейской экономической зоне (ЕЭЗ), не вызывайте веб-сервисы Places API с бэкенд-сервера. Используйте клиентские компоненты Places UI Kit на целевой платформе (Maps JavaScript API в интернете, Places SDK для Android на Android или Places SDK для iOS на iOS). Полный список требований и часто задаваемые вопросы: https://developers.google.com/maps/comms/eea/faq.
- Настройте стили и конфигурации элементов интерфейса с данными о местах с помощью инструмента настройки элементов интерфейса. Примечание. ТРЕБОВАНИЕ ДЛЯ СОБЛЮДЕНИЯ ЗАКОНОДАТЕЛЬСТВА ЕЭЗ. Чтобы показывать данные о местах на карте в Европейской экономической зоне (ЕЭЗ), не вызывайте веб-сервисы Places API с бэкенд-сервера. Используйте клиентские компоненты Places UI Kit на целевой платформе (Maps JavaScript API в интернете, Places SDK для Android на Android или Places SDK для iOS на iOS). Полный список требований и часто задаваемые вопросы: https://developers.google.com/maps/comms/eea/faq.
- Добавьте элемент пользовательского интерфейса, который показывает информацию об определенном месте на веб-странице или в мобильном приложении. Примечание. ТРЕБОВАНИЕ О СОБЛЮДЕНИИ ЗАКОНОДАТЕЛЬСТВА ЕЭЗ. Чтобы показывать данные о местах на карте в Европейской экономической зоне (ЕЭЗ), не вызывайте веб-сервисы Places API с бэкенд-сервера. Используйте клиентские компоненты Places UI Kit на целевой платформе (Maps JavaScript API в интернете, Places SDK для Android на Android или Places SDK для iOS на iOS). Полный список требований и часто задаваемые вопросы: https://developers.google.com/maps/comms/eea/faq.
- Добавьте на веб-страницу элемент интерфейса, который показывает список мест на основе строки запроса. Примечание. Поддерживается как на веб-страницах (Maps JavaScript API), так и в мобильных приложениях (Places SDK для Android и Places SDK для iOS). ТРЕБОВАНИЕ ДЛЯ СОБЛЮДЕНИЯ ЗАКОНОДАТЕЛЬСТВА ЕЭЗ. Чтобы показывать данные о местах на карте в Европейской экономической зоне (ЕЭЗ), не вызывайте веб-сервисы Places API с бэкенд-сервера. Используйте клиентские компоненты Places UI Kit на целевой платформе (Maps JavaScript API в интернете, Places SDK для Android на Android или Places SDK для iOS на iOS). Полный список требований и часто задаваемые вопросы: https://developers.google.com/maps/comms/eea/faq.
- Добавьте на веб-страницу элемент интерфейса, который показывает список мест рядом с определенным местоположением. Примечание. Поддерживается как на веб-страницах (Maps JavaScript API), так и в мобильных приложениях (Places SDK для Android и Places SDK для iOS). ТРЕБОВАНИЕ ДЛЯ СОБЛЮДЕНИЯ ЗАКОНОДАТЕЛЬСТВА ЕЭЗ. Чтобы показывать данные о местах на карте в Европейской экономической зоне (ЕЭЗ), не вызывайте веб-сервисы Places API с бэкенд-сервера. Используйте клиентские компоненты Places UI Kit на целевой платформе (Maps JavaScript API в интернете, Places SDK для Android на Android или Places SDK для iOS на iOS). Полный список требований и часто задаваемые вопросы: https://developers.google.com/maps/comms/eea/faq.
- Добавьте на веб-страницу или в приложение базовый элемент интерфейса с автозаполнением, который возвращает идентификаторы мест Google на основе строки запроса. Примечание. ТРЕБОВАНИЕ ДЛЯ СОБЛЮДЕНИЯ ЗАКОНОДАТЕЛЬСТВА ЕЭЗ. Чтобы показывать данные о местах на карте в Европейской экономической зоне (ЕЭЗ), не вызывайте веб-сервисы Places API с бэкенд-сервера. Используйте клиентские компоненты Places UI Kit на целевой платформе (Maps JavaScript API в интернете, Places SDK для Android на Android или Places SDK для iOS на iOS). Полный список требований и часто задаваемые вопросы: https://developers.google.com/maps/comms/eea/faq.