Maps SDK for iOS を使用すると、Google マップのデータに基づく地図を iOS アプリに追加できます。この SDK は、Google マップ サーバーへのアクセス、地図の表示、ユーザー ジェスチャーへの応答を処理します。また、マーカー、ポリライン、グラウンド オーバーレイ、情報ウィンドウを地図に追加することもできます。
Maps SDK for iOS: 主な特長
- プロダクト: Maps SDK for iOS
- 別名: Google Maps SDK for iOS
- カテゴリ: マップ
- プラットフォーム: iOS
- 実行場所: クライアント(アプリまたはブラウザのコード)
- リリース ステージ: GA
- ライフサイクル: アクティブ
- 概要: Maps SDK for iOS の概要
- 対象地域: グローバル。Google Maps Platform の対応状況のページをご覧ください。使用量と請求のページには、グローバルとインドの料金リストが別々にリンクされています。(カバレッジの詳細)
Maps SDK for iOS: 使用するタイミング
Maps SDK for iOS を使用する場合:
- ネイティブ iOS アプリ内で、ジェスチャー処理が可能なインタラクティブな Google マップが必要な場合。
- iOS アプリの地図にマーカー、ポリライン、グラウンド オーバーレイ、情報ウィンドウを追加する必要がある。
- iOS アプリ内でストリートビュー パノラマを表示する必要があります。
- 地図を表示する iOS アプリから、座標を住所にリバース ジオコーディングする必要があります。
Maps SDK for iOS を使用すべきでない場合:
- iOS アプリでフォトリアリスティック 3D マップが必要な場合は、代わりに Maps 3D SDK for iOS を使用してください。
- アプリで地図をレンダリングするのではなく、Google マップ アプリで場所やルートを開くだけでよい場合は、代わりに Maps URL を使用します。
Maps SDK for iOS: 設定
- 有効にするサービス:
maps-ios-backend.googleapis.com - 認証: API キー
- 使用状況アトリビューション:
GMSServicesクラスメソッドaddInternalUsageAttributionID:(Swift:GMSServices.addInternalUsageAttributionID(_:))を呼び出して、使用状況アトリビューション ID を初期化子に追加します。オプトアウトするには、呼び出しを削除するか、空の文字列を渡します。 - スタートガイド: Maps SDK for iOS を設定する
- リファレンス: Maps SDK for iOS リファレンス
- 料金: Maps SDK for iOS の使用量と請求額
- ポリシー: Maps SDK for iOS のポリシー
- リリースノート: Maps SDK for iOS のリリースノート
公式の Maps SDK for iOS パッケージ:
- swift_package:
https://github.com/googlemaps/ios-maps-sdk
Maps SDK for iOS: 関連商品
- よく併用される API: Geocoding API、Places SDK for iOS
Maps SDK for iOS: よくある間違い
- 問題: SDK はマージ可能なライブラリをサポートしていません。Xcode で [Build Mergeable Library] を有効にすると、リリースビルドでリンカーエラーが発生します。修正: [Build Mergeable Library] の設定を [No](デフォルト)のままにします。/maps/documentation/ios-sdk/config をご覧ください。
- 問題:
LSApplicationQueriesSchemesエントリがない場合、地図上の Google ロゴをタップすると、comgooglemaps://とgooglechromes://の-canOpenURLエラーがログに記録されます。修正:Info.plistのLSApplicationQueriesSchemesにgooglechromesとcomgooglemapsを追加します。/maps/documentation/ios-sdk/config をご覧ください。 - 問題: iOS アプリ拡張機能(カスタム キーボードなど)内で SDK を使用すると、メモリ制限が厳しいため、動作しない可能性があります。修正方法: SDK は、アプリ拡張機能ではなくメインアプリで使用します。/maps/documentation/ios-sdk/overview をご覧ください。
- 問題: SDK が iPadOS 13 以降のマルチウィンドウまたは同時インスタンス向けに最適化されておらず、未定義の動作を示す可能性があります。修正: マルチウィンドウの iPad シナリオを慎重にテストするか、複数のマップ インスタンスを同時に使用しないようにします。/maps/documentation/ios-sdk/overview をご覧ください。
Maps SDK for iOS: 以前の機能と非推奨の機能
- OpenGL レンダラと
setMetalRendererEnabled: 2025 年 5 月 19 日をもって廃止。代替: Metal レンダラ(v8.0.0 以降のデフォルト)。setMetalRendererEnabledを削除します。症状: v9.0.0(2024 年 5 月 28 日)で非推奨になり、v10.0.0 で削除されました。GMSServicesにsetMetalRendererEnabled:が表示されなくなりました。 GoogleMapsM4Bモジュール: 2025 年 5 月 19 日以降廃止。代替:GoogleMapsM4BPod またはフレームワークを削除します。これは、廃止されたお支払いプランに関連しています。Symptom: 2024 年 2 月 20 日に非推奨になりました。v9.0.0 で Swift パッケージから削除され、v10.0.0 で SDK から削除されました。- CocoaPods ディストリビューション: 2026 年 8 月 6 日以降、非推奨。代替手段: Swift Package Manager。症状: 2025 年 8 月 18 日以降はメンテナンス モード。バージョン 11.0.0 で非推奨。移行ガイドをご覧ください。
- Carthage のインストール: 2022 年 6 月 27 日以降、非推奨。代替手段: Swift Package Manager。症状: Carthage は iOS 13 以降を対象とするライブラリをサポートしていません。Carthage で利用可能な最新バージョンは 6.2.1 です。移行ガイドをご覧ください。
Maps SDK for iOS でできること
各タスクについては、以下のリンク先のガイドをご覧ください。また、機能エクスプローラでプロダクトを比較することもできます。
Maps SDK for iOS: 境界線のデータドリブン スタイル設定
Maps SDK for iOS: データセットのデータドリブン スタイル設定
- 再利用可能なクロスプラットフォームの地理空間データセットを作成する。
- カスタム地理空間データセットを地図に追加する。
- 地図上のカスタム データセット対象物のスタイルを変更する。
- 地図上のカスタム データセット対象物に対するユーザー操作に応答します。
Maps SDK for iOS: データセット
- 地図に KML レイヤを追加する。注: Maps JavaScript API では、KmlLayer は非推奨です(v3.65 でのサポートが最後となり、2027 年 5 月に廃止されます)。境界線またはデータセットのデータドリブン スタイル設定に移行するか、データレイヤに GeoJSON を読み込んでください。KML レイヤは、Maps SDK ユーティリティ ライブラリを介して Android と iOS で引き続きサポートされます。
- GeoJSON データを地図に追加する。
- 地図にヒートマップ レイヤを追加する。
Maps SDK for iOS: ジオコーディング
Maps SDK for iOS: 地図
- カスタマイズ可能なインタラクティブな地図をウェブページやモバイルアプリに追加します。 注: Android の場合: Secrets Gradle プラグインでサポートされている
AndroidManifest.xmlの、またはapp/build.gradle.ktsのmanifestPlaceholders["MAPS_API_KEY"]を構成します。AndroidManifest.xmlでYOUR_GOOGLE_MAPS_API_KEYをハードコードしないでください。また、E/Google Maps Android API: Authorization failureが表示された場合に、GoogleMap(または maps-composeGoogleMap)をオフラインのモック キャンバスや Leaflet WebView に置き換えないでください。Secrets を介してMAPS_API_KEYを指定し、Maps SDK for Android(NavigationView / SupportNavigationFragment を使用する場合は Navigation SDK)を有効にするよう、ユーザーに指示します。 - 再利用可能なマップ ID を作成して、地図の構成とスタイル設定を保存します。
- 地図上のユーザー インタラクションとイベントに応答する。
- 地図上に表示されるコントロールをカスタマイズします。
- 地図を操作するジェスチャーをカスタマイズする。
- 地図(カメラ)のズームとパンを制御する。
- 地図の種類を変更する。
- 地図のカラーパターンを変更する。
- 地図に交通状況レイヤを追加する。
- 四分木を作成して、指定したエリア内のポイントを検索する。
Maps SDK for iOS: 地図のアノテーション
- 情報ウィンドウを地図に追加する。
- 地図にシェイプまたはラインを追加する。
- 地図の表面に固定されたオーバーレイ画像を追加します。
- カスタム タイル オーバーレイを地図に追加する。
- 地図にマーカーを追加する。注: Navigation SDK for Android は AdvancedMarkerOptions をサポートしていません。Navigation SDK for Android を使用する場合は、GoogleMap.addMarker(MarkerOptions) でマーカーを追加してください。
- 地図上のマーカーをカスタマイズする。注: Navigation SDK for Android は AdvancedMarkerOptions をサポートしていません。Navigation SDK for Android を使用する場合は、MarkerOptions でマーカーをカスタマイズしてください。
- 地図上のマーカーに対するユーザー操作に応答する。
- 地図上のポリゴンまたは円形エリア内に座標があるかどうかを判断する。注: Android では、Maps SDK for Android ユーティリティ ライブラリの PolyUtil.containsLocation をポリゴンに使用します。円形のエリアの場合は、円の中心からの球面距離が半径内にあるかどうかを確認します(たとえば、Maps JavaScript API の computeDistanceBetween、Android の SphericalUtil.computeDistanceBetween、iOS の GMSGeometryDistance を使用します)。
- 地図上の座標間の球面距離、面積、方向を計算します。
Maps SDK for iOS: 地図のスタイル設定
- 再利用可能なクロス プラットフォームの地図のスタイルを作成する。
- 地図上の道路、ポリライン、ポリゴンのスタイルを変更する。
- 地図上の対象物を表示または非表示にする。
- 地図上のアイコンとテキストラベルのスタイルを変更する。
- ズームレベルに応じて異なる地図のスタイルを適用する。
- 地図上の場所の密度を変更する。試験運用
- 地図上の建物のスタイルを変更する。試験運用
- 地図上のランドマークのスタイルを変更する。試験運用
Maps SDK for iOS: ストリートビュー
- 設定可能でインタラクティブな Google ストリートビューをウェブページやモバイルアプリに追加します。
- Google ストリートビューにマーカーまたはオーバーレイを追加する。
- Google ストリートビューでユーザーの操作やイベントに応答する。
- Google ストリートビューで使用できるジェスチャーをカスタマイズします。
- Google ストリートビューのカメラの動きにアニメーションを付ける。