はじめに
Places API は、さまざまな方法で位置情報データの HTTP リクエストを受け付けるサービスです。施設、地理的位置、有名なスポットに関するフォーマット済みの位置情報データと画像が返されます。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（新版）は、/places や places:searchText などの特定のサービス エンドポイントを持つ標準 URL としてリクエストを受け付け、JSON レスポンスを返します。
Places API（新版）は、API キーと OAuth トークンによる認可をサポートしています。
次の例では、API キーを使用してプレイス ID の住所コンポーネントを返す Place Details（新版）リクエストを作成します。
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 | 基本的なテキスト検索を試す | Text Search（新版）を使用してテキスト検索を発行します。 |
| 3 | プレイス ID を使用して詳細情報を取得する | 多くの Google Maps Platform API は、レスポンスの一部としてプレイス ID を返します。プレイス ID を使用して Place Details（新版）を取得します。 |
| 4 | 場所の写真を取得する | Place Photos（新版）を使用すると、プレイス データベースに保存されている数百万の 写真にアクセスできます。Place Photos（新版）を使用して、場所の写真にアクセスします。 |