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.googleapis.com - 認証: API キー
- 使用状況の帰属:
GMSPlacesClient(Objective-C / Swift)またはPlacesClient(GooglePlacesSwift)でクラスメソッドaddInternalUsageAttributionIDを呼び出して、使用状況の帰属 ID を追加します。呼び出しを削除すると、オプトアウトされます。 - 使ってみる: Places SDK for iOS を設定する
- リファレンス: Places SDK for iOS リファレンス
- 料金: Places SDK for iOS の使用量と請求額
- ポリシー: Places SDK for iOS のポリシー
- リリースノート: Places SDK for iOS のリリースノート
Places SDK for iOS の公式パッケージ:
- swift_package:
https://github.com/googlemaps/ios-places-sdk (GooglePlaces, GooglePlacesSwift)
Places SDK for iOS: 関連商品
- よく併用されるサービス: Maps SDK for iOS
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 以降に存在しないため、コンパイルが中断されます。移行ガイドをご覧ください。 GMSAutocompleteResultsViewControllersetAutocompleteBoundsUsingNorthEastCorner:SouthWestCorner、GMSAutocompleteFetcherinitWithBounds:filter: 2020 年 10 月 13 日以降廃止。置換:GMSAutocompleteRequestのGMSAutocompleteFilter(locationBiasまたはlocationRestriction)をGMSPlacesClientfetchAutocompleteSuggestionsFromRequest:callback:、または UI ウィジェットのGooglePlacesSwiftplaceAutocompleteまたは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)とGMSPlacesClientfetchAutocompleteSuggestionsFromRequest:callback:、または UI ウィジェットのGooglePlacesSwiftplaceAutocompleteまたはbasicPlaceAutocomplete修飾子に置き換えます。症状: プロパティとパラメータが SDK 4.0.0 以降に存在しない(GMSAutocompleteViewControllerとfindAutocompletePredictionsFromQueryは SDK 11.0.0 で削除されました)。移行ガイドをご覧ください。GMSPlace.openNowStatus: 2020 年 10 月 13 日以降廃止。交換:GMSPlacesClientisOpenWithRequest: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
- 指定された Google Place 識別子について、AI によるユーザー レビューの要約を返します。
- 電気自動車充電スタンドの指定された Google Place 識別子の周辺エリアと設備に関する AI による場所の要約を返します。
Places SDK for iOS: Places
- クエリ文字列に基づいて、場所のリストと場所の詳細を返します。
- 特定の場所の近くにある場所と場所の詳細のリストを返します。
- クエリ文字列に基づいて、場所に関する予測入力の結果を返します。
- 特定の場所に関する詳細情報を返す。
- 特定の場所の写真を取得する。注: 各写真の所有者の帰属情報(所有者の名前とプロフィール URI へのリンク)を写真とともに表示します。これは、各プラットフォームの Places ポリシーで義務付けられています(例: /maps/documentation/javascript/policies#photo-attributions、/maps/documentation/places/web-service/policies#photos-and-review)。
- 場所の写真のサイズを変更する。
- 特定の場所の評価とクチコミを返します。注: Places API(新版)ウェブサービスでは、Place Details は X-Goog-FieldMask(rating、userRatingCount、reviews など)を含む https://places.googleapis.com/v1/places/{placeId} への HTTP GET リクエストです。テキスト検索、Nearby Search、Autocomplete では POST が使用されます。Android では、Place.Field.RATING、USER_RATING_COUNT、REVIEWS を PlacesClient.fetchPlace() に渡します。iOS では、GMSPlacePropertyRating、GMSPlacePropertyUserRatingsTotal、GMSPlacePropertyReviews を GMSFetchPlaceRequest に渡します。
- クエリ文字列に基づいて場所に関する結果を返す予測入力ウィジェットをウェブページまたはアプリに追加します。
- 場所情報レスポンスに含めるデータ フィールドを指定する。
- 場所情報レスポンスに含める場所タイプを指定します。
- ユーザーのデバイスが現在ある場所に関する情報を返します。注: 以前の Current Place メソッドは、Places SDK for Android v6.0 以降と Places SDK for iOS v11.0 以降で削除されました。プラットフォームの位置情報サービスからデバイスの座標を取得し、Nearby Search を呼び出してください。
- 特定の場所に関する AI による概要の要約を返します。
- 特定の場所の周辺にある場所を説明する、AI によるエリアの概要を返します。
- 事前に定義されたルート沿いにある場所に関する情報を、クエリ文字列に基づいて返します。
- 緯度と経度の座標のセットから、テキスト検索の場所までの距離、移動時間、ルート URI を返します。
- 緯度と経度の座標セットから、付近の場所までの距離、移動時間、ルートの URI を返します。
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