Place

地点 类别

google.maps.places.Place 类别

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

Place
Place(options)
参数
searchByText
searchByText(request)
参数
返回值Promise<{places:Array<Place>}>
基于文本查询的地点搜索。
searchNearby
searchNearby(request)
参数
返回值Promise<{places:Array<Place>}>
搜索附近的地点。
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
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”如果尚未请求此字段,则会发生此错误。
hasWiFi
类型boolean optional
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
类型Array<Photo> optional
此地点的照片。该集合最多包含十个 Photo 对象。
plusCode
类型PlusCode optional
priceLevel
类型PriceLevel optional
地方的价位。此属性可以返回以下任意值
  • Free
  • Inexpensive
  • Moderate
  • Expensive
  • Very Expensive
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
类型Array<Review> optional
此地点的评价列表。
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
此地点的类型(例如 ["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
此地点(例如商家)的官方网站首页。
openingHours
类型OpeningHours optional
fetchFields
fetchFields(options)
参数
返回值Promise<{place:Place}>
BetagetNextOpeningTime
getNextOpeningTime([date])
参数
  • dateDate optional
返回值Promise<Date optional>
计算表示下一个 OpeningHoursTime 的日期。如果数据不足以计算结果,或此地点已停止运营,则返回 undefined。
BetaisOpen
isOpen([date])
参数
  • dateDate optional 默认为立即。
返回值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”(技术上适用于“大不列颠及北爱尔兰联合王国”)。

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>
一个字符串数组,用于表示该地址组成部分的类型。请点击此处查看有效类型的列表。

归因 类别

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 连接器。
OTHER 其他连接器类型。
TESLA 通用 TESLA 连接器。在北美,这是 NACS,但在世界其他地区可以是非 NACS(如 CCS 组合 2 (CCS2) 或 GB/T)。此值不太代表实际的连接器类型,而更表示在特斯拉自有充电站为特斯拉品牌车辆充电的能力。
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
类型Array<FuelPrice>
该站提供的每种燃料的燃油价格列表,每种燃料类型各有一个条目。

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 柴油。
E80 E 80。
E85 E 85。
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 卡车柴油。

资金 类别

google.maps.places.Money 类别

金额及其货币类型的表示。

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

currencyCode
类型string
ISO 4217 中定义的由三个字母组成的货币代码。
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
一周中每一天的开始时段,从星期日开始,按时间顺序排列。不包括该地点未营业的日期。
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
类型number
OpeningHoursPoint.time 的小时数,以数字表示,范围为 [0, 23]。系统将按照地方的时区报告此情况。
minute
类型number
OpeningHoursPoint.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”如果值未知,则会发生此错误。

照片 类别

google.maps.places.Photo 类别

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

authorAttributions
要为此照片显示的提供方说明文本。
heightPx
类型number
照片的高度(以像素为单位)。
widthPx
类型number
照片的宽度(以像素为单位)。
getURI
getURI([options])
参数
返回值string
返回与指定选项对应的图片网址。

PlusCode 类别

google.maps.places.PlusCode 类别

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

compoundCode
类型string optional
以 1/8000 度 x 1/8000 度数表示的 Plus 代码,其中的前四个字符(区号)会被去掉,并替换为市行政区说明。例如,“9G8F+5W Zurich, 瑞士”。
globalCode
类型string optional
以 1/8000 度 x 1/8000 度面积表示的 Plus 代码。例如,“8FVC9G8F+5W”。

PriceLevel 常量

google.maps.places.PriceLevel 常量

Place 对象的价格级枚举。

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

EXPENSIVE
FREE
INEXPENSIVE
MODERATE
VERY_EXPENSIVE

查看 类别

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(含)之间的数字。
relativePublishTimeDescription
类型string optional
一系列带格式的最近时间,以适用于相应语言和国家/地区的格式表示相对于当前时间的评论时间。例如,"a 个月前"'。
text
类型string optional
评价文字。
textLanguageCode
类型string optional
表示此评论撰写语言的 IETF 语言代码。请注意,此代码仅包含主要语言标记,而不包含任何表示国家或地区的辅助标记。例如,所有英语评价都标记为 'en',而不是“en-AU”或“en-UK”

SearchByTextRequest 界面

google.maps.places.SearchByTextRequest 界面

请求 Place.searchByText 的接口。

fields
类型Array<string>
要包含在响应中(将产生费用)的字段。如果传入 ['*'],系统将返回所有可用字段并收取费用(不建议用于生产部署)。您可以将 Place 类中的任何属性作为字段请求。
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
要搜索的地区。此位置起到了限制作用,这意味着将不会返回指定位置以外的结果。不能与 locationBias 一起设置。
maxResultCount optional
类型number optional
返回的结果数上限。它必须介于 1 到 20 之间(包括 1 和 20)。
minRating optional
类型number optional
滤除平均用户评分严格低于此限制的结果。有效值必须是介于 0 和 5(含)之间的浮点数,频率必须为 0.5,即 [0, 0.5, 1.0, ... , 5.0](包括 1 和 5.0])。输入的评分将四舍五入到最接近的 0.5(上限)。例如,评分为 0.6 将排除评分低于 1.0 的所有结果。
priceLevels optional
类型Array<PriceLevel> optional
用于将搜索范围限制为标记为特定价位的地点。可以选择任意价位组合。默认为所有价位。
query optional
类型string optional
BetarankBy 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>
要包含在响应中(将产生费用)的字段。如果传入 ['*'],系统将返回所有可用字段并收取费用(不建议用于生产部署)。您可以将 Place 类中的任何属性作为字段请求。
locationRestriction
要搜索的地区,以具有中心和半径的圆形的形式指定。不返回指定位置以外的结果。
excludedPrimaryTypes optional
类型Array<string> optional
已排除的主要地点类型。请参阅受支持类型的完整列表。一个地点只能有一个主要类型。最多可以指定 50 种类型。如果您在 includedexcluded 列表中指定了同一类型,系统会返回 INVALID_ARGUMENT 错误。
excludedTypes optional
类型Array<string> optional
已排除的地点类型。请参阅受支持类型的完整列表。一个地点可以有多个不同的地点类型。最多可以指定 50 种类型。如果您在 includedexcluded 列表中指定了同一类型,系统会返回 INVALID_ARGUMENT 错误。
includedPrimaryTypes optional
类型Array<string> optional
包含的主要地点类型。请参阅受支持类型的完整列表。一个地点只能有一个主要类型。最多可以指定 50 种类型。如果您在 includedexcluded 列表中指定了同一类型,系统会返回 INVALID_ARGUMENT 错误。
includedTypes optional
类型Array<string> optional
包含的地点类型。请参阅受支持类型的完整列表。一个地点可以有多个不同的地点类型。最多可以指定 50 种类型。如果您在 includedexcluded 列表中指定了同一类型,系统会返回 INVALID_ARGUMENT 错误。
language optional
类型string optional
系统将以首选语言(如果有)显示地点详情。将默认采用浏览器的语言偏好设置。当前支持的语言列表:https://developers.google.com/maps/faq#languagesupport
maxResultCount optional
类型number optional
返回的结果数上限。它必须介于 1 到 20 之间(包括 1 和 20)。
rankPreference optional
类型SearchNearbyRankPreference optional
默认值SearchNearbyRankPreference.DISTANCE
结果在响应中如何排名。
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 按热门程度对结果进行排名。