加值資料

針對擁有舊版 Google Maps APIs for Work 或 Google Maps API for Business 授權的客戶,Google Places API 是作為 Google Places API for Work 的一部分而購買的。 本節介紹如何啟用該 API 的加值資料。

總覽

Google Places API Web Service 可讓您存取針對數以千計的餐廳、酒吧和全球其他位置的評分與評論。 透過加值資料功能,您可以經由程式設計的方式,存取作為 Google Places API Web Service 一部分的增強型評論資料。

啟用加值資料後,您會收到額外內容,例如30 分的分值、詳細的數值評分,以及評論摘要(如果有的話)。

加值資料功能基於現有的 Google Places API Web Service。 請參考開發人員文件來取得更多資訊。

啟用

在開始之前,您必須持有能存取 Google Places API Web Service 加值資料的帳戶。 啟用您的帳戶後,包含您金鑰的查詢便能存取增強型評論資料與評分。

回應的詳細程度在地點搜尋要求和地點詳細資料要求之間有所不同。

您可以依照下列步驟來驗證您的帳戶是否已在 Google API Console 中啟用。

  1. 造訪 Google API Console,並使用您的 Google 帳戶登入。
  2. 選取在您註冊時為您建立的專案。 專案名稱將會以 Google Maps APIs for Business or Google Maps for Work or Google Maps 做為開頭。

  3. 在「Enabled APIs」清單中,應啟用「Places API - Zagat Content」服務。

Google Places API Web Service 服務則應停用

如果您想存取加值資料,但您的專案尚未啟用它,請聯絡您的客戶經理。

加值資料功能

注意:加值資料目前僅可於 Google Places API Web Service 取得。 Google Maps JavaScript API 地方資訊程式庫中並未提供此資料。

地點搜尋

除了標準回應欄位之外,Google Places API for Work 客戶還可能收到下列欄位。 這些欄位將顯示為 result 欄位的頂層子項。

  • aspects已淘汰)包含單一的 AspectRating 物件,用來做為該機構的主要評分。 每個 AspectRating 的描述為:

    • type:被評分方面的名稱。 例如 atmosphere、service、food、overall 等等。

    • rating:此特定方面的彙總評分,從 0 到 30。 請注意,彙總評分的範圍是從 0 到 30,而作為評論一部分的評分範圍是從 0 到 3。

    • zagat_selected已淘汰)指出該地點已被評選為 Zagat 優良地點。

Zagat 標籤識別地點因其一貫高品質或具有特殊或獨特特色而著稱。

地點詳細資料要求

除了標準回應欄位之外,Google Places API for Work 客戶還可能收到下列欄位。 這些欄位將顯示為 result 欄位的頂層子項。

  • aspects已淘汰)包含單一的 AspectRating 物件,用來做為該機構的主要評分。 每個 AspectRating 的描述為:

    • type:被評分方面的名稱。 例如 atmosphere、service、food、overall 等等。

    • rating:此特定方面的彙總評分,從 0 到 30。 請注意,彙總評分的範圍是從 0 到 30,而作為評論一部分的評分範圍是從 0 到 3。

    • review_summary已淘汰)包括由 Google 的編輯人員所策劃之既豐富又簡要的評論。

除非您在詳細資料要求中傳遞 extensions=review_summary 參數,否則不會有此欄位。

  • zagat_selected已淘汰)指出該地點已被評選為 Zagat 優良地點。

Zagat 標籤識別地點因其一貫高品質或具有特殊或獨特特色而著稱。

地點詳細資料回應

下列範例示範 aspectsreview_summary 欄位在回應主體中看起來的樣子:

"aspects" : [
   {
      "rating" : 24,
      "type" : "food"
   },
   {
      "rating" : 21,
      "type" : "decor"
   },
   {
      "rating" : 24,
      "type" : "service"
   }
],

...

"review_summary" : "For a meal that's a \"leisurely celebration\",
Mountain View \"foodies\" head to this \"lovely\" old Victorian house, where
\"artful\", \"high-end\" New French tasting dinners that \"look great and taste
even better\" are enhanced by sommelier-selected wines and service that
\"anticipates your every need\"; a garden out back supplies some ingredients,
while four dining areas provide \"lovely decor and ambiance\"; P.S. an
abbreviated tasting menu is also available."