关于 Places API(新)

Places API(新)包含以下 API:

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

地点详情(新)

地点 ID 是 Google Places 数据库中的地点的唯一标识符, Google 地图。通过地点 ID,您可以请求获取特定地点的详细信息 发起地点详情(新) 请求。地点详情(新)请求会返回有关 显示的位置(如其完整地址、电话号码、用户评分以及 审核。

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

地点照片(新)

Place Photo(新)API 可让您添加高品质的照片内容 让您可以访问存储在 Google Places 数据库。使用地点照片(新版)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 给定结果的主要类型。例如,某个地点可以被归类为 cafeairport。答 地点只能有一个主要类型。如需查看 可能的值,请参阅支持的类型
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,请参阅以下迁移文档: