このページは Cloud Translation API によって翻訳されました。

概要

プラットフォームを選択: Android iOS JavaScript ウェブサービス

欧州経済領域（EEA）のデベロッパー

はじめに

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 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（新規）を使用して、場所の写真を表示します。