REST Resource: places

资源：地点

表示地点的所有信息。

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 悉尼”“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
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 设置为 0，将 hour 设置为 0，并将 minute 设置为 0。
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)

包含接下来七天的一系列条目，包括商家次要营业时间的相关信息。辅助营业时间不同于商家的主营业时间。例如，餐厅可以将自助取餐时间或外卖时间指定为次要营业时间。此字段用于填充“type”子字段，该字段会根据地点的类型从预定义的营业时间类型列表（例如 DRIVE_THROUGH、PICKUP 或 TAKEOUT）中提取数据。此字段包含所有小时的 specialDays 子字段，用于为具有特殊营业时间的日期设置。
regularSecondaryOpeningHours[]

object (OpeningHours)

包含一系列条目，用于提供有关商家常规次要营业时间的信息。辅助营业时间不同于商家的主营业时间。例如，餐厅可以将自助取餐时间或外卖时间指定为次要营业时间。此字段用于填充“type”子字段，该字段会根据地点的类型从预定义的营业时间类型列表（例如 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://github.com/google/libaddressinput。- 在使用某个字段的国家/地区之外，不应向用户显示用于输入或修改该字段的界面元素。

如需详细了解如何使用此架构，请参阅：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 中。可以在没有地理编码的情况下非常近似地设置此地址的格式，但是在至少部分完成之前，不能对任何地址组成部分进行语义推理。

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

string

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

string

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

AddressComponent

构成格式化地址的结构化组成部分（如果有）。

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

string

地址组成部分的完整文本说明或名称。例如，澳大利亚这个国家/地区的地址组成部分的 long_name 可能为“Australia”。
shortText

string

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

string

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

string

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

PlusCode

Plus Code（http://plus.codes）是一种位置参考，有两种格式：全局代码（定义 14 米 x 14 米 [1/8,000 度] 或更小的矩形）和复合代码（将前缀替换为参考位置）。

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

string

地点的全局（完整）代码，例如“9FWM33GV+HQ”，表示 1/8, 000 度 x 1/8,000 度（约 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)

此地点在一周内正常营业的时间段。这些时段按时间顺序排列，从地点当地时区的星期日开始。空值（但不为缺失值）表示相应地点从未营业，例如因装修而暂时停业。
weekdayDescriptions[]

string

用于描述此地点营业时间的本地化字符串，一周内每天对应一个字符串。如果小时数未知或无法转换为本地化文本，则为空。示例：“周日：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 卡车柴油。

金钱

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

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] 分组的电动车辆充电信息。显示具有相同类型和最大充电速率（以千瓦为单位）的充电桩的 EV 充电汇总数据。

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 类型 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)
  }
}
字段
text

object (LocalizedText)

用户评价摘要。
flagContentUri

string

一个链接，供用户举报摘要存在的问题。
disclosureText

object (LocalizedText)

AI 披露消息“由 Gemini 总结”（及其本地化变体）。此字段将采用请求中指定的语言（如果有）。

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

被引用地点的资源名称列表。此名称可用于接受地点资源名称的其他 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

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