Package google.maps.places.v1

Landmark

附近地标的排名列表。最容易识别且距离最近的地标会排在最前面。

Area

包含区域或相邻区域的排名列表。最容易识别且最精确的区域会排在前面。

string

相应地区的资源名称。

string

相应区域的地点 ID。

LocalizedText

相应区域的显示名称。

Containment

定义目标位置与区域之间的空间关系。

string

地标的资源名称。

string

地标的地点 ID。

LocalizedText

地标的显示名称。

string

相应地标的一组类型标记。如需查看可能值的完整列表，请访问 https://developers.google.com/maps/documentation/places/web-service/place-types。

SpatialRelationship

定义目标位置与地标之间的空间关系。

float

目标中心点与地标中心点之间的直线距离（以米为单位）。在某些情况下，此值可能大于 travel_distance_meters。

float

从目标到地标的沿道路网的行驶距离（以米为单位，如果已知）。此值未考虑交通方式，例如步行、驾车或骑行。

string

Photo 或 Review 的作者姓名。

string

Photo 或 Review 作者的 URI。

string

Photo 或 Review 的作者的个人资料照片 URI。

string

必需。要搜索的文本字符串。

LocationBias

可选。使结果偏向于指定位置。

location_bias 和 location_restriction 最多只能设置一个。如果两者均未设置，结果将按 IP 地址进行偏向，这意味着 IP 地址将映射到不精确的位置并用作偏向信号。

LocationRestriction

可选。将结果限制在指定位置。

location_bias 和 location_restriction 最多只能设置一个。如果两者均未设置，结果将按 IP 地址进行偏向，这意味着 IP 地址将映射到不精确的位置并用作偏向信号。

string

可选。地点类型 (https://developers.google.com/maps/documentation/places/web-service/place-types) 中包含的主要地点类型（例如“餐厅”或“加油站”），或仅包含 (regions)，或仅包含 (cities)。仅当某个地点的主要类型包含在此列表中时，才会返回该地点。最多可以指定 5 个值。如果未指定任何类型，系统将返回所有地点类型。

string

可选。仅包含指定地区的结果，最多可指定 15 个 CLDR 双字符地区代码。空集不会限制结果。如果同时设置了 location_restriction 和 included_region_codes，结果将位于交集区域。

string

可选。返回结果所用的语言。默认值为 en-US。如果 input 中使用的语言与 language_code 不同，或者返回的地点没有从本地语言到 language_code 的翻译，则结果可能采用混合语言。

string

可选。地区代码，以 CLDR 双字符地区代码的形式指定。这会影响地址格式、结果排名，还可能会影响返回的结果。这不会将结果限制在指定区域内。如需将结果限制在某个区域内，请使用 region_code_restriction。

LatLng

可选。用于计算到目的地的地理距离（以 distance_meters 形式返回）的起点。如果省略此值，则不会返回地理距离。

int32

可选。一个从零开始的 Unicode 字符偏移量，值为 input，用于指示 input 中的光标位置。光标位置可能会影响返回的预测结果。

如果为空，则默认为 input 的长度。

bool

可选。如果为 true，则响应将同时包含地点预测和查询预测。否则，响应将仅返回地点预测结果。

string

可选。一个字符串，用于标识自动补全会话以进行结算。必须是网址和文件名安全的 base64 字符串，长度不得超过 36 个 ASCII 字符。否则，系统会返回 INVALID_ARGUMENT 错误。

会话在用户开始输入查询内容时开始，并在用户选择地点且系统执行“地点详情”或“地址验证”调用时结束。在每个会话中，用户可以输入多项查询内容，并最终发送一个地点详情或地址验证请求。会话中每个请求所用的凭据必须属于同一 Google Cloud 控制台项目。会话结束后，令牌将失效；您的应用必须为每个会话生成一个新的令牌。如果您省略 session_token 参数或重复使用会话令牌，系统会按未提供会话令牌的情况为会话计费（每个请求均单独结算）。

我们建议您遵循以下准则：

• 针对所有“地点自动补全”调用使用会话令牌。
• 为每个会话生成一个新的令牌。建议使用版本 4 UUID。
• 确保会话中用于所有“地点自动补全”“地点详情”和“地址验证”请求的凭据属于同一 Cloud 控制台项目。
• 请务必为每个新会话传递唯一的会话令牌。针对多个会话使用同一令牌会导致每个请求被单独计费。

bool

可选。如果该字段设置为 true，则包含纯上门服务商家。纯上门服务商家是指为客户送货上门或提供上门服务，但不在自己的商家地址为客户提供服务的商家。例如，清洁服务类商家或管道工。这些商家在 Google 地图上没有实际地址或位置信息。对于这些商家，“地点”将不会返回包含 location、plus_code 和其他与位置相关的字段。

Viewport

由东北角和西南角定义的视口。

Circle

由中心点和半径定义的圆。

Viewport

由东北角和西南角定义的视口。

Circle

由中心点和半径定义的圆。

Suggestion

包含建议列表，按相关性降序排列。

PlacePrediction

某个营业地点的预测。

QueryPrediction

查询的预测结果。

string

可直接使用或使用 matches 进行格式设置的文本。

StringRange

一个字符串范围列表，用于标识输入请求在 text 中的匹配位置。这些范围可用于设置 text 的特定部分的格式。如果匹配是根据字符串匹配以外的其他条件（例如拼写更正或音译）确定的，则子字符串可能与 input 不完全匹配。

这些值是 text 的 Unicode 字符偏移量。系统保证这些范围按偏移值递增的顺序排列。

string

建议地点的资源名称。此名称可用于接受地点名称的其他 API。

string

建议地点的唯一标识符。此标识符可用于接受地点 ID 的其他 API。

FormattableText

包含返回结果的简明易懂的名称。对于商家结果，这通常是商家名称和地址。

建议希望显示单个界面元素的开发者使用 text。如果开发者希望显示两个单独但相关的界面元素，可能需要改用 structured_format。它们是表示地点预测的两种不同方式。用户不应尝试将 structured_format 解析为 text，反之亦然。

此文本可能与 GetPlace 返回的 display_name 不同。

如果请求 input 和 language_code 使用不同的语言，或者如果地点没有从本地语言到 language_code 的翻译，则可能采用混合语言。

StructuredFormat

地点预测的细分，包括包含地点名称的主要文本和包含其他消歧特征（例如城市或地区）的次要文本。

建议希望显示两个单独但相关的界面元素的开发者使用 structured_format。如果开发者希望显示单个界面元素，不妨改用 text。它们是表示地点预测的两种不同方式。用户不应尝试将 structured_format 解析为 text，反之亦然。

string

适用于相应地点的类型列表，来自 https://developers.google.com/maps/documentation/places/web-service/place-types 中的表 A 或表 B。

类型是对地点的分类。具有相同类型的地点将具有相似的特征。

int32

从 origin 开始的测地线长度（以米为单位，如果指定了 origin）。某些预测（例如路线）可能不会填充此字段。

FormattableText

预测的文本。此文本不代表地点，而是可在搜索端点（例如文本搜索）中使用的文本查询。

建议希望显示单个界面元素的开发者使用 text。如果开发者希望显示两个单独但相关的界面元素，可能需要改用 structured_format。它们是表示查询预测的两种不同方式。用户不应尝试将 structured_format 解析为 text，反之亦然。

如果请求 input 和 language_code 使用不同的语言，或者部分查询没有从本地语言到 language_code 的翻译，则可能使用混合语言。

StructuredFormat

将查询预测分解为包含查询内容的主要文本和包含其他消歧特征（例如城市或地区）的次要文本。

建议希望显示两个单独但相关的界面元素的开发者使用 structured_format。如果开发者希望显示单个界面元素，不妨改用 text。它们是表示查询预测的两种不同方式。用户不应尝试将 structured_format 解析为 text，反之亦然。

int32

字符串的第一个 Unicode 字符的从零开始的偏移量（含）。

int32

最后一个 Unicode 字符（不含）的从零开始的偏移量。

FormattableText

表示地点或查询的名称。

FormattableText

表示用于进一步标识地点或优化查询的其他消除歧义功能（例如城市或地区）。

LatLng

必需。中心纬度和经度。

纬度的范围必须在 [-90.0, 90.0] 之间。经度的范围必须在 [-180.0, 180.0] 之间。

double

必需。半径（以米为单位）。半径必须介于 [0.0, 50000.0] 之间。

LocalizedText

与主题相关的内容。

string

所引用地点的资源名称列表。此名称可用于接受 Place 资源名称的其他 API。

Review

与地点查询相关的此地点的评价列表。

Photo

有关此地点的照片的信息（包括参考信息），与地点查询相关。

Justification

实验性功能：如需了解详情，请访问 https://developers.google.com/maps/documentation/places/web-service/experimental/places-generative。

地点的理由。

ReviewJustification

实验性功能：如需了解详情，请访问 https://developers.google.com/maps/documentation/places/web-service/experimental/places-generative。

BusinessAvailabilityAttributesJustification

实验性功能：如需了解详情，请访问 https://developers.google.com/maps/documentation/places/web-service/experimental/places-generative。

bool

相应地点是否提供外卖服务。

bool

如果某个地点提供送货服务。

bool

如果某个场所提供堂食。

HighlightedText

Review

突出显示的文本所依据的评价。

string

HighlightedTextRange

突出显示文本的范围列表。

int32

int32

int32

相应充电站的连接器数量。不过，由于某些充电端口可能配备多个连接器，但一次只能为一辆汽车充电，因此连接器的数量可能大于可同时充电的汽车总数。

ConnectorAggregation

包含相同类型和相同充电速率的连接器的电动汽车充电连接器聚合的列表。

EVConnectorType

相应聚合的连接器类型。

double

汇总中每个连接器的静态最大充电速率（以千瓦为单位）。

int32

相应汇总中的连接器数量。

Timestamp

相应汇总中连接器可用性信息的上次更新时间。

int32

相应聚合中当前可用的连接器数量。

int32

相应汇总中目前处于停止服务状态的连接器数量。

FuelPrice

相应加油站每种燃油的最新已知燃油价格。每种燃料类型对应一个条目。顺序并不重要。

FuelType

燃料类型。

Money

燃油价格。

Timestamp

上次更新燃油价格的时间。

string

必需。照片媒体的资源名称，格式为：places/{place_id}/photos/{photo_reference}/media。

Place 对象的 photos.name 字段中返回的照片资源名称采用 places/{place_id}/photos/{photo_reference} 格式。您需要在照片资源末尾附加 /media，以获取照片媒体资源名称。

int32

可选。指定所需的最大图片宽度（以像素为单位）。如果图片小于指定值，则返回原始图片。如果图片在任一维度上都大于指定尺寸，系统会将其缩放为与两个维度中较小的维度相匹配，但会限制为原始宽高比。max_height_px 和 max_width_px 属性均接受介于 1 到 4800 之间的整数（含 1 和 4800）。如果该值不在允许的范围内，系统会返回 INVALID_ARGUMENT 错误。

必须至少指定 max_height_px 或 max_width_px 之一。如果未指定 max_height_px 和 max_width_px，系统会返回 INVALID_ARGUMENT 错误。

int32

可选。指定图片所需的最大高度（以像素为单位）。如果图片小于指定值，则返回原始图片。如果图片在任一维度上都大于指定尺寸，系统会将其缩放为与两个维度中较小的维度相匹配，但会限制为原始宽高比。max_height_px 和 max_width_px 属性均接受介于 1 到 4800 之间的整数（含 1 和 4800）。如果该值不在允许的范围内，系统会返回 INVALID_ARGUMENT 错误。

必须至少指定 max_height_px 或 max_width_px 之一。如果未指定 max_height_px 和 max_width_px，系统会返回 INVALID_ARGUMENT 错误。

bool

可选。如果设置，则跳过默认的 HTTP 重定向行为，并呈现文本格式（例如，对于 HTTP 使用情形，以 JSON 格式）的响应。如果未设置，系统将发出 HTTP 重定向，以将调用重定向到图片媒体。对于非 HTTP 请求，此选项会被忽略。

string

必需。地点的资源名称，格式为 places/{place_id}。

string

可选。如果地点详情有首选语言版本，系统会以该语言显示。

当前支持的语言列表：https://developers.google.com/maps/faq#languagesupport。

string

可选。请求来源地的 Unicode 国家/地区代码 (CLDR)。此参数用于显示地点详情，例如特定于区域的地点名称（如果有）。此参数可能会根据适用法律影响结果。如需了解详情，请参阅 https://www.unicode.org/cldr/charts/latest/supplemental/territory_language_information.html。

请注意，目前不支持 3 位数的地区代码。

string

可选。一个字符串，用于标识自动补全会话以进行结算。必须是网址和文件名安全的 base64 字符串，长度不得超过 36 个 ASCII 字符。否则，系统会返回 INVALID_ARGUMENT 错误。

会话在用户开始输入查询内容时开始，并在用户选择地点且系统执行“地点详情”或“地址验证”调用时结束。在每个会话中，用户可以输入多项查询内容，并最终发送一个地点详情或地址验证请求。会话中每个请求所用的凭据必须属于同一 Google Cloud 控制台项目。会话结束后，令牌将失效；您的应用必须为每个会话生成一个新的令牌。如果您省略 session_token 参数或重复使用会话令牌，系统会按未提供会话令牌的情况为会话计费（每个请求均单独结算）。

我们建议您遵循以下准则：

• 针对所有“地点自动补全”调用使用会话令牌。
• 为每个会话生成一个新的令牌。建议使用版本 4 UUID。
• 确保会话中用于所有“地点自动补全”“地点详情”和“地址验证”请求的凭据属于同一 Cloud 控制台项目。
• 请务必为每个新会话传递唯一的会话令牌。针对多个会话使用同一令牌会导致每个请求被单独计费。

string

标识符。表示相应地点照片的引用，可用于再次查找相应地点照片（也称为 API“资源”名称：places/{place_id}/photos/{photo}）。

int32

最大可用宽度（以像素为单位）。

int32

可用的最大高度（以像素为单位）。

AuthorAttribution

相应照片的作者。

string

用户可用于标记照片存在问题的链接。

string

用于在 Google 地图上显示照片的链接。

string

照片媒体的资源名称，格式为：places/{place_id}/photos/{photo_reference}/media。

string

可用于渲染照片的短期有效 URI。

string

相应地点的资源名称，格式为 places/{place_id}。可用于查找地点。

string

地点的唯一标识符。

LocalizedText

地点的本地化名称，适合用作简短且直观易懂的说明。例如，“Google Sydney”“Starbucks”“Pyrmont”等。

string

相应结果的一组类型标记。例如，“政治”和“地点”。如需查看可能值的完整列表，请参阅 https://developers.google.com/maps/documentation/places/web-service/place-types 中的表 A 和表 B

string

指定结果的主要类型。此类型必须是 Places API 支持的类型之一。例如，“餐厅”“咖啡馆”“机场”等。一个地点只能有一个主要类型。如需查看可能值的完整列表，请参阅 https://developers.google.com/maps/documentation/places/web-service/place-types 中的表 A 和表 B。如果地点的主要类型是不受支持的类型，则可能缺少主要类型。如果存在主要类型，则该类型始终是 types 字段中的一种类型。

LocalizedText

主要类型的显示名称，如果适用，则本地化为请求语言。如需查看可能值的完整列表，请参阅 https://developers.google.com/maps/documentation/places/web-service/place-types 中的表 A 和表 B。如果地点的主要类型是不受支持的类型，则可能缺少主要类型。

string

以国家格式表示的地点电话号码（用户可读）。

string

地点的电话号码（采用国际电话号码格式），方便用户阅读。

string

相应地点的完整且直观易懂的地址。

string

相应地点的简短且直观易懂的地址。

PostalAddress

邮政地址格式的地址。

AddressComponent

每个地理位置级别的重复组件。请注意，address_components[] 数组有以下特点：- 地址组成部分的数组包含的组成部分可能多于 formatted_address。- 除了 formatted_address 中包含的政治实体之外，数组不一定会纳入包含地址的所有政治实体。若要检索包含特定地址的所有政治实体，您应使用反向地理编码，并将地址的纬度/经度作为参数传递给请求。- 两次请求之间的响应格式不一定相同。特别是，address_components 的数量因所请求的地址而异，对于同一个地址，数量也可能会随着时间推移而发生变化。组成部分在数组中的位置可能发生变化。组成部分的类型也可能发生变化。后续响应中可能缺少特定组成部分。

PlusCode

相应地点位置的纬度/经度 Plus Code。

LatLng

相应营业地点的地理位置。

Viewport

适合在平均大小的地图上显示相应地点的视口。此视口不应作为商家的实际边界或服务区域。

double

根据用户对此地点的评价得出的评分，介于 1.0 到 5.0 之间。

string

提供有关此地点的更多信息的网址。

string

此地点的权威网站，例如商家主页。请注意，对于连锁店（例如宜家商场），此网址通常是单个商店的网站，而不是整个连锁店的网站。

Review

有关此地点的评价列表，按相关性排序。最多可返回 5 条评价。

OpeningHours

正常营业时间。请注意，如果某个地点全天营业（24 小时），则不会设置 close 字段。客户端可以通过以下方式表示全天营业（24 小时）：将 open 中的 day、hour 和 minute 设置为值 0。00

TimeZone

IANA 时区数据库时区。例如“America/New_York”。

Photo

有关此地点的照片的信息（包括参考资料）。最多可返回 10 张照片。

string

采用 adr 微格式的地点地址：http://microformats.org/wiki/adr。

BusinessStatus

相应地点的营业状态。

PriceLevel

相应地点的价格水平。

Attribution

必须与此结果一起显示的一组数据提供程序。

string

指向图标遮罩的截断网址。用户可以在末尾附加类型后缀（例如“.svg”或“.png”）来访问不同的图标类型。

string

icon_mask 的背景颜色（采用十六进制格式），例如 #909CE1。

OpeningHours

接下来 7 天（包括今天）的营业时间。时间段从请求当天的午夜开始，到六天后的晚上 11:59 结束。此字段包含所有营业时间的 special_days 子字段，针对营业时间特殊的日期设置。

OpeningHours

包含未来 7 天的条目数组，其中包括商家次要营业时间的相关信息。次要营业时间与商家的主要营业时间不同。例如，餐厅可以将外卖自取时间或送餐时间指定为次要营业时间。此字段会根据地点的类型填充类型子字段，该子字段会从预定义的营业时间类型列表（例如 DRIVE_THROUGH、PICKUP 或 TAKEOUT）中提取数据。此字段包含所有营业时间的 special_days 子字段，针对营业时间特殊的日期设置。

OpeningHours

包含一个条目数组，用于提供有关商家常规次要营业时间的信息。次要营业时间与商家的主要营业时间不同。例如，餐厅可以将外卖自取时间或送餐时间指定为次要营业时间。此字段会根据地点的类型，从预定义的营业时间类型列表（例如 DRIVE_THROUGH、PICKUP 或 TAKEOUT）中填充类型子字段。

LocalizedText

包含地点的摘要。摘要包含文本概览，还包括这些文本概览的语言代码（如果适用）。摘要文本必须按原样呈现，不得修改或更改。

PaymentOptions

相应场所接受的付款方式。如果付款选项数据不可用，则付款选项字段将处于未设置状态。

ParkingOptions

地点提供的停车选项。

SubDestination

与地点相关的子目的地列表。

FuelOptions

加油站中有关燃油选项的最新信息。这些信息会定期更新。

EVChargeOptions

电动汽车充电选项的相关信息。

GenerativeSummary

AI 生成的地点摘要。

ContainingPlace

当前位置所在的地点列表。

AddressDescriptor

相应地点的地址描述符。地址描述符包含有助于使用地标和区域描述位置的其他信息。如需查看地址描述符的区域覆盖范围，请访问 https://developers.google.com/maps/documentation/geocoding/address-descriptors/coverage。

GoogleMapsLinks

用于触发不同 Google 地图操作的链接。

PriceRange

与某个地点相关联的价格范围。

ReviewSummary

使用用户评价生成的地点 AI 摘要。

EvChargeAmenitySummary

电动车辆充电站附近设施的摘要。

NeighborhoodSummary

地点附近地图注点的摘要。

int32

相应地点的时区目前与世界协调时间 (UTC) 的偏移量（以分钟为单位）。以分钟表示，以支持偏差为小时分数（例如 X 小时 15 分钟）的时区。

int32

相应地点的评价（无论是否包含文字）总数。

bool

指定商家是否支持外卖。

bool

指定商家是否支持配送。

bool

指定商家是否支持室内或室外座位选项。

bool

指定商家是否支持路边自提。

bool

指定相应地点是否支持预订。

bool

指定相应场所是否供应早餐。

bool

指定相应场所是否提供午餐。

bool

指定相应场所是否提供晚餐。

bool

指定相应场所是否供应啤酒。

bool

指定相应场所是否供应葡萄酒。

bool

指定营业地点是否供应早午餐。

bool

指定相应地点是否供应素食。

bool

该场所提供户外座位。

bool

场所提供现场音乐表演。

bool

有儿童菜单。

bool

该场所供应鸡尾酒。

bool

该场所供应甜点。

bool

场所供应咖啡。

bool

此场所适合儿童。

bool

该场所允许带狗。

bool

地点有卫生间。

bool

地点可容纳的群组数量。

bool

此场所适合观看体育赛事。

AccessibilityOptions

地点提供的无障碍功能选项的相关信息。

bool

指明相应地点是否为纯上门服务商家。纯上门服务商家是指为客户送货上门或提供上门服务，但不在自己的商家地址为客户提供服务的商家。例如，清洁服务类商家或管道工。这些商家可能没有实际地址或 Google 地图上的营业地点。

bool

该场所提供无障碍停车位。

bool

场所设有无障碍入口。

bool

场所设有无障碍卫生间。

bool

该场所设有无障碍座席。

string

地址组成部分的完整文本说明或名称。例如，澳大利亚的地址组成部分可能包含“Australia”这一 long_name。

string

地址组成部分的缩写文本名称（如果有）。例如，澳大利亚的地址组成部分可能具有“AU”的 short_name。

string

一个数组，用于指示地址组成部分的类型。

string

用于设置相应组件格式的语言（采用 CLDR 表示法）。

string

相应地点的提供商的名称。

string

地点的数据提供方的 URI。

string

相应地点所在的地点对应的资源名称。

string

相应地点所在的地点 ID。

ContentBlock

可用设施概览。保证会提供此信息。

ContentBlock

附近咖啡馆的选项摘要。

ContentBlock

附近餐厅的摘要。

ContentBlock

附近商店的摘要。

string

一个链接，用户可以通过该链接标记摘要存在的问题。

LocalizedText

AI 披露声明消息“由 Gemini 总结”（及其本地化变体）。如果支持，则以请求中指定的语言显示。

LocalizedText

地点的概览。

string

用户可用于标记概览摘要存在问题的链接。

LocalizedText

AI 披露声明消息“由 Gemini 总结”（及其本地化变体）。如果支持，则以请求中指定的语言显示。

string

用于显示前往相应地点的路线的链接。该链接仅填充目的地位置，并使用默认出行方式 DRIVE。

string

用于显示相应地点的链接。

string

用于在 Google 地图上为此地点撰写评价的链接。

string

用于在 Google 地图上显示相应地点的评价的链接。

string

用于在 Google 地图上显示相应地点的评价的链接。

ContentBlock

社区的概览摘要。

ContentBlock

社区的详细说明。

string

一个链接，用户可以通过该链接标记摘要存在的问题。

LocalizedText

AI 披露声明消息“由 Gemini 总结”（及其本地化变体）。如果支持，则以请求中指定的语言显示。

Period

相应地点在一周内的营业时间段。这些时间段按时间顺序排列，采用的是地点本地时区。空值（但不是缺失值）表示某个地点从未营业，例如因装修而暂时关闭。

periods 的起始日期是不固定的，不应假定为星期日。API 会根据多种因素确定开始日期。例如，对于全天候营业的商家，第一个周期可能从提出请求的当天开始。对于其他商家，可能是他们一周内首次营业的日期。

注意：periods 数组的顺序与 weekday_descriptions 数组的顺序无关。请勿假设它们会在同一天开始。

string

描述相应地点的营业时间的本地化字符串，一周中的每一天对应一个字符串。

注意：日期顺序和周的开始日期由语言区域设置（语言和地区）决定。periods 数组的顺序与 weekday_descriptions 数组的顺序无关。请勿假设它们会在同一天开始。

如果营业时间未知或无法转换为本地化文本，则为空。示例：“周日：18:00-06:00”

SecondaryHoursType

用于标识次要营业时间的类型字符串。

SpecialDay

返回的营业时间涵盖的特殊日期对应的结构化信息。特殊日期是指可能会影响场所营业时间的日期，例如圣诞节。如果存在特殊营业时间，则为 current_opening_hours 和 current_secondary_opening_hours 设置。

Timestamp

当前营业时间段在未来最多 7 天内的下一次开始时间。仅当在处理请求时营业时间段处于非有效状态时，系统才会填充此字段。

Timestamp

当前营业时间段的结束时间在未来 7 天内。仅当营业时间段在提供请求时处于有效状态时，系统才会填充此字段。

bool

营业时间段目前是否处于有效状态。对于正常营业时间和当前营业时间，此字段表示相应地点是否在营业。对于次要营业时间和当前次要营业时间，此字段表示相应地点的次要营业时间是否处于有效状态。

Point

地点的开始营业时间。

Point

场所开始关闭的时间。

Date

相应地点的本地时区中的日期。

bool

相应端点是否被截断。当实际小时数超出我们愿意返回的小时数范围时，就会发生截断，因此我们会将小时数截断回这些边界。这可确保返回的时间不超过自请求当天午夜起的 24 * 7 小时。

int32

周几，以 0-6 范围内的整数表示。0 表示星期日，1 表示星期一，依此类推。

int32

以 24 小时制表示的小时。范围是 0 到 23。

int32

分钟。范围为 0 到 59。

Date

此特殊日期的日期。

bool

该场所提供免费停车场。

bool

该场所提供付费停车场。

bool

此房源提供免费路边停车位。

bool

此场所提供收费路边停车位。

bool

该场所提供代客泊车服务。

bool

酒店提供免费停车库。

bool

此场所提供收费停车库。

bool

商家接受信用卡付款。

bool

商家接受借记卡付款。

bool

商家仅接受现金付款。具有此属性的场所可能仍接受其他付款方式。

bool

场所接受 NFC 支付。

string

地点的全局（完整）代码，例如“9FWM33GV+HQ”，表示 1/8000 度 x 1/8000 度（约 14 米 x 14 米）的区域。

string

地点的混合代码，例如“33GV+HQ, Ramberg, Norway”，包含全局代码的后缀，并将前缀替换为参考实体的格式化名称。

LocalizedText

用户评价摘要。

string

一个链接，用户可以通过该链接标记摘要存在的问题。

LocalizedText

AI 披露声明消息“由 Gemini 总结”（及其本地化变体）。如果支持，则以请求中指定的语言显示。

string

用于在 Google 地图上显示相应地点的评价的链接。

string

子目的地的资源名称。

string

子目的地的地点 ID。

string

编码多段线，由 Routes API 默认返回。请参阅编码器和解码器工具。

Money

价格范围的下限（含）。价格应不低于此金额。

Money

价格范围的上限（不含）。价格应低于此金额。

string

表示相应地点评价的引用，可用于再次查找相应地点评价（也称为 API“资源”名称：places/{place_id}/reviews/{review}）。

string

格式化的近期时间字符串，以适合相应语言和国家/地区的形式表示相对于当前时间的评价时间。

LocalizedText

评价的本地化文本。

LocalizedText

评价文本的原始语言版本。

double

介于 1.0 和 5.0 之间的数字，也称为星数。

AuthorAttribution

相应评价的作者。

Timestamp

评价的时间戳。

string

用户可用于标记评价问题的链接。

string

用于在 Google 地图上显示相应评价的链接。

bool

可选。如果设置为 true，则尽可能避开收费公路，优先选择不包含收费公路的路线。仅适用于 DRIVE 和 TWO_WHEELER TravelMode。

bool

可选。如果设置为 true，则尽可能避开高速公路，优先选择不包含高速公路的路线。仅适用于 DRIVE 和 TWO_WHEELER TravelMode。

bool

可选。如果设置为 true，则在合理的情况下避开轮渡，优先选择不包含轮渡的路线。仅适用于 DRIVE 和 TWO_WHEELER TravelMode。

bool

可选。如果设置为 true，则尽可能避免室内导航，优先选择不包含室内导航的路线。仅适用于 WALK TravelMode。

LatLng

可选。一种显式路线规划起点，用于替换多段线中定义的起点。默认情况下，系统会使用折线的起点。

TravelMode

可选。出行方式。

RouteModifiers

可选。路线修饰符。

RoutingPreference

可选。指定如何计算路由摘要。服务器会尝试使用所选的路由偏好设置来计算路由。可感知路况的路线偏好设置仅适用于 DRIVE 或 TWO_WHEELER travelMode。

Leg

行程的各个部分。

当您计算从一组出发地出发的行程时长和距离时，legs 包含一个路段，其中包含从出发地到目的地的时长和距离。当您搜索沿途地点时，legs 包含两个路段：一个是从出发地到该地点的路段，另一个是从该地点到目的地的路段。

string

一个链接，用于在 Google 地图上显示使用指定路线摘要中的途经点的路线。通过此链接生成的路线不一定与用于生成路线摘要的路线相同。该链接使用请求中提供的信息（包括 routingParameters 和 searchAlongRouteParameters 字段中的信息，如果适用）来生成路线链接。

Duration

完成此段行程所需的时间。

int32

相应行程段的距离。

string

如果地点详情有首选语言版本，系统会以该语言显示。如果未指定或无法识别语言代码，则可能会返回任何语言的地点详细信息，但如果存在英语详细信息，则优先返回英语详细信息。

当前支持的语言列表：https://developers.google.com/maps/faq#languagesupport。

string

请求来源地的 Unicode 国家/地区代码 (CLDR)。此参数用于显示地点详情，例如特定于区域的地点名称（如果有）。此参数可能会根据适用法律影响结果。

如需了解详情，请参阅 https://www.unicode.org/cldr/charts/latest/supplemental/territory_language_information.html。

请注意，目前不支持 3 位数的地区代码。

string

https://developers.google.com/maps/documentation/places/web-service/place-types 中包含的地点类型（例如“restaurant”或“gas_station”）。

最多可以指定 表 A 中的 50 种类型。

如果存在任何冲突的类型（即某个类型同时出现在 included_types 和 excluded_types 中），系统会返回 INVALID_ARGUMENT 错误。

如果指定了地点类型并设置了多个类型限制，则系统只会返回满足所有限制的地点。例如，如果我们有 {included_types = ["restaurant"], excluded_primary_types = ["restaurant"]}，则返回的地点提供与“餐厅”相关的服务，但主要不是作为“餐厅”运营的。

string

排除的地点类型（例如“restaurant”或“gas_station”），请参阅 https://developers.google.com/maps/documentation/places/web-service/place-types。

最多可以指定 表 A 中的 50 种类型。

如果客户端同时提供 included_types（例如餐厅）和 excluded_types（例如咖啡馆），则响应应包含餐厅但不能包含咖啡馆。响应中包含至少与一个 included_types 匹配且与任何 excluded_types 都不匹配的地点。

如果存在任何冲突的类型（即某个类型同时出现在 included_types 和 excluded_types 中），系统会返回 INVALID_ARGUMENT 错误。

如果指定了地点类型并设置了多个类型限制，则系统只会返回满足所有限制的地点。例如，如果我们有 {included_types = ["restaurant"], excluded_primary_types = ["restaurant"]}，则返回的地点提供与“餐厅”相关的服务，但主要不是作为“餐厅”运营的。

string

来自 https://developers.google.com/maps/documentation/places/web-service/place-types 的主要地点类型（例如“restaurant”或“gas_station”）。一个地点只能有一个与支持的类型表相关联的主要类型。

最多可以指定 表 A 中的 50 种类型。

如果存在任何冲突的主要类型（即某种类型同时出现在 included_primary_types 和 excluded_primary_types 中），则返回 INVALID_ARGUMENT 错误。

如果指定了地点类型并设置了多个类型限制，则系统只会返回满足所有限制的地点。例如，如果我们有 {included_types = ["restaurant"], excluded_primary_types = ["restaurant"]}，则返回的地点提供与“餐厅”相关的服务，但主要不是作为“餐厅”运营的。

string

从 https://developers.google.com/maps/documentation/places/web-service/place-types 中排除的主要地点类型（例如“餐厅”或“加油站”）。

最多可以指定 表 A 中的 50 种类型。

如果存在任何冲突的主要类型（即某种类型同时出现在 included_primary_types 和 excluded_primary_types 中），则返回 INVALID_ARGUMENT 错误。

如果指定了地点类型并设置了多个类型限制，则系统只会返回满足所有限制的地点。例如，如果我们有 {included_types = ["restaurant"], excluded_primary_types = ["restaurant"]}，则返回的地点提供与“餐厅”相关的服务，但主要不是作为“餐厅”运营的。

int32

返回的结果数上限。必须介于 1 到 20（默认值）之间（含边界值）。如果未设置该数量，则会回退到上限。如果该数字设置为负数或超过上限，系统会返回 INVALID_ARGUMENT 错误。

LocationRestriction

必需。要搜索的地区。

RankPreference

结果在回答中的排名方式。

RoutingParameters

可选。影响搜索结果路由的参数。

Circle

由中心点和半径定义的圆。

Place

满足用户要求的地点列表，例如地点类型、地点数量和特定位置限制。

RoutingSummary

一个路线摘要列表，其中每个条目都与 places 字段中相同索引处的相应地点相关联。如果某个地点的路线摘要不可用，则该地点对应的条目将为空。如果请求了地点列表，此列表应包含与地点列表相同数量的条目。

string

必需。用于文本搜索的文本查询。

string

如果地点详情有首选语言版本，系统会以该语言显示。如果未指定或无法识别语言代码，则可能会返回任何语言的地点详细信息，但如果存在英语详细信息，则优先返回英语详细信息。

当前支持的语言列表：https://developers.google.com/maps/faq#languagesupport。

string

请求来源地的 Unicode 国家/地区代码 (CLDR)。此参数用于显示地点详情，例如特定于区域的地点名称（如果有）。此参数可能会根据适用法律影响结果。

如需了解详情，请参阅 https://www.unicode.org/cldr/charts/latest/supplemental/territory_language_information.html。

请注意，目前不支持 3 位数的地区代码。

RankPreference

结果在回答中的排名方式。

string

所请求的地点类型。如需查看支持的类型的完整列表，请访问：https://developers.google.com/maps/documentation/places/web-service/place-types。仅支持一种包含的类型。

bool

用于将搜索范围限制在当前营业的地点。默认值为 false。

double

过滤掉平均用户评分严格低于此限制的结果。有效值必须是介于 0 到 5 之间的浮点数（含边界值），且以 0.5 为步长，即 [0, 0.5, 1.0, ... , 5.0]（含边界值）。输入的评分将向上舍入到最接近的 0.5（上限）。例如，如果评分为 0.6，则会排除所有评分低于 1.0 的结果。

int32

已弃用：请改用 page_size。

每页可返回的结果数上限。如果可用结果的数量大于 max_result_count，则会返回 next_page_token，该值可传递给 page_token，以便在后续请求中获取下一页结果。如果提供的值为 0 或未提供值，则使用默认值 20。最大值为 20；大于 20 的值将被强制转换为 20。如果值为负数，系统会返回 INVALID_ARGUMENT 错误。

如果同时指定了 max_result_count 和 page_size，则将忽略 max_result_count。

int32

可选。每页可返回的结果数上限。如果可用结果的数量大于 page_size，则会返回 next_page_token，该值可传递给 page_token，以便在后续请求中获取下一页结果。如果提供的值为 0 或未提供值，则使用默认值 20。最大值为 20；大于 20 的值将设置为 20。如果值为负数，系统会返回 INVALID_ARGUMENT 错误。

如果同时指定了 max_result_count 和 page_size，则将忽略 max_result_count。

string

可选。从之前的 TextSearch 调用接收的页面令牌。利用其进行后续页面检索。

进行分页时，提供给 TextSearch 的所有参数（page_token、page_size 和 max_result_count 除外）必须与提供页面令牌的初始调用相一致。否则，系统会返回 INVALID_ARGUMENT 错误。

PriceLevel

用于将搜索范围限制为标记为特定价位的地点。用户可以选择任意价格等级组合。默认选择所有价位。

bool

用于为 included_type 设置严格的类型过滤条件。如果设置为 true，则仅返回相同类型的结果。默认为 false。

LocationBias

要搜索的地区。此位置用作偏差，这意味着可能会返回给定位置附近的结果。不能与 location_restriction 一起设置。

LocationRestriction

要搜索的地区。此位置用作限制条件，这意味着系统不会返回指定位置以外的结果。无法与 location_bias 一起设置。

EVOptions

可选。设置地点搜索请求的可搜索电动汽车选项。

RoutingParameters

可选。用于将用户路由到结果的其他参数。

SearchAlongRouteParameters

可选。用于沿路线搜索的其他参数 proto。

bool

可选。如果该字段设置为 true，则包含纯上门服务商家。纯上门服务商家是指为客户送货上门或提供上门服务，但不在自己的商家地址为客户提供服务的商家。例如，清洁服务类商家或管道工。这些商家在 Google 地图上没有实际地址或位置信息。对于这些商家，“地点”将不会返回包含 location、plus_code 和其他与位置相关的字段。

double

可选。所需的最低充电功率（以千瓦为单位）。充电速率低于指定速率的地点会被过滤掉。

EVConnectorType

可选。首选电动汽车连接器类型的列表。不支持任何所列连接器类型的地点会被过滤掉。

Viewport

由东北角和西南角定义的矩形框。rectangle.high() 必须是矩形视口的东北点。rectangle.low() 必须是矩形视口的西南点。rectangle.low().latitude() 不得大于 rectangle.high().latitude()。这会导致纬度范围为空。矩形视口的宽度不能超过 180 度。

Circle

由中心点和半径定义的圆。

Viewport

由东北角和西南角定义的矩形框。rectangle.high() 必须是矩形视口的东北点。rectangle.low() 必须是矩形视口的西南点。rectangle.low().latitude() 不得大于 rectangle.high().latitude()。这会导致纬度范围为空。矩形视口的宽度不能超过 180 度。

Polyline

必需。路线多段线。

Place

满足用户文本搜索条件的地点列表。

RoutingSummary

一个路线摘要列表，其中每个条目都与 places 字段中相同索引处的相应地点相关联。如果某个地点的路线摘要不可用，则该地点对应的条目将为空。如果请求了地点列表，此列表将包含与地点列表相同的条目数。

ContextualContent

实验性功能：如需了解详情，请访问 https://developers.google.com/maps/documentation/places/web-service/experimental/places-generative。

一个上下文内容列表，其中每个条目都与 places 字段中相同索引处的相应位置相关联。优先选择与请求中的 text_query 相关的内容。如果某个地点的上下文相关内容不可用，则会返回非上下文相关内容。仅当相应地点没有内容时，此字段才会为空。如果请求了地点列表，此列表将包含与地点列表相同的条目数。

string

可作为 page_token 发送并用于检索下一页的令牌。如果此字段省略或为空，则不存在后续页面。

string

通过该链接，用户可以在 Google 地图中搜索请求中指定的相同文本查询内容。