简介
Places API（新版）包含以下 API：
本文档简要介绍了这些新 API。
地点详情（新版）
地点 ID 可唯一标识 Google Places 数据库中和 Google 地图上的地点。借助地点 ID，您可以通过发起地点详情（新版）请求来请求特定场所或地图注点的详细信息。地点详情（新版）请求会返回有关指定地点的全面信息，例如完整地址、电话号码、房客评分和评价。
您可以通过多种方式获取地点 ID。您可以使用：
Place Photos（新版）
借助地点照片（新版），您可以访问存储在 Google 地点数据库中的数百万张照片，从而向应用添加高品质照片内容。使用 Place Photos (New) API，您可以访问照片，并根据自己的应用将图片调整为最适合的大小。
对 Place Photos (New) API 的所有请求都必须包含照片资源名称，该名称可唯一标识要返回的照片。您可以使用以下命令获取照片资源名称：
如需在“地点详情（新）”“文本搜索（新）”或“附近搜索（新）”请求的响应中包含照片资源名称，请务必在请求的字段掩码中包含 photos 字段。
文本搜索（新版）和附近搜索（新版）
Places API（新版）包含两个搜索 API：
-
可让您指定一个文本字符串，用于搜索地点。例如：“Spicy Vegetarian Food in Sydney, Australia”（澳大利亚悉尼的香辣素食）或“Fine seafood dining near Palo Alto, CA”（加利福尼亚州帕洛阿尔托附近的精致海鲜餐厅）。
您可以通过指定价格水平、当前营业状态、评分或特定地点类型等详细信息来优化搜索。您还可以指定将结果偏向特定位置，或将搜索范围限制在特定位置。
-
可让您指定要搜索的区域以及地点类型列表。 将区域指定为由中心点的纬度和经度坐标以及半径（以米为单位）定义的圆形。
指定一个或多个用于定义地点特征的地点类型。例如，指定“
pizza_restaurant”和“shopping_mall”可搜索位于指定区域购物中心内的披萨餐厅。
这两种搜索的主要区别在于，文本搜索（新版）可让您指定任意搜索字符串，而附近搜索（新版）则需要指定搜索区域。
自动补全（新版）和会话令牌
自动补全（新版）是一项网络服务，可针对 HTTP 请求返回地点预测结果和查询预测结果。在请求中，指定文本搜索字符串和控制搜索区域的地理边界。
会话令牌是用户生成的字符串，用于将会话中的 Autocomplete (New) 调用作为会话进行跟踪。Autocomplete（新版）使用会话令牌将用户自动补全搜索的查询和选择阶段归入不同的会话，以便进行结算。
新字段、属性和无障碍选项
Places API（新版）包含新的字段、属性和无障碍选项，可为用户提供有关地点的更多信息。以下各部分介绍了这些方面。
字段
Places API（新版）包含多个新字段：
| 字段 | 说明 |
|---|---|
regularSecondaryOpeningHours |
描述特定操作的具体时间。次要营业时间与商家的主要营业时间不同。例如，餐厅可以将免下车服务时间或配送时间指定为次要营业时间。 |
paymentOptions |
该地点接受的支付方式。一个地点可以接受多种支付方式。如果支付选项数据不可用，则支付选项字段将处于未设置状态。包括以下选项：
|
parkingOptions |
该地点提供的停车选项。包括以下选项：
|
subDestinations |
与特定地点相关的独特地点。例如，机场航站楼被视为机场的子目的地。 |
fuelOptions |
加油站提供的燃油选项的最新信息。此信息会定期更新。选项包括：
|
evChargeOptions |
此充电站的电动汽车 (EV) 充电桩数量。虽然有些电动汽车充电桩有多个连接器，但每个充电桩一次只能为一辆车充电；因此，此字段反映的是在给定时间可用的电动汽车充电桩数量。 |
shortFormattedAddress |
地点的简短、人类可读的地址。 |
primaryType |
给定结果的主要类型。例如，某个地点可能会被归类为 cafe 或 airport。一个地点只能有一个主要类型。如需查看可能值的完整列表，请参阅支持的类型。 |
primaryTypeDisplayName |
主要类型的显示名称，已本地化为请求语言（如果适用）。如需查看可能值的完整列表，请参阅支持的类型。 |
entrances |
目的地的入口。入口是一对经纬度坐标，用于定义地点的出入口位置。 |
navigationPoints |
目的地的导航点。导航点是道路旁可作为导航终点的位置，包括支持的出行方式和用途。 |
属性
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（旧版）的现有客户，并且希望将应用迁移到 Places API（新版），请参阅以下迁移文档：