关于 Places API（新）

Places API（新）包含以下 API：

本文档简要介绍了这些新 API。

地点详情（新）

地点 ID 可唯一标识 Google 地点数据库中和 Google 地图上的地点。有了地点 ID，您就可以发起地点详情（新）请求，请求有关特定场所或景点的详细信息。“地点详情（新）”请求会返回有关指定地点的全面信息，例如完整地址、电话号码、用户评分和评价。

您可以通过多种方式获取地点 ID。您可以使用：

地点照片（新）

借助 Place Photo（新版）API，您可以访问存储在 Google 地点数据库中数以百万计的照片，从而将高品质照片内容添加到您的应用中。使用地点照片（新版）API，您可以访问照片，并将图片调整为最适合您的应用的大小。

对地点照片（新版）API 的所有请求都必须包含照片资源名称，该名称用于唯一标识要返回的照片。您可以使用以下命令获取照片资源名称：

如需在“地点详情（新）”“文本搜索（新）”或“附近搜索（新）”请求的响应中添加照片资源名称，请务必在请求的字段掩码中添加 photos 字段。

文本搜索（新）和附近搜索（新）

Places API 包含两个搜索 API：

  • 文字形式的搜索广告（新）

    用于指定用于搜索地点的文本字符串。例如：“澳大利亚悉尼的辛辣素食”或“加利福尼亚州帕洛阿尔托附近的高档海鲜餐厅”。

    您可以通过指定价格水平、当前营业状态、评分或特定地点类型等详细信息来优化搜索。您还可以指定将结果偏向于特定地理位置，或将搜索范围限制为特定地理位置。

  • 附近搜索（新）

    可让您指定要搜索的区域以及地点类型列表。 将区域指定为由中心点的纬度和经度坐标以及半径（以米为单位）定义的圆形。

    指定一个或多个地点类型，用于定义地点的特征。例如，指定“pizza_restaurant”和“shopping_mall”可搜索位于指定区域购物中心内的披萨餐厅。

这两种搜索的主要区别在于，文本搜索（新）允许您指定任意搜索字符串，而附近搜索（新）则需要指定要搜索的特定区域。

自动补全（新）和会话令牌

自动补全（新）是一项 Web 服务，可在 HTTP 请求的响应中返回地点预测结果和查询预测结果。在请求中，指定文本搜索字符串和用于控制搜索区域的地理边界。

会话令牌是用户生成的字符串，用于将“自动补全（新）”调用作为会话进行跟踪。“自动补全”（新）使用会话令牌将用户自动补全搜索的查询和选择阶段归入不同的会话，以便进行结算。

新字段、属性和无障碍选项

Places API（新版）包含新的字段、属性和无障碍选项，可为用户提供有关地点的更多信息。以下部分介绍了这些方面。

字段

Places API（新）包含多个新字段：

字段 说明
regularSecondaryOpeningHours 描述特定操作的特定时间。次要营业时间不同于商家的主要营业时间。例如，餐厅可以将自助取餐时间或外卖时间指定为次要营业时间。
paymentOptions 相应地点接受的付款方式。一个地点可以接受多种付款方式。如果付款方式数据不可用，系统会取消设置付款方式字段。选项包括：
  • 信用卡
  • 借记卡
  • 只接受现金付款
  • NFC 付款
parkingOptions 地点提供的停车选项。选项包括：
  • 免费停车场
  • 收费停车场
  • 免费路边停车
  • 代客泊车
  • 免费停车库
  • 收费停车库
subDestinations 与特定地点相关的独特地点。例如，机场航站楼被视为机场的子目的地。
fuelOptions 有关加油站提供的燃料选项的最新信息。这些信息会定期更新。选项包括：
  • 柴油
  • 普通无铅汽油
  • 中级
  • 高级
  • SP91
  • SP91 E10
  • SP92
  • SP95 E10
  • SP98
  • SP99
  • SP100
  • 液化石油气
  • E80
  • E85
  • 甲烷
  • 生物柴油
  • 卡车柴油
evChargeOptions 此充电站的电动车辆 (EV) 充电桩数量。虽然某些电动汽车充电桩有多个连接器，但每个充电桩一次只能为一辆车辆充电；因此，此字段反映的是给定时间可用的电动汽车充电桩数量。
shortFormattedAddress 地点的简短且直观易懂的地址。
primaryType 给定结果的主要类型。例如，某个地点可以被归类为 cafe 或 airport。地点只能有一个主要类型。如需查看可能值的完整列表，请参阅支持的类型。
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，请参阅以下迁移文档：