はじめに
Places SDK for Android を使用すると、位置認識アプリを構築して、ユーザーのデバイス付近にあるローカル ビジネスなど、さまざまな場所にコンテキストに応じた応答を提供できます。つまり、ユーザーにとって重要な場所に基づいて機能豊富なアプリを構築し、Android の位置情報サービスによって提供される単純な地理ベースのサービスを補完できます。
概念
次のインターフェースは、Places SDK for Android への主なエントリ ポイントとなります。
Places
は、ローカルの場所、ビジネス情報、デバイスの現在地を含む Google のデータベースにプログラムでアクセスできるようにします。Autocomplete
は、ユーザーの検索クエリに対して場所の予測を返す既製のウィジェットを提供します。
場所とは、名前を持つ物理的な空間のことです。もう一つの場所は、地図上で見つけることができるものだと考えることができます。
たとえば、ローカル ビジネス、スポット、地理的位置などです。API では、場所は Place
インターフェースで表されます。これには、場所の名前と住所、地理的位置、プレイス ID、電話番号、場所のタイプ、ウェブサイトの URL などの情報が含まれます。
SDK のバージョンを選択する
Places SDK for Android バージョン 3.3.0 では、既存の Places SDK for Android と、次世代バージョンの SDK for Android(New)の 2 つの SDK バージョンがサポートされています。
最初のタスクは、使用する SDK を決定することです。これは、新規のお客様、またはすでに SDK を使用している既存のお客様の場合に該当します。2 つの SDK バージョンの主な違いについては、SDK バージョンを選択するをご覧ください。
各 SDK バージョンの料金
Place Details、Text Search、Place Photos の料金は、選択したバージョンの SDK によって管理されます。Places SDK for Android(新機能)は、簡素化された料金モデルをサポートしているため、使用したデータに対してのみ料金が発生します。両 SDK の料金について詳しくは、使用量と課金をご覧ください。
API の概要
ユーザーが今いる場所や周囲のものを簡単に調べられるようにする:
- Place Autocomplete では、ユーザーの入力に応じて場所の名前や住所が自動的に入力されます。
- Current Place は、ユーザーのデバイスが最後に確認された場所のリストと、各場所の相対的な可能性を示すリストを返します。
- Place Details: 場所に関する詳細情報を返して表示します。
- Text Search は、検索テキスト文字列に基づいて場所を返します。Text Search は Places SDK for Android(新機能)の一部です。
- プレイスフォト: 場所の高画質な画像を返します。
- 場所 ID には、場所情報をオンデマンドで取得できるように、1 つ以上の場所の一意の ID が保存されます。
ポリシーと規約
Places SDK for Android を使用するすべてのアプリは、Google Maps Platform 利用規約、使用量と課金、属性の表示に記載されている要件に準拠する必要があります。