はじめに
Places SDK for iOS を使用すると、デバイスの周辺にあるローカル ビジネスなどの場所に応じて状況に応じた応答を行う位置認識アプリを構築できます。つまり、ユーザーにとって意味のある場所に基づいて、リッチなアプリを構築できます。
概念
場所とは、名前を持つ物理的な空間のことです。もう一つの場所は、地図上で見つけられる場所であるということです。たとえば、ローカル ビジネス、スポット、地理的位置などです。API では、場所は GMSPlace Class Reference で表されます。これには、場所の名前と住所、地理的位置、プレイス ID、電話番号、場所のタイプ、ウェブサイトの URL などの情報が含まれます。
SDK のバージョンを選択する
Places SDK for iOS バージョン 9.0.0 は、既存の Places SDK for iOS と、次世代の SDK である Places SDK for iOS（新規）の 2 つの SDK バージョンをサポートしています。
最初のタスクは、使用する SDK を決定することです。これは、新規のお客様、またはすでに SDK を使用している既存のお客様の場合に該当します。2 つの SDK バージョンの主な違いについては、SDK バージョンを選択するをご覧ください。
各 SDK バージョンの料金
料金は、選択したバージョンの SDK によって決まります。Places SDK for iOS（新）では、簡素化された料金モデルがサポートされているため、使用したデータに対してのみ料金が発生します。両方の SDK の詳細な料金情報については、使用量と請求額をご覧ください。
GooglePlacesSwift のプレビュー リリース
このリリースには、GooglePlacesSwift バージョン 0.1.0 のプレビュー リリースが含まれています。GooglePlacesSwift では、Places SDK for iOS（新）のすべての API をはじめ、新しい Swift インターフェースを使って Place API を呼び出せます。
- Place Autocomplete（新）
- Place Details（新規）
- 場所の写真（New）
- テキスト検索（新版）
- Nearby Search（New）
GooglePlacesSwift の要件:
- 自分の API キーで Places API (New) を有効にすることができます。詳細については、Google Cloud プロジェクトを設定するをご覧ください。
- Xcode 15.3
詳しくは、GooglePlacesSwift API リファレンスをご覧ください。
SDK の概要
Places SDK for iOS を使用すると、ユーザーが現在地や周辺の情報を探索しやすくなります。Places SDK for iOS には次の API が用意されています。
| Places SDK for iOS（新規） | Places SDK for iOS | 説明 |
|---|---|---|
| Place Details（New） | Place Details | 場所の名前と住所、地理的位置、場所の種類（ナイトクラブ、ペットショップ、博物館など）など、場所に関する情報を返します。 |
| Place Photo（New） | Place Photo | 場所の高画質の画像を返します。 |
| テキスト検索（新） | テキスト検索に基づいて、一連の場所に関する情報を返します。 | |
| Nearby Search（New） | 場所を検索領域として指定して、場所のセットに関する情報を返します。 | |
| オートコンプリート（新） | 予測入力 | ユーザーの入力に応じて場所の名前や住所を自動的に入力します。 |
| Current Place | ユーザーのデバイスが最後に確認された場所のリストと、それぞれの場所の相対的な可能性を示すリストを返します。 |
SDK のその他の特長は次のとおりです。
- Wi-Fi スキャンによる低電力での正確な場所検出。
- デバイス上のキャッシュ保存: Places SDK for iOS へのリクエストのほとんどは、Google サーバーへのラウンド トリップを伴う場合がありますが、データを 30 日間ローカルにキャッシュ保存することもできます。
ポリシーと規約
Places SDK for iOS を使用するアプリケーションはすべて、Google Maps Platform 利用規約と帰属表示に記載されている要件に準拠する必要があります。