REST Resource: places

资源：Place

表示某个地点的所有信息。

JSON 表示法 
{
  "name": string,
  "id": string,
  "displayName": {
    object (LocalizedText)
  },
  "types": [
    string
  ],
  "primaryType": string,
  "primaryTypeDisplayName": {
    object (LocalizedText)
  },
  "nationalPhoneNumber": string,
  "internationalPhoneNumber": string,
  "formattedAddress": string,
  "shortFormattedAddress": string,
  "postalAddress": {
    object (PostalAddress)
  },
  "addressComponents": [
    {
      object (AddressComponent)
    }
  ],
  "plusCode": {
    object (PlusCode)
  },
  "location": {
    object (LatLng)
  },
  "viewport": {
    object (Viewport)
  },
  "rating": number,
  "googleMapsUri": string,
  "websiteUri": string,
  "reviews": [
    {
      object (Review)
    }
  ],
  "regularOpeningHours": {
    object (OpeningHours)
  },
  "timeZone": {
    object (TimeZone)
  },
  "photos": [
    {
      object (Photo)
    }
  ],
  "adrFormatAddress": string,
  "businessStatus": enum (BusinessStatus),
  "priceLevel": enum (PriceLevel),
  "attributions": [
    {
      object (Attribution)
    }
  ],
  "iconMaskBaseUri": string,
  "iconBackgroundColor": string,
  "currentOpeningHours": {
    object (OpeningHours)
  },
  "currentSecondaryOpeningHours": [
    {
      object (OpeningHours)
    }
  ],
  "regularSecondaryOpeningHours": [
    {
      object (OpeningHours)
    }
  ],
  "editorialSummary": {
    object (LocalizedText)
  },
  "paymentOptions": {
    object (PaymentOptions)
  },
  "parkingOptions": {
    object (ParkingOptions)
  },
  "subDestinations": [
    {
      object (SubDestination)
    }
  ],
  "fuelOptions": {
    object (FuelOptions)
  },
  "evChargeOptions": {
    object (EVChargeOptions)
  },
  "generativeSummary": {
    object (GenerativeSummary)
  },
  "containingPlaces": [
    {
      object (ContainingPlace)
    }
  ],
  "addressDescriptor": {
    object (AddressDescriptor)
  },
  "googleMapsLinks": {
    object (GoogleMapsLinks)
  },
  "priceRange": {
    object (PriceRange)
  },
  "reviewSummary": {
    object (ReviewSummary)
  },
  "evChargeAmenitySummary": {
    object (EvChargeAmenitySummary)
  },
  "neighborhoodSummary": {
    object (NeighborhoodSummary)
  },
  "utcOffsetMinutes": integer,
  "userRatingCount": integer,
  "takeout": boolean,
  "delivery": boolean,
  "dineIn": boolean,
  "curbsidePickup": boolean,
  "reservable": boolean,
  "servesBreakfast": boolean,
  "servesLunch": boolean,
  "servesDinner": boolean,
  "servesBeer": boolean,
  "servesWine": boolean,
  "servesBrunch": boolean,
  "servesVegetarianFood": boolean,
  "outdoorSeating": boolean,
  "liveMusic": boolean,
  "menuForChildren": boolean,
  "servesCocktails": boolean,
  "servesDessert": boolean,
  "servesCoffee": boolean,
  "goodForChildren": boolean,
  "allowsDogs": boolean,
  "restroom": boolean,
  "goodForGroups": boolean,
  "goodForWatchingSports": boolean,
  "accessibilityOptions": {
    object (AccessibilityOptions)
  },
  "pureServiceAreaBusiness": boolean
}
字段
name

string

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

string

地点的唯一标识符。
displayName

object (LocalizedText)

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

string

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

string

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

object (LocalizedText)

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

string

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

string

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

string

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

string

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

object (PostalAddress)

邮政地址格式的地址。
addressComponents[]

object (AddressComponent)

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

object (PlusCode)

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

object (LatLng)

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

object (Viewport)

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

number

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

string

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

string

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

object (Review)

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

object (OpeningHours)

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

object (TimeZone)

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

object (Photo)

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

string

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

enum (BusinessStatus)

相应地点的营业状态。
priceLevel

enum (PriceLevel)

相应地点的价格水平。
attributions[]

object (Attribution)

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

string

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

string

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

object (OpeningHours)

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

object (OpeningHours)

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

object (OpeningHours)

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

object (LocalizedText)

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

object (PaymentOptions)

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

object (ParkingOptions)

地点提供的停车选项。
subDestinations[]

object (SubDestination)

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

object (FuelOptions)

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

object (EVChargeOptions)

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

object (GenerativeSummary)

AI 生成的地点摘要。
containingPlaces[]

object (ContainingPlace)

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

object (AddressDescriptor)

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

object (PriceRange)

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

object (ReviewSummary)

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

object (EvChargeAmenitySummary)

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

object (NeighborhoodSummary)

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

integer

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

integer

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

boolean

指定商家是否支持外卖。
delivery

boolean

指定商家是否支持配送。
dineIn

boolean

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

boolean

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

boolean

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

boolean

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

boolean

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

boolean

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

boolean

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

boolean

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

boolean

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

boolean

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

boolean

该场所提供户外座位。
liveMusic

boolean

场所提供现场音乐表演。
menuForChildren

boolean

有儿童菜单。
servesCocktails

boolean

该场所供应鸡尾酒。
servesDessert

boolean

该场所供应甜点。
servesCoffee

boolean

场所供应咖啡。
goodForChildren

boolean

此场所适合儿童。
allowsDogs

boolean

该场所允许带狗。
restroom

boolean

地点有卫生间。
goodForGroups

boolean

地点可容纳的群组数量。
goodForWatchingSports

boolean

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

object (AccessibilityOptions)

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

boolean

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

LocalizedText

特定语言的文本的本地化变体。

JSON 表示法 
{
  "text": string,
  "languageCode": string
}
字段
text

string

采用与下方 languageCode 对应的语言的本地化字符串。
languageCode

string

文本的 BCP-47 语言代码，例如“en-US”或“sr-Latn”。

如需了解详情，请参阅 http://www.unicode.org/reports/tr35/#Unicode_locale_identifier。

PostalAddress

表示邮政地址，例如邮政递送或付款地址。给定邮政地址后，邮政服务可以将物品投递到处所、邮政信箱或其他投递地点。邮政地址并非用于描述地理位置（例如道路、城镇或山区）。

在典型的使用场景中，地址将通过用户输入或导入现有数据来创建，具体取决于进程的类型。

有关输入或修改地址的建议：

如需详细了解如何使用此架构，请参阅：https://support.google.com/business/answer/6397478。

JSON 表示法 
{
  "revision": integer,
  "regionCode": string,
  "languageCode": string,
  "postalCode": string,
  "sortingCode": string,
  "administrativeArea": string,
  "locality": string,
  "sublocality": string,
  "addressLines": [
    string
  ],
  "recipients": [
    string
  ],
  "organization": string
}
字段
revision

integer

PostalAddress 的架构修订版本。必须将其设置为 0，也就是最新版本。

所有新版本必须向后兼容旧版本。
regionCode

string

必需。地址的国家/地区的 CLDR 地区代码。系统不会推断此字段，该值由用户确保正确。如需了解详情，请参阅 https://cldr.unicode.org/ 和 https://www.unicode.org/cldr/charts/30/supplemental/territory_information.html。例如：瑞士的地区代码为“CH”。
languageCode

string

选填。此地址内容的 BCP-47 语言代码（如果已知）。这通常是输入表单的界面语言，或者与地址的“国家/地区”中使用的某种语言或其转换后的其他语言相匹配。这可能会影响某些国家/地区的格式，但对数据的正确性并不重要，也不会影响任何验证或其他与格式无关的操作。

如果此值未知，则应省略（而不是指定可能不正确的默认值）。

示例：“zh-Hant”、“ja”、“ja-Latn”、“en”。
postalCode

string

可选。地址的邮政编码。并非所有国家/地区都使用或要求使用邮政编码，但在使用邮政编码时，它们可能会触发以地址其他部分为参照的额外验证（例如美国的州或邮政编码验证）。
sortingCode

string

可选。特定于国家/地区的额外排序代码。大多数区域都未使用此功能。如果使用此元素，相应的值可以是“CEDEX”之类的字符串（可以选择后跟一个数字，例如“CEDEX 7”），也可以只是一个数字，表示“邮政区号”（牙买加）、“送达区域指示符”（马拉维）或“邮局指示符”（科特迪瓦）。
administrativeArea

string

可选。最高行政区划，用于国家或地区的邮政地址。例如，此值可以是州、省、州（俄罗斯）或县。对于西班牙，此值为省而非自治区（例如此值为“巴塞罗那”而非“加泰罗尼亚”）。许多国家在邮政地址中不使用行政区划。例如，对于瑞士，此字段应留空。
locality

string

可选。一般是指地址的城市或城镇部分。示例：美国的城市、意大利的市镇、英国的邮镇。对于没有明确定义市行政区或者其无法很好地对应这个结构的地区，应将 locality 留空并使用 addressLines。
sublocality

string

可选。地址的子级市行政区。例如，此值可以是社区、自治市/镇/区或街区。
addressLines[]

string

描述详细地址的非结构化地址行。

由于 addressLines 中的值没有类型信息，并且有时可能在单个字段中包含多个值（例如“Austin, TX”），因此清楚的行顺序很重要。地址行的顺序应该是地址所在“国家/地区”的“信封顺序”。在某些地方，此顺序有可能不同（例如日本），在这种情况下可以使用 address_language 来明确顺序（例如，“ja”表示从大到小排序，“ja-Latn”或“en”表示从小到大排序）。这样就可以根据语言选择地址中最具体的行。

地址的最小结构化表示形式由 regionCode 和 addressLines 组成，其中所有其他信息都放在 addressLines 中。可以在没有地理编码的情况下非常近似地设置此地址的格式，但是在至少部分完成之前，不能对任何地址组成部分进行语义推理。

创建仅包含 regionCode 和 addressLines 的地址然后进行地理编码，这是处理完全非结构化地址的推荐方法（而不是猜测地址的哪些部分是市行政区或行政区）。
recipients[]

string

可选。此地址的收件人。在某些情况下，该字段可能包含多行信息。例如，它可能包含“转交”信息。
organization

string

可选。地址对应的组织的名称。

AddressComponent

构成格式化地址的结构化组件（如果此信息可用）。

JSON 表示法 
{
  "longText": string,
  "shortText": string,
  "types": [
    string
  ],
  "languageCode": string
}
字段
longText

string

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

string

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

string

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

string

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

PlusCode

Plus Code (http://plus.codes) 是一种位置引用，包含两种格式：用于定义 14 米 x 14 米（1/8000 度）或更小矩形的全局代码，以及用参考位置替换前缀的混合代码。

JSON 表示法 
{
  "globalCode": string,
  "compoundCode": string
}
字段
globalCode

string

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

string

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

LatLng

表示纬度/经度对的对象。该对象以一对双精度数表示，分别代表纬度度数和经度度数。除非另有说明，否则该对象必须符合 WGS84 标准。值必须介于标准化范围内。

JSON 表示法 
{
  "latitude": number,
  "longitude": number
}
字段
latitude

number

纬度（以度为单位）。它必须在 [-90.0, +90.0] 范围内。
longitude

number

经度（以度为单位）。它必须在 [-180.0, +180.0] 范围内。

视口

一个经纬度视口，表示为两个对角点 low 和 high。视口被视为一个封闭区域，即包含其边界。纬度范围必须介于 -90 度到 90 度之间（含），经度范围必须介于 -180 度到 180 度之间（含）。各种情况包括：

  • 如果 low = high，则视口由该单个点组成。

  • 如果 low.longitude > high.longitude，则经度范围会反转（视口跨越 180 度经度线）。

  • 如果 low.longitude = -180 度且 high.longitude = 180 度，则视口包含所有经度。

  • 如果 low.longitude = 180 度且 high.longitude = -180 度，则经度范围为空。

  • 如果 low.latitude > high.latitude，则纬度范围为空。

low 和 high 都必须填充，并且所表示的框不能为空（如上述定义中所指定）。空视口会导致错误。

例如，此视口完全包含纽约市：

{ "low": { "latitude": 40.477398, "longitude": -74.259087 }, "high": { "latitude": 40.91618, "longitude": -73.70018 } }

JSON 表示法 
{
  "low": {
    object (LatLng)
  },
  "high": {
    object (LatLng)
  }
}
字段
low

object (LatLng)

必需。视口的低点。
high

object (LatLng)

必需。视口的高点。

查看

有关地点评价的信息。

JSON 表示法 
{
  "name": string,
  "relativePublishTimeDescription": string,
  "text": {
    object (LocalizedText)
  },
  "originalText": {
    object (LocalizedText)
  },
  "rating": number,
  "authorAttribution": {
    object (AuthorAttribution)
  },
  "publishTime": string,
  "flagContentUri": string,
  "googleMapsUri": string
}
字段
name

string

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

string

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

object (LocalizedText)

评价的本地化文本。
originalText

object (LocalizedText)

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

number

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

object (AuthorAttribution)

相应评价的作者。
publishTime

string (Timestamp format)

评价的时间戳。

采用 RFC 3339 标准，生成的输出将始终在末尾带 Z，并使用 0、3、6 或 9 个小数位。不带“Z”的偏差时间也是可以接受的。示例："2014-10-02T15:01:23Z"、"2014-10-02T15:01:23.045123456Z" 或 "2014-10-02T15:01:23+05:30"。
flagContentUri

string

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

string

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

AuthorAttribution

UGC 数据作者的相关信息。在 Photo 和 Review 中使用。

JSON 表示法 
{
  "displayName": string,
  "uri": string,
  "photoUri": string
}
字段
displayName

string

Photo 或 Review 的作者姓名。
uri

string

Photo 或 Review 作者的 URI。
photoUri

string

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

OpeningHours

有关地点营业时间的信息。

JSON 表示法 
{
  "periods": [
    {
      object (Period)
    }
  ],
  "weekdayDescriptions": [
    string
  ],
  "secondaryHoursType": enum (SecondaryHoursType),
  "specialDays": [
    {
      object (SpecialDay)
    }
  ],
  "nextOpenTime": string,
  "nextCloseTime": string,
  "openNow": boolean
}
字段
periods[]

object (Period)

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

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

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

string

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

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

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

enum (SecondaryHoursType)

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

object (SpecialDay)

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

string (Timestamp format)

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

采用 RFC 3339 标准，生成的输出将始终在末尾带 Z，并使用 0、3、6 或 9 个小数位。不带“Z”的偏差时间也是可以接受的。示例："2014-10-02T15:01:23Z"、"2014-10-02T15:01:23.045123456Z" 或 "2014-10-02T15:01:23+05:30"。
nextCloseTime

string (Timestamp format)

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

采用 RFC 3339 标准，生成的输出将始终在末尾带 Z，并使用 0、3、6 或 9 个小数位。不带“Z”的偏差时间也是可以接受的。示例："2014-10-02T15:01:23Z"、"2014-10-02T15:01:23.045123456Z" 或 "2014-10-02T15:01:23+05:30"。
openNow

boolean

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

时段

地点保持 openNow 状态的时段。

JSON 表示法 
{
  "open": {
    object (Point)
  },
  "close": {
    object (Point)
  }
}
字段
open

object (Point)

地点的开始营业时间。
close

object (Point)

场所开始关闭的时间。

点

状态更改点。

JSON 表示法 
{
  "date": {
    object (Date)
  },
  "truncated": boolean,
  "day": integer,
  "hour": integer,
  "minute": integer
}
字段
date

object (Date)

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

boolean

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

integer

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

integer

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

integer

分钟。范围为 0 到 59。

日期

表示整个或部分日历日期（例如生日）。一天中的时间和时区要么在别处指定，要么不重要。日期相对于公历。可以表示以下任一情况：

  • 包含非零年份、月份和天值的完整日期。
  • 月份和天，年份值为零（例如周年纪念日）。
  • 单独的年份，月份和天值为零。
  • 年份和月份，天值为零（例如，信用卡到期日期）。

相关类型：

JSON 表示法 
{
  "year": integer,
  "month": integer,
  "day": integer
}
字段
year

integer

日期中的年份。必须介于 1 到 9999 之间，或为 0（即指定不含年份的日期）。
month

integer

一年中的第几个月。必须介于 1 到 12 之间，或为 0（即只指定年份，不指定月份和天值）。
day

integer

一个月中的第几天。必须介于 1 到 31 之间并且对年份和月份有效，或为 0（即天不重要，指定单独的年份或者年份和月份）。

SecondaryHoursType

用于标识次要工时的类型。

枚举
SECONDARY_HOURS_TYPE_UNSPECIFIED 未指定次要小时类型时的默认值。
DRIVE_THROUGH 银行、餐厅或药店的驾车通道开放时间。
HAPPY_HOUR 欢乐时光。
DELIVERY 送达时间。
TAKEOUT 外卖时段。
KITCHEN 厨房营业时间。
BREAKFAST 早餐时间。
LUNCH 午餐时间。
DINNER 晚餐时间。
BRUNCH 早午餐时间。
PICKUP 取货时段。
ACCESS 存储地点的开放时间。
SENIOR_HOURS 老年人专属时段。
ONLINE_SERVICE_HOURS 在线服务时段。

SpecialDay

返回的营业时间涵盖的特殊日期对应的结构化信息。特殊日期是指可能会影响场所营业时间的日期，例如圣诞节。

JSON 表示法 
{
  "date": {
    object (Date)
  }
}
字段
date

object (Date)

此特殊日期的日期。

TimeZone

表示 IANA 时区数据库中的时区。

JSON 表示法 
{
  "id": string,
  "version": string
}
字段
id

string

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

string

可选。IANA 时区数据库版本号。例如“2019a”。

照片

有关地点照片的信息。

JSON 表示法 
{
  "name": string,
  "widthPx": integer,
  "heightPx": integer,
  "authorAttributions": [
    {
      object (AuthorAttribution)
    }
  ],
  "flagContentUri": string,
  "googleMapsUri": string
}
字段
name

string

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

integer

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

integer

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

object (AuthorAttribution)

相应照片的作者。
flagContentUri

string

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

string

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

BusinessStatus

相应地点的商家状态。

枚举
BUSINESS_STATUS_UNSPECIFIED 默认值。此值未使用。
OPERATIONAL 商家正在营业，但不一定现在营业。
CLOSED_TEMPORARILY 该场所已暂停营业。
CLOSED_PERMANENTLY 该场所已永久停业。

PriceLevel

相应地点的价格水平。

枚举
PRICE_LEVEL_UNSPECIFIED 地点价格水平未指定或未知。
PRICE_LEVEL_FREE 场所提供免费服务。
PRICE_LEVEL_INEXPENSIVE 商家提供价格实惠的服务。
PRICE_LEVEL_MODERATE 该场所提供价格适中的服务。
PRICE_LEVEL_EXPENSIVE 场所提供昂贵的服务。
PRICE_LEVEL_VERY_EXPENSIVE 场所提供的服务非常昂贵。

归因

有关此地点的数据提供商的信息。

JSON 表示法 
{
  "provider": string,
  "providerUri": string
}
字段
provider

string

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

string

地点的数据提供方的 URI。

PaymentOptions

相应场所接受的付款方式。

JSON 表示法 
{
  "acceptsCreditCards": boolean,
  "acceptsDebitCards": boolean,
  "acceptsCashOnly": boolean,
  "acceptsNfc": boolean
}
字段
acceptsCreditCards

boolean

商家接受信用卡付款。
acceptsDebitCards

boolean

商家接受借记卡付款。
acceptsCashOnly

boolean

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

boolean

场所接受 NFC 支付。

ParkingOptions

有关地点的停车选项的信息。一个停车场可以同时支持多个选项。

JSON 表示法 
{
  "freeParkingLot": boolean,
  "paidParkingLot": boolean,
  "freeStreetParking": boolean,
  "paidStreetParking": boolean,
  "valetParking": boolean,
  "freeGarageParking": boolean,
  "paidGarageParking": boolean
}
字段
freeParkingLot

boolean

该场所提供免费停车场。
paidParkingLot

boolean

该场所提供付费停车场。
freeStreetParking

boolean

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

boolean

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

boolean

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

boolean

酒店提供免费停车库。
paidGarageParking

boolean

此场所提供收费停车库。

SubDestination

子目的地是指与主要地点相关联的特定地点。这些标记可为在机场、国家公园、大学或体育场等大型或复杂场所内搜索的用户提供更具体的目的地。例如，机场的子目的地可能包括相关联的航站楼和停车场。子目的地会返回地点 ID 和地点资源名称，这些信息可用于后续的地点详情（新）请求，以获取更丰富的详细信息，包括子目的地的显示名称和位置。

JSON 表示法 
{
  "name": string,
  "id": string
}
字段
name

string

子目的地的资源名称。
id

string

子目的地的地点 ID。

AccessibilityOptions

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

JSON 表示法 
{
  "wheelchairAccessibleParking": boolean,
  "wheelchairAccessibleEntrance": boolean,
  "wheelchairAccessibleRestroom": boolean,
  "wheelchairAccessibleSeating": boolean
}
字段
wheelchairAccessibleParking

boolean

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

boolean

场所设有无障碍入口。
wheelchairAccessibleRestroom

boolean

场所设有无障碍卫生间。
wheelchairAccessibleSeating

boolean

该场所设有无障碍座席。

FuelOptions

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

JSON 表示法 
{
  "fuelPrices": [
    {
      object (FuelPrice)
    }
  ]
}
字段
fuelPrices[]

object (FuelPrice)

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

FuelPrice

指定类型的燃料价格信息。

JSON 表示法 
{
  "type": enum (FuelType),
  "price": {
    object (Money)
  },
  "updateTime": string
}
字段
type

enum (FuelType)

燃料类型。
price

object (Money)

燃油价格。
updateTime

string (Timestamp format)

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

采用 RFC 3339 标准，生成的输出将始终在末尾带 Z，并使用 0、3、6 或 9 个小数位。不带“Z”的偏差时间也是可以接受的。示例："2014-10-02T15:01:23Z"、"2014-10-02T15:01:23.045123456Z" 或 "2014-10-02T15:01:23+05:30"。

FuelType

燃料类型。

枚举
FUEL_TYPE_UNSPECIFIED 未指定燃料类型。
DIESEL 柴油。
DIESEL_PLUS 柴油加燃料。
REGULAR_UNLEADED 常规无铅汽油。
MIDGRADE 中级。
PREMIUM Premium。
SP91 SP 91.
SP91_E10 SP 91 E10。
SP92 SP 92.
SP95 SP 95.
SP95_E10 SP95 E10。
SP98 SP 98.
SP99 SP 99.
SP100 SP 100。
LPG 液化石油气。
E80 E 80.
E85 E 85.
E100 E 100.
METHANE 甲烷。
BIO_DIESEL 生物柴油。
TRUCK_DIESEL 卡车柴油。

Money

表示含有货币类型的金额。

JSON 表示法 
{
  "currencyCode": string,
  "units": string,
  "nanos": integer
}
字段
currencyCode

string

ISO 4217 中定义的由 3 个字母组成的货币代码。
units

string (int64 format)

金额的整数单位。例如，如果 currencyCode 是 "USD"，则 1 单位就是一美元。
nanos

integer

金额的纳诺 (10^-9) 单位数。这个值必须在 -999999999（含）和 +999999999（含）之间。如果 units 是正数，nanos 必须是正数或零。如果 units 为零，nanos 可以是正数、零或负数。如果 units 是负数，nanos 必须是负数或零。例如，$-1.75 表示为 units=-1 和 nanos=-750000000。

EVChargeOptions

有关地点中托管的电动车辆充电站的信息。术语遵循 https://afdc.energy.gov/fuels/electricity_infrastructure.html。一个充电接口一次只能为一辆汽车充电。一个端口有一个或多个连接器。一个充电站有一个或多个充电桩。

JSON 表示法 
{
  "connectorCount": integer,
  "connectorAggregation": [
    {
      object (ConnectorAggregation)
    }
  ]
}
字段
connectorCount

integer

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

object (ConnectorAggregation)

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

ConnectorAggregation

按 [type, maxChargeRateKw] 分组的电动汽车充电信息。显示具有相同类型和最大充电速率（以千瓦为单位）的连接器的电动汽车充电汇总数据。

JSON 表示法 
{
  "type": enum (EVConnectorType),
  "maxChargeRateKw": number,
  "count": integer,
  "availabilityLastUpdateTime": string,
  "availableCount": integer,
  "outOfServiceCount": integer
}
字段
type

enum (EVConnectorType)

相应聚合的连接器类型。
maxChargeRateKw

number

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

integer

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

string (Timestamp format)

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

采用 RFC 3339 标准，生成的输出将始终在末尾带 Z，并使用 0、3、6 或 9 个小数位。不带“Z”的偏差时间也是可以接受的。示例："2014-10-02T15:01:23Z"、"2014-10-02T15:01:23.045123456Z" 或 "2014-10-02T15:01:23+05:30"。
availableCount

integer

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

integer

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

EVConnectorType

如需详细了解电动汽车充电连接器类型，请参阅 http://ieeexplore.ieee.org/stamp/stamp.jsp?arnumber=6872107。

枚举
EV_CONNECTOR_TYPE_UNSPECIFIED 未指定连接器。
EV_CONNECTOR_TYPE_OTHER 其他连接器类型。
EV_CONNECTOR_TYPE_J1772 J1772 1 型连接器。
EV_CONNECTOR_TYPE_TYPE_2 IEC 62196 Type 2 连接器。通常称为 MENNEKES。
EV_CONNECTOR_TYPE_CHADEMO CHAdeMO 型连接器。
EV_CONNECTOR_TYPE_CCS_COMBO_1 组合充电系统（交流电和直流电）。基于 SAE。Type-1 J-1772 连接器
EV_CONNECTOR_TYPE_CCS_COMBO_2 组合充电系统（交流电和直流电）。基于 Type-2 Mennekes 连接器
EV_CONNECTOR_TYPE_TESLA 通用 TESLA 连接器。在北美，这是 NACS，但在世界其他地区，这可能是非 NACS（例如 CCS Combo 2 (CCS2) 或 GB/T）。此值不太能代表实际的连接器类型，而更代表在 Tesla 自有充电站为 Tesla 品牌车辆充电的能力。
EV_CONNECTOR_TYPE_UNSPECIFIED_GB_T GB/T 类型对应于中国的 GB/T 标准。此类型涵盖所有 GB_T 类型。
EV_CONNECTOR_TYPE_UNSPECIFIED_WALL_OUTLET 未指定墙壁插座。
EV_CONNECTOR_TYPE_NACS 北美充电系统 (NACS)，已标准化为 SAE J3400。

GenerativeSummary

AI 生成的地点摘要。

JSON 表示法 
{
  "overview": {
    object (LocalizedText)
  },
  "overviewFlagContentUri": string,
  "disclosureText": {
    object (LocalizedText)
  }
}
字段
overview

object (LocalizedText)

地点的概览。
overviewFlagContentUri

string

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

object (LocalizedText)

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

ContainingPlace

有关此地点所在位置的信息。

JSON 表示法 
{
  "name": string,
  "id": string
}
字段
name

string

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

string

相应地点所在的地点 ID。

AddressDescriptor

位置的相关说明。包含一组排名靠前的附近地标、精确的包含区域及其与目标位置的关系。

JSON 表示法 
{
  "landmarks": [
    {
      object (Landmark)
    }
  ],
  "areas": [
    {
      object (Area)
    }
  ]
}
字段
landmarks[]

object (Landmark)

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

object (Area)

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

地标

地标的基本信息以及地标与目标位置的关系。

地标是可用于描述位置的醒目地点。

JSON 表示法 
{
  "name": string,
  "placeId": string,
  "displayName": {
    object (LocalizedText)
  },
  "types": [
    string
  ],
  "spatialRelationship": enum (SpatialRelationship),
  "straightLineDistanceMeters": number,
  "travelDistanceMeters": number
}
字段
name

string

地标的资源名称。
placeId

string

地标的地点 ID。
displayName

object (LocalizedText)

地标的显示名称。
types[]

string

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

enum (SpatialRelationship)

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

number

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

number

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

SpatialRelationship

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

枚举
NEAR 如果以下没有更具体的关系，则这是默认关系。
WITHIN 地标具有空间几何图形，并且目标位于其边界内。
BESIDE 目标直接位于地标旁边。
ACROSS_THE_ROAD 目标位于道路另一侧，与地标直接相对。
DOWN_THE_ROAD 与地标位于同一路线，但不在地标旁边或对面。
AROUND_THE_CORNER 不在同一路线上，但只需转一次弯即可到达。
BEHIND 靠近地标的结构，但距离其街道入口较远。

领域

区域信息以及区域与目标位置的关系。

区域包括可用于描述位置的精确子位置、社区和大型综合体。

JSON 表示法 
{
  "name": string,
  "placeId": string,
  "displayName": {
    object (LocalizedText)
  },
  "containment": enum (Containment)
}
字段
name

string

相应地区的资源名称。
placeId

string

相应区域的地点 ID。
displayName

object (LocalizedText)

相应区域的显示名称。
containment

enum (Containment)

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

contain 属性

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

枚举
CONTAINMENT_UNSPECIFIED 未指定包含关系。
WITHIN 目标位置位于区域内，靠近中心。
OUTSKIRTS 目标位置位于区域区域内，靠近边缘。
NEAR 目标位置位于区域范围之外，但距离很近。

PriceRange

与某个地点相关联的价格范围。endPrice 可以不设置，表示没有上限的范围（例如“超过 100 美元”）。

JSON 表示法 
{
  "startPrice": {
    object (Money)
  },
  "endPrice": {
    object (Money)
  }
}
字段
startPrice

object (Money)

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

object (Money)

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

ReviewSummary

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

JSON 表示法 
{
  "text": {
    object (LocalizedText)
  },
  "flagContentUri": string,
  "disclosureText": {
    object (LocalizedText)
  },
  "reviewsUri": string
}
字段
text

object (LocalizedText)

用户评价摘要。
flagContentUri

string

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

object (LocalizedText)

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

string

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

EvChargeAmenitySummary

电动车辆充电站附近设施的摘要。这仅适用于类型为 electric_vehicle_charging_station 的地点。系统保证会提供 overview 字段，而其他字段为可选字段。

JSON 表示法 
{
  "overview": {
    object (ContentBlock)
  },
  "coffee": {
    object (ContentBlock)
  },
  "restaurant": {
    object (ContentBlock)
  },
  "store": {
    object (ContentBlock)
  },
  "flagContentUri": string,
  "disclosureText": {
    object (LocalizedText)
  }
}
字段
overview

object (ContentBlock)

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

object (ContentBlock)

附近咖啡馆的选项摘要。
restaurant

object (ContentBlock)

附近餐厅的摘要。
store

object (ContentBlock)

附近商店的摘要。
flagContentUri

string

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

object (LocalizedText)

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

ContentBlock

可单独投放的内容块。

JSON 表示法 
{
  "content": {
    object (LocalizedText)
  },
  "referencedPlaces": [
    string
  ]
}
字段
content

object (LocalizedText)

与主题相关的内容。
referencedPlaces[]

string

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

NeighborhoodSummary

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

JSON 表示法 
{
  "overview": {
    object (ContentBlock)
  },
  "description": {
    object (ContentBlock)
  },
  "flagContentUri": string,
  "disclosureText": {
    object (LocalizedText)
  }
}
字段
overview

object (ContentBlock)

社区的概览摘要。
description

object (ContentBlock)

社区的详细说明。
flagContentUri

string

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

object (LocalizedText)

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

方法

autocomplete

 返回指定输入的预测结果。

get

 根据地点的资源名称（格式为 places/{place_id} 的字符串）获取地点的详细信息。

searchNearby

 搜索位置附近的地点。

searchText

 基于文本查询的地点搜索。