Places API(新規)を使用する理由
位置認識機能を作成して、ユーザーが詳細な位置情報データを利用できるようにします。Places API(新版)で利用できるデータは、現実世界の場所モデルの中でも、特に精度と包括性が高くなっています。アプリケーションのユースケースの例を次に示します。
- 主要大都市圏内のコンドミニアムの賃貸を、都市に特化した結果とともに表示します。
- 受け取りまたは配達のステータスの更新に場所の詳細を含める。
- 地域の公園のリストと、ユーザーが投稿した写真やレビューを表示します。
- 旅行を計画しているユーザーに、沿道の施設の連絡先情報、レビュー、価格帯を提供します。
Places API (New) でできること
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(新規)は、/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 Photos(新版)などの追加のエンドポイントを使用できます。1 | セットアップする | まず、Google Cloud プロジェクトを設定するで設定手順を完了し、API キーの使用方法を学びます。 |
2 | 基本的なテキスト検索を試す | テキスト検索(新版)を使用してテキスト検索を実行します。 |
3 | プレイス ID を使用して詳細を確認する | 多くの Google Maps Platform API は、レスポンスの一部としてプレイス ID を返します。Place ID を使用して Place Details(新版)を取得します。 |
4 | 場所の写真を取得する | Place Photo(新規)を使用すると、プレイス データベースに保存されている数百万の写真にアクセスできます。Place Photo(新規)を使用して、場所の写真を取得します。 |