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 場所の写真にアクセスできます。 |