关于 Places API（新）

Places API（新）包含以下 API：

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

地点详情（新）

地点 ID 是 Google 地点数据库和 Google 地图上某个地点的唯一标识符。借助地点 ID，您可以通过发起地点详情（新）请求来请求特定建筑物或地图注点的详细信息。“地点详情（新）”请求会返回有关指定地点的全面信息，例如其完整地址、电话号码、用户评分和评价。

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

地点照片（新）

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

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

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

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

Places API 包含两个搜索 API：

  • 文本搜索（新）

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

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

  • 附近搜索（新）

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

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

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

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

自动补全（新）是一项网络服务，它会返回地点预测结果和查询预测结果以响应 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，请参阅以下迁移文档：