高级数据

对于采用旧版 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 或 Google Maps for Work 或 Google Maps 开头。

  3. Enabled APIs 列表中,Places API - Zagat Content 服务应已启用。

Google Places API Web Service 服务应已停用

如果您想要获取高级数据,但您的项目未激活此项功能,请联系您的客户经理。

高级数据功能

注:高级数据功能现在仅在 Google Places API Web Service中提供。 它在 Google Maps JavaScript API Places 内容库中不可用。

地点搜索

除了标准响应字段,Google Places API for Work 客户还可能接收到以下字段。 这些字段将作为结果字段的顶级子字段显示。

  • aspects已弃用)包含单个 AspectRating 对象,即对场所的主要评分。 每个 AspectRating 的描述如下:

    • type:表示评分指标名称。 例如: 氛围、服务、食物、总体评论等。

    • rating:是指对此特定评分指标的综合评分,范围为 0 至 30。 请注意,综合评分的范围为 0 至 30,但评论中显示的评分范围为 0 至 3。

    • zagat_selected已弃用)表示该地点已被选为 Zagat 精选地点。

拥有 Zagat 标签的地点要么以其始终如一的高品质服务而闻名,要么拥有与众不同的特色。

地点详情请求

除了标准响应字段,Google Places API for Work 客户还可能接收到以下字段。 这些字段将作为结果字段的顶级子字段显示。

  • aspects已弃用)包含单个 AspectRating 对象,即对场所的主要评分。 每个 AspectRating 的描述如下:

    • type:表示评分指标名称。 例如: 氛围、服务、食物、总体评论等。

    • 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."