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

此结果的一组类型标记。例如，“political”和“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 中包含的那些实体，该数组不必包含所有包含地址的政治实体。若要检索包含特定地址的所有政治实体，您应使用反向地理编码，将地址的纬度/经度作为参数传递给请求。- 两次请求之间的响应格式不一定相同。特别是， addressComponents 的数量因所请求的地址而异，对于同一地址，其数量可能会随时间而变化。组成部分在数组中的位置会发生变化。组成部分的类型也可能发生变化。后续响应中可能缺少特定组成部分。

object (PlusCode)

地点位置的纬度/经度的 Plus 代码。

object (LatLng)

此地点的位置。

object (Viewport)

适于在平均大小的地图上显示地点的视口。

number

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

string

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

string

此地点的官方网站，例如商家的首页。请注意，对于连锁商家的地点（例如宜家商店），此处通常指单个商店（而非整个连锁店）的网站。

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 天（包括今天）的营业时间。此时间段从请求日期的午夜开始，到 6 天后的晚上 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)

电动汽车充电选项信息。

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 可能为“Australia”。

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 和 currentPrimaryOpeningHours。

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

此汇总中目前已停用的连接器数量。