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