Maps SDK for Android 快速参考

Maps SDK for Android 可将 Google 地图数据、地图显示内容和地图手势响应添加到 Android 应用(包括 Wear OS 应用)中。您可以使用 Kotlin 或 Java 添加标记、多边形和叠加层,以显示有关地图位置的信息并支持用户互动。

Maps SDK for Android:关键信息

  • 产品:Maps SDK for Android
  • 别名:Google 地图 Android API
  • 类别:Google 地图
  • 平台:Android
  • 运行位置:客户端(应用或浏览器代码)
  • 发布阶段:GA
  • 生命周期:有效
  • 概览:Maps SDK for Android 概览
  • 适用区域:全球。请参阅 Google Maps Platform 覆盖范围页面;用量和结算页面链接分别提供了全球和印度价格列表。(覆盖范围详情)

Maps SDK for Android:何时使用

在以下情况下使用 Maps SDK for Android:

  • 您需要在原生 Android 或 Wear OS 应用中添加交互式 2D Google 地图。
  • 您需要向 Android 应用中的地图添加标记、信息窗口、多段线、多边形、地面叠加层或图块叠加层。
  • 您需要在 Android 应用中使用街景全景图片、精简模式(位图)地图或具有地图 ID 的云端地图样式设置。
  • 您可以使用 Kotlin 或 Java 构建 Android 地图,包括通过 Maps Compose 库使用 Jetpack Compose。

在以下情况下,请勿使用 Maps SDK for Android:

Maps SDK for Android:设置

官方 Maps SDK for Android 软件包:

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

Maps SDK for Android:常见错误

  • 问题:自 SDK v20.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 或更高版本、已启用 Play 商店)的设备会回退到旧版渲染程序,因此这些设备上无法使用需要新版渲染程序的功能,例如云端地图样式设置。解决方法:调用 MapsInitializer.initialize(context, MapsInitializer.Renderer.LATEST, callback) 并检查传递给 OnMapsSdkInitializedCallback.onMapsSdkInitialized() 的 MapsInitializer.Renderer 值,或检查 GoogleMap.getMapCapabilities()。如果设备使用 LEGACY,请勿依赖云端地图样式设置或高级标记。请参阅 /android/reference/com/google/android/gms/maps/OnMapsSdkInitializedCallback。
  • 问题:SDK 要求运行应用的设备上安装了 Google Play 服务。修复方法:您可以选择从应用中调用 Google Play 服务可用性检查。请参阅 /maps/documentation/android-sdk/config。

Maps SDK for Android:旧版和已弃用的功能

  • 旧版地图渲染程序:自 2024 年 3 月 4 日起已弃用。替代方案:升级版(最新)地图渲染程序,自 SDK 18.2.0 起成为默认渲染程序。症状:旧版渲染程序不支持云端地图样式设置、高级多段线自定义和高级标记。请参阅迁移指南。

Maps SDK for Android 的用途

请参阅下面链接的指南,了解每项任务,或在功能探索器中比较不同产品。

Maps SDK for Android:边界的数据驱动型样式

Maps SDK for Android:数据集的数据驱动型样式

Maps SDK for Android:数据集

Maps SDK for Android:地图

Maps SDK for Android:地图注释

Maps SDK for Android:地图样式设置

Maps SDK for Android:街景