新版 Places API 包含以下 API:
本文概要介绍了这些新 API。
地点详情 API
地点 ID 可唯一标识 Google 地点数据库和 Google 地图中的地点。使用地点 ID,您可以通过发起地点详情(新)请求来请求有关特定场所或地图注点的详细信息。“地点详情(新)”请求会返回有关指定地点的全面信息,如完整地址、电话号码、用户评分和评价。
获取地点 ID 的方式有多种。您可以使用:
Place Photo API
借助 Place Photo(新)API,您可以访问 Google 地点数据库中存储的数百万张照片,从而为您的应用添加高品质照片内容。使用 Place Photo(新)API,您可以访问照片并将图片调整为最适合您的应用的大小。
对 Place Photo(新)API 的所有请求都必须包含照片资源名称,用于唯一标识要返回的照片。您可以通过以下方式获取照片资源名称:
如需在“地点详情(新)”“文本搜索(新)”或“附近搜索(新)”请求的响应中添加照片资源名称,请务必在该请求的字段掩码中添加 photos
字段。
文本搜索和附近搜索
Places API 包含两个搜索 API:
-
可让您指定搜索地点时所用的文本字符串。例如:“辣味素食,澳大利亚悉尼市”或“加州帕洛阿尔托附近的精致海鲜餐厅”。
您可以通过指定价位、当前营业状态、评分或特定地点类型等详细信息来缩小搜索范围。您还可以指定使结果偏向于特定位置,或将搜索限制在特定位置。
-
可让您指定要搜索的区域以及地点类型列表。将区域指定为由中心点的纬度和经度坐标以及半径(以米为单位)定义的圆圈。
指定一个或多个地点类型,以定义地点的特征。例如,指定“
pizza_restaurant
”和“shopping_mall
”即可搜索位于指定区域的购物中心内的披萨餐馆。
两次搜索之间的主要区别是,文本搜索(新)允许您指定任意搜索字符串,而附近搜索(新)需要在特定区域内进行搜索。
Autocomplete API 和会话令牌
Autocomplete(新)API 是一项网络服务,可在响应 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,请参阅以下迁移文档: