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 微格式表示的地点地址。 |
allowsDogs |
类型:
boolean optional |
attributions |
类型:
Array<Attribution> optional必须为地点显示的数据提供方。 |
businessStatus |
类型:
BusinessStatus optional营业地点的营业状态。如果状态未知,则为 null。如果尚未从服务器加载状态数据,则为 undefined。 |
consumerAlert |
类型:
ConsumerAlert optional此地点的消费者提醒。 |
displayName |
类型:
string optional营业地点的显示名称。 null(如果没有名称)。如果尚未从服务器加载名称数据,则为 undefined。 |
displayNameLanguageCode |
类型:
string optional营业地点显示名称的语言。 null(如果没有名称)。如果尚未从服务器加载名称数据,则为 undefined。 |
editorialSummary |
类型:
string optional此地点的编辑摘要。如果不存在编辑摘要,则为 null。undefined(如果尚未请求此字段)。 |
editorialSummaryLanguageCode |
类型:
string optional此地点的编辑摘要所用的语言。如果不存在编辑摘要,则为 null。undefined(如果尚未请求此字段)。 |
evChargeAmenitySummary |
类型:
EVChargeAmenitySummary optional此地点的 EVChargeAmenitySummary。 |
evChargeOptions |
类型:
EVChargeOptions optional该地点提供的电动汽车充电选项。 undefined(如果尚未从服务器调用电动汽车充电选项)。 |
formattedAddress |
类型:
string optional营业地点的完整地址。 |
fuelOptions |
类型:
FuelOptions optional该地点提供的燃料选项。 undefined(如果尚未从服务器调用燃油选项)。 |
generativeSummary |
类型:
GenerativeSummary optional此地点的 GenerativeSummary。 |
googleMapsLinks |
类型:
GoogleMapsLinks optional用于触发不同 Google 地图操作的链接。 |
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地点的电话号码,按号码所属地区的格式规范显示。 |
neighborhoodSummary |
类型:
NeighborhoodSummary optional此地点的 NeighborhoodSummary。 |
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此地点请求的区域。 |
resourceName |
类型:
string唯一的地点资源名称。 |
reviews |
此地点的评价列表。 |
reviewSummary |
类型:
ReviewSummary optional此地点的 ReviewSummary。 |
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”。 |
shortFormattedAddress |
类型:
string optional营业地点的简短地址。 |
subDestinations |
此地点的子目的地列表。子目的地是与主要地点相关联的具体地点。这些子地点为在大型或复杂场所(例如机场、国家公园、大学或体育场)内搜索的用户提供了更具体的目的地。 |
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])参数:
使用地点的 Place.regularOpeningHours 计算下一个营业时间的 Date。如果数据不足,无法计算结果,或者此地点未营业,则返回 undefined。 |
|
isOpen([date])参数:
返回值:
Promise<boolean optional>检查该地点在给定的 Date 是否营业。如果地点的已知数据不足以计算此值(例如,营业时间未注册),则解析为 undefined。 |
toJSON |
toJSON()参数:无
返回值:
Object 一个 JSON 对象,其中包含所有请求的地点属性。 |
PlaceOptions 接口
google.maps.places.PlaceOptions
接口
用于构建地点的选项。
属性 | |
|---|---|
id optional |
类型:
string optional唯一地点 ID。 |
requestedLanguage optional |
类型:
string optional语言标识符,用于指定应以哪种语言返回详细信息。请参阅支持的语言列表。 |
requestedRegion optional |
类型:
string optional用户所在地区的地区代码。这可能会影响返回的照片,还可能会影响其他方面。地区代码接受 ccTLD(“顶级域名”)双字符值。多数 ccTLD 代码都与 ISO 3166-1 代码相同,但也有一些需要注意的例外情况。例如,英国的 ccTLD 为“uk”( .co.uk),而其 ISO 3166-1 代码为“gb”(代表“大不列颠及北爱尔兰联合王国”)。 |
resourceName optional |
类型:
string optional唯一的地点资源名称。 |
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地点数据提供方的 URI。 |
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汇总中每个连接器的静态最大充电速率(以 kW 为单位)。 |
outOfServiceCount |
类型:
number optional此聚合中当前无法使用的连接器数量。 |
type |
类型:
EVConnectorType optional此汇总的连接器类型。 |
ConsumerAlert 类
google.maps.places.ConsumerAlert 类
消费者提醒消息。所有文本均以 languageCode 字段指定的语言呈现。
通过拨打 const {ConsumerAlert} = await google.maps.importLibrary("places") 访问。
请参阅 Maps JavaScript API 中的库。
属性 | |
|---|---|
details |
类型:
ConsumerAlertDetails optional消费者提醒消息的详细信息。 |
languageCode |
类型:
string optional消费者提醒消息的语言代码。 |
overview |
类型:
string optional消费者提醒消息概览。 |
ConsumerAlertDetails 类
google.maps.places.ConsumerAlertDetails 类
消费者提醒消息的详细信息。
通过拨打 const {ConsumerAlertDetails} = await google.maps.importLibrary("places") 访问。
请参阅 Maps JavaScript API 中的库。
属性 | |
|---|---|
aboutLinkTitle |
类型:
string optional要显示的链接标题,用于提供更多信息。 |
aboutLinkURI |
类型:
string optional用于提供更多信息的链接的 URI。 |
description |
类型:
string optional消费者提醒消息的说明。 |
title |
类型:
string optional与详细说明一起显示的标题。 |
ContentBlock 类
google.maps.places.ContentBlock 类
ContentBlock 描述了摘要的内容及其来源。
通过拨打 const {ContentBlock} = await google.maps.importLibrary("places") 访问。
请参阅 Maps JavaScript API 中的库。
属性 | |
|---|---|
content |
类型:
string optional与主题相关的内容。 |
contentLanguageCode |
类型:
string optional内容的语言代码。 |
referencedPlaces |
引用的 Place 的列表。首次检索时,每个 Place 仅在 id 字段中包含地点 ID。 |
EVChargeAmenitySummary 类
google.maps.places.EVChargeAmenitySummary 类
AI 生成的电动车辆充电站附近设施摘要。此字段仅适用于类型为 electric_vehicle_charging_station 的地点。
通过拨打 const {EVChargeAmenitySummary} = await google.maps.importLibrary("places") 访问。
请参阅 Maps JavaScript API 中的库。
属性 | |
|---|---|
coffee |
类型:
ContentBlock optional附近咖啡馆的摘要。 |
disclosureText |
类型:
string optional与此摘要相关的披露声明文本。 |
disclosureTextLanguageCode |
类型:
string optional披露声明文本的语言代码。 |
flagContentURI |
类型:
string optional用于报告摘要问题的 URI。 |
overview |
类型:
ContentBlock optional可用设施概览。 |
restaurant |
类型:
ContentBlock optional附近餐厅的摘要。 |
store |
类型:
ContentBlock 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 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
接口
用于提取地点字段的选项。
属性 | |
|---|---|
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 |
LPG。 |
METHANE |
甲烷。 |
MIDGRADE |
中级。 |
PREMIUM |
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 |
卡车柴油。 |
GenerativeSummary 类
google.maps.places.GenerativeSummary 类
AI 生成的地点摘要。
通过拨打 const {GenerativeSummary} = await google.maps.importLibrary("places") 访问。
请参阅 Maps JavaScript API 中的库。
属性 | |
|---|---|
disclosureText |
类型:
string optional与此摘要相关的披露声明文本。 |
disclosureTextLanguageCode |
类型:
string optional披露声明文本的语言代码。 |
flagContentURI |
类型:
string optional用于报告摘要问题的 URI。 |
overview |
类型:
string optional地点的概览。 |
overviewLanguageCode |
类型:
string optional概览的语言代码。 |
GoogleMapsLinks 类
google.maps.places.GoogleMapsLinks 类
用于触发不同 Google 地图操作的链接。
通过拨打 const {GoogleMapsLinks} = await google.maps.importLibrary("places") 访问。
请参阅 Maps JavaScript API 中的库。
属性 | |
|---|---|
directionsURI |
类型:
string optional一个链接,用于在 Google 地图上显示前往该地点的路线。该链接仅填充目的地位置,并使用默认出行方式 DRIVE。 |
photosURI |
类型:
string optional一个链接,用于在 Google 地图上显示该地点的照片。 |
placeURI |
类型:
string optional一个用于在 Google 地图上显示该地点的链接。 |
reviewsURI |
类型:
string optional一个链接,用于在 Google 地图上显示该地点的评价。 |
writeAReviewURI |
类型:
string optional一个链接,用于在 Google 地图上为该地点撰写评价。 |
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返回金额的人类可读表示形式,并附带货币符号。 |
NeighborhoodSummary 类
google.maps.places.NeighborhoodSummary 类
AI 生成的地点附近地图注点摘要。
通过拨打 const {NeighborhoodSummary} = await google.maps.importLibrary("places") 访问。
请参阅 Maps JavaScript API 中的库。
属性 | |
|---|---|
description |
类型:
ContentBlock optional对周边环境的详细描述。 |
disclosureText |
类型:
string optional与此摘要相关的披露声明文本。 |
disclosureTextLanguageCode |
类型:
string optional披露声明文本的语言代码。 |
flagContentURI |
类型:
string optional用于报告摘要问题的 URI。 |
overview |
类型:
ContentBlock optional街区概览。 |
OpeningHours 类
google.maps.places.OpeningHours 类
地点营业时间的相关信息。
通过拨打 const {OpeningHours} = await google.maps.importLibrary("places") 访问。
请参阅 Maps JavaScript API 中的库。
属性 | |
|---|---|
periods |
涵盖一周中每一天的营业时段,从星期日开始,按时间顺序排列。不包括地点不营业的日子。 |
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”。 |
acceptsCreditCards |
类型:
boolean optional地点是否接受信用卡付款。如果值已知,则返回“true”或“false”。如果值未知,则返回“null”。 |
acceptsDebitCards |
类型:
boolean optional地点是否接受借记卡付款。如果值已知,则返回“true”或“false”。如果值未知,则返回“null”。 |
acceptsNFC |
类型:
boolean optional地点是否接受通过 NFC 付款。如果值已知,则返回“true”或“false”。如果值未知,则返回“null”。 |
Photo 类
google.maps.places.Photo 类
地点照片的相关信息。
通过拨打 const {Photo} = await google.maps.importLibrary("places") 访问。
请参阅 Maps JavaScript API 中的库。
属性 | |
|---|---|
authorAttributions |
要针对此照片显示的提供方文字。 |
flagContentURI |
类型:
string optional一个链接,用户可通过该链接举报照片存在的问题。 |
googleMapsURI |
类型:
string optional用于在 Google 地图上显示照片的链接。 |
heightPx |
类型:
number照片的高度(以像素为单位)。 |
widthPx |
类型:
number照片的宽度(以像素为单位)。 |
方法 | |
|---|---|
getURI |
getURI([options])参数:
返回值:
string返回与指定选项对应的图片网址。 |
PlusCode 类
google.maps.places.PlusCode 类
地点的 Plus Code。如需了解详情,请参阅 https://plus.codes/。
通过拨打 const {PlusCode} = await google.maps.importLibrary("places") 访问。
请参阅 Maps JavaScript API 中的库。
属性 | |
|---|---|
compoundCode |
类型:
string optional精度为 1/8000 度 × 1/8000 度的 Plus Code,其中前四个字符(区域代码)被舍弃并替换为区域描述。例如,“9G8F+5W Zurich, Switzerland”。 |
globalCode |
类型:
string optional精度为 1/8000 度 x 1/8000 度的 Plus Code。例如,“8FVC9G8F+5W”。 |
PostalAddress 类
google.maps.places.PostalAddress 类
表示邮寄地址(例如,邮政服务递送物品的地址)。注意:JavaScript API 使用 PostalAddress 来实例化表示 Web 服务返回的数据的对象。
此类实现 PostalAddressLiteral。
通过拨打 const {PostalAddress} = await google.maps.importLibrary("places") 访问。
请参阅 Maps JavaScript API 中的库。
属性 | |
|---|---|
addressLines |
类型:
Array<string>描述详细地址的非结构化地址行。 |
administrativeArea |
类型:
string optional某个国家或地区的邮政地址中使用的最高行政区划。 |
languageCode |
类型:
string optional此地址内容的 BCP-47 语言代码。示例:“zh-Hant”、“ja”、“ja-Latn”、“en”。 |
locality |
类型:
string optional通常指地址的城市/乡镇部分。 |
organization |
类型:
string optional地址对应的组织的名称。 |
postalCode |
类型:
string optional地址的邮政编码。 |
recipients |
类型:
Array<string>地址处的收件人。 |
regionCode |
类型:
string地址的国家/地区的 CLDR 地区代码。示例:瑞士为“CH”。如需了解详情,请参阅 https://cldr.unicode.org/ 和 https://www.unicode.org/cldr/charts/30/supplemental/territory_information.html。 |
sortingCode |
类型:
string optional地址的汇兑代码。 |
sublocality |
类型:
string optional地址的次级行政区,例如街区、行政区或区。 |
PostalAddressLiteral 接口
google.maps.places.PostalAddressLiteral
接口
用于填充 PostalAddress 的数据。
属性 | |
|---|---|
regionCode |
类型:
string |
addressLines optional |
类型:
Iterable<string> optional |
administrativeArea optional |
类型:
string optional |
languageCode optional |
类型:
string optional |
locality optional |
类型:
string optional |
organization optional |
类型:
string optional |
postalCode optional |
类型:
string optional |
recipients optional |
类型:
Iterable<string> optional |
sortingCode optional |
类型:
string optional |
sublocality optional |
类型:
string optional |
PriceLevel 常量
google.maps.places.PriceLevel
常量
地点的价格水平。
通过拨打 const {PriceLevel} = await google.maps.importLibrary("places") 访问。
请参阅 Maps JavaScript API 中的库。
常量 | |
|---|---|
EXPENSIVE |
|
FREE |
|
INEXPENSIVE |
|
MODERATE |
|
VERY_EXPENSIVE |
|
PriceRange 类
google.maps.places.PriceRange 类
与地点关联的价格范围。endPrice 可以不设置,这表示没有上限的范围(例如“超过 100 美元”)。
通过拨打 const {PriceRange} = await google.maps.importLibrary("places") 访问。
请参阅 Maps JavaScript API 中的库。
属性 | |
|---|---|
endPrice |
类型:
Money optional价格范围的上限(含此值)。价格应低于此金额。 |
startPrice |
类型:
Money价格范围的下限(含此值)。价格应等于或高于此金额。 |
Review 类
google.maps.places.Review 类
有关地点评价的信息。
通过拨打 const {Review} = await google.maps.importLibrary("places") 访问。
请参阅 Maps JavaScript API 中的库。
属性 | |
|---|---|
authorAttribution |
类型:
AuthorAttribution optional评价者。 |
flagContentURI |
类型:
string optional一个链接,用户可通过该链接举报评价存在的问题。 |
googleMapsURI |
类型:
string optional用于在 Google 地图上显示评价的链接。 |
originalText |
类型:
string optional评价文本(原始语言)。 |
originalTextLanguageCode |
类型:
string optional表示评价原始语言的 IETF 语言代码。 |
publishTime |
类型:
Date optional |
rating |
类型:
number optional此评价的评分,介于 1.0 到 5.0 之间(含边界值)。 |
relativePublishTimeDescription |
类型:
string optional一个采用特定格式的近期时间字符串,以符合相应语言和国家/地区习惯的形式表示评价时间相对于当前时间的间隔。例如“1 个月前”。 |
text |
类型:
string optional评价的本地化文本。 |
textLanguageCode |
类型:
string optional表示评价本地化语言的 IETF 语言代码。 |
visitDateMonth |
类型:
number optional评价作者到访该地点的月份。此字段从 0 开始;0 表示 1 月,11 表示 12 月。 |
visitDateYear |
类型:
number optional评价作者到访相应地点的年份。 |
ReviewSummary 类
google.maps.places.ReviewSummary 类
AI 生成的地点用户评价摘要。
通过拨打 const {ReviewSummary} = await google.maps.importLibrary("places") 访问。
请参阅 Maps JavaScript API 中的库。
属性 | |
|---|---|
disclosureText |
类型:
string optional与此摘要相关的披露声明文本。 |
disclosureTextLanguageCode |
类型:
string optional披露声明文本的语言代码。 |
flagContentURI |
类型:
string optional用于报告摘要问题的 URI。 |
reviewsURI |
类型:
string optional用于在 Google 地图上显示此地点评价的 URI。 |
text |
类型:
string optional用户评价摘要。 |
textLanguageCode |
类型:
string optional用户评价摘要的语言代码。 |
SearchByTextRequest 接口
google.maps.places.SearchByTextRequest
接口
Place.searchByText 的请求接口。
属性 | |
|---|---|
fields |
类型:
Array<string> |
evSearchOptions optional |
类型:
EVSearchOptions optional可为地点搜索请求指定的电动汽车相关选项。 |
includedType optional |
类型:
string optional请求的地点类型。如需查看支持的类型的完整列表,请访问:https://developers.google.com/maps/documentation/places/web-service/place-types。仅支持一种包含的类型。请参阅 SearchByTextRequest.useStrictTypeFiltering |
isOpenNow optional |
类型:
boolean optional默认值:
false用于将搜索范围限制为当前营业的地点。 |
language optional |
类型:
string optional地点详情将以首选语言(如有)显示。默认采用浏览器的语言偏好设置。当前支持的语言列表:https://developers.google.com/maps/faq#languagesupport。 |
locationBias optional |
要搜索的区域。此位置用作偏向,这意味着系统可能会返回给定位置周围的结果。无法与 locationRestriction 一起设置。 |
locationRestriction optional |
类型:
LatLngBounds|LatLngBoundsLiteral optional要搜索的区域。此位置用作限制条件,这意味着系统不会返回给定位置以外的结果。无法与 locationBias 一起设置。 |
maxResultCount optional |
类型:
number optional页面中结果的数量上限。必须介于 1 到 20 之间(含 1 和 20)。 |
minRating optional |
类型:
number optional滤除平均房客评分严格低于此限制的结果。有效值必须是 0 到 5 之间(含边界值)的浮点数,步长为 0.5,即 [0, 0.5, 1.0, … , 5.0](含边界值)。输入的评分将向上舍入到最接近的 0.5(上限)。例如,如果评分为 0.6,系统会排除所有评分低于 1.0 的结果。 |
priceLevels optional |
类型:
Array<PriceLevel> optional用于将搜索范围限制为标记为特定价格水平的地点。您可以选择任意价格水平组合。默认值为所有价格级别。 |
|
类型:
string optional |
|
类型:
SearchByTextRankPreference optional |
rankPreference optional |
类型:
SearchByTextRankPreference optional默认值:
SearchByTextRankPreference.RELEVANCE回答中结果的排序方式。 |
region optional |
类型:
string optional请求来源位置的 Unicode 国家/地区代码 (CLDR)。此参数用于显示地点详情,例如特定于区域的地点名称(如果有)。该参数可能会根据适用法律影响结果。如需了解详情,请参阅 https://www.unicode.org/cldr/charts/latest/supplemental/territory_language_information.html。请注意,目前不支持 3 位数的地区代码。 |
textQuery optional |
类型:
string optional当您不使用 时,此参数为必填。文本搜索的文本查询。 |
useStrictTypeFiltering optional |
类型:
boolean optional默认值:
false用于为 SearchByTextRequest.includedType 设置严格的类型过滤。如果设置为 true,则系统只会返回相同类型的结果。 |
SearchByTextRankPreference 常量
google.maps.places.SearchByTextRankPreference
常量
SearchByTextRequest 的 RankPreference 枚举。
通过拨打 const {SearchByTextRankPreference} = await google.maps.importLibrary("places") 访问。
请参阅 Maps JavaScript API 中的库。
常量 | |
|---|---|
DISTANCE |
按距离对结果进行排名。 |
RELEVANCE |
按相关性对结果进行排名。 |
SearchNearbyRequest 接口
google.maps.places.SearchNearbyRequest
接口
Place.searchNearby 的请求接口。如需详细了解请求,请参阅 Places API 参考文档。
属性 | |
|---|---|
fields |
类型:
Array<string> |
locationRestriction |
要搜索的区域,指定为具有中心和半径的圆形。系统不会返回指定位置以外的结果。 |
excludedPrimaryTypes optional |
类型:
Array<string> optional已排除的主要地点类型。查看支持的类型的完整列表。一个地点只能有一个主要类型。最多可以指定 50 种类型。如果您在 included 和 excluded 列表中指定了相同的类型,系统会返回 INVALID_ARGUMENT 错误。 |
excludedTypes optional |
类型:
Array<string> optional排除的地点类型。查看支持的类型的完整列表。一个地点可以有许多不同的地点类型。最多可以指定 50 种类型。如果您在 included 和 excluded 列表中指定了相同的类型,系统会返回 INVALID_ARGUMENT 错误。 |
includedPrimaryTypes optional |
类型:
Array<string> optional包含的主要地点类型。查看支持的类型的完整列表。一个地点只能有一个主要类型。最多可以指定 50 种类型。如果您在 included 和 excluded 列表中指定了相同的类型,系统会返回 INVALID_ARGUMENT 错误。 |
includedTypes optional |
类型:
Array<string> optional包含的地点类型。查看支持的类型的完整列表。一个地点可以有许多不同的地点类型。最多可以指定 50 种类型。如果您在 included 和 excluded 列表中指定了相同的类型,系统会返回 INVALID_ARGUMENT 错误。 |
language optional |
类型:
string optional地点详情将以首选语言(如有)显示。默认采用浏览器的语言偏好设置。当前支持的语言列表:https://developers.google.com/maps/faq#languagesupport。 |
maxResultCount optional |
类型:
number optional页面中结果的数量上限。如需了解可接受的值和默认值,请参阅 Places API 参考文档。 |
rankPreference optional |
类型:
SearchNearbyRankPreference optional默认值:
SearchNearbyRankPreference.POPULARITY回答中结果的排序方式。 |
region optional |
类型:
string optional请求来源位置的 Unicode 国家/地区代码 (CLDR)。此参数用于显示地点详情,例如特定于区域的地点名称(如果有)。该参数可能会根据适用法律影响结果。如需了解详情,请参阅 https://www.unicode.org/cldr/charts/latest/supplemental/territory_language_information.html。请注意,目前不支持 3 位数的地区代码。 |
SearchNearbyRankPreference 常量
google.maps.places.SearchNearbyRankPreference
常量
SearchNearbyRequest 的 RankPreference 枚举。
通过拨打 const {SearchNearbyRankPreference} = await google.maps.importLibrary("places") 访问。
请参阅 Maps JavaScript API 中的库。
常量 | |
|---|---|
DISTANCE |
按距离对结果进行排名。 |
POPULARITY |
按热门程度对结果进行排名。 |