googlemaps/android-maps-utils

这是什么？

核心功能

• 01标记聚合，包括适用于 10 万以上标记的 SuperCluster 算法
• 02大量点数据的热力图渲染
• 03KML 与 GeoJSON 数据的导入和样式化显示
• 04折线编解码与球面几何计算
• 05面向地图 API 的协程与 Flow 扩展
• 06模块化发布，应用可只引入所需部分

适用场景

• 在 Android 地图上展示成千上万的门店或传感器位置而不致杂乱
• 将 GIS 来源的 KML 或 GeoJSON 文件叠加到 Google 地图上
• 用热力图展示点的分布密度
• 在移动应用中计算坐标之间的距离或面积

快速上手

1. 1

   在 Gradle 依赖中添加聚合库

   implementation("com.google.maps.android:android-maps-utils:6.1.0")
2. 2

   获取已启用 Maps SDK for Android 的 Google Maps Platform API 密钥

3. 3

   若要运行示例应用，请在根项目的 secrets.properties 中添加 MAPS_API_KEY

4. 4

   构建并运行示例应用的 debug 版本

使用前须知

• !需要 Google Maps Platform 项目和 API 密钥才能使用 Maps SDK for Android。
• !仅适用于 Android，要求 API 级别 24 或更高。

收录于专题

标签

常见问题

android-maps-utils 是什么？

Google Maps Android SDK 的 Kotlin 工具库，提供标记聚合、热力图、KML/GeoJSON 导入和几何计算等功能。 android-maps-utils 是基于 Google Maps SDK for Android 开发应用时使用的工具库，封装了常见的地图功能，例如对大量标记进行聚合、绘制热力图、标记动画以及在标记上显示文字。

android-maps-utils 可以免费使用吗？用的什么许可证？

android-maps-utils 以 Apache-2.0 许可证开源。用于商业产品前，请先确认许可证条款。

android-maps-utils 还在维护吗？

活跃维护中。android-maps-utils 最近一次提交是在 2026年11月5日。

android-maps-utils 适合用来做什么？

在 Android 地图上展示成千上万的门店或传感器位置而不致杂乱 将 GIS 来源的 KML 或 GeoJSON 文件叠加到 Google 地图上 用热力图展示点的分布密度 在移动应用中计算坐标之间的距离或面积

android-maps-utils 怎么安装和运行？

在 Gradle 依赖中添加聚合库: implementation("com.google.maps.android:android-maps-utils:6.1.0") 获取已启用 Maps SDK for Android 的 Google Maps Platform API 密钥 若要运行示例应用，请在根项目的 secrets.properties 中添加 MAPS_API_KEY 构建并运行示例应用的 debug 版本

在哪里获取 android-maps-utils？

源代码和安装说明在 GitHub 上：https://github.com/googlemaps/android-maps-utils