Places API を使用する理由
位置認識機能を作成して、ユーザーが詳細な位置情報を簡単に利用できるようにします。 Places API で利用できるデータは、精度が高く、 現実世界のさまざまな場所のモデルを 提供しますアプリケーションのユースケースの例を次に示します。
- 大都市圏内の賃貸マンションを表示し、特に都市をターゲットに設定した検索結果を表示します。
- 受け取りまたは配達の状況の最新情報に場所の詳細を含める。
- エリア内の公園のリストと、ユーザーが送信した写真やレビューを表示します。
- 旅行を計画している人々に、途中の施設の連絡先情報、クチコミ、価格帯を提供することができます。
Places API でできること
Places API を使用すると、 アプリケーション:
- テキスト入力、入力テキスト、入力テキスト、 あいまいなまたはカテゴリーのユーザーのクエリに対しても役立ちます。
- さまざまな検索タイプ、特定のテキストクエリに対して予測入力機能を有効にする クエリを作成できます
- 営業時間、概要、営業時間など、場所について返される詳細情報の種類を絞り込みます。 ユーザーレビュー、写真などがあります
- アプリケーションで配信される場所に高画質の写真を追加します。
多くの 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（新版）では、標準の URL として、
サービス エンドポイント（/places、places:searchText など）
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 は、標準の URL としてリクエストを受け付け、
サービス エンドポイント（/place や /photo など）。エンドポイントは
リクエストで指定された形式のタイプ（JSON または XML）を受け入れます。サービス
リクエストは、その特定のエンドポイントに関連するパラメータを使用して、返されるデータを絞り込みます。
次のサンプルは、Place Details リクエストを実行して、
JSON 形式のプレイス ID:
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（新版） | テキストクエリを含む既存の API を使用するすべてのリクエストで、 テキスト検索（新版） Nearby Search（新版）はテキスト入力に対応していないためです。 |
| テキスト検索 | テキスト検索（新版） | |
| 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 を返します。こちらの 場所の詳細を取得することもできます。 Place Details（新版）と Place Details をご覧ください。 |
| 4 | 場所の写真の撮影 | プレイスフォトサービスでは、プレイスに保存されている数百万もの写真にアクセスできます。 データベースですPlace Photo (New) を使用 または Place Details 場所の写真にアクセスできます。 |