Places API(新版)には以下の API が含まれています。
このドキュメントでは、これらの新しい API の概要について説明します。
Place Details(新規)
プレイス ID は、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 (New) からのレスポンスに写真リソース名を含めるには、次の操作を行います。
テキスト検索(新版)または Nearby Search(新版)のリクエストの場合は、
リクエストのフィールド マスクの photos
フィールド。
Text Search(新版)と Nearby Search(新版)
Places API には、次の 2 つの検索 API が含まれています。
-
場所を検索するテキスト文字列を指定できます。次に例を示します。 "オーストラリア、シドニーのスパイシー ベジタリアン料理"「近くの高級シーフード レストラン」など Palo Alto, CA"
価格帯、価格帯などの詳細を指定することで、 現在の営業状況、評価、特定の場所のタイプなどです。また、 検索結果を特定の地域に限定したり、検索対象を 特定の場所に移動できます
-
検索する地域と場所タイプのリストを指定できます。 緯度と経度で定義された円として地域を指定します 中心点の座標と半径(メートル単位)。
場所の特性を定義する場所のタイプを 1 つ以上指定します。 できます。たとえば、「
pizza_restaurant
」と指定します。と「shopping_mall
」から 指定したエリアのショッピング モールにあるピザレストランを検索する あります。
2 つの検索の主な違いは、テキスト検索(新版)では 任意の検索文字列を指定できますが、Nearby Search(新版)では特定の検索文字列が 検索対象領域を指定します
予測入力(新)とセッション トークン
Autocomplete (new) は、場所の候補と結果を返すウェブサービスです。 HTTP リクエストに応答して予測をクエリします。リクエストでは、テキスト 検索文字列と、検索領域を制御する地理的境界です。
セッション トークンはユーザーが生成した文字列で、予測入力(新)の呼び出しを あります。予測入力(新版)では、セッション トークンを使用してクエリをグループ化し、 ユーザー 予測入力の選択フェーズを複数のセッションに分割し、 請求に使用されます。
新しいフィールド、属性、ユーザー補助オプション
Places API(新版)に、新しいフィールド、属性、ユーザー補助機能オプションが追加されました より詳しい情報をユーザーに提供できます。これらの側面は 以下で説明します。
フィールド
Places API(新版)には、いくつかの新しいフィールドが含まれています。
フィールド | 説明 |
---|---|
regularSecondaryOpeningHours |
特定の操作の特定の時間を表します。セカンダリ 営業時間はビジネスのメインの営業時間とは異なります。対象 たとえばレストランの場合はドライブスルーの営業時間や宅配を指定できます サブの営業時間として設定します。 |
paymentOptions |
その場所で利用できる支払い方法。1 つの場所に
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 のお客様で、アプリケーションを 次の移行ドキュメントをご覧ください。