简介
Places API（新）包含以下 API：
本文档概述了这些新 API。
地点详情（新）
地点 ID 可唯一标识 Google 地点数据库中和 Google 地图上的地点。借助地点 ID，您可以通过发起 “地点详情（新）”请求来请求特定 商家或地图注点的详细信息。“地点详情（新）”请求会返回有关指定地点的全面信息，例如完整地址、电话号码、房客评分和评价。
您可以通过多种方式获取地点 ID。您可以使用：
地点照片（新）
Place Photos（新）让您能够访问 Google 地点数据库中存储的数百万张照片，从而在您的应用中添加高质量照片内容。使用 Place Photos (New) API，您可以访问照片，并根据自己的应用将图片调整为最适合的大小。
对 Place Photos (New) API 的所有请求都必须包含照片资源名称，该名称可唯一标识要返回的照片。您可以使用以下方式获取照片资源名称：
如需在“地点详情（新）”“文本搜索（新）”或“附近搜索（新）”请求的响应中添加照片资源名称，请确保在请求的字段掩码中添加 photos 字段。
文本搜索（新）和附近搜索（新）
Places API 包含以下两个搜索 API：
-
让您可以指定一个文本字符串，以便搜索地点。例如：“澳大利亚悉尼的香辣素食”或“加利福尼亚州帕洛阿尔托附近的优质海鲜餐厅”。
您可以指定价格水平、当前营业状态、评分或特定地点类型等详细信息来优化搜索。您还可以指定将结果偏向特定地点，或将搜索限制在特定地点。
-
让您可以指定要搜索的区域以及地点类型列表。 将区域指定为一个圆，该圆由中心点的纬度和经度坐标以及半径（以米为单位）定义。
指定一个或多个地点类型，以定义地点的特征。例如，指定“
pizza_restaurant”和“shopping_mall”，以搜索指定区域内购物中心内的披萨餐厅。
这两种搜索的主要区别在于，“文本搜索（新）”让您可以指定任意搜索字符串，而“附近搜索（新）”则需要指定要搜索的特定区域。
自动补全（新）和会话令牌
自动补全（新）是一种 Web 服务，可针对 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 |
地点提供无障碍座位。 |
AI 赋能的摘要
Places API（新）AI 赋能的摘要使用 Gemini 模型功能返回有关地点和区域的摘要，帮助用户决定去哪里。
AI 赋能的摘要会综合来自各种输入的数据，帮助用户就某个地点做出更明智的决定。例如，如果您考虑尝试一家新餐厅，AI 赋能的摘要可以突出显示常见菜单，让您了解餐厅的氛围，或从用户评价中提取主题。如果您要前往一座新城市，AI 赋能的摘要可以提供附近景点和设施的概览。
添加到 Places API（新）的 AI 赋能的功能
“地点详情（新）” “文本搜索（新）” 和 “附近搜索（新）” 支持 AI 赋能的摘要。 Places API（新）响应中提供以下 AI 赋能的摘要：
Google 会经常重新生成这些摘要，以确保它们基于最新的可用信息。当您发出 Places API（新）请求时，您的应用中将显示最新鲜的数据。
迁移到新的 Places API
如果您是现有的 Places API（新）客户，并且想要迁移应用以使用新的 API，请参阅以下迁移文档：