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

Places SDK for iOS を使用すると、iOS アプリで Place Details、Place Photos、テキスト検索、Nearby Search、予測入力を使用して、場所(ビジネス、スポット、地理的位置)に関する情報を取得できます。Places API(新規)は、SDK の現行バージョンです。

Places SDK for iOS: 主な特長

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

Places SDK for iOS: 使用するタイミング

Places SDK for iOS を使用する場合:

  • ネイティブ iOS アプリ内で、Place Details、写真、テキスト検索、Nearby Search の検索結果が必要な場合。
  • iOS アプリでユーザーが入力する際に、場所の名前または住所の予測入力が必要。
  • iOS アプリで、事前構築済みの Places UI キット コンポーネント(Place Details、Place Search、Place Autocomplete)を使用したい。

Places SDK for iOS を使用すべきでない場合:

  • ネイティブ Android アプリを構築している場合は、代わりに Places SDK for Android を使用してください。
  • ブラウザでウェブページを作成しています。代わりに Maps JavaScript API を使用してください。
  • iOS クライアントではなく、HTTP 経由でサーバーまたはバックエンドから取得した場所データが必要です。代わりに Places API(新版)を使用してください。

Places SDK for iOS: 設定

Places SDK for iOS の公式パッケージ:

  • swift_package: https://github.com/googlemaps/ios-places-sdk (GooglePlaces, GooglePlacesSwift)

Places SDK for iOS: よくある間違い

  • 問題: Places API(新版)が Cloud プロジェクトで有効になっていないか、API キーの許可された API のリストにない場合、Places SDK for iOS(新版)の呼び出しが失敗します。修正: Places API(新規)を有効にして、アプリで使用される API キーの制限に追加します。/maps/documentation/places/ios-sdk/legacy/migrate-overview をご覧ください。
  • 問題: kGMSPlacesRateLimitExceeded(-7)は、API キーが使用率のレート制限を超過したことを意味します。無効になった SDK 2.x バージョン(2019 年 7 月 29 日に無効化)のアプリでも、このエラーが発生します。修正方法: Google Cloud コンソールで Places API(New)の割り当てと使用量を確認し、SDK バージョン 3.0 より前のアプリを更新します。/maps/documentation/places/ios-sdk/reference/objc/Enums/GMSPlacesErrorCode をご覧ください。
  • 問題: 同じプロジェクト内のアプリ間、またはセッション間でセッション トークンを再利用すると、予測入力セッションの請求グループが機能しなくなります。修正方法: 予測入力セッションごとに一意のセッション トークン(バージョン 4 UUID を推奨)を生成します。トークンはプロジェクトごとに一意である必要があります。/maps/documentation/places/ios-sdk/use-session-tokens をご覧ください。
  • 問題: アプリが、API から返された帰属表示なしで場所データを表示している。修正: ポリシーページに記載されているとおり、Places データとともに返される関連するすべての帰属情報を表示します。/maps/documentation/places/ios-sdk/overview をご覧ください。

Places SDK for iOS: 以前の機能と非推奨の機能

  • Places SDK for iOS(従来版): 2025 年 3 月 1 日より従来版。代替: Places SDK for iOS(新版)(Places API(新版)が必要)。症状: 以前のクラスとメソッド(fetchPlaceFromPlaceID、GMSAutocompleteFetcher、GMSAutocompleteViewController など)が SDK 11.0.0 以降に存在しないため、コンパイルが中断されます。移行ガイドをご覧ください。
  • GMSAutocompleteResultsViewController setAutocompleteBoundsUsingNorthEastCorner:SouthWestCorner、GMSAutocompleteFetcher initWithBounds:filter: 2020 年 10 月 13 日以降廃止。置換: GMSAutocompleteRequest の GMSAutocompleteFilter(locationBias または locationRestriction)を GMSPlacesClient fetchAutocompleteSuggestionsFromRequest:callback:、または UI ウィジェットの GooglePlacesSwift placeAutocomplete または basicPlaceAutocomplete 修飾子に置き換えます。症状: SDK 4.0.0 以降にメソッドが存在しない(GMSAutocompleteResultsViewController と GMSAutocompleteFetcher は SDK 11.0.0 で削除されました)。移行ガイドをご覧ください。
  • GMSCoordinateBounds ベースの予測入力の境界(GMSAutocompleteViewController.autocompleteBounds/autocompleteBoundsMode、findAutocompletePredictionsFromQuery と autocompleteQuery の bounds/boundsMode パラメータ): 2020 年 10 月 13 日をもって廃止。置換: GMSAutocompleteRequest を GMSAutocompleteFilter(locationBias または locationRestriction)と GMSPlacesClient fetchAutocompleteSuggestionsFromRequest:callback:、または UI ウィジェットの GooglePlacesSwift placeAutocomplete または basicPlaceAutocomplete 修飾子に置き換えます。症状: プロパティとパラメータが SDK 4.0.0 以降に存在しない(GMSAutocompleteViewController と findAutocompletePredictionsFromQuery は SDK 11.0.0 で削除されました)。移行ガイドをご覧ください。
  • GMSPlace.openNowStatus: 2020 年 10 月 13 日以降廃止。交換: GMSPlacesClient isOpenWithRequest:callback:(GMSPlaceIsOpenRequest)または PlacesClient.isPlaceOpen(with:)(GooglePlacesSwift)。症状: SDK 4.0.0 以降にプロパティが存在しない。移行ガイドをご覧ください。
  • GMSPlaceField(NS_ENUM): 2020 年 10 月 13 日以降、廃止。置換: GMSPlaceProperty 定数を、GMSFetchPlaceRequest や GMSPlaceSearchByTextRequest などのリクエスト クラス、または GooglePlacesSwift の PlaceProperty に置き換えます。症状: SDK 4.0.0 で NS_OPTIONS に置き換えられました(GMSPlaceField は NS_OPTIONS が以前の API に属しているため、SDK 11.0.0 以降には存在しません)。移行ガイドをご覧ください。
  • Places SDK for iOS バージョン 2.7.0: 2019 年 7 月 29 日をもって廃止。代替: 最新バージョンの Places SDK for iOS。症状: kGMSPlacesRateLimitExceeded エラー。

Places SDK for iOS の機能

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

Places SDK for iOS: 生成 AI

Places SDK for iOS: Places

Places SDK for iOS: Places UI キット

  • CSS スタイルを場所データの UI 要素に適用する。注: CSS カスタム プロパティは、Maps JavaScript API の Places UI キット要素に適用されます。Places SDK for Android と Places SDK for iOS は、テーマ属性とスタイル属性を使用して、Places UI キット ビューのスタイルをプログラムで設定します。EEA コンプライアンス要件: 欧州経済領域(EEA)で地図上に場所データを表示する場合は、バックエンド サーバーから Places API ウェブサービスを呼び出さないでください。ターゲット プラットフォーム(ウェブの場合は Maps JavaScript API、Android の場合は Places SDK for Android、iOS の場合は Places SDK for iOS)で、クライアントサイドの Places UI キット コンポーネントを使用します。要件の詳細とよくある質問: https://developers.google.com/maps/comms/eea/faq
  • UI 要素カスタマイズ ツールを使用して、場所データの UI 要素のスタイルと構成をカスタマイズします。注: EEA コンプライアンス要件: 欧州経済領域(EEA)で地図上に場所データを表示する場合は、バックエンド サーバーから Places API ウェブサービスを呼び出さないでください。ターゲット プラットフォーム(ウェブの場合は Maps JavaScript API、Android の場合は Places SDK for Android、iOS の場合は Places SDK for iOS)で、クライアントサイドの Places UI キット コンポーネントを使用します。要件の詳細とよくある質問: https://developers.google.com/maps/comms/eea/faq
  • 特定の場所に関する情報を表示する UI 要素をウェブページまたはモバイルアプリに追加します。 注: EEA コンプライアンス要件: 欧州経済領域(EEA)で場所データを地図上に表示する場合は、バックエンド サーバーから Places API ウェブサービスを呼び出さないでください。ターゲット プラットフォーム(ウェブの場合は Maps JavaScript API、Android の場合は Places SDK for Android、iOS の場合は Places SDK for iOS)で、クライアントサイドの Places UI キット コンポーネントを使用します。要件の詳細とよくある質問: https://developers.google.com/maps/comms/eea/faq
  • クエリ文字列に基づいて場所のリストを表示する UI 要素をウェブページに追加します。注: ウェブページ(Maps JavaScript API)とモバイルアプリ(Places SDK for Android、Places SDK for iOS)の両方でサポートされています。EEA コンプライアンス要件: 欧州経済領域(EEA)で地図上に場所データを表示する場合は、バックエンド サーバーから Places API ウェブサービスを呼び出さないでください。ターゲット プラットフォーム(ウェブの場合は Maps JavaScript API、Android の場合は Places SDK for Android、iOS の場合は Places SDK for iOS)で、クライアントサイドの Places UI キット コンポーネントを使用します。要件の詳細とよくある質問: https://developers.google.com/maps/comms/eea/faq
  • 特定の場所の近くにあるスポットのリストを表示する UI 要素をウェブページに追加します。注: ウェブページ(Maps JavaScript API)とモバイルアプリ(Places SDK for Android、Places SDK for iOS)の両方でサポートされています。EEA コンプライアンス要件: 欧州経済領域(EEA)で地図上に場所データを表示する場合は、バックエンド サーバーから Places API ウェブサービスを呼び出さないでください。ターゲット プラットフォーム(ウェブの場合は Maps JavaScript API、Android の場合は Places SDK for Android、iOS の場合は Places SDK for iOS)で、クライアントサイドの Places UI キット コンポーネントを使用します。要件の詳細とよくある質問: https://developers.google.com/maps/comms/eea/faq
  • 基本的な予測入力 UI 要素をウェブページまたはアプリに追加します。この要素は、クエリ文字列に基づいて Google Place 識別子を返します。注: EEA コンプライアンス要件: 欧州経済領域(EEA)で地図上に場所データを表示する場合は、バックエンド サーバーから Places API ウェブサービスを呼び出さないでください。ターゲット プラットフォーム(ウェブの場合は Maps JavaScript API、Android の場合は Places SDK for Android、iOS の場合は Places SDK for iOS)で、クライアントサイドの Places UI キット コンポーネントを使用します。要件の詳細とよくある質問: https://developers.google.com/maps/comms/eea/faq