Places API を使用する理由
ユーザーが詳細な位置情報を簡単に利用できるように、位置認識機能を作成します。 Places API で提供されるデータは、現実世界で最も正確で最新かつ包括的な場所モデルの一つです。アプリケーションのユースケースの例を次に示します。
- 大都市圏内の賃貸マンションを、都市をターゲットにした検索結果とともに表示します。
- 受け取りまたは配達ステータスの更新に場所の詳細を含めます。
- ある地域の公園のリストと、ユーザーが投稿した写真やレビューを表示します。
- 旅行を計画している人々に、経路上の施設の連絡先情報、レビュー、価格レベルを提供します。
Places API でできること
Places API を使用すると、アプリケーションに次の機能を含めることができます。
- テキスト入力、付近の場所、あいまいなユーザークエリ、カテゴリカルのユーザークエリなど、さまざまな種類のユーザークエリからプレイス検索結果を提供します。
- さまざまなタイプの検索(特定のテキストクエリまたはカテゴリクエリ)に対してオートコンプリート機能を有効にします。
- 営業時間、概要、ユーザー レビュー、写真など、場所に関して返される詳細情報のタイプを絞り込みます。
- アプリケーションでサービスを提供する場所に高画質の写真を追加します。
多くの Google Maps Platform API ではプレイス ID がサポートされています。プレイス ID は、Google プレイスのデータベースと Google マップで、プレイスを一意に識別する ID です。プレイス ID を取得するには、Places API だけでなく、Geocoding API、Routes API、Address 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(新規)は、/places
や places: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 を使用して、場所の写真にアクセスします。 |