REST Resource: places

{
  "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)
  }
}

string

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

string

地点的唯一标识符。

object (LocalizedText)

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

string

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

string

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

object (LocalizedText)

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

string

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

string

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

string

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

string

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

object (AddressComponent)

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

object (PlusCode)

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

object (LatLng)

此地点的位置。

object (Viewport)

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

number

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

string

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

string

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

object (Review)

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

object (OpeningHours)

正常营业时间。

object (Photo)

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

string

以 adr 微格式表示的地点地址：http://microformats.org/wiki/adr。

enum (BusinessStatus)

地点的商家状态。

enum (PriceLevel)

地点的价格水平。

object (Attribution)

一组数据提供商，必须与此结果一起显示。

string

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

string

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

object (OpeningHours)

未来 7 天（包括今天）的营业时间。该时间段从请求日期的午夜开始，到六天后晚上 11:59 结束。此字段包括所有营业时间的 specialDays 子字段，该子字段用于设置特殊营业时间的日期。

object (OpeningHours)

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

object (OpeningHours)

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

object (LocalizedText)

包含地点的摘要。摘要由文本概览组成，还包含这些内容的语言代码（如果有）。摘要文本必须按原样显示，且不得修改或更改。

object (PaymentOptions)

该地点接受的付款方式。如果未提供付款方式数据，系统将取消设置付款方式字段。

object (ParkingOptions)

地点提供的停车位选项。

object (SubDestination)

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

object (FuelOptions)

有关加油站燃料选项的最新信息。此信息会定期更新。

object (EVChargeOptions)

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

object (GenerativeSummary)

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

AI 生成的地点摘要。

object (AreaSummary)

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

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

integer

此地点的时区当前与世界协调时间 (UTC) 相差的分钟数。该时区以分钟为单位表示，以便支持相差一小时的时区，例如：X 小时 15 分钟。

integer

此地点的总评价数（有无文字）。

boolean

指定商家是否支持外带。

boolean

指定商家是否支持配送。

boolean

指定商家是否支持室内还是户外就座选项。

boolean

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

boolean

指定该地点是否支持预订。

boolean

指定该地点是否供应早餐。

boolean

指定该地点是否供应午餐。

boolean

指定该地点是否供应晚餐。

boolean

指定该地点是否供应啤酒。

boolean

指定该地点是否供应葡萄酒。

boolean

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

boolean

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

boolean

地点设有户外座位。

boolean

这个地方提供现场音乐表演。

boolean

该地点提供儿童菜单。

boolean

供应鸡尾酒。

boolean

供应甜点的餐厅。

boolean

咖啡馆，供应咖啡。

boolean

这个地方很适合儿童。

boolean

此地点允许带狗。

boolean

有卫生间。

boolean

该地点可接待团体。

boolean

该地点适合观看体育赛事。

object (AccessibilityOptions)

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

{
  "text": string,
  "languageCode": string
}

string

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

string

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

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

{
  "longText": string,
  "shortText": string,
  "types": [
    string
  ],
  "languageCode": string
}

string

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

string

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

string

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

string

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

{
  "globalCode": string,
  "compoundCode": string
}

string

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

string

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

{
  "latitude": number,
  "longitude": number
}

number

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

number

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

{
  "low": {
    object (LatLng)
  },
  "high": {
    object (LatLng)
  }
}

object (LatLng)

必需。视口的低点。

object (LatLng)

必需。视口的高点。

{
  "name": string,
  "relativePublishTimeDescription": string,
  "text": {
    object (LocalizedText)
  },
  "originalText": {
    object (LocalizedText)
  },
  "rating": number,
  "authorAttribution": {
    object (AuthorAttribution)
  },
  "publishTime": string
}

string

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

string

一系列带格式的最近时间，以适用于相应语言和国家/地区的格式表示相对于当前时间的评论时间。

object (LocalizedText)

评价的本地化文本。

object (LocalizedText)

评价文字的原文。

number

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

object (AuthorAttribution)

此评价的作者。

string (Timestamp format)

评价的时间戳。

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

{
  "displayName": string,
  "uri": string,
  "photoUri": string
}

string

Photo 或 Review 作者的姓名。

string

Photo 或 Review 作者的 URI。

string

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

{
  "periods": [
    {
      object (Period)
    }
  ],
  "weekdayDescriptions": [
    string
  ],
  "secondaryHoursType": enum (SecondaryHoursType),
  "specialDays": [
    {
      object (SpecialDay)
    }
  ],
  "openNow": boolean
}

object (Period)

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

string

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

enum (SecondaryHoursType)

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

object (SpecialDay)

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

boolean

此地点目前正在营业吗？始终显示，除非我们缺少这些营业时间对应的时段或时区数据。

{
  "open": {
    object (Point)
  },
  "close": {
    object (Point)
  }
}

object (Point)

地点开始营业的时间。

object (Point)

地点开始停止营业的时间。

{
  "date": {
    object (Date)
  },
  "truncated": boolean,
  "day": integer,
  "hour": integer,
  "minute": integer
}

object (Date)

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

boolean

此端点是否被截断。当实际小时数超出我们愿意返回的时间值之间时，会发生截断，因此我们会将小时数截断回这些边界值。这可确保返回请求当天午夜最多 24 * 7 小时。

integer

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

integer

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

integer

以 2 位数表示的分钟。范围是 00 到 59。

{
  "year": integer,
  "month": integer,
  "day": integer
}

integer

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

integer

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

integer

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

{
  "date": {
    object (Date)
  }
}

object (Date)

这个特殊日子的日期。

{
  "name": string,
  "widthPx": integer,
  "heightPx": integer,
  "authorAttributions": [
    {
      object (AuthorAttribution)
    }
  ]
}

string

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

integer

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

integer

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

object (AuthorAttribution)

此照片的作者。

{
  "provider": string,
  "providerUri": string
}

string

“地点”的数据提供商的名称。

string

地点数据提供程序的 URI。

{
  "acceptsCreditCards": boolean,
  "acceptsDebitCards": boolean,
  "acceptsCashOnly": boolean,
  "acceptsNfc": boolean
}

boolean

“地方”接受信用卡付款。

boolean

“地方”接受借记卡付款。

boolean

此地点只接受现金付款。具有此属性的地点可能仍接受其他付款方式。

boolean

“地点”接受 NFC 付款。

{
  "freeParkingLot": boolean,
  "paidParkingLot": boolean,
  "freeStreetParking": boolean,
  "paidStreetParking": boolean,
  "valetParking": boolean,
  "freeGarageParking": boolean,
  "paidGarageParking": boolean
}

boolean

该地点提供免费停车场。

boolean

此地点提供付费停车场。

boolean

此地点提供免费的路边停车位。

boolean

此地点提供付费路边停车位。

boolean

提供代客泊车服务。

boolean

酒店提供免费车库。

boolean

这个地点提供付费停车库。

{
  "name": string,
  "id": string
}

string

子目的地的资源名称。

string

子目的地的地点 ID。

{
  "wheelchairAccessibleParking": boolean,
  "wheelchairAccessibleEntrance": boolean,
  "wheelchairAccessibleRestroom": boolean,
  "wheelchairAccessibleSeating": boolean
}

boolean

此地设有无障碍停车位。

boolean

地点设有无障碍入口。

boolean

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

boolean

此场所设有无障碍座席。

{
  "fuelPrices": [
    {
      object (FuelPrice)
    }
  ]
}

object (FuelPrice)

该加站中每种燃料的最新已知燃油价格。该加油站的每种燃料类型都有一个条目。顺序并不重要。

{
  "type": enum (FuelType),
  "price": {
    object (Money)
  },
  "updateTime": string
}

enum (FuelType)

燃料的类型。

object (Money)

燃料的价格。

string (Timestamp format)

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

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

{
  "currencyCode": string,
  "units": string,
  "nanos": integer
}

string

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

string (int64 format)

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

integer

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

{
  "connectorCount": integer,
  "connectorAggregation": [
    {
      object (ConnectorAggregation)
    }
  ]
}

integer

此充电站的连接器数量。不过，由于某些端口可能有多个连接器，但一次只能为一辆汽车充电（例如，连接器的数量可能会大于可同时为一辆汽车充电的汽车总数）。

object (ConnectorAggregation)

电动汽车充电连接器汇总列表，其中包含类型相同、充电费率相同的连接器。

{
  "type": enum (EVConnectorType),
  "maxChargeRateKw": number,
  "count": integer,
  "availabilityLastUpdateTime": string,
  "availableCount": integer,
  "outOfServiceCount": integer
}

enum (EVConnectorType)

此聚合的连接器类型。

number

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

integer

此汇总中的连接器数量。

string (Timestamp format)

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

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

integer

此汇总中当前可用的连接器数量。

integer

此汇总中当前已停止服务的连接器数量。

{
  "overview": {
    object (LocalizedText)
  },
  "description": {
    object (LocalizedText)
  },
  "references": {
    object (References)
  }
}

object (LocalizedText)

地点的概览。

object (LocalizedText)

地点的详细说明。

object (References)

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

{
  "reviews": [
    {
      object (Review)
    }
  ],
  "places": [
    string
  ]
}

object (Review)

用作参考文件的评价。

string

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

{
  "contentBlocks": [
    {
      object (ContentBlock)
    }
  ]
}

object (ContentBlock)

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

{
  "topic": string,
  "content": {
    object (LocalizedText)
  },
  "references": {
    object (References)
  }
}

string

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

object (LocalizedText)

与主题相关的内容。

object (References)

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

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