Place 类
google.maps.places.Place 类
此类实现了 PlaceOptions。
通过调用 const {Place} = await google.maps.importLibrary("places") 进行访问。
请参阅 Maps JavaScript API 中的库。
构造函数 | |
|---|---|
Place |
Place(options)参数：
|
静态方法 | |
|---|---|
searchByText |
searchByText(request)参数：
基于文本查询的地点搜索。 |
searchNearby |
searchNearby(request)参数：
搜索附近的地点。 |
属性 | |
|---|---|
accessibilityOptions |
类型：
AccessibilityOptions optional此地点的无障碍选项。如果尚未从服务器调用无障碍选项数据，则为 undefined。 |
addressComponents |
类型：
Array<AddressComponent> optional相应地点的地址组成部分集合。如果没有已知的地址数据，则为空对象。如果尚未从服务器调用地址数据，则为 undefined。 |
adrFormatAddress |
类型：
string optional以 adr 微格式表示的 Place 的地址。 |
allowsDogs |
类型：
boolean optional |
attributions |
类型：
Array<Attribution> optional要针对此地点结果显示的提供方说明文本。 |
businessStatus |
类型：
BusinessStatus optional相应位置的营业状态。如果不存在已知状态，则为 null。如果尚未从服务器加载状态数据，则为 undefined。 |
displayName |
类型：
string optional位置的显示名称。如果不存在名称，则为 null。如果尚未从服务器加载名称数据，则为 undefined。 |
displayNameLanguageCode |
类型：
string optional地理位置显示名称的语言。如果不存在名称，则为 null。如果尚未从服务器加载名称数据，则为 undefined。 |
editorialSummary |
类型：
string optional相应地点的编辑摘要。如果没有编辑摘要，则返回 null。如果尚未请求此字段，则为 undefined。 |
editorialSummaryLanguageCode |
类型：
string optional相应地点的编辑摘要所用的语言。如果没有编辑摘要，则返回 null。如果尚未请求此字段，则为 undefined。 |
evChargeOptions |
类型：
EVChargeOptions optional地点提供的电动汽车充电选项。如果尚未从服务器调用电动汽车充电选项，则为 undefined。 |
formattedAddress |
类型：
string optional相应地点的完整地址。 |
fuelOptions |
类型：
FuelOptions optional地点提供的燃料选项。如果尚未从服务器中调用燃料选项，则为 undefined。 |
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”。 |
hasLiveMusic |
类型：
boolean optional |
hasMenuForChildren |
类型：
boolean optional |
hasOutdoorSeating |
类型：
boolean optional |
hasRestroom |
类型：
boolean optional |
hasTakeout |
类型：
boolean optional某个场所是否提供外卖服务。如果值已知，则返回“true”或“false”。如果值未知，则返回“null”。如果尚未请求此字段，则返回“undefined”。 |
iconBackgroundColor |
类型：
string optional地点类别的默认十六进制颜色代码。 |
id |
类型：
string唯一地点 ID。 |
internationalPhoneNumber |
类型：
string optional地点的电话号码（采用国际电话号码格式）。国际格式包含国家/地区代码，并且带有一个加号 (+) 前缀。 |
isGoodForChildren |
类型：
boolean optional |
isGoodForGroups |
类型：
boolean optional |
isGoodForWatchingSports |
类型：
boolean optional |
isReservable |
类型：
boolean optional某个地点是否可预订。如果值已知，则返回“true”或“false”。如果值未知，则返回“null”。如果尚未请求此字段，则返回“undefined”。 |
location |
类型：
LatLng optional地点的位置。 |
nationalPhoneNumber |
类型：
string optional地点的电话号码，其格式遵循号码的地区惯例。 |
parkingOptions |
类型：
ParkingOptions optional地点提供的停车选项。如果尚未从服务器请求停车选项数据，则为 undefined。 |
paymentOptions |
类型：
PaymentOptions optional地点提供的付款方式。如果尚未从服务器调用付款选项数据，则为 undefined。 |
photos |
此地点的照片。该集合最多包含 10 个 Photo 对象。 |
plusCode |
类型：
PlusCode optional |
postalAddress |
类型：
PostalAddress optional |
priceLevel |
类型：
PriceLevel optional相应地点的价格水平。此属性可以返回以下任一值
|
priceRange |
类型：
PriceRange optional相应地点的价格范围。 endPrice 可以不设置，表示没有上限的范围（例如“超过 100 美元”）。 |
primaryType |
类型：
string optional位置的主要类型。如果没有类型，则为 null。如果尚未从服务器加载类型数据，则为 undefined。 |
primaryTypeDisplayName |
类型：
string optional营业地点的主要类型显示名称。如果没有类型，则为 null。如果尚未从服务器加载类型数据，则为 undefined。 |
primaryTypeDisplayNameLanguageCode |
类型：
string optional营业地点主要类型的显示名称所用的语言。如果没有类型，则为 null。如果尚未从服务器加载类型数据，则为 undefined。 |
rating |
类型：
number optional根据用户对相应地点的评价得出的评分，介于 1.0 到 5.0 之间。 |
regularOpeningHours |
类型：
OpeningHours optional |
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”。 |
servesCocktails |
类型：
boolean optional |
servesCoffee |
类型：
boolean optional |
servesDessert |
类型：
boolean optional |
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此地点的权威网站，例如商家主页。 |
|
类型：
OpeningHours optional |
|
类型：
boolean optional |
方法 | |
|---|---|
fetchFields |
fetchFields(options)参数：
|
|
getNextOpeningTime([date])参数：
计算表示下一个 OpeningHoursTime 的日期。如果数据不足以计算结果，或者相应地点不营业，则返回未定义。 |
|
isOpen([date])参数：
返回值：
Promise<boolean optional>检查相应地点在指定日期时间是否开放。如果位置的已知数据不足以计算此值，例如营业时间未注册，则会以 undefined 进行解析。 |
toJSON |
toJSON()参数：无
返回值：包含所有请求的 Place 属性的 JSON 对象
Object。 |
PlaceOptions 接口
google.maps.places.PlaceOptions
接口
用于构建 Place 的选项。
属性 | |
|---|---|
id |
类型：
string唯一地点 ID。 |
requestedLanguage optional |
类型：
string optional一种语言标识符，用于指定应以哪种语言返回详细信息。请参阅支持的语言列表。 |
requestedRegion optional |
类型：
string optional用户所在地区的地区代码。这可能会影响返回的照片，还可能会影响其他方面。地区代码接受 ccTLD（“顶级域名”）双字符值。多数 ccTLD 代码都与 ISO 3166-1 代码相同，但也有一些需要注意的例外情况。例如，英国的 ccTLD 为“uk”( .co.uk)，而其 ISO 3166-1 代码为“gb”（从技术上讲，是指“大不列颠及北爱尔兰联合王国”这一实体）。 |
AccessibilityOptions 类
google.maps.places.AccessibilityOptions 类
通过调用 const {AccessibilityOptions} = await google.maps.importLibrary("places") 进行访问。
请参阅 Maps JavaScript API 中的库。
属性 | |
|---|---|
hasWheelchairAccessibleEntrance |
类型：
boolean optional某个地点是否有无障碍入口。如果值已知，则返回“true”或“false”。如果值未知，则返回“null”。 |
hasWheelchairAccessibleParking |
类型：
boolean optional某个地点是否有无障碍停车位。如果值已知，则返回“true”或“false”。如果值未知，则返回“null”。 |
hasWheelchairAccessibleRestroom |
类型：
boolean optional某个地点是否有无障碍卫生间。如果值已知，则返回“true”或“false”。如果值未知，则返回“null”。 |
hasWheelchairAccessibleSeating |
类型：
boolean optional场所是否提供无障碍座位。如果值已知，则返回“true”或“false”。如果值未知，则返回“null”。 |
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 |
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。 |
ConnectorAggregation 类
google.maps.places.ConnectorAggregation 类
电动汽车充电信息，按连接器类型和充电速率汇总。
通过调用 const {ConnectorAggregation} = await google.maps.importLibrary("places") 进行访问。
请参阅 Maps JavaScript API 中的库。
属性 | |
|---|---|
availabilityLastUpdateTime |
类型：
Date optional相应汇总中连接器可用性信息的上次更新时间。 |
availableCount |
类型：
number optional相应汇总中当前可用的连接器数量。 |
count |
类型：
number相应汇总中的连接器数量。 |
maxChargeRateKw |
类型：
number相应聚合中每个连接器的静态最大充电速率（以千瓦为单位）。 |
outOfServiceCount |
类型：
number optional相应汇总中目前处于停止服务状态的连接器数量。 |
type |
类型：
EVConnectorType optional相应聚合的连接器类型。 |
EVChargeOptions 类
google.maps.places.EVChargeOptions 类
有关场所内电动车辆充电站的信息。
通过调用 const {EVChargeOptions} = await google.maps.importLibrary("places") 进行访问。
请参阅 Maps JavaScript API 中的库。
属性 | |
|---|---|
connectorAggregations |
包含相同类型和相同充电速率的连接器的电动汽车充电连接器聚合的列表。 |
connectorCount |
类型：
number相应充电站的连接器数量。由于某些充电端口可能配备多个连接器，但一次只能为一辆汽车充电，因此连接器的数量可能大于可同时充电的汽车总数。 |
EVConnectorType 常量
google.maps.places.EVConnectorType 常量
电动汽车充电连接器类型。
通过调用 const {EVConnectorType} = await google.maps.importLibrary("places") 进行访问。
请参阅 Maps JavaScript API 中的库。
常量 | |
|---|---|
CCS_COMBO_1 |
组合充电系统（交流电和直流电）。基于 SAE Type-1 J-1772 连接器。 |
CCS_COMBO_2 |
组合充电系统（交流电和直流电）。基于 Type-2 Mennekes 连接器。 |
CHADEMO |
CHAdeMO 型连接器。 |
J1772 |
J1772 1 型连接器。 |
NACS |
北美充电系统 (NACS)，已标准化为 SAE J3400。 |
OTHER |
其他连接器类型。 |
TESLA |
通用 TESLA 连接器。在北美，这是 NACS，但在世界其他地区，这可能是非 NACS（例如 CCS Combo 2 (CCS2) 或 GB/T）。此值不太能代表实际的连接器类型，而更代表在 Tesla 自有充电站为 Tesla 品牌车辆充电的能力。 |
TYPE_2 |
IEC 62196 Type 2 连接器。通常称为 MENNEKES。 |
UNSPECIFIED_GB_T |
GB/T 类型对应于中国的 GB/T 标准。此类型涵盖所有 GB_T 类型。 |
UNSPECIFIED_WALL_OUTLET |
未指定墙壁插座。 |
EVSearchOptions 接口
google.maps.places.EVSearchOptions
接口
可为地点搜索请求指定的与电动汽车相关的选项。
属性 | |
|---|---|
connectorTypes optional |
类型：
Array<EVConnectorType> optional首选电动汽车连接器类型的列表。不支持任何所列连接器类型的地点会被过滤掉。 |
minimumChargingRateKw optional |
类型：
number optional所需的最低充电功率（以千瓦为单位）。充电速率低于指定速率的地点会被过滤掉。 |
FetchFieldsRequest 接口
google.maps.places.FetchFieldsRequest
接口
用于提取 Place 字段的选项。
属性 | |
|---|---|
fields |
类型：
Array<string>要提取的字段的列表。 |
FuelOptions 类
google.maps.places.FuelOptions 类
加油站中有关燃油选项的最新信息。这些信息会定期更新。
通过调用 const {FuelOptions} = await google.maps.importLibrary("places") 进行访问。
请参阅 Maps JavaScript API 中的库。
属性 | |
|---|---|
fuelPrices |
相应加油站提供的每种燃料的价格列表，每种燃料对应一个条目。 |
FuelPrice 类
google.maps.places.FuelPrice 类
指定类型燃料的燃料价格信息。
通过调用 const {FuelPrice} = await google.maps.importLibrary("places") 进行访问。
请参阅 Maps JavaScript API 中的库。
属性 | |
|---|---|
price |
类型：
Money optional燃油价格。 |
type |
类型：
FuelType optional燃料类型。 |
updateTime |
类型：
Date optional上次更新燃油价格的时间。 |
FuelType 常量
google.maps.places.FuelType 常量
燃料类型。
通过调用 const {FuelType} = await google.maps.importLibrary("places") 进行访问。
请参阅 Maps JavaScript API 中的库。
常量 | |
|---|---|
BIO_DIESEL |
生物柴油。 |
DIESEL |
柴油。 |
DIESEL_PLUS |
柴油加燃料。 |
E100 |
E 100. |
E80 |
E 80. |
E85 |
E 85. |
LPG |
液化石油气。 |
METHANE |
甲烷。 |
MIDGRADE |
中级。 |
PREMIUM |
高级版。 |
REGULAR_UNLEADED |
常规无铅汽油。 |
SP100 |
SP 100。 |
SP91 |
SP 91. |
SP91_E10 |
SP 91 E10。 |
SP92 |
SP 92. |
SP95 |
SP 95. |
SP95_E10 |
SP95 E10。 |
SP98 |
SP 98. |
SP99 |
SP 99. |
TRUCK_DIESEL |
卡车柴油。 |
Money 类
google.maps.places.Money 类
表示含有货币类型的金额。
通过调用 const {Money} = await google.maps.importLibrary("places") 进行访问。
请参阅 Maps JavaScript API 中的库。
属性 | |
|---|---|
currencyCode |
类型：
stringISO 4217 中定义的由 3 个字母组成的货币代码。 |
nanos |
类型：
number金额的纳诺 (10^-9) 单位数。 |
units |
类型：
number金额的整数单位。例如，如果 Money.currencyCode 为“USD”，则 1 个单位为 1 美元。 |
方法 | |
|---|---|
toString |
toString()参数：无
返回值：
string返回金额及其币种符号的人类可读表示形式。 |
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 类
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] 范围内的数字表示。系统将按地点的时区报告此数据。 |
ParkingOptions 类
google.maps.places.ParkingOptions 类
通过调用 const {ParkingOptions} = await google.maps.importLibrary("places") 进行访问。
请参阅 Maps JavaScript API 中的库。
属性 | |
|---|---|
hasFreeGarageParking |
类型：
boolean optional某个场所是否提供免费停车库。如果值已知，则返回“true”或“false”。如果值未知，则返回“null”。 |
hasFreeParkingLot |
类型：
boolean optional相应地点是否提供免费停车位。如果值已知，则返回“true”或“false”。如果值未知，则返回“null”。 |
hasFreeStreetParking |
类型：
boolean optional相应地点是否提供免费路边停车位。如果值已知，则返回“true”或“false”。如果值未知，则返回“null”。 |
hasPaidGarageParking |
类型：
boolean optional某个地点是否提供收费停车库。如果值已知，则返回“true”或“false”。如果值未知，则返回“null”。 |
hasPaidParkingLot |
类型：
boolean optional某个地点是否提供付费停车场。如果值已知，则返回“true”或“false”。如果值未知，则返回“null”。 |
hasPaidStreetParking |
类型：
boolean optional某个地点是否提供付费路边停车位。如果值已知，则返回“true”或“false”。如果值未知，则返回“null”。 |
hasValetParking |
类型：
boolean optional场所是否提供代客泊车服务。如果值已知，则返回“true”或“false”。如果值未知，则返回“null”。 |
PaymentOptions 类
google.maps.places.PaymentOptions 类
通过调用 const {PaymentOptions} = await google.maps.importLibrary("places") 进行访问。
请参阅 Maps JavaScript API 中的库。
属性 | |
|---|---|
acceptsCashOnly |
类型：
boolean optional相应场所是否仅接受现金付款。如果值已知，则返回“true”或“false”。如果值未知，则返回“null”。 |
| |