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

Maps 3D SDK for Android を使用すると、Android アプリで Google の 3D 画像から作成されたインタラクティブな 3D 地図を表示できます。マーカー、ポップオーバー、ポリライン、ポリゴン、glTF 3D モデル、カメラパス アニメーション、ユーザー インタラクションとカメラ移動のコントロールを提供します。

Maps 3D SDK for Android: 主な特長

  • プロダクト: Maps 3D SDK for Android
  • 別名: Maps 3D Android SDK
  • カテゴリ: マップ
  • プラットフォーム: Android
  • 実行場所: クライアント(アプリまたはブラウザのコード)
  • リリース ステージ: GA
  • ライフサイクル: アクティブ
  • 概要: Maps 3D SDK for Android の概要
  • 対象地域: 制限あり。提供状況は国や地域によって異なります。Google Maps Platform の対応状況ページの「Maps 3D(JavaScript、Android、iOS)」列をご覧ください。(カバレッジの詳細)

Maps 3D SDK for Android: 使用するタイミング

Maps 3D SDK for Android を使用するケース:

  • Android アプリで、現実世界の場所のインタラクティブなフォトリアリスティック 3D 地図を表示する必要があります。
  • Android アプリの 3D 地図にマーカー、ポップオーバー、ポリライン、ポリゴン、glTF 3D モデルを配置する必要がある。
  • 3D 地図上のスポット間でユーザーをガイドする、事前定義のカメラ アニメーション(fly-to、fly-around)が必要な場合。
  • Android アプリの 3D 地図でユーザーが使用できるカメラの動きと UI コントロールを制御する必要があります。

次のような場合は、Maps 3D SDK for Android を使用しないでください。

  • 3D 地図を必要とするウェブアプリを構築している。代わりに Maps JavaScript API を使用してください。
  • 3D 地図を必要とする iOS アプリを構築しています。代わりに Maps 3D SDK for iOS を使用してください。
  • Android アプリに、プロダクション レディな標準の 2D 道路地図が必要な場合(この SDK の ROADMAP モードは試験運用版です)。代わりに Maps SDK for Android を使用してください。

Maps 3D SDK for Android: 設定

公式の Maps 3D SDK for Android パッケージ:

  • Maven: com.google.android.gms:play-services-maps3d

Maps 3D SDK for Android: よくある間違い

  • 問題: 地図の読み込み時に地図モードが指定されていない場合、地図の読み込みに失敗します。修正: レイアウト XML(map3d:mapMode)または setMapMode/Map3DInitConfig で、常に Map3DMode(SATELLITE、HYBRID、ROADMAP)を設定します。/maps/documentation/maps-3d/android-sdk/map-modes をご覧ください。
  • 問題: クリック リスナー(地図とマーカーのクリック)がメイン UI スレッドで実行されないため、ハンドラから UI を直接更新できない。修正: UI を更新する前に、lifecycleScope.launch(Dispatchers.Main) などを使用してメインスレッドに切り替えます。/maps/documentation/maps-3d/android-sdk/add-a-marker をご覧ください。
  • 問題: 地図の状態が Map3DView インスタンス間で共有されるため、古いビューのマーカー、オーバーレイ、カメラ位置が新しいビューに引き継がれます。修正方法: アクティブな Map3DView を 1 つだけ保持します。古いインスタンスで onDestroy() を呼び出し、マーカーとオーバーレイを手動でクリアして、GoogleMap3D でカメラをリセットします。/maps/documentation/maps-3d/android-sdk/add-a-3d-map をご覧ください。
  • 問題: デフォルトでは、基本地図のスポットをタップすると Places UI ウィジェットが表示されます。これには Places SDK の依存関係も必要です。修正: Places SDK for Android の依存関係を追加し、デフォルトのウィジェットが不要な場合は、OnMap3DClickListener の onMap3DClick から true を返してデフォルトのウィジェットを抑制します。/maps/documentation/maps-3d/android-sdk/points-of-interest をご覧ください。

Maps 3D SDK for Android でできること

各タスクについては、以下のリンク先のガイドをご覧ください。また、機能エクスプローラでプロダクトを比較することもできます。