Places API を使用する理由
位置認識機能を作成して、ユーザーが詳細な位置情報を簡単に利用できるようにします。Places API で利用できるデータは、現実世界の非常に正確で最新かつ包括的なプレイスモデルの一つで構築されています。アプリケーションのユースケースの例を次に示します。
- 主要都市圏内の賃貸マンションを表示し、特に都市をターゲットに設定した検索結果を表示します。
- 受け取りまたは配達の状況の最新情報に場所の詳細を含める。
- エリア内の公園のリストと、ユーザーが送信した写真やレビューを表示します。
- 旅行を計画している人々に、途中の施設の連絡先情報、クチコミ、価格帯を提供することができます。
Places API でできること
Places API を使用すると、アプリケーションに次の機能を追加できます。
- テキスト入力、付近の場所、あいまいなクエリやカテゴリ型のユーザークエリなど、さまざまなタイプのユーザークエリから Place Search の結果を提供できます。
- 特定のテキストクエリやカテゴリクエリなど、さまざまな検索タイプに対して予測入力機能を有効にします。
- 営業時間、概要、ユーザー レビュー、写真など、場所について返される詳細情報の種類を絞り込みます。
- アプリケーションで配信される場所に高画質の写真を追加します。
多くの Google Maps Platform API はプレイス ID をサポートしています。プレイス ID は、Google プレイスのデータベースや Google マップで、特定の場所を一意に識別するものです。プレイス ID は、Places API だけでなく、Geocoding API、Routes API、Address Validation API などから取得することもできます。
プレイス ID を取得したら、Places API を使用して、特定の施設やスポットに関する詳細情報（完全な住所、電話番号、ユーザーの評価、クチコミなど）をリクエストできます。
Places API のバージョンを選択する
Places API は 2 つの API バージョンをサポートしています。Places API は既存の API で、Places API（新版）は次世代バージョンの API です。
Places API（新版）のリリース時の最初のタスクは、使用する API セットを決めることです。これは、新規のお客様か、すでに API を使用している既存のお客様の場合に該当します。2 つの API の主な違いについては、こちらのガイドをご覧ください。
Places API の仕組み
Places API（新規）
Places API（新版）は、特定のサービス エンドポイント（/places や places:searchText など）を含むリクエストを標準 URL として受け入れ、JSON レスポンスを返します。Places API（新版）は、API キーと OAuth トークンによる認証に対応しています。次の例では、Place Details リクエストを行い、API キーを使ってプレイス 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 の新しいバージョンはありません。 代わりにテキスト検索（新版）に切り替わりました。 |
| Nearby Search | Nearby Search（新版） | Nearby Search（新版）はテキスト入力に対応していないため、テキストクエリを含む既存の API を使用するすべてのリクエストでは、テキスト検索（新版）を使用する必要があります。 |
| テキスト検索 | テキスト検索（新版） | |
| Place Details | Place Details（新規） | |
| Place Photo | Place Photo（新） | |
| Place Autocomplete | 予測入力（新） | |
| Query Autocomplete | 予測入力（新） | 予測入力に追加された機能（新機能） |
Places API の使用方法
以下の手順は、Places API サービスを使用する一般的なユースケースのシナリオを示したものです。ソリューションを構築する際に、Nearby Search や Place Photos などの追加のエンドポイントを使用できます。| 1 | セットアップする | まず Google Cloud プロジェクトをセットアップするから、以下の設定手順を完了してから、API キーの使用方法をご覧ください。Places API（新版）の場合は、OAuth トークンも使用できます。 |
| 2 | 基本的なテキスト検索を試す | テキスト検索（新版）またはテキスト検索を使用して、単純なテキスト検索を行います。 |
| 3 | 場所 ID を使用して詳細情報を確認する | 多くの Google Maps Platform API は、レスポンスの一部としてプレイス ID を返します。プレイス ID を使って、場所の詳細情報を取得します。Place Details（新版）と Place Details をご覧ください。 |
| 4 | 場所の写真の撮影 | Place Photo サービスを使用すると、プレイス データベースに保存されている何百万もの写真にアクセスできます。場所の写真にアクセスするには、Place Photo（新版）または Place Details を使用します。 |