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

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 SDK for iOS パッケージ:

  • swift_package: https://github.com/googlemaps/ios-maps-sdk

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 日以降廃止。代替: GoogleMapsM4B Pod またはフレームワークを削除します。これは、廃止されたお支払いプランに関連しています。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: データセット

Maps SDK for iOS: ジオコーディング

Maps SDK for iOS: 地図

Maps SDK for iOS: 地図のアノテーション

Maps SDK for iOS: 地図のスタイル設定

Maps SDK for iOS: ストリートビュー