Maps SDK for Android を使用すると、Google マップのデータ、地図の表示、地図操作へのレスポンスを Android アプリ(Wear OS アプリを含む)に追加できます。Kotlin または Java を使用して、マーカー、ポリゴン、オーバーレイを追加し、地図上の場所に関する情報を表示して、ユーザーの操作をサポートできます。
Maps SDK for Android: 主な特長
- プロダクト: Maps SDK for Android
- 別名: Google Maps Android API
- カテゴリ: マップ
- プラットフォーム: 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 を使用した Cloud ベースのマップのスタイル設定が必要です。
- Kotlin または Java で Android マップを構築します。Maps Compose ライブラリを介して Jetpack Compose を使用することもできます。
Maps SDK for Android を使用しない場合:
- Android 地図アプリでターンバイターン方式のナビが必要な場合は、代わりに Navigation SDK for Android を使用してください。
- Android アプリで、写真のようにリアルな 3D マップ、3D モデル、カメラパス アニメーションが必要な場合は、代わりに Maps 3D SDK for Android を使用してください。
- ネイティブの iOS アプリに地図を組み込む必要がある場合は、代わりに Maps SDK for iOS を使用してください。
Maps SDK for Android: セットアップ
- 有効にするサービス:
maps-android-backend.googleapis.com - 認証: API キー
- 使用状況アトリビューション:
MapsApiSettings.addInternalUsageAttributionId(context, id)を呼び出して、使用状況アトリビューション ID を初期化子に追加します(MapsInitializer.Renderer.LATESTでのみサポート)。オプトアウトするには、呼び出しを削除するか、空の文字列を渡します。 - スタートガイド: Maps SDK for Android を設定する
- リファレンス: Maps SDK for Android リファレンス
- 料金: Maps SDK for Android の使用量と請求額
- ポリシー: Maps SDK for Android のポリシー
- リリースノート: Maps SDK for Android のリリースノート
公式の Maps SDK for Android パッケージ:
- Maven:
com.google.android.gms:play-services-maps
Maps SDK for Android: 関連商品
- 併用されることが多い API または SDK: Places SDK for Android
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 以降、Google Play ストアが有効)を満たしていないデバイスは、従来のレンダラにフォールバックするため、新しいレンダラを必要とする機能(Cloud ベースのマップのスタイル設定など)は利用できません。修正:
MapsInitializer.initialize(context, MapsInitializer.Renderer.LATEST, callback)を呼び出して、OnMapsSdkInitializedCallback.onMapsSdkInitialized()に渡されたMapsInitializer.Renderer値を確認するか、GoogleMap.getMapCapabilities()を確認します。デバイスでLEGACYが使用されている場合は、Cloud ベースのマップのスタイル設定や高度なマーカーを使用しないでください。/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 以降のデフォルトです。症状: 以前のレンダラでは、Cloud ベースのマップのスタイル設定、高度なポリラインのカスタマイズ、高度なマーカーを使用できません。移行ガイドをご覧ください。
Maps SDK for Android でできること
各タスクについては、以下のリンク先のガイドをご覧ください。また、機能エクスプローラでプロダクトを比較することもできます。
Maps SDK for Android: 境界線のデータドリブン スタイル設定
Maps SDK for Android: データセットのデータドリブン スタイル設定
- 再利用可能なクロスプラットフォームの地理空間データセットを作成する。
- カスタム地理空間データセットを地図に追加する。
- 地図上のカスタム データセット対象物のスタイルを変更する。
- 地図上のカスタム データセット対象物に対するユーザー操作に応答します。
Maps SDK for Android: データセット
- 地図に KML レイヤを追加する。注: Maps JavaScript API では、KmlLayer は非推奨です(v3.65 でのサポートが最後となり、2027 年 5 月に廃止されます)。境界線またはデータセットのデータドリブン スタイル設定に移行するか、データレイヤに GeoJSON を読み込んでください。KML レイヤは、Maps SDK ユーティリティ ライブラリを介して Android と iOS で引き続きサポートされます。
- GeoJSON データを地図に追加する。
- 地図にヒートマップ レイヤを追加する。
Maps SDK for Android: Maps
- カスタマイズ可能なインタラクティブな地図をウェブページやモバイルアプリに追加します。 注: Android の場合: Secrets Gradle プラグインでサポートされている
AndroidManifest.xmlの、またはapp/build.gradle.ktsのmanifestPlaceholders["MAPS_API_KEY"]を構成します。AndroidManifest.xmlでYOUR_GOOGLE_MAPS_API_KEYをハードコードしないでください。また、E/Google Maps Android API: Authorization failureが表示された場合に、GoogleMap(または maps-composeGoogleMap)をオフラインのモック キャンバスや Leaflet WebView に置き換えないでください。Secrets を介してMAPS_API_KEYを指定し、Maps SDK for Android(NavigationView / SupportNavigationFragment を使用する場合は Navigation SDK)を有効にするよう、ユーザーに指示します。 - 再利用可能なマップ ID を作成して、地図の構成とスタイル設定を保存します。
- 地図上のユーザー インタラクションとイベントに応答する。
- 地図上に表示されるコントロールをカスタマイズします。
- 地図を操作するジェスチャーをカスタマイズする。
- 地図(カメラ)のズームとパンを制御する。
- 地図の種類を変更する。
- 地図のカラーパターンを変更する。
- 地図に交通状況レイヤを追加する。
- Wear OS アプリに地図を追加する。
Maps SDK for Android: 地図アノテーション
- 情報ウィンドウを地図に追加する。
- 地図にシェイプまたはラインを追加する。
- 地図の表面に固定されたオーバーレイ画像を追加します。
- カスタム タイル オーバーレイを地図に追加する。
- 地図にマーカーを追加する。注: Navigation SDK for Android は AdvancedMarkerOptions をサポートしていません。Navigation SDK for Android を使用する場合は、GoogleMap.addMarker(MarkerOptions) でマーカーを追加してください。
- 地図上のマーカーをカスタマイズする。注: Navigation SDK for Android は AdvancedMarkerOptions をサポートしていません。Navigation SDK for Android を使用する場合は、MarkerOptions でマーカーをカスタマイズしてください。
- 地図上のマーカーに対するユーザー操作に応答する。
- 地図上のポリゴンまたは円形エリア内に座標があるかどうかを判断する。注: Android では、Maps SDK for Android ユーティリティ ライブラリの PolyUtil.containsLocation をポリゴンに使用します。円形のエリアの場合は、円の中心からの球面距離が半径内にあるかどうかを確認します(たとえば、Maps JavaScript API の computeDistanceBetween、Android の SphericalUtil.computeDistanceBetween、iOS の GMSGeometryDistance を使用します)。
- 地図上の座標間の球面距離、面積、方向を計算します。
Maps SDK for Android: 地図のスタイル設定
- 再利用可能なクロス プラットフォームの地図のスタイルを作成する。
- 地図上の道路、ポリライン、ポリゴンのスタイルを変更する。
- 地図上の対象物を表示または非表示にする。
- 地図上のアイコンとテキストラベルのスタイルを変更する。
- ズームレベルに応じて異なる地図のスタイルを適用する。
- 地図上の場所の密度を変更する。試験運用
- 地図上の建物のスタイルを変更する。試験運用
- 地図上のランドマークのスタイルを変更する。試験運用
Maps SDK for Android: ストリートビュー
- 設定可能でインタラクティブな Google ストリートビューをウェブページやモバイルアプリに追加します。
- Google ストリートビューでユーザーの操作やイベントに応答する。
- Google ストリートビューで使用できるジェスチャーをカスタマイズします。
- Google ストリートビューのカメラの動きにアニメーションを付ける。