Place (beta)

Place 类

google.maps.places.Place 类

注意：仅在 v=beta 渠道中提供。

使用 &libraries=places 网址参数加载。请参阅 Maps JavaScript API 中的库。

使用 v=beta 时，可通过调用 const {Place} = await google.map.importLibrary("places") 进行访问。请参阅 Maps JavaScript API 中的库。

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

静态方法
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”。
icon	类型：string optional 指向可用于代表此营业地点类别的图片资源的网址。
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	类型：number optional 地点的价格水平，范围为 0 到 4 级。价格水平的解释如下： 0：免费 1：便宜 2：中等 3：昂贵 4：非常贵
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"]）。
userRatingsCount	类型：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	fetchFields(options) 参数： options：FetchFieldsRequest 返回值：Promise<{place:Place}>
getNextOpeningTime	getNextOpeningTime([date]) 参数： date：Date optional 返回值：Promise<Date optional> 计算表示下一个 OpeningHoursTime 的时间戳（以毫秒为单位，从 Epoch 起算，适合与 new Date() 搭配使用）。如果数据不足，无法计算结果，或者此地点无法正常运行，则返回未定义。
isOpen	isOpen([date]) 参数： date：Date optional 默认为现在。 返回值：Promise<boolean optional> 检查地点在指定日期是否营业。如果营业地点的已知数据不足以计算此值，例如在营业时间未注册时，使用 undefined 解析。

PlaceOptions 接口

google.maps.places.PlaceOptions接口

注意：仅在 v=beta 渠道中提供。

用于构建地点的选项。

属性
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 类

注意：仅在 v=beta 渠道中提供。

使用 &libraries=places 网址参数加载。请参阅 Maps JavaScript API 中的库。

使用 v=beta 时，可通过调用 const {AddressComponent} = await google.map.importLibrary("places") 进行访问。请参阅 Maps JavaScript API 中的库。

属性
longText	类型：string optional 地址组成部分的全文。
shortText	类型：string optional 给定地址组成部分的缩写文本。
types	类型：Array<string> 一个字符串数组，用于表示此地址组成部分的类型。您可以在此处找到有效类型的列表。

Attribution 类

google.maps.places.Attribution 类

注意：仅在 v=beta 渠道中提供。

使用 &libraries=places 网址参数加载。请参阅 Maps JavaScript API 中的库。

使用 v=beta 时，可通过调用 const {Attribution} = await google.map.importLibrary("places") 进行访问。请参阅 Maps JavaScript API 中的库。

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

FetchFieldsRequest 接口

google.maps.places.FetchFieldsRequest接口

注意：仅在 v=beta 渠道中提供。

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

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

OpeningHours 类

google.maps.places.OpeningHours 类

注意：仅在 v=beta 渠道中提供。

使用 &libraries=places 网址参数加载。请参阅 Maps JavaScript API 中的库。

使用 v=beta 时，可通过调用 const {OpeningHours} = await google.map.importLibrary("places") 进行访问。请参阅 Maps JavaScript API 中的库。

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

OpeningHoursPeriod 类

google.maps.places.OpeningHoursPeriod 类

注意：仅在 v=beta 渠道中提供。

使用 &libraries=places 网址参数加载。请参阅 Maps JavaScript API 中的库。

使用 v=beta 时，可通过调用 const {OpeningHoursPeriod} = await google.map.importLibrary("places") 进行访问。请参阅 Maps JavaScript API 中的库。

属性
close	类型：OpeningHoursPoint optional 该地点的结束营业时间。
open	类型：OpeningHoursPoint 该地点的开业时间。

OpeningHoursPoint 类

google.maps.places.OpeningHoursPoint 类

注意：仅在 v=beta 渠道中提供。

使用 &libraries=places 网址参数加载。请参阅 Maps JavaScript API 中的库。

使用 v=beta 时，可通过调用 const {OpeningHoursPoint} = await google.map.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 类

注意：仅在 v=beta 渠道中提供。

使用 &libraries=places 网址参数加载。请参阅 Maps JavaScript API 中的库。

使用 v=beta 时，可通过调用 const {Photo} = await google.map.importLibrary("places") 进行访问。请参阅 Maps JavaScript API 中的库。

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

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

PhotoAttribution 类

google.maps.places.PhotoAttribution 类

注意：仅在 v=beta 渠道中提供。

使用 &libraries=places 网址参数加载。请参阅 Maps JavaScript API 中的库。

使用 v=beta 时，可通过调用 const {PhotoAttribution} = await google.map.importLibrary("places") 进行访问。请参阅 Maps JavaScript API 中的库。

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

PlusCode 类

google.maps.places.PlusCode 类

注意：仅在 v=beta 渠道中提供。

使用 &libraries=places 网址参数加载。请参阅 Maps JavaScript API 中的库。

使用 v=beta 时，可通过调用 const {PlusCode} = await google.map.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 类

注意：仅在 v=beta 渠道中提供。

使用 &libraries=places 网址参数加载。请参阅 Maps JavaScript API 中的库。

使用 v=beta 时，可通过调用 const {Review} = await google.map.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”。