はじめに
Places API は、さまざまなメソッドで位置情報の HTTP リクエストを受け付けるサービスです。施設、地理的位置、有名なスポットなどに関する、フォーマットされた位置データと画像が返されます。Places API（新版）を使用する理由
位置認識機能を作成して、ユーザーが詳細な位置情報データを利用できるようにします。Places API（新版）で利用できるデータは、現実世界の場所モデルの中でも、特に精度と包括性が高くなっています。アプリケーションのユースケースの例を次に示します。
- 大都市圏内のマンションの賃貸物件を表示し、検索結果を特定の都市に絞り込みます。
- 受け取りまたは配達のステータスの更新に場所の詳細を含めます。
- エリア内の公園のリストと、ユーザーが投稿した写真やレビューを表示します。
- 旅行を計画しているユーザーに、ルート沿いの施設の連絡先情報、レビュー、価格帯を提供します。
Places API (New) でできること
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（新版）は、/places や places:searchText などの特定のサービス エンドポイントを含む標準 URL としてリクエストを受け取り、JSON レスポンスを返します。Places API（新版）は、API キーと OAuth トークンによる認可をサポートしています。次の例では、API キーを使用してプレイス ID の住所コンポーネントを返す Place Details（New）リクエストを作成します。
https://places.googleapis.com/v1/places/GyuEmsRBfy61i59si0?fields=addressComponents &key=YOUR_API_KEY
Places API（新版）の使用方法
以下の手順は、Places API サービスを使用する一般的なユースケースのシナリオを対象としています。ソリューションを構築する際は、Nearby Search（新版）や Place Photos（新版）などの追加のエンドポイントを使用できます。| 1 | セットアップする | 設定: 課金を設定し、Places API（新版）を有効にして、最初のリクエストを送信します。 |
| 2 | 基本的なテキスト検索を試す | テキスト検索（新版）を使用してテキスト検索を発行します。 |
| 3 | プレイス ID を使用して詳細情報を取得する | 多くの Google Maps Platform API は、レスポンスの一部としてプレイス ID を返します。プレイス ID を使用して、Place Details（新版）を取得します。 |
| 4 | 場所の写真を取得する | Place Photos (New) を使用すると、プレイス データベースに保存されている数百万枚の写真にアクセスできます。Place Photo (New) を使用して、場所の写真にアクセスします。 |