Places API（新版）には以下の API が含まれています。
このドキュメントでは、これらの新しい API の概要について説明します。
Place Details（新規）
プレイス ID は、Google プレイスのデータベースと Google マップで、特定の場所を一意に識別する ID です。プレイス ID を使って Place Details (New) リクエストを開始すると、特定の施設やスポットの詳細情報をリクエストできます。Place Details (New) リクエストは、完全な住所、電話番号、ユーザーの評価、クチコミなど、指定された場所に関する包括的な情報を返します。
プレイス ID はさまざまな方法で取得できます。次を使用できます。
Place Photo（新）
Place Photo（新）API を使用すると、Google プレイスのデータベースに保存されている何百万もの写真にアクセスして、高品質の写真コンテンツをアプリケーションに追加できます。Place Photo (New) API を使用すると、写真にアクセスし、アプリケーションに最適なサイズに画像のサイズを変更できます。
Place Photo（新版）API に対するすべてのリクエストに、返される写真を一意に識別する写真のリソース名を含める必要があります。写真のリソース名は次の方法で取得できます。
Place Details（新版）、テキスト検索（新版）、Nearby Search（新版）のリクエストに対するレスポンスに写真リソース名を含めるには、リクエストのフィールド マスクに photos フィールドを含めます。
Text Search（新版）と Nearby Search（新版）
Places API には、次の 2 つの検索 API が含まれています。
-
場所を検索するテキスト文字列を指定できます。たとえば、「オーストラリア、シドニーのスパイシー ベジタリアン料理」、「カリフォルニア州パロアルト近郊の高級シーフード レストラン」などです。
価格レベル、現在の営業状況、評価、特定の場所のタイプなどの詳細を指定して、検索を絞り込むことができます。特定の場所にバイアスをかけたり、検索を特定の地域に制限したりすることもできます。
-
場所タイプのリストとともに、検索する地域を指定できます。地域は、中心点の緯度と経度の座標とメートル単位で定義した円として指定します。
場所の特性を定義する場所のタイプを 1 つ以上指定します。たとえば、指定した地域のショッピング モール内にあるピザレストランを検索するには、「
pizza_restaurant」と「shopping_mall」を指定します。
この 2 つの検索の主な違いは、テキスト検索（新版）では任意の検索文字列を指定できるのに対し、Nearby Search（新版）では検索対象領域を指定する必要がある点です。
予測入力（新）とセッション トークン
Autocomplete (new) は、HTTP リクエストに応じて場所の予測とクエリの予測を返すウェブサービスです。リクエストでは、テキスト検索文字列と、検索領域を制御する地理的境界を指定します。
セッション トークンはユーザーが生成する文字列で、予測入力（新）の呼び出しをセッションとしてトラッキングします。予測入力（新版）では、セッション トークンを使用して、ユーザーの予測入力検索のクエリフェーズと選択フェーズを、請求処理のために個別のセッションにグループ化します。
新しいフィールド、属性、ユーザー補助オプション
Places API（新版）には、場所に関する詳細情報をユーザーに提供するための新しいフィールド、属性、ユーザー補助オプションが含まれています。以降のセクションで、これらの点について説明します。
フィールド
Places API（新版）には、いくつかの新しいフィールドが含まれています。
| 項目 | 説明 |
|---|---|
regularSecondaryOpeningHours |
特定の操作の特定の時間を表します。予備の営業時間は、ビジネスのメインの営業時間とは異なります。たとえば、レストランの場合は、予備の営業時間としてドライブスルーや宅配の営業時間を指定できます。 |
paymentOptions |
その場所で利用できる支払い方法。1 つの場所で複数の支払い方法を利用できる場合があります。支払いオプション データが利用できない場合、支払いオプション フィールドは設定されません。選択できるオプションには次のものがあります。
|
parkingOptions |
その場所が提供する駐車場。選択できるオプションには次のものがあります。
|
subDestinations |
特定の場所に関連するユニークな場所です。たとえば、空港ターミナルは空港のサブ目的地とみなされます。 |
fuelOptions |
ガソリン スタンドで利用できる燃料オプションに関する最新情報。この情報は定期的に更新されます。選択できるオプションには次のものがあります。
|
evChargeOptions |
このステーションの電気自動車（EV）充電器の数。一部の EV 充電器は複数のコネクタを備えていますが、各充電器が一度に充電できる車両は 1 台のみです。そのため、このフィールドにはその時点で利用可能な EV 充電器の数が反映されます。 |
shortFormattedAddress |
人が読める短い場所の住所。 |
primaryType |
指定された結果のメインのタイプ。たとえば、場所は cafe または airport に分類されます。1 つの場所に設定できるプライマリ タイプは 1 つだけです。使用可能な値の一覧については、サポートされている型をご覧ください。 |
primaryTypeDisplayName |
必要に応じてリクエストの言語にローカライズされた、メインのタイプの表示名。使用可能な値の一覧については、サポートされている型をご覧ください。 |
属性
Places API（新版）には、新しい属性がいくつか追加されています。
| 属性 | 説明 |
|---|---|
outdoorSeating |
テラス席あり。 |
liveMusic |
生演奏も楽しめる。 |
menuForChildren |
子供向けメニューがある。 |
servesCocktails |
カクテルを提供する店。 |
servesDessert |
デザートもある。 |
servesCoffee |
コーヒーを提供。 |
goodForChildren |
子ども連れに適した場所です。 |
allowsDogs |
犬の同伴可。 |
restroom |
トイレあり。 |
goodForGroups |
団体客に対応しています。 |
goodForWatchingSports |
スポーツ観戦に適しています。 |
ユーザー補助機能の設定
Places API（新版）には、以下のユーザー補助機能オプション フィールドがあります。
| 項目 | 説明 |
|---|---|
wheelchairAccessibleParking |
車椅子対応の駐車場がある。 |
wheelchairAccessibleEntrance |
この場所には車椅子対応の入り口がある。 |
wheelchairAccessibleRestroom |
車椅子対応のトイレがある。 |
wheelchairAccessibleSeating |
車椅子対応の座席がある。 |
新しい Places API への移行
すでに Places API をご利用で、新しい API を使用するようにアプリを移行する場合は、以下の移行に関するドキュメントをご覧ください。