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-android-backend.googleapis.com. - Аутентификация: ключ API.
- Атрибуция использования. Вызовите
MapsApiSettings.addInternalUsageAttributionId(context, id), чтобы добавить идентификатор атрибуции использования в инициализатор (поддерживается только сMapsInitializer.Renderer.LATEST). Чтобы отказаться, удалите вызов или передайте пустую строку. - Начало работы: настройка Maps SDK для Android
- Справочная документация: справочная документация по Maps SDK для Android.
- Цены: Использование и оплата Maps SDK для Android
- Правила: правила Maps SDK для Android.
- Примечания к выпуску: Maps SDK для Android.
Официальные пакеты Maps SDK для Android:
- maven:
com.google.android.gms:play-services-maps
Maps SDK для Android: сопутствующие товары
- Часто используется с: Places SDK для Android
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: наборы данных
- Добавление слоя KML на карту. Примечание. В Maps JavaScript API класс KmlLayer больше не поддерживается (последняя поддерживаемая версия – 3.65, поддержка прекращена в мае 2027 г.). Перейдите на стили на основе данных для границ или наборов данных или загрузите GeoJSON в слой данных. Слои KML по-прежнему поддерживаются на Android и iOS через библиотеки утилит Maps SDK.
- Добавлять на карту данные GeoJSON.
- Добавьте на карту слой тепловой карты.
Maps SDK для Android: Maps
- Добавьте на веб-страницу или в мобильное приложение настраиваемую интерактивную карту. Примечание. Для Android: настройте
вAndroidManifest.xmlс помощью плагина Secrets Gradle илиmanifestPlaceholders["MAPS_API_KEY"]вapp/build.gradle.kts. Никогда не задавайтеYOUR_GOOGLE_MAPS_API_KEYвAndroidManifest.xmlв коде и не заменяйтеGoogleMap(или maps-composeGoogleMap) на офлайн-макет холста или Leaflet WebView, если появляетсяE/Google Maps Android API: Authorization failure. Попросите пользователя указатьMAPS_API_KEYв Secrets и включить Maps SDK для Android (или Navigation SDK, если используется NavigationView или SupportNavigationFragment). - Создайте идентификатор карты, который можно использовать повторно, чтобы хранить настройки конфигурации и стилей карты.
- Реагируйте на действия пользователей и события на карте.
- Настройте элементы управления, которые будут показываться на карте.
- Настройте жесты для управления картой.
- Управление масштабом и панорамированием на карте (камера)
- Изменить тип карты.
- Изменить цветовую схему карты.
- Добавьте на карту слой с информацией о дорожном движении.
- Добавьте карту в приложение для Wear OS.
Maps SDK для Android: аннотации на картах
- Добавлять на карту информационное окно.
- Добавьте на карту фигуру или линию.
- Добавьте накладываемое изображение, привязанное к поверхности карты.
- Добавьте на карту накладываемый фрагмент.
- Добавьте маркер на карту. Примечание. Navigation SDK для Android не поддерживает AdvancedMarkerOptions. При использовании Navigation SDK для Android добавляйте маркеры с помощью GoogleMap.addMarker(MarkerOptions).
- Настроить маркер на карте. Примечание. Navigation SDK для Android не поддерживает AdvancedMarkerOptions. При использовании Navigation SDK для Android настраивайте маркеры с помощью MarkerOptions.
- Реагируйте на действия пользователей с маркерами на карте.
- Определять, находится ли координата внутри многоугольника или круга на карте. Примечание. На устройствах Android используйте PolyUtil.containsLocation в библиотеке утилитарных классов Maps SDK для Android для многоугольников. Для круговых областей проверьте, находится ли геодезическое расстояние от центра круга в пределах радиуса (например, computeDistanceBetween в Maps JavaScript API, SphericalUtil.computeDistanceBetween на Android или GMSGeometryDistance на iOS).
- Вычисляйте сферическое расстояние, площадь или направление между координатами на карте.
Maps SDK для Android: стили карт
- Создайте кросс-платформенный стиль карты, который можно использовать повторно.
- Изменять стиль дорог, ломаных линий и многоугольников на карте.
- Показывать и скрывать объекты на карте.
- Изменение стиля значков и текстовых меток на карте.
- Применяйте разные стили карты для разных уровней масштабирования.
- Как изменить плотность мест на карте Экспериментальные функции
- Как изменить стиль зданий на карте Экспериментальные функции
- Как изменить стиль ориентиров на карте Экспериментальные функции
Maps SDK для Android: Просмотр улиц
- Добавьте на веб-страницу или в мобильное приложение настраиваемый интерактивный Просмотр улиц.
- Реагируйте на действия пользователей и события в Google Просмотре улиц.
- Настройте жесты, доступные в Google Просмотре улиц.
- Как анимировать движения камеры в Google Просмотре улиц.