概要

プラットフォームを選択: Android iOS JavaScript ウェブサービス
Places API は、さまざまな方法で位置情報の HTTP リクエストを受け付けるサービスです。これにより、フォーマットされた位置情報と、施設、地理的位置、有名なスポットに関する画像が返されます。

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 のレスポンステキスト検索のレスポンスをご覧ください。

  • JSON
  • XML
Place Details ユーザーのクチコミなど、特定の場所に関する詳細情報を返します。

詳しくは、Place Details のレスポンスをご覧ください。

  • JSON
  • XML
場所の写真 Google のプレイス データベースに保存されている数百万件の場所関連の写真にアクセスできます。

詳しくは、プレイスの写真レスポンスをご覧ください。

  • JSON
  • XML
Place Autocomplete ユーザーの入力に応じて、場所の名前や住所を自動的に入力します。

詳しくは、Place Autocomplete のレスポンスをご覧ください。

  • JSON
  • XML
Query Autocomplete テキストベースの地理的検索用のクエリ予測サービスを提供し、ユーザーの入力に応じて推奨クエリを返します。

詳しくは、クエリに対するオートコンプリートのレスポンスをご覧ください。

  • JSON
  • XML

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 クライアント、Python クライアント、Go クライアント、Node.js クライアントは、コミュニティがサポートするクライアント ライブラリであり、Apache 2.0 ライセンスの下でオープンソース化されています。GitHub からインストールしてください。GitHub にはインストール手順とサンプルコードも掲載されています。

次のステップ