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 や places:searchText などの特定のサービス エンドポイントを含む標準 URL としてリクエストを受け取り、JSON レスポンスを返します。Places API（新規）は、API キーと OAuth トークンによる認可をサポートしています。次の例では、Place Details リクエストを実行して、API キーを使用して Place ID の住所コンポーネントを返します。
https://places.googleapis.com/v1/places/GyuEmsRBfy61i59si0?fields=addressComponents &key= YOUR_API_KEY
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 | Autocomplete（新規） | |
| クエリの自動補完 | Autocomplete（新規） | Autocomplete（新規）に追加された機能 |
Places API の使用方法
以下の手順は、Places API サービスの一般的なユースケース シナリオを説明しています。ソリューションを構築する際には、Nearby Search や Place Photos などの追加のエンドポイントを使用できます。| 1 | セットアップする | まず、Google Cloud プロジェクトを設定するで、続く設定手順を完了してから、API キーの使用方法を学びます。Places API（新版）では、OAuth トークンを使用することもできます。 |
| 2 | 基本的なテキスト検索を試す | Text Search（新版）または Text Search を使用してテキスト検索を実行します。 |
| 3 | プレイス ID を使用して詳細を確認する | Google Maps Platform の多くの API は、レスポンスの一部としてプレイス ID を返します。プレイス ID を使用して、場所の詳細を取得します。Place Details（新版）と Place Details をご覧ください。 |
| 4 | 場所の写真を取得する | Place Photo サービスを使用すると、プレイス データベースに保存されている数百万の写真を利用できます。Place Photo（新版）または Place Details を使用して、場所の写真にアクセスします。 |