はじめに
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 バージョンをサポートしています。
Swift 言語を完全にサポートするには、Places Swift SDK for iOS（プレビュー版）を使用します。これは、完全に Swift コードベースで記述された Places SDK for iOS（新規）と同じ API をサポートしています。詳しくは、iOS 向け Places Swift SDK の詳細をご覧ください。
まず、使用する SDK を決定します。これは、新規のお客様の場合も、すでに SDK を使用している既存のお客様の場合も同様です。2 つの SDK バージョンの主な違いについては、SDK バージョンを選択するをご覧ください。
各 SDK バージョンの料金
料金は、選択した SDK のバージョンによって異なります。Places SDK for iOS（新規）は、簡素化された料金モデルをサポートしているため、使用するデータに対してのみ料金が発生します。両方の SDK の料金について詳しくは、使用量と課金をご覧ください。
SDK の概要
Places SDK for iOS を使用すると、ユーザーが現在地や周辺の情報を探索できます。Places SDK for iOS には、次の API が用意されています。
| Places SDK for iOS（新規） | Places SDK for iOS | 説明 |
|---|---|---|
| Place Details（新規） | Place Details | 場所の名前や住所、地理的位置、場所の種類（ナイトクラブ、ペットショップ、美術館など）など、場所に関する情報を返します。 |
| Place Photo (New) | Place Photo | 場所の高品質の画像を返します。 |
| テキスト検索（新規） | テキスト検索に基づいて、一連の場所に関する情報を返します。 | |
| Nearby Search（新規） | 場所を検索エリアとして指定することで、一連の場所に関する情報を返します。 | |
| Autocomplete（新規） | 予測入力 | ユーザーが入力すると、場所の名前や住所が自動的に入力されます。 |
| Current Place | ユーザーのデバイスが最後に確認された場所のリストと、各場所の相対的な可能性の指標を返します。 |
この SDK のその他の主な機能は次のとおりです。
- Wi-Fi スキャンによる低電力の正確な場所の検出。
- デバイス上のキャッシング: iOS 向け Places SDK へのほとんどのリクエストでは Google サーバーとのデータのやり取りが発生しますが、ローカルにデータを 30 日間キャッシュに保存することもできます。
ポリシーと規約
Places SDK for iOS を使用するすべてのアプリは、Google Maps Platform の利用規約と帰属情報の表示に記載されている要件に準拠する必要があります。