Maps SDK for Android クイック リファレンス

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 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 以降、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: データセット

Maps SDK for Android: Maps

Maps SDK for Android: 地図アノテーション

Maps SDK for Android: 地図のスタイル設定

Maps SDK for Android: ストリートビュー