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,
  "addressComponents": [
    {
      object (AddressComponent)
    }
  ],
  "plusCode": {
    object (PlusCode)
  },
  "location": {
    object (LatLng)
  },
  "viewport": {
    object (Viewport)
  },
  "rating": number,
  "googleMapsUri": string,
  "websiteUri": string,
  "reviews": [
    {
      object (Review)
    }
  ],
  "regularOpeningHours": {
    object (OpeningHours)
  },
  "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)
  },
  "areaSummary": {
    object (AreaSummary)
  },
  "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)
  }
}
字段
name

string

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

string

地点的唯一标识符。
displayName

object (LocalizedText)

地点的本地化名称，适合作为人类可读的简短说明。例如，“Google Sydney”、“Starbucks”、“Pyrmont”等。
types[]

string

此结果的一组类型标记。例如：“政治”和“locality”。如需查看可能值的完整列表，请参阅表 A 和表 B（网址为 https://developers.google.com/maps/documentation/places/web-service/place-types）
primaryType

string

给定结果的主要类型。此类型必须是 Places API 支持的类型之一。例如，“餐馆”“咖啡馆”“机场”等。一个地点只能有一个主要类型。如需查看可能值的完整列表，请参阅表 A 和表 B（网址为 https://developers.google.com/maps/documentation/places/web-service/place-types）
primaryTypeDisplayName

object (LocalizedText)

主要类型的显示名称，已本地化为请求所用语言（如果适用）。如需查看可能值的完整列表，请参阅表 A 和表 B（网址为 https://developers.google.com/maps/documentation/places/web-service/place-types）
nationalPhoneNumber

string

为地点提供的人类可读电话号码，采用全国性格式。
internationalPhoneNumber

string

地点的直观易懂的电话号码，采用国际电话号码格式。
formattedAddress

string

人类可读的此地点的完整地址。
shortFormattedAddress

string

此地的可人工读取的简短地址。
addressComponents[]

object (AddressComponent)

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

object (PlusCode)

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

object (LatLng)

此地点的位置。
viewport

object (Viewport)

适合在一般尺寸地图上显示相应地点的视口。
rating

number

1.0 到 5.0 之间的评分，基于对此地点的用户评价。
googleMapsUri

string

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

string

此地点的官方网站，例如企业首页。请注意，对于连锁店（例如 IKEA 商店）中的地点，此网址通常是单个商店（而非整个连锁店）的网站。
reviews[]

object (Review)

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

object (OpeningHours)

正常营业时间。
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)

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

AI 生成的地点摘要。
areaSummary

object (AreaSummary)

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

AI 针对地点所在区域生成的摘要。
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)

有关地点提供的无障碍选项的信息。

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。

AddressComponent

构成设置了格式的地址的结构化组件（如果有这些信息）。

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

string

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

string

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

string

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

string

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

PlusCode

Plus Code (http://plus.codes) 是采用两种格式的位置引用：定义 14mx14 米（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
}
字段
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)

评价的时间戳。

时间戳采用 RFC3339 世界协调时间（UTC，即“祖鲁时”）格式，精确到纳秒，最多九个小数位。示例："2014-10-02T15:01:23Z" 和 "2014-10-02T15:01:23.045123456Z"。

AuthorAttribution

用户生成的内容数据作者的相关信息。在 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)
    }
  ],
  "openNow": boolean
}
字段
periods[]

object (Period)

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

string

描述此地点营业时间的本地化字符串，一周中的每一天都使用一个字符串。如果营业时间未知或无法转换为本地化文本，则此字段为空。示例：“周日：18:00–06:00”
secondaryHoursType

enum (SecondaryHoursType)

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

object (SpecialDay)

在返回的营业时间涵盖的时段内的特殊日期的结构化信息。特殊日期是指可能影响地点营业时间的日期，例如圣诞节。如果有特别营业时间，针对 currentOpeningHours 和 currentsecondaryOpeningHours 进行设置。
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

以 2 位数表示的小时数。范围是 00 到 23。
minute

integer

以 2 位数表示的分钟。范围是 00 到 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)

这个特殊日子的日期。

照片

地点照片的相关信息。

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

string

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

integer

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

integer

可用高度上限（以像素为单位）。
authorAttributions[]

object (AuthorAttribution)

此照片的作者。

BusinessStatus

地点的商家状态。

枚举
BUSINESS_STATUS_UNSPECIFIED 默认值。此值未使用。
OPERATIONAL 此场所已开通运营，不一定正在营业。
CLOSED_TEMPORARILY 此场所已暂停营业。
CLOSED_PERMANENTLY 此场所已永久停业。

PriceLevel

地点的价格水平。

枚举
PRICE_LEVEL_UNSPECIFIED 地点价位未指定或未知。
PRICE_LEVEL_FREE Place 提供免费服务。
PRICE_LEVEL_INEXPENSIVE Place 提供廉价服务。
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)

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

时间戳采用 RFC3339 世界协调时间（UTC，即“祖鲁时”）格式，精确到纳秒，最多九个小数位。示例："2014-10-02T15:01:23Z" 和 "2014-10-02T15:01:23.045123456Z"。

FuelType

燃料类型。

枚举
FUEL_TYPE_UNSPECIFIED 未指定的燃料类型。
DIESEL 柴油。
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。
METHANE 甲烷。
BIO_DIESEL 生物柴油。
TRUCK_DIESEL 卡车柴油。

金钱

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

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

string

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

string (int64 format)

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

integer

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

EVChargeOptions

在 Place 中托管的电动车辆充电站的相关信息。相关术语遵循 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)

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

时间戳采用 RFC3339 世界协调时间（UTC，即“祖鲁时”）格式，精确到纳秒，最多九个小数位。示例："2014-10-02T15:01:23Z" 和 "2014-10-02T15:01:23.045123456Z"。
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 组合 2 (CCS2) 或 GB/T）。此值不太代表实际的连接器类型，而更表示在特斯拉自有充电站为特斯拉品牌车辆充电的能力。
EV_CONNECTOR_TYPE_UNSPECIFIED_GB_T GB/T 类型对应于中国的 GB/T 标准。此类型涵盖所有 GB_T 类型。
EV_CONNECTOR_TYPE_UNSPECIFIED_WALL_OUTLET 未指定的墙壁插座。

GenerativeSummary

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

AI 生成的地点摘要。

JSON 表示法 
{
  "overview": {
    object (LocalizedText)
  },
  "description": {
    object (LocalizedText)
  },
  "references": {
    object (References)
  }
}
字段
overview

object (LocalizedText)

地点的概览。
description

object (LocalizedText)

地点的详细说明。
references

object (References)

用于生成摘要说明的参考。

参考

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

与生成式内容相关的参考文件。

JSON 表示法 
{
  "reviews": [
    {
      object (Review)
    }
  ],
  "places": [
    string
  ]
}
字段
reviews[]

object (Review)

用作参考文件的评价。
places[]

string

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

AreaSummary

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

AI 针对地点所在区域生成的摘要。

JSON 表示法 
{
  "contentBlocks": [
    {
      object (ContentBlock)
    }
  ]
}
字段
contentBlocks[]

object (ContentBlock)

构成区域摘要的内容块。每个区块都有关于该区域的独立主题。

ContentBlock

可单独传送的内容块。

JSON 表示法 
{
  "topic": string,
  "content": {
    object (LocalizedText)
  },
  "references": {
    object (References)
  }
}
字段
topic

string

内容的主题，例如“概览”或“餐馆”。
content

object (LocalizedText)

与主题相关的内容。
references

object (References)

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

与这些内容块相关的参考文件。

方法

autocomplete

 返回对指定输入的预测。

get

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

searchNearby

 搜索地点附近的地点。

searchText

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