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

Maps 3D SDK for iOS を使用すると、Google の 3D 画像を使用して iOS アプリで 3D マップ エクスペリエンスを構築できます。マーカー、ポップオーバー、ポリライン、ポリゴン、3D モデル(glTF)、カメラパス アニメーション、カメラとインタラクションのコントロール用の SwiftUI API が用意されています。

Maps 3D SDK for iOS: 主な特長

  • プロダクト: Maps 3D SDK for iOS
  • カテゴリ: マップ
  • プラットフォーム: iOS
  • 実行場所: クライアント(アプリまたはブラウザのコード)
  • リリース ステージ: GA
  • ライフサイクル: アクティブ
  • 概要: Maps 3D SDK for iOS の概要

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

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

  • ネイティブ iOS(SwiftUI)アプリに、インタラクティブなフォトリアリスティック 3D 地図を組み込む必要があります。
  • iOS の 3D 地図にマーカー、ポップオーバー、ポリライン、ポリゴン、glTF 3D モデルを配置する必要がある。
  • iOS の 3D 地図で、カメラのフライスルー アニメーションやフライアラウンド アニメーション、またはカメラの制限が必要な場合。
  • ユーザーが 3D 地図上の地点をタップすると、組み込みの Places UI キット ウィジェットに Place Details が表示されるようにする必要があります。

Maps 3D SDK for iOS を使用すべきでない場合:

  • Android アプリに 3D 地図が必要な場合は、Maps 3D SDK for Android を使用してください。
  • ウェブページに 3D 地図が必要です。代わりに Maps JavaScript API を使用してください。
  • iOS アプリに標準の 2D 地図が必要な場合は、代わりに Maps SDK for iOS を使用してください。

Maps 3D SDK for iOS: 設定

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

  • swift_package: https://github.com/googlemaps/ios-maps-3d-sdk (product GoogleMaps3D)
  • swift_package: https://github.com/googlemaps/ios-maps-3d-sdk (product GoogleMaps3DKit, for POI taps with the Places UI Kit widget)

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

  • 問題: 地図の読み込み時に地図モードが設定されていない場合、地図の読み込みに失敗します。修正: Map を作成するときは、常にモード(Map(mode: .hybrid) など)を渡します。/maps/documentation/maps-3d/ios-sdk/map-modes をご覧ください。
  • 問題: アプリのエントリ ポイントと個々のマップビューの両方で API キーを設定すると、コンソール エラーが発生します。修正方法: Map.apiKey は、アプリのエントリ ポイントまたは各マップビューのいずれか 1 か所でのみ設定します。/maps/documentation/maps-3d/ios-sdk/setup をご覧ください。
  • 問題: Camera altitudeMode はカメラ アニメーション以外では無視されます。flyCameraTo と flyCameraAround にのみ適用されます。 修正: Camera altitudeMode に依存する場合は、flyCameraTo または flyCameraAround を使用します。/maps/documentation/maps-3d/ios-sdk/custom-camera-paths をご覧ください。
  • 問題: GoogleMaps3DKit では、ユーザーがスポットをタップすると、Places UI ウィジェットがデフォルトで表示されます。修正: placeInformationEnabled(false) を使用するか、onPlaceTap(_:) から .none を返して、ウィジェットを抑制します。/maps/documentation/maps-3d/ios-sdk/points-of-interest をご覧ください。

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

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