Place 类
google.maps.places.Place 类
通过调用 const {Place} = await google.maps.importLibrary("places") 进行访问。请参阅 Maps JavaScript API 中的库。
构造函数 | |
|---|---|
Place |
Place(options)参数：
|
静态方法 | |
|---|---|
|
findPlaceFromPhoneNumber(request)参数：
根据指定的电话号码搜索地点。由于极少数情况下可能会有多个电话号码共用一个电话号码，因此返回数组。 |
|
findPlaceFromQuery(request)参数：
根据给定文本查询搜索地点。当查询具有轻微含糊不清且返回多个地点的情况时，会返回一个数组。此方法不适用于预计会有多个结果的搜索。 |
属性 | |
|---|---|
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 |
此地点的照片。该集合最多可包含 10 个 Photo 对象。 |
plusCode |
类型：
PlusCode optional |
priceLevel |
类型：
PriceLevel optional地点的价格水平。此属性可返回以下任一值：
|
rating |
类型：
number optional评分（1.0 到 5.0 分），根据此地点的用户评价得出。 |
requestedLanguage |
类型：
string optional此地点所请求的语言。 |
requestedRegion |
类型：
string optional此地点请求的区域。 |
reviews |
此地点的评价列表。 |
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 |
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(options)参数：
|
|
getNextOpeningTime([date])参数：
计算表示下一个 OpeningHoursTime 的日期。如果数据不足以计算结果，或者该地点未营业，则返回未定义。 |
|
isOpen([date])参数：
返回值：
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 |
营业时间，涵盖星期几（从星期日开始）并按时间顺序排列。不包括该地点未营业的天数。 |
weekdayDescriptions |
类型：
Array<string>由 7 个字符串组成的数组，用于表示每个日期（以特定格式表示）的营业时间。地点服务会根据当前语言设置营业时间的格式并进行本地化。此数组中元素的顺序取决于语言。有些语言以星期一作为一周的开始，有些语言则以星期日作为开始。 |
OpeningHoursPeriod 类
google.maps.places.OpeningHoursPeriod 类
通过调用 const {OpeningHoursPeriod} = await google.maps.importLibrary("places") 进行访问。请参阅 Maps JavaScript API 中的库。
属性 | |
|---|---|
close |
类型：
OpeningHoursPoint optionalPlace 的停业时间。 |
open |
Place 的营业时间。 |
OpeningHoursPoint 类
google.maps.places.OpeningHoursPoint 类
通过调用 const {OpeningHoursPoint} = await google.maps.importLibrary("places") 进行访问。请参阅 Maps JavaScript API 中的库。
属性 | |
|---|---|
day |
类型：
number星期几，以 [0, 6] 范围内的数字表示，从星期日开始。例如，2 表示星期二。 |
hour |
类型：
numberOpeningHoursPoint.time 的数值，以数字表示，范围为 [0, 23]。系统将会按照相应地点的时区进行报告。 |
minute |
类型：
numberOpeningHoursPoint.time 的数值（以数字表示），范围为 [0, 59]。系统将会按照相应地点的时区进行报告。 |
照片类
google.maps.places.Photo 类
通过调用 const {Photo} = await google.maps.importLibrary("places") 进行访问。请参阅 Maps JavaScript API 中的库。
属性 | |
|---|---|
authorAttributions |
要为此照片显示的提供方说明文字。 |
heightPx |
类型：
number照片的高度，以像素为单位。 |
widthPx |
类型：
number照片的宽度，以像素为单位。 |
方法 | |
|---|---|
getURI |
getURI([options])参数：
返回值：
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度数为 1/8000 度、度 1/8000 度的 Plus Code。前 4 个字符（区号）已舍弃，并替换为市行政区说明。例如：“9G8F+5W 苏黎世，瑞士”。 |
globalCode |
类型：
string optional以 1/8000 度和 1000 度为单位表示的 Plus Code。例如“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最近格式化的字符串，以适合语言和国家/地区的形式表示相对于当前时间的审核时间。例如“ 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 |
|