Краткий справочник по Places SDK для Android

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 SDK для Android:

  • maven: com.google.android.libraries.places:places

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: генеративный ИИ

Places SDK для Android: Places

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.