はじめに
Places API（新版）には、次の API が含まれています。
このドキュメントでは、これらの新しい API の概要について説明します。
Place Details（新規）
プレイス ID は、Google プレイスのデータベースと Google マップで、プレイスを一意に識別します。プレイス ID を使用して、Place Details (New) リクエストを開始し、特定の店やスポットに関する詳細をリクエストできます。Place Details（新版）リクエストは、指定の場所に関する包括的な情報（完全な住所、電話番号、ユーザーの評価、レビューなど）を返します。
プレイス ID を取得する方法はいくつかあります。以下を使用できます。
Place Photos（新規）
Place Photo（新規）を使用すると、Google Places データベースに保存されている数百万枚の写真にアクセスして、アプリケーションに高品質な写真コンテンツを追加できます。Place Photos (New) API を使用すると、写真にアクセスして、アプリケーションに最適なサイズに画像のサイズを変更できます。
Place Photos（新版）API へのすべてのリクエストには、返す写真を一意に識別する写真リソース名を含める必要があります。写真のリソース名は、次の方法で取得できます。
Place Details（新版）、テキスト検索（新版）、Nearby Search（新版）リクエストのレスポンスに写真リソース名を含めるには、リクエストのフィールド マスクに photos フィールドを含める必要があります。
テキスト検索（新版）と Nearby Search（新版）
Places API（新版）には、次の 2 つの検索 API が含まれています。
-
場所を検索するテキスト文字列を指定できます。たとえば、「オーストラリアのシドニーにあるスパイシーなベジタリアン料理」や「カリフォルニア州パロアルト近郊の高級シーフード料理」などです。
価格レベル、現在の営業状況、評価、特定の場所の種類などの詳細を指定して、検索を絞り込むことができます。また、特定の場所を優先して結果を表示したり、検索を特定の場所に制限したりすることもできます。
-
場所タイプのリストとともに、検索する地域を指定できます。中心点の緯度と経度の座標、半径（メートル単位）で定義された円として領域を指定します。
場所の特性を定義する 1 つ以上の場所タイプを指定します。たとえば、「
pizza_restaurant」と「shopping_mall」を指定すると、指定した地域のショッピング モールにあるピザレストランを検索できます。
2 つの検索の主な違いは、テキスト検索（新版）では任意の検索文字列を指定できるのに対し、Nearby Search（新版）では検索する特定のエリアが必要になる点です。
Autocomplete（新規）とセッション トークン
Autocomplete (New) は、HTTP リクエストに応じて場所の候補とクエリ予測を返すウェブサービスです。リクエストでは、テキスト検索文字列に加え、検索対象地域を限定する地理的境界を指定します。
セッション トークンは、Autocomplete（新版）呼び出しをセッションとして追跡するユーザー生成の文字列です。Autocomplete（新規）はセッション トークンを使用し、請求処理のために予測入力検索でのユーザーのクエリと選択フェーズを個別のセッションにグループ化します。
新しいフィールド、属性、ユーザー補助オプション
Places API（新版）には、場所に関する詳細情報をユーザーに提供するための新しいフィールド、属性、ユーザー補助オプションが含まれています。これらの側面については、以降のセクションで説明します。
フィールド
Places API (New) には、いくつかの新しいフィールドが含まれています。
| フィールド | 説明 |
|---|---|
regularSecondaryOpeningHours |
特定のオペレーションの特定の時間を記述します。二次的な営業時間は、ビジネスの主な営業時間とは異なります。たとえば、レストランでは、ドライブスルーの営業時間やデリバリーの営業時間を、2 つ目の営業時間として指定できます。 |
paymentOptions |
その場所で利用できるお支払いオプション。1 つの場所で複数のお支払いオプションを利用できます。お支払いオプションのデータが利用できない場合、お支払いオプション フィールドは設定されません。選択できるオプションは次のとおりです。
|
parkingOptions |
施設が提供する駐車場のオプション。選択できるオプションは次のとおりです。
|
subDestinations |
特定の場所に関連するユニークな場所。たとえば、空港ターミナルは空港のサブデスティネーションと見なされます。 |
fuelOptions |
ガソリン スタンドで利用可能な燃料オプションに関する最新情報。この情報は定期的に更新されます。次のオプションがあります。
|
evChargeOptions |
このスタンドにある電気自動車（EV）充電器の数。一部の EV 充電器には複数のコネクタがありますが、各充電器で一度に充電できる車両は 1 台のみです。そのため、このフィールドには、特定の時点で利用可能な EV 充電器の数が反映されます。 |
shortFormattedAddress |
場所の人が読める短い住所。 |
primaryType |
指定された結果のプライマリ タイプ。たとえば、場所は cafe または airport として分類されます。1 つの場所に設定できるプライマリ タイプは 1 つのみです。有効な値の完全なリストについては、サポートされているタイプをご覧ください。 |
primaryTypeDisplayName |
メインのタイプの表示名。該当する場合は、リクエスト言語にローカライズされます。有効な値の完全なリストについては、サポートされているタイプをご覧ください。 |
entrances |
目的地の入り口。エントランスは、場所の出入り口の位置を定義する単一の緯度と経度の座標ペアです。 |
navigationPoints |
目的地のナビゲーション ポイント。ナビゲーション ポイントは、ナビゲーションを終了できる道路の近くの場所です。サポートされている移動手段と用途が含まれます。 |
属性
Places API（新版）には、次のような新しい属性がいくつか含まれています。
| 属性 | 説明 |
|---|---|
outdoorSeating |
テラス席のある場所。 |
liveMusic |
音楽の生演奏が楽しめるお店。 |
menuForChildren |
お子様メニューがある。 |
servesCocktails |
カクテルを提供している。 |
servesDessert |
デザートを提供している。 |
servesCoffee |
コーヒーを提供している。 |
goodForChildren |
子供連れに適しています。 |
allowsDogs |
犬の同伴が可能な場所。 |
restroom |
トイレがある。 |
goodForGroups |
プレイスはグループに対応しています。 |
goodForWatchingSports |
スポーツ観戦に適しています。 |
ユーザー補助機能の設定
Places API（新版）には、次のユーザー補助オプション フィールドが含まれています。
| フィールド | 説明 |
|---|---|
wheelchairAccessibleParking |
車椅子対応の駐車場がある。 |
wheelchairAccessibleEntrance |
車椅子対応の入り口がある。 |
wheelchairAccessibleRestroom |
車椅子対応のトイレがある。 |
wheelchairAccessibleSeating |
車椅子対応の座席がある。 |
AI を活用した要約
Places API（新）の AI を活用した要約では、Gemini モデルの機能を使用して、ユーザーが行き先を決める際に役立つ場所やエリアに関する要約を返します。
AI による概要では、さまざまな入力データが統合され、ユーザーが場所についてより多くの情報に基づいて判断できるようになります。たとえば、新しいレストランを試してみようとしている場合、AI を活用した概要では、一般的なメニューのハイライトが表示されたり、お店の雰囲気がわかったり、ユーザー レビューのテーマがまとめられたりします。新しい街を訪れる場合は、AI を活用した概要で、近くのアトラクションやアメニティの概要を確認できます。
Places API（新版）に AI 搭載機能を追加
AI による要約は、Place Details（新版）、テキスト検索（新版）、Nearby Search（新版）でサポートされています。Places API（新版）のレスポンスでは、次の AI を活用した要約を利用できます。
- 場所の要約。特定の場所に関連する短い概要の要約です。
- クチコミの要約: クチコミ投稿者がその場所について述べた内容をわかりやすくまとめたものです。
- エリアの概要: 周辺エリアにある近くの人気スポットの概要が表示されます。これには、近隣の概要や EV 充電スタンドの概要などが含まれます。
Google は、利用可能な最新の情報に基づいて、これらの要約が常に最新の状態になるように、頻繁に再生成します。Places API（新版）リクエストを行うと、アプリに最新のデータが表示されます。
Places API（新版）に移行する
Places API（レガシー）の既存のお客様で、アプリを移行して Places API（New）を使用する場合は、次の移行に関するドキュメントをご覧ください。
- Place Details（新版）に移行する
- Nearby Search（新版）に移行する
- テキスト検索（新版）に移行する
- Place Photos（新規）に移行する
- Autocomplete（新規）に移行する