关于 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 该地点接受的付款方式。一个地点可以接受超过 一种付款方式。如果没有付款方式数据, 付款方式字段将被取消设置。选项包括:
<ph type="x-smartling-placeholder">
    </ph>
  • 信用卡
  • 借记卡
  • 只接受现金付款
  • NFC 付款
parkingOptions 该地点提供的停车位。选项包括:
<ph type="x-smartling-placeholder">
    </ph>
  • 免费停车场
  • 收费停车场
  • 免费路边停车
  • 代客泊车
  • 免费停车库
  • 收费停车库
subDestinations 与特定地点有关的独特地点。对于 例如,机场航站楼被视为某航站楼的子目的地 机场
fuelOptions 以下商家提供的燃油选项的最新信息: 加油站。此信息会定期更新。选项包括 以下:
<ph type="x-smartling-placeholder">
    </ph>
  • 柴油
  • 常规无潜在客户
  • 中级
  • 高级
  • 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,请参阅以下迁移文档: