概要

プラットフォームを選択: Android iOS JavaScript ウェブサービス
Places API は、さまざまな方法で位置情報の HTTP リクエストを受け入れるサービスです。施設、地理的位置、有名なスポットに関するフォーマットされた位置データと画像を返します。

Places API(新規)を使用する理由

位置認識機能を作成して、ユーザーが詳細な位置情報データを利用できるようにします。Places API(新版)で利用できるデータは、現実世界の場所モデルの中でも、特に精度と包括性が高くなっています。アプリケーションのユースケースの例を次に示します。

  • 主要大都市圏内のコンドミニアムの賃貸を、都市に特化した結果とともに表示します。
  • 受け取りまたは配達のステータスの更新に場所の詳細を含める。
  • 地域の公園のリストと、ユーザーが投稿した写真やレビューを表示します。
  • 旅行を計画しているユーザーに、沿道の施設の連絡先情報、レビュー、価格帯を提供します。

Places API (New) でできること

Places API(新版)を使用すると、アプリに次の機能を追加できます。

  • テキスト入力、近くの場所、あいまいなユーザー クエリやカテゴリ クエリなど、さまざまなタイプのユーザー クエリから場所の検索結果を提供します。
  • 特定のテキスト クエリまたはカテゴリ クエリなど、さまざまな検索タイプで予測入力機能を有効にします。
  • 場所について返される詳細情報の種類(営業時間、概要、ユーザー レビュー、写真など)を絞り込む。
  • アプリケーションが提供する場所に高画質の写真を追加します。

多くの Google Maps Platform API はプレイス ID をサポートしています。プレイス ID は、Google プレイスのデータベースと Google マップで、特定の場所を一意に識別する ID です。プレイス ID を取得する方法は、Places API(新版)以外にも、Geocoding APIRoutes APIAddress Validation API など、多数あります。

プレイス ID を取得したら、Places API(新規)を使用して、特定の施設やスポットに関する詳細(完全な住所、電話番号、ユーザーの評価、レビューなど)をリクエストできます。

Places API(新版)の仕組み

Places API(新規)は、/placesplaces: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 Photos(新版)などの追加のエンドポイントを使用できます。
1 セットアップする まず、Google Cloud プロジェクトを設定するで設定手順を完了し、API キーの使用方法を学びます。
2 基本的なテキスト検索を試す テキスト検索(新版)を使用してテキスト検索を実行します。
3 プレイス ID を使用して詳細を確認する 多くの Google Maps Platform API は、レスポンスの一部としてプレイス ID を返します。Place ID を使用して Place Details(新版)を取得します。
4 場所の写真を取得する Place Photo(新規)を使用すると、プレイス データベースに保存されている数百万の写真にアクセスできます。Place Photo(新規)を使用して、場所の写真を取得します。