Places API（新版）には以下の API が含まれています。
このドキュメントでは、これらの新しい API の概要について説明します。
Place Details（新規）
プレイス ID は、Google プレイスのデータベースおよび Google プレイスで場所を一意に識別する ID です。 Google マップ。プレイス ID を使用して、Place Details (New) リクエストを開始して、特定の店やスポットに関する詳細をリクエストできます。Place Details (New) リクエストは、完全な住所、電話番号、ユーザーの評価、クチコミなど、指定されたプレイスに関する包括的な情報を返します。
プレイス ID を取得する方法はいくつかあります。次を使用できます。
Place Photo（新規）
Place Photo (New) API を使用すると、高品質の写真コンテンツを追加可能 クラウドに保存されている何百万もの写真にアクセスして、 Google プレイスのデータベース。Place Photo (New) API を使用すると、 アプリケーションに最適なサイズに変更できます。
Place Photo（新版）API へのリクエストにはすべて、写真のリソース名、 返される写真を一意に識別します。この写真リソースは 次を使用して名前を指定します。
Place Details（新版）、テキスト検索（新版）、Nearby Search（新版）のリクエストからのレスポンスに写真リソース名を含めるには、リクエストのフィールド マスクに photos フィールドを含める必要があります。
Text Search（新版）と Nearby Search（新版）
Places API には、次の 2 つの検索 API が含まれています。
-
場所を検索するテキスト文字列を指定できます。次に例を示します。 「オーストラリア、シドニーのスパイシー ベジタリアン料理」「近くの高級シーフード レストラン」など Palo Alto, CA"
価格帯、価格帯、価格帯などの詳細を指定することで、 現在の営業状況、評価、特定の場所のタイプなどです。また、 検索結果を特定の地域に限定したり、検索対象を 特定の場所に移動できます
-
検索する地域と場所の種類のリストを指定できます。緯度と経度で定義された円として地域を指定します 中心点の座標と半径（メートル単位）。
プレイスの特性を定義するプレイスタイプを 1 つ以上指定します。たとえば、「
pizza_restaurant」と指定します。と「shopping_mall」から 指定した地域にあるショッピング モールにあるピザレストランを検索する あります。
2 つの検索の主な違いは、Text Search（新規）では任意の検索文字列を指定できること、Nearby Search（新規）では検索する特定のエリアが必要になることです。
予測入力（新）とセッション トークン
Autocomplete (New) は、HTTP リクエストに応じて場所の候補とクエリ予測を返すウェブサービスです。リクエストでは、テキスト 検索文字列と、検索領域を制御する地理的境界です。
セッション トークンはユーザーが生成した文字列で、予測入力（新）の呼び出しを あります。Autocomplete（新規）は、セッション トークンを使用して、予測入力検索でのユーザーのクエリと選択フェーズを、請求処理のために個別のセッションにグループ化します。
新しいフィールド、属性、ユーザー補助オプション
Places API（新版）に、新しいフィールド、属性、ユーザー補助機能オプションが追加されました より詳しい情報をユーザーに提供できます。これらの点については、以降のセクションで説明します。
フィールド
Places API（新版）には、いくつかの新しいフィールドが含まれています。
| フィールド | 説明 |
|---|---|
regularSecondaryOpeningHours |
特定のオペレーションの特定の時間を表します。セカンダリ 営業時間はビジネスのメインの営業時間とは異なります。たとえば、レストランはドライブスルー営業時間やデリバリー営業時間を副業時間として指定できます。 |
paymentOptions |
スポットで利用できるお支払い方法。1 つの場所で複数のお支払い方法を利用できます。支払いオプションのデータを使用できない場合は、
支払いオプションの項目は設定されません。選択できるオプションは次のとおりです。
|
parkingOptions |
施設が提供する駐車場のオプション。選択できるオプションは次のとおりです。
|
subDestinations |
特定の場所に関連する一意の場所。たとえば、空港ターミナルは空港のサブデスティネーションと見なされます。 |
fuelOptions |
利用可能な燃料オプションに関する最新情報は、
ガソリンスタンドこの情報は定期的に更新されます。次のオプションがあります。
|
evChargeOptions |
この充電スタンドにある電気自動車（EV）充電器の数。EV 充電器には複数のコネクタが付いているものもありますが、各充電器で一度に充電できる車両は 1 台のみです。そのため、このフィールドには、特定の時点で利用可能な EV 充電器の数が表示されます。 |
shortFormattedAddress |
人が読める短い場所の住所。 |
primaryType |
指定された結果のプライマリ タイプ。たとえば、場所は cafe または airport に分類されます。
各場所に設定できるプライマリ タイプは 1 つのみです。Google Cloud Platform の
有効な値については、サポートされている型をご覧ください。 |
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 を使用するようにアプリを移行する場合は、次の移行ドキュメントをご覧ください。