概要

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

Places API を使用するメリット

ユーザーが詳細な位置情報を簡単に利用できるように、位置認識機能を作成します。Places API で提供されるデータは、現実世界の最も正確で最新かつ包括的な場所モデルの一つ上に構築されています。アプリケーションのユースケースの例を次に示します。

  • 大都市圏内のマンション賃貸物件を、都市をターゲットとした検索結果とともに表示します。
  • 受け取りまたは配達のステータスの更新に場所の詳細を含めます。
  • ユーザーが投稿した写真やレビューとともに、ある地域にある公園のリストを表示します。
  • 旅行を計画している人々に、途中の施設の連絡先情報、レビュー、価格レベルを提供しましょう。

Places API でできること

Places API を使用すると、アプリケーションに次の機能を含めることができます。

  • テキスト入力、付近の場所、あいまいなクエリやカテゴリ的なユーザークエリなど、さまざまな種類のユーザークエリからプレイス検索結果を提供します。
  • さまざまなタイプの検索(特定のテキストクエリまたはカテゴリクエリ)に対してオートコンプリート機能を有効にします。
  • ある場所について返される詳細情報(営業時間、概要、ユーザーのクチコミ、写真など)を絞り込みます。
  • アプリケーションで提供する場所に高画質の写真を追加します。

多くの Google Maps Platform API はプレイス ID をサポートしています。プレイス ID は、Google プレイスのデータベースと Google マップで、プレイスを一意に識別する ID です。プレイス ID を取得する方法は、Places API から取得するだけでなく、Geocoding APIRoutes APIAddress Validation API から取得することもできます。

プレイス ID を取得したら、Places API を使用して、特定の施設やスポットに関する詳細情報(完全な住所、電話番号、ユーザーの評価、クチコミなど)をリクエストできます。

Places API のバージョンを選択する

Places API では、2 つの API バージョンがサポートされています。Places API は既存の API で、Places API(新規)は次世代バージョンの API です。

Places API(New)のリリースでは、まず使用する API のセットを決定します。これは、新規のお客様、またはすでに API を使用している既存のお客様の場合に該当します。2 つの API の主な違いについては、こちらのガイドをご覧ください。

Places API の仕組み

Places API(新規)

Places API(新規)は、/placesplaces:searchText などの特定のサービス エンドポイントを含む標準 URL としてリクエストを受け入れ、JSON レスポンスを返します。Places API(新規)は、API キーと OAuth トークンによる認証をサポートしています。次の例では、API キーを使用して Place Details リクエストを作成し、プレイス ID の住所コンポーネントを取得しています。

https://places.googleapis.com/v1/places/GyuEmsRBfy61i59si0?fields=addressComponents&key=YOUR_API_KEY

Places API

Places API は、/place/photo などの特定のサービス エンドポイントを含む標準の URL としてリクエストを受け入れます。エンドポイントは、リクエストで指定された形式(JSON または XML)の形式も受け入れます。サービス リクエストでは、その特定のエンドポイントに関連するパラメータを使用して、返されるデータを絞り込むことができます。次の例では、Place Details リクエストを作成し、プレイス ID の住所コンポーネントを 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 で利用できるリソースをまとめたものです。

Places API Places API(新規)
Find Place テキスト検索(新) Find Place の新しいバージョンはありません。 Text Search (New) に置き換わりました。
Nearby Search Nearby Search(New) Nearby Search(New)はテキスト入力をサポートしていないため、テキストクエリを含む既存の API を使用するすべてのリクエストでは、Text Search (New) を使用する必要があります。
テキスト検索 テキスト検索(新)
Place Details Place Details(New)
Place Photo Place Photo(New)
Place Autocomplete オートコンプリート(新) プレビュー版
クエリ オートコンプリート オートコンプリート(新) オートコンプリートのプレビュー版に追加された機能(新機能)

Places API の使用方法

以下の手順は、Places API サービスの使用の一般的なユースケース シナリオです。ソリューションを構築する際に、Nearby Search や Place Photos などの追加エンドポイントを使用できます。
1 セットアップする Google Cloud プロジェクトをセットアップするから始めて、以下の設定手順を完了してから、API キーの使用方法を学びます。Places API(New)では、OAuth トークンも使用できます。
2 基本的なテキスト検索を試す Text Search (New) または Text Search を使用して単純なテキスト検索を実行します。
3 場所 ID を使って詳細を確認する 多くの Google Maps Platform API は、レスポンスの一部としてプレイス ID を返します。プレイス ID を使って、場所の詳細を取得できます。 Place Details (New)Place Details をご覧ください。
4 場所の写真を取得する プレイスフォト サービスでは、プレイス データベースに保存されている数百万件の写真にアクセスできます。場所の写真にアクセスするには、Place Photo (New) または Place Details を使用します。