Repolode
googlemaps

googlemaps/android-maps-utils

Google Maps SDK for Android向けのKotlinユーティリティライブラリ。マーカーのクラスタリング、ヒートマップ、KML/GeoJSONのインポート、ジオメトリ計算をサポートします。

スター
3,625
フォーク
1,551
未解決の Issue
29
最終コミット
一昨日

これは何?

android-maps-utilsは、Google Maps SDK for Androidを使って開発するアプリ向けのユーティリティライブラリです。大量のマーカーのクラスタリング、ヒートマップの描画、マーカーのアニメーション、マーカー上へのテキストラベルの表示など、地図でよく使われる機能をまとめて提供します。

データのインポートやジオメトリ処理にも対応しています。スタイルを指定してKMLやGeoJSONファイルを解析・表示できるほか、Maps APIのWebサービスで使われる形式のポリラインをエンコード/デコードしたり、球面上の距離、方位、面積を計算したりできます。また、別途提供されるStreet Viewメタデータヘルパーを使うと、アプリでパノラマを表示しようとする前に、指定した場所にパノラマが存在するか確認できます。

バージョン5.0以降、ライブラリはKotlinで記述され、core、clustering、data、heatmaps、uiなどのサブモジュールに分割されています。そのため、アプリは必要な機能だけを導入できます。バージョン6.0では、以前のktxアーティファクトがcom.google.maps.androidパッケージ配下に統合され、coroutineとFlow向けのヘルパーが追加されました。

主な機能

  • 0110万個以上のマーカーに対応するSuperClusterアルゴリズムを含む、マーカーのクラスタリング
  • 02大量の点データをヒートマップとして描画
  • 03KMLおよびGeoJSONデータのインポートと、スタイルを適用した表示
  • 04ポリラインのエンコード/デコードと球面ジオメトリの計算
  • 05地図API向けのKotlin coroutineおよびFlow拡張
  • 06必要な機能だけに依存できるモジュール構成

ユースケース

  • Androidの地図上で店舗やセンサーの位置を数千件表示し、画面が見づらくなるのを防ぐ
  • GISソースのKMLまたはGeoJSONファイルをGoogle Map上に重ねて表示する
  • ヒートマップで点の密度を可視化する
  • モバイルアプリで座標間の距離や面積を計算する

クイックスタート

  1. 1

    aggregator artifactを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 variantをビルドして実行します

使う前に知っておきたいこと

  • Maps SDK for Androidを使用するには、Google Maps PlatformのプロジェクトとAPIキーが必要です。
  • Androidのみが対象で、APIレベル24以上が必要です。

収録されている特集

トピック

#android#google-maps#kotlin#marker-clustering#heatmap#geojson#kml#geometry#heat-maps#maps

よくある質問

android-maps-utils とは?
Google Maps SDK for Android向けの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 Map上に重ねて表示する ヒートマップで点の密度を可視化する モバイルアプリで座標間の距離や面積を計算する
android-maps-utils のインストール方法は?
aggregator artifactを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 variantをビルドして実行します
android-maps-utils はどこで入手できますか?
ソースコードとインストール手順は GitHub にあります:https://github.com/googlemaps/android-maps-utils

概要はプロジェクトの README をもとに AI が生成しています。GitHub の数値は毎日更新されます。

関連プロジェクト