Places API を使用する理由
位置認識機能を作成して、詳細な位置情報データをユーザーが簡単に利用できるようにします。Places API を通じて取得されるデータは、正確かつ最新かつ包括的な場所モデルに基づいて作成されています。アプリケーションのユースケースの例を次に示します。
- 主要都市圏の賃貸マンションを表示します。検索結果は都市をターゲットにしています。
- ピックアップまたは配送ステータスの更新に場所の詳細を含めます。
- エリア内の公園のリストと、ユーザーが投稿した写真やクチコミを確認できます。
- 旅の計画段階にいる旅行者に、連絡先情報、レビュー、料金レベルを提供します。
Places API でできること
Places API を使用すると、アプリケーションに以下の機能を含めることができます。
- テキスト入力、周辺の場所、不明瞭またはカテゴリーのユーザークエリなど、さまざまな種類のユーザークエリからプレイスの検索結果を提供します。
- さまざまな検索タイプ(特定のテキストクエリまたはカテゴリクエリ)でオートコンプリート機能を有効にする。
- 営業時間、概要、ユーザーのクチコミ、写真など、場所に関して表示される詳細情報の種類を絞り込みます。
- アプリケーションでサービスを提供する場所に高画質の写真を追加します。
Places API の仕組み
Places API は、特定のサービス エンドポイント(/place
や /photo
など)を含む標準 URL としてリクエストを受け入れます。エンドポイントは、リクエストで指定された形式(JSON または XML)を受け入れます。最後に、サービス リクエストはその特定のエンドポイントに関連するパラメータを使用して、返されるデータを絞り込みます。たとえば、住所コンポーネントに対する次の Place Details リクエストは、JSON 形式の戻り値を前提としています。
https://maps.googleapis.com/maps/api/place/details/json ?place_id=ChIJrTLr-GyuEmsRBfy61i59si0 &fields=address_components &key=YOUR_API_KEY
この場合、サービスは指定された場所 ID を使用してリクエストされた場所を探し、JSON 形式で住所コンポーネントを返します。
リソース
次の表は、Places API で利用可能なリソースと返されるデータをまとめたものです。
データリソース | 返されたデータ | 戻り値の形式 |
---|---|---|
Place Search | デバイスの位置情報または検索文字列に基づいて、場所のリストを返します。 詳しくは、Place Search のレスポンス、Nearby Search のレスポンス、テキスト検索のレスポンスをご覧ください。 |
|
Place Details | ユーザーのクチコミなど、特定の場所に関する詳細情報を返します。 詳しくは、Place Details のレスポンスをご覧ください。 |
|
場所の写真 | Google のプレイス データベースに保存されている数百万件の場所関連の写真にアクセスできます。 詳しくは、プレイスの写真レスポンスをご覧ください。 |
|
Place Autocomplete | ユーザーの入力に応じて、場所の名前や住所を自動的に入力します。 詳しくは、Place Autocomplete のレスポンスをご覧ください。 |
|
Query Autocomplete | テキストベースの地理的検索用のクエリ予測サービスを提供し、ユーザーの入力に応じて推奨クエリを返します。
詳しくは、クエリに対するオートコンプリートのレスポンスをご覧ください。 |
|
Places API の使用方法
以下では、Places API サービスで 3 つのエンドポイントを使用する一般的なユースケース シナリオについて説明します。ソリューションを構築する場合、Nearby Search、Place Photos、Query Autocomplete などの追加のエンドポイントを使用できます。1 | セットアップする | Google Cloud プロジェクトの設定から始め、以下の設定手順を完了してから、API キーの使用方法をご覧ください。 |
2 | 基本的なテキスト検索を試す | API キーを取得したら、テキスト検索ガイドの基本的なテキスト検索の例に示すように、シンプルなテキスト検索を発行します。 |
3 | Find Place リクエストを使用する | Find Place リクエストでは、場所 ID に加え、リクエストされたデータ フィールド(営業時間、住所、写真など)が返されます。Find Place の例 をご覧になり、ユースケースに関連するものをお試しください。 |
4 | Find Place のレスポンスの基本を理解する | Find Place レスポンスから返されたデータを確認します。詳しくは、場所の回答を検索するをご覧ください。 |
5 | 場所 ID を使用して詳細を表示する | Find Place のレスポンスでは、特定の場所のすべてのデータを利用できるわけではありません。Find Place レスポンスから返されたプレイス ID を使用すると、プレイスの詳細情報を取得できます。Place Details をご覧ください。 |
利用可能なクライアント ライブラリ
次のいずれかのクライアント ライブラリを使用して、選択した言語でこの API を呼び出します。
- Google マップ サービス向け Java クライアント
- Google マップ サービス向け Python クライアント
- Google マップ サービス向け Go クライアント
- Google マップ サービス向け Node.js クライアント
Google マップ サービス向けの Java クライアント、Python クライアント、Go クライアント、Node.js クライアントは、コミュニティがサポートするクライアント ライブラリであり、Apache 2.0 ライセンスの下でオープンソース化されています。GitHub からインストールしてください。GitHub にはインストール手順とサンプルコードも掲載されています。
次のステップ
- Places API 検索の使用を開始する: Place Search に移動します。
- API キーを取得する: API キーの使用をご覧ください。