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

Maps SDK для Android позволяет добавлять в приложения для Android и приложения для Wear OS карты на основе данных из Google Карт, а также настраивать их внешний вид и реакцию на жесты. Вы можете добавлять маркеры, многоугольники и наложения, чтобы показывать информацию о местах на карте и поддерживать взаимодействие с пользователем, используя Kotlin или Java.

Maps SDK для Android: основные факты

  • Продукт: Maps SDK для Android.
  • Другое название: Google Карты Android API.
  • Категория: Карты
  • Платформа: Android.
  • Где выполняется: на стороне клиента (в коде приложения или браузера).
  • Стадия запуска: GA
  • Жизненный цикл: активно.
  • Обзор: Обзор Maps SDK для Android
  • Регионы: все страны. Перейдите на страницу покрытия платформы Google Карт. На странице использования и оплаты есть ссылки на отдельные прейскуранты для Индии и других стран. (подробнее о покрытии)

Когда использовать Maps SDK для Android

Используйте Maps SDK для Android, если:

  • Вам нужна интерактивная двухмерная карта Google в нативном приложении для Android или Wear OS.
  • Вам нужно добавить на карту в приложении для Android маркеры, информационные окна, ломаные линии, многоугольники, наземные наложения или наложения фрагментов.
  • Вам нужны панорамы в Просмотре улиц, карты в упрощенном режиме (битовые карты) или облачные стили карт с идентификаторами карт в приложении для Android.
  • Вы создаете карту Android на Kotlin или Java, включая Jetpack Compose через библиотеку Maps Compose.

Не используйте Maps SDK для Android в следующих случаях:

  • Вам нужна пошаговая навигация в приложении с картами для Android. Используйте Navigation SDK для Android.
  • Вам нужны фотореалистичные 3D-карты, 3D-модели или анимация траектории камеры в приложении для Android. Используйте Maps 3D SDK для Android.
  • Вам нужно добавить карту в нативное приложение для iOS. Используйте Maps SDK для iOS.

Maps SDK для Android: настройка

Официальные пакеты Maps SDK для Android:

  • maven: com.google.android.gms:play-services-maps

Maps SDK для Android: распространенные ошибки

  • Проблема. Начиная с версии 20.0.0 манифест SDK больше не включает библиотеку org.apache.http.legacy. Приложения, которые загружают устаревшее средство отрисовки карт, могут аварийно завершать работу с ошибкой java.lang.NoClassDefFoundError. Решение. Добавьте в тег файла AndroidManifest.xml приложения. Устройства с сервисами Google Play версии 25.50.34 или более поздней не затронуты. Подробнее: /maps/documentation/android-sdk/release-notes.
  • Проблема. Для работы с расширенными маркерами требуется обновленное средство отрисовки карт. обновленное средство визуализации карт. Если вы добавите маркеры в существующее приложение, не изменив его, в нем может по-прежнему использоваться устаревшее средство визуализации. Решение. Пересоберите приложение с SDK 18.2.0 или более поздней версии, чтобы обновленное средство отрисовки использовалось по умолчанию. Подробнее: /maps/documentation/android-sdk/advanced-markers/start.
  • Проблема. Устройства, которые не соответствуют требованиям к средству отрисовки (Android 5.0/API 21 или более поздней версии, сервисы Google Play 21.39.14 или более поздней версии, включенный Google Play), возвращаются к прежнему средству отрисовки, поэтому функции, для которых требуется новое средство отрисовки, например облачные стили карт, на них недоступны. Решение. Вызовите MapsInitializer.initialize(context, MapsInitializer.Renderer.LATEST, callback) и проверьте значение MapsInitializer.Renderer, переданное в OnMapsSdkInitializedCallback.onMapsSdkInitialized(), или проверьте GoogleMap.getMapCapabilities(). Если на устройстве используется LEGACY, не полагайтесь на облачные стили карт или расширенные маркеры. Подробнее: /android/reference/com/google/android/gms/maps/OnMapsSdkInitializedCallback.
  • Проблема. Для работы SDK на устройстве, где запущено приложение, требуются сервисы Google Play. Решение. При необходимости вызовите проверку доступности сервисов Google Play из приложения. Подробнее: /maps/documentation/android-sdk/config.

Maps SDK для Android: устаревшие и не поддерживаемые функции

  • Устаревшее средство отрисовки карт. Поддержка прекращена 4 марта 2024 г. Замена. Обновленное (последнее) средство отрисовки карт, которое используется по умолчанию начиная с SDK 18.2.0. Признак. Облачные стили карт, расширенные настройки ломаных линий и расширенные маркеры недоступны в устаревшем средстве визуализации. Ознакомьтесь с руководством по переносу.

Что можно делать с помощью Maps SDK для Android

Ниже приведены ссылки на руководства по каждой задаче. Вы также можете сравнить возможности продуктов в Обзоре возможностей.

Maps SDK для Android: стили на основе данных для границ

Maps SDK для Android: стили на основе данных для наборов данных

Maps SDK для Android: наборы данных

Maps SDK для Android: Maps

Maps SDK для Android: аннотации на картах

Maps SDK для Android: стили карт

Maps SDK для Android: Просмотр улиц