此页面由 Cloud Translation API 翻译。

Place (beta)

Place 类

google.maps.places.Place 类

通过调用 const {Place} = await google.maps.importLibrary("places") 进行访问。请参阅 Maps JavaScript API 中的库。

构造函数
`Place`	`Place(options)` 参数： `options`：`PlaceOptions`

静态方法
`findPlaceFromPhoneNumber`	注意：仅适用于 v=beta 渠道。 `findPlaceFromPhoneNumber(request)` 参数： `request`：`FindPlaceFromPhoneNumberRequest` 包含电话号码和所请求字段的请求。返回值：`Promise<{places:Array<Place>}>` 根据指定电话号码搜索地点。在极少数情况下，多个地点可能共用一个电话号码，因此返回一个数组。
`findPlaceFromQuery`	注意：仅适用于 v=beta 渠道。 `findPlaceFromQuery(request)` 参数： `request`：`FindPlaceFromQueryRequest` 包含文本查询和所请求字段的请求。返回值：`Promise<{places:Array<Place>}>` 基于指定文本查询搜索地点。如果查询有轻微不明确的情况，并且返回了多个地点，则会返回一个数组。此方法不适用于预计有多个结果的搜索。

静态方法

findPlaceFromPhoneNumber

findPlaceFromPhoneNumber(request)

参数：

request：FindPlaceFromPhoneNumberRequest 包含电话号码和所请求字段的请求。

返回值：Promise<{places:Array<Place>}>

根据指定电话号码搜索地点。在极少数情况下，多个地点可能共用一个电话号码，因此返回一个数组。

findPlaceFromQuery

findPlaceFromQuery(request)

参数：

request：FindPlaceFromQueryRequest 包含文本查询和所请求字段的请求。

返回值：Promise<{places:Array<Place>}>

基于指定文本查询搜索地点。如果查询有轻微不明确的情况，并且返回了多个地点，则会返回一个数组。此方法不适用于预计有多个结果的搜索。

属性
`addressComponents`	类型：`Array<AddressComponent> optional` 该地点营业地点的地址组成部分集合。如果没有已知的地址数据，则为空对象。如果未从服务器调用地址数据，则为 `undefined`。
`adrFormatAddress`	类型：`string optional` 以 adr 微格式表示的地方地址。
`attributions`	类型：`Array<Attribution> optional` 要针对此地点结果显示的提供方说明文本。
`businessStatus`	类型：`BusinessStatus optional` 营业地点的营业状态。如果尚无已知状态，则返回 `null`。如果状态数据尚未从服务器加载，则为 `undefined`。
`displayName`	类型：`string optional` 营业地点的显示名称。如果没有名称，则为 `null`。如果姓名数据尚未从服务器加载，则为 `undefined`。
`formattedAddress`	类型：`string optional` 营业地点的完整地址。
`googleMapsURI`	类型：`string optional` 此地点的官方 Google 页面的网址。这是由 Google 拥有的页面，其中包含有关该地方的最佳可用信息。
`hasCurbsidePickup`	类型：`boolean optional` 地点是否提供路边自提。如果值已知，则返回“true”或“false”。如果值未知，则返回“null”。如果尚未请求此字段，则返回“undefined”。
`hasDelivery`	类型：`boolean optional` 某个地点是否提供送餐服务。如果值已知，则返回“true”或“false”。如果值未知，则返回“null”。如果尚未请求此字段，则返回“undefined”。
`hasDineIn`	类型：`boolean optional` 某个地点是否堂食。如果值已知，则返回“true”或“false”。如果值未知，则返回“null”。如果尚未请求此字段，则返回“undefined”。
`hasTakeout`	类型：`boolean optional` 某个地点是否提供外卖服务。如果值已知，则返回“true”或“false”。如果值未知，则返回“null”。如果尚未请求此字段，则返回“undefined”。
`hasWheelchairAccessibleEntrance`	类型：`boolean optional` 地点是否有无障碍入口。如果值已知，则返回“true”或“false”。如果值未知，则返回“null”。如果尚未请求此字段，则返回“undefined”。
`iconBackgroundColor`	类型：`string optional` 地点类别的默认十六进制颜色码。
`id`	类型：`string` 唯一地点 ID。
`internationalPhoneNumber`	类型：`string optional` 地点的电话号码（采用国际电话号码格式）。国际格式包含国家/地区代码，并且带有一个加号 (+) 前缀。
`isReservable`	类型：`boolean optional` 地点是否可预订。如果值已知，则返回“true”或“false”。如果值未知，则返回“null”。如果尚未请求此字段，则返回“undefined”。
`location`	类型：`LatLng optional` 地点的位置。
`nationalPhoneNumber`	类型：`string optional` 该地点的电话号码，其格式遵循号码的地区惯例。
`openingHours`	类型：`OpeningHours optional`
`photos`	类型：`Array<Photo> optional` 此地点的照片。该集合最多包含十个 `Photo` 对象。
`plusCode`	类型：`PlusCode optional`
`priceLevel`	类型：`PriceLevel optional` 地点的价格水平。此属性可以返回以下任意值： `Free` `Inexpensive` `Moderate` `Expensive` `Very Expensive`
`rating`	类型：`number optional` 一个评分（在 1.0 到 5.0 之间），这是根据用户对该地方的评价得出。
`requestedLanguage`	类型：`string optional` 此地点所请求的语言。
`requestedRegion`	类型：`string optional` 为此地点请求的区域。
`reviews`	类型：`Array<Review> optional` 此“地方”的评价列表。
`servesBeer`	类型：`boolean optional` 地点是否供应啤酒。如果值已知，则返回“true”或“false”。如果值未知，则返回“null”。如果尚未请求此字段，则返回“undefined”。
`servesBreakfast`	类型：`boolean optional` 某个地点是否供应早餐。如果值已知，则返回“true”或“false”。如果值未知，则返回“null”。如果尚未请求此字段，则返回“undefined”。
`servesBrunch`	类型：`boolean optional` 某个地点是否供应早午餐。如果值已知，则返回“true”或“false”。如果值未知，则返回“null”。如果尚未请求此字段，则返回“undefined”。
`servesDinner`	类型：`boolean optional` 某个地点是否供应晚餐。如果值已知，则返回“true”或“false”。如果值未知，则返回“null”。如果尚未请求此字段，则返回“undefined”。
`servesLunch`	类型：`boolean optional` 某个地点是否供应午餐。如果值已知，则返回“true”或“false”。如果值未知，则返回“null”。如果尚未请求此字段，则返回“undefined”。
`servesVegetarianFood`	类型：`boolean optional` 某个地点是否供应素食。如果值已知，则返回“true”或“false”。如果值未知，则返回“null”。如果尚未请求此字段，则返回“undefined”。
`servesWine`	类型：`boolean optional` 某个地点是否供应葡萄酒。如果值已知，则返回“true”或“false”。如果值未知，则返回“null”。如果尚未请求此字段，则返回“undefined”。
`svgIconMaskURI`	类型：`string optional` 指向可用于表示地点类别的 svg 图片遮罩资源的 URI。
`types`	类型：`Array<string> optional` 该地方的类型数组（例如 `["political", "locality"]` 或 `["restaurant", "establishment"]`）。
`userRatingCount`	类型：`number optional` 让此地点的`Place.rating`获得的用户评分数量。
`utcOffsetMinutes`	类型：`number optional` 地点当前时区与世界协调时间 (UTC) 的偏移量（以分钟为单位）。例如，采用夏令时的奥地利东部标准时间 (GMT+10) 比 UTC 早 11 小时，因此 `utc_offset_minutes` 将为 `660`。对于晚于世界协调时间 (UTC) 的时区，时差为负数。例如，对于佛得角，`utc_offset_minutes` 为 `-60`。
`viewport`	类型：`LatLngBounds optional` 在地图上显示该地方时的首选视口。
`websiteURI`	类型：`string optional` 此地方的官方网站，例如商家的首页。

方法
`fetchFields`	注意：仅适用于 v=beta 渠道。 `fetchFields(options)` 参数： `options`：`FetchFieldsRequest` 返回值：`Promise<{place:Place}>`
`getNextOpeningTime`	注意：仅适用于 v=beta 渠道。 `getNextOpeningTime([date])` 参数： `date`：`Date optional` 返回值：`Promise<Date optional>` 计算表示下一个 OpeningHoursTime 的日期。如果数据不足以计算结果，或者此地点不再营业，则返回 undefined。
`isOpen`	注意：仅适用于 v=beta 渠道。 `isOpen([date])` 参数： `date`：`Date optional` 默认为现在。返回值：`Promise<boolean optional>` 检查地点在指定日期时间是否正常营业。如果营业地点的已知数据不足以计算此值（例如营业时间未登记），则解析为 `undefined`。
`toJSON`	`toJSON()` 参数：无返回值：`Object` 是一个 JSON 对象，其中包含所有所请求的地点属性。

PlaceOptions 接口

google.maps.places.PlaceOptions 接口

用于构建地点的选项。

属性
`id`	类型：`string` 唯一地点 ID。
`requestedLanguage optional`	类型：`string optional` 应返回详细信息时使用的语言的语言标识符。请参阅支持的语言列表。
`requestedRegion optional`	类型：`string optional` 用户所在地区的地区代码。这可能会影响可能会返回哪些照片，还可能会影响其他设置。地区代码接受 ccTLD（“顶级域名”）双字符值。多数 ccTLD 代码都与 ISO 3166-1 代码相同，但也有一些需要注意的例外情况。例如，英国的 ccTLD 为“uk”(`.co.uk`)，而其 ISO 3166-1 代码为“gb”（专指“大不列颠及北爱尔兰联合王国”）。

AddressComponent 类

google.maps.places.AddressComponent 类

通过调用 const {AddressComponent} = await google.maps.importLibrary("places") 进行访问。请参阅 Maps JavaScript API 中的库。

属性
`longText`	类型：`string optional` 地址组成部分的完整文本。
`shortText`	类型：`string optional` 指定地址组成部分的简短缩写文本。
`types`	类型：`Array<string>` 一个字符串数组，表示此地址组成部分的类型。如需查看有效类型的列表，请点击此处。

Attribution 类

google.maps.places.Attribution 类

通过调用 const {Attribution} = await google.maps.importLibrary("places") 进行访问。请参阅 Maps JavaScript API 中的库。

属性
`provider`	类型：`string optional` 要针对此地点结果显示的提供方说明文本。
`providerURI`	类型：`string optional`

FetchFieldsRequest 接口

google.maps.places.FetchFieldsRequest 接口

用于提取地点字段的选项。

属性
`fields`	类型：`Array<string>` 要提取的字段的列表。
`sessionToken optional`	类型：`AutocompleteSessionToken optional` 用于将详情请求与自动补全会话捆绑在一起的唯一引用。

OpeningHours 类

google.maps.places.OpeningHours 类

通过调用 const {OpeningHours} = await google.maps.importLibrary("places") 进行访问。请参阅 Maps JavaScript API 中的库。

属性
`periods`	类型：`Array<OpeningHoursPeriod>` 开放时段涵盖一周中的每一天，从星期日开始，按时间顺序排列。不包括该地点未营业的日期。
`weekdayDescriptions`	类型：`Array<string>` 由七个字符串组成的数组，以特定格式表示一周内每天的营业时间。地点服务会根据当前语言对营业时间进行适当的格式设置和本地化。此数组中元素的顺序取决于语言。有些语言以星期一作为一周的开始，有些语言则以星期日作为开始。

OpeningHoursPeriod 类

google.maps.places.OpeningHoursPeriod 类

通过调用 const {OpeningHoursPeriod} = await google.maps.importLibrary("places") 进行访问。请参阅 Maps JavaScript API 中的库。

属性
`close`	类型：`OpeningHoursPoint optional` 地点的打烊时间。
`open`	类型：`OpeningHoursPoint` 地点的营业时间。

OpeningHoursPoint 类

google.maps.places.OpeningHoursPoint 类

通过调用 const {OpeningHoursPoint} = await google.maps.importLibrary("places") 进行访问。请参阅 Maps JavaScript API 中的库。

属性
`day`	类型：`number` 一周中的某天，以 [0, 6] 范围内的数字表示，从星期日开始。例如，2 表示星期二。
`hour`	类型：`number` OpeningHoursPoint.time 的小时，以数字表示，范围为 [0, 23]。系统会按照该地点的时区报告这一数据。
`minute`	类型：`number` OpeningHoursPoint.time 的分钟，以数字表示，范围为 [0, 59]。系统会按照该地点的时区报告这一数据。

Photo 类

google.maps.places.Photo 类

通过调用 const {Photo} = await google.maps.importLibrary("places") 进行访问。请参阅 Maps JavaScript API 中的库。

属性
`authorAttributions`	类型：`Array<AuthorAttribution>` 要为此照片显示的提供方说明文本。
`heightPx`	类型：`number` 照片的高度（以像素为单位）。
`widthPx`	类型：`number` 照片的宽度（以像素为单位）。

方法
`getURI`	`getURI([options])` 参数： `options`：`PhotoOptions optional` 返回值：`string` 返回与指定选项对应的图片网址。

AuthorAttribution 类

google.maps.places.AuthorAttribution 类

通过调用 const {AuthorAttribution} = await google.maps.importLibrary("places") 进行访问。请参阅 Maps JavaScript API 中的库。

属性
`displayName`	类型：`string` 此结果的作者姓名。
`photoURI`	类型：`string optional` 此结果的作者的照片 URI。此信息有时可能无法使用。
`uri`	类型：`string optional` 此结果的作者个人资料 URI。

PlusCode 类

google.maps.places.PlusCode 类

通过调用 const {PlusCode} = await google.maps.importLibrary("places") 进行访问。请参阅 Maps JavaScript API 中的库。

属性
`compoundCode`	类型：`string optional` 一个 Plus Code，其 1/8000 度乘以 1/8000 度区域，其中的前四个字符（区号）会被丢弃，并替换为市行政区说明。例如：“9G8F+5W Zurich, Indonesia”。
`globalCode`	类型：`string optional` 一个 Plus 代码，其面积为 1/8000 度，占面积的 1/8000。例如：“8FVC9G8F+5W”。

Review 类

google.maps.places.Review 类

通过调用 const {Review} = await google.maps.importLibrary("places") 进行访问。请参阅 Maps JavaScript API 中的库。

属性
`authorAttribution`	类型：`AuthorAttribution optional` 评价者。
`publishTime`	类型：`Date optional`
`rating`	类型：`number optional` 此评价的评分，1.0 到 5.0 之间的数字（含 1.0 和 5.0）。
`relativePublishTimeDescription`	类型：`string optional` 一个带格式的最近时间字符串，以适合相应语言和国家/地区的形式表示相对于当前时间的评价时间。例如“一个月前”。
`text`	类型：`string optional` 评价的文字。
`textLanguageCode`	类型：`string optional` 表示撰写此评价所用语言的 IETF 语言代码。请注意，此代码仅包含主要语言标记，不包含任何指示国家或地区的辅助标记。例如，所有英文评价都标记为 `'en'`，而不是“en-AU”或“en-UK”。

PriceLevel 常量

google.maps.places.PriceLevel 常量

Place 对象的价格级枚举。

通过调用 const {PriceLevel} = await google.maps.importLibrary("places") 进行访问。请参阅 Maps JavaScript API 中的库。

常量
`EXPENSIVE`
`FREE`
`INEXPENSIVE`
`MODERATE`
`VERY_EXPENSIVE`

Place (beta)

Place 类

构造函数

静态方法

属性

方法

PlaceOptions 接口

属性

AddressComponent 类

属性

Attribution 类

属性

FetchFieldsRequest 接口

属性

OpeningHours 类

属性

OpeningHoursPeriod 类

属性

OpeningHoursPoint 类

属性

Photo 类

属性

方法

AuthorAttribution 类

属性

PlusCode 类

属性

Review 类

属性

PriceLevel 常量

常量