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: 設定
- 有効にするサービス:
mapsandroid.googleapis.com - 認証: API キー
- 使ってみる: Maps 3D SDK for Android を設定する
- リファレンス: Maps 3D SDK for Android リファレンス
- 料金: Maps 3D SDK for Android の使用量と請求額
- ポリシー: Maps 3D 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: 関連商品
- 併用されることが多い API または SDK: Places SDK for Android
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 でできること
各タスクについては、以下のリンク先のガイドをご覧ください。また、機能エクスプローラでプロダクトを比較することもできます。
- インタラクティブな Photorealistic 3D Maps をウェブページに追加する。
- フォトリアリスティック 3D 地図にマーカーを追加する。
- フォトリアリスティック 3D マップ上のマーカーをカスタマイズする。
- 3D モデルをフォトリアリスティック 3D 地図に追加する。
- 3D ポリラインをフォトリアリスティック 3D 地図に追加する。
- フォトリアリスティック 3D 地図に 3D ポリゴンを追加する。
- フォトリアリスティック 3D 地図上でユーザーの操作やイベントに応答する。
- フォトリアリスティック 3D マップに表示されるコントロールをカスタマイズします。
- フォトリアリスティック 3D マップでカメラパスとアニメーションを制御する。
- フォトリアリスティック 3D マップでカメラの制限を制御する。