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 では、2 つのバージョンの API がサポートされています。Places API は既存の API で、Places API(新機能)は次世代の API です。
Places API(New)のリリースに伴い、最初に行う作業は、使用する API のセットを決定することです。これは、新規のお客様またはすでに API を使用しているお客様の場合に該当します。2 つの API の主な違いについては、こちらのガイドをご覧ください。
Places API の仕組み
Places API(新規)
Places API(新規)は、特定のサービス エンドポイント(/places
や places:searchText
など)を含む標準 URL としてリクエストを受け入れ、JSON レスポンスを返します。Places API (new) は、API キーと OAuth トークンによる認証をサポートしています。次の例では、API キーを使用してプレイス ID の住所コンポーネントを返す Place Details リクエストを作成します。
https://places.googleapis.com/v1/places/GyuEmsRBfy61i59si0?fields=addressComponents &key=YOUR_API_KEY
Places API
Places API は、/place
や /photo
などの特定のサービス エンドポイントを含む標準 URL としてリクエストを受け入れます。エンドポイントは、リクエストで指定された形式(JSON または XML)も受け入れます。サービス リクエストは、その特定のエンドポイントに関連するパラメータを使用して、返されるデータを絞り込むことができます。次の例では、プレイス ID の住所コンポーネントを JSON 形式で返す Place Details リクエストを作成します。
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 | Text Search(新規) | Find Place の新しいバージョンはありません。 Text Search (New) に置き換わりました。 |
Nearby Search | Nearby Search(新機能) | Nearby Search(New)はテキスト入力に対応していないため、既存の API を使用したテキストクエリを含むリクエストでは、すべて Text Search (New) を使用する必要があります。 |
テキスト検索 | Text Search(新規) | |
Place Details | Place Details(新規) | |
場所の写真 | 場所の写真(新規) | |
Place Autocomplete | Places API (New) バージョンがない | |
クエリのオートコンプリート | Places API (New) バージョンがない |
Places API の使用方法
以下では、Places API サービスを使用する一般的なユースケースについて説明します。ソリューションを構築するときに、Nearby Search や Place Photos など、追加のエンドポイントを使用できます。1 | セットアップする | Google Cloud プロジェクトの設定から始めて、設定手順を完了して、API キーの使用方法を学びましょう。Places API (New) では、OAuth トークンも使用できます。 |
2 | 基本的なテキスト検索を試す | Text Search (New) またはText Search を使用して単純なテキスト検索を行います。 |
3 | 場所 ID を使用して詳細を確認する | 多くの Google Maps Platform API では、レスポンスの一部としてプレイス ID が返されます。プレイス ID を使って、場所に関する詳細情報を取得します。 Place Details (New) と Place Details をご覧ください。 |
4 | 場所の写真を撮る | プレイス写真サービスを使用すると、プレイスのデータベースに保存されている数百万件の写真にアクセスできます。場所の写真にアクセスするには、Place Photo (New) または Place Details を使用します。 |