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,请参阅以下迁移文档: