概要

プラットフォームを選択: 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 (New) は次世代の API です。

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

Places API の仕組み

Places API(新規)

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

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

Places API

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

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 Text Search (new) Find Place の新しいバージョンはありません。 代替テキストは Text Search(New)に置き換えられました。
Nearby Search Nearby Search(新機能) Nearby Search(New)はテキスト入力をサポートしていないため、テキストクエリを含む既存の API を使用したすべてのリクエストでは、Text Search(New)を使用する必要があります。
テキスト検索 Text Search (new)
Place Details Place Details(新)
場所の写真 場所の写真(新機能)
Place Autocomplete Places API (New) バージョンなし
クエリ オートコンプリート Places API (New) バージョンなし

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(新機能)Place Details をご覧ください。
4 場所の写真を取得する プレイスフォト サービスでは、プレイスのデータベースに保存されている数百万件の写真にアクセスできます。Place Photo(New)または Place Details を使用して、場所の写真にアクセスします。