はじめに
Places SDK for Android を使用すると、ユーザーのデバイスの付近にあるお店やその他の場所に反応する、位置情報認識アプリを構築できます。つまり、ユーザーにとって意味のある場所に基づいてリッチなアプリを構築し、Android 位置情報サービスが提供する単純な地理ベースのサービスを補完できます。
コンセプト
次のインターフェースは、Places SDK for Android への主なエントリ ポイントとなります。
Places
は、ローカル プレイスやビジネス情報に関する Google のデータベース、およびデバイスの現在地にプログラムでアクセスできるようにします。Autocomplete
ユーザーの検索クエリに応じて場所の予測を返す、事前作成されたウィジェットを提供します。
プレイスは、名前が付けられた物理的な空間として定義されます。場所を地図上で見つけられるものと考えることもできます。たとえば、地域のお店やサービス、スポット、地理的位置などです。API では、プレイスは Place
インターフェースで表されます。場所の名前、住所、地理的位置、場所 ID、電話番号、場所の種類、ウェブサイトの URL などの情報が含まれます。
SDK バージョンを選択する
アプリで使用できる Places SDK for Android の機能は、アプリの構成で指定した SDK バージョン番号(3.5.0 など)、API キーで有効にした API、アプリの初期化方法の組み合わせによって決まります。Places SDK for Android と Places SDK for Android(新規)の違いについては、SDK バージョンを選択するをご覧ください。
まず、使用する SDK を決定します。これは、新規のお客様の場合も、すでに SDK を使用している既存のお客様の場合も同様です。2 つの SDK バージョンの主な違いについては、SDK バージョンを選択するをご覧ください。
各 SDK バージョンの料金
有効にする SDK バージョンによって、SDK の使用料金が決まります。Places SDK for Android(新規)は、簡素化された料金モデルをサポートしているため、使用するデータに対してのみ料金が発生します。Places SDK for Android と Places SDK for Android(新規)の両方の料金について詳しくは、使用量と請求額をご覧ください。
API の概要
ユーザーが現在地や周辺の情報を探索できるようにします。
- Place Autocomplete: ユーザーが入力すると、場所の名前や住所が自動的に入力されます。
- Current Place は、ユーザーのデバイスが最後に確認された場所のリストと、各場所の相対的な可能性を返します。
- Place Details は、場所に関するより詳細な情報を返して表示します。
- Text Search は、検索テキスト文字列に基づいて場所を返します。テキスト検索は Places SDK for Android(新規)の一部です。
- Place Photo は、場所の高品質な画像を返します。
- プレイス ID には、1 つ以上の場所の一意の ID が保存され、場所情報をオンデマンドで取得できます。
ポリシーと規約
Places SDK for Android を使用するすべてのアプリは、Google Maps Platform 利用規約、使用と課金、アトリビューションの表示に記載されている要件を遵守する必要があります。