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（新規）は、/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 サービスの一般的なユースケース シナリオを説明しています。ソリューションを構築する際には、Nearby Search（新版）や Place Photo（新版）などの追加のエンドポイントを使用できます。| 1 | セットアップする | まず、Google Cloud プロジェクトを設定するで、続く設定手順を完了してから、API キーの使用方法を学びます。 |
| 2 | 基本的なテキスト検索を試す | テキスト検索（新版）を使用してテキスト検索を実行します。 |
| 3 | プレイス ID を使用して詳細を確認する | 多くの Google Maps Platform API は、レスポンスの一部としてプレイス ID を返します。Place ID を使用して Place Details（新版）を取得します。 |
| 4 | 場所の写真を取得する | Place Photo（新規）サービスを使用すると、プレイス データベースに保存されている数百万の写真にアクセスできます。Place Photo（新規）を使用して、場所の写真を表示します。 |