此页面由 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` 此地点的照片。该集合最多可包含 10 个 `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 的时间戳（以毫秒为单位，从 Epoch 起算，适合与 `new Date()` 搭配使用）。如果数据不足，无法计算结果，或者此地点无法正常运行，则返回未定义。
`isOpen`	注意：仅在 v=beta 渠道中提供。 `isOpen([date])` 参数： `date`：`Date optional` 默认为现在。返回值：`Promise<boolean optional>` 检查地点在指定日期是否营业。如果营业地点的已知数据不足以计算此值，例如在营业时间未注册时，使用 `undefined` 解析。

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>` 由 7 个字符串组成的数组，这些字符串表示以特定格式表示的一周内每一天的营业时间。地点服务会根据当前语言来设置营业时间的格式，并进行本地化。此数组中元素的顺序取决于语言。有些语言以星期一作为一周的开始，有些语言则以星期日作为开始。

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] 为单位。系统会按照该地点的时区进行报告。

照片类

google.maps.places.Photo 类

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

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

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

PhotoAttribution 类

google.maps.places.PhotoAttribution 类

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

属性
`author`	类型：`string` 要为此照片结果显示的提供方说明文本。
`authorURI`	类型：`string optional`

PlusCode 类

google.maps.places.PlusCode 类

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

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

Review 类

google.maps.places.Review 类

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

属性
`author`	类型：`string optional` 评价者的姓名。
`authorPhotoURI`	类型：`string optional` 更新者个人资料图片的网址。
`authorURI`	类型：`string optional` 评价者个人资料的网址。
`publishTime`	类型：`Date optional`
`rating`	类型：`number optional` 评价的评分，是一个 1.0 到 5.0 之间的数字（含 1.0 和 5.0）。
`relativePublishTimeDescription`	类型：`string optional` 最近格式化的一个字符串，以适合相应语言和国家/地区的形式表示相对于当前时间的审核时间。例如，“1 个月前”。
`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 类

属性

照片类

属性

方法

PhotoAttribution 类

属性

PlusCode 类

属性

Review 类

属性

PriceLevel 常量

常量