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 |
该地点接受的付款方式。一个地点可以接受超过
一种付款方式。如果没有付款方式数据,
付款方式字段将被取消设置。选项包括:
|
parkingOptions |
该地点提供的停车位。选项包括:
|
subDestinations |
与特定地点有关的独特地点。对于 例如,机场航站楼被视为某航站楼的子目的地 机场 |
fuelOptions |
以下商家提供的燃油选项的最新信息:
加油站。此信息会定期更新。选项包括
以下:
|
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,请参阅以下迁移文档: