Place

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 微格式表示的 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
类型:  Array<Photo> optional
此地点的照片。该集合最多包含 10 个 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
hasWiFi
类型:  boolean optional
fetchFields
fetchFields(options)
参数: 
返回值:  Promise<{place:Place}>
BetagetNextOpeningTime
getNextOpeningTime([date])
参数: 
  • dateDate optional
返回值:  Promise<Date optional>
计算表示下一个 OpeningHoursTime 的日期。如果数据不足以计算结果,或者相应地点不营业,则返回未定义。
BetaisOpen
isOpen([date])
参数: 
  • dateDate optional 默认为当前时间。
返回值:  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 型连接器。
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
类型:  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 高级版。
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
类型:  string
ISO 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
涵盖一周中每一天的营业时段,从星期日开始,按时间顺序排列。不包括地点不营业的日期。
weekdayDescriptions
类型:  Array<string>
一个包含七个字符串的数组,用于以特定格式表示一周内每天的营业时间。地点服务会根据当前语言设置营业时间格式,并进行本地化。此数组中元素的顺序取决于语言。有些语言以星期一作为一周的开始,有些语言则以星期日作为开始。

OpeningHoursPeriod

google.maps.places.OpeningHoursPeriod

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

close
类型:  OpeningHoursPoint optional
场所的结束营业时间。
open
类型:  OpeningHoursPoint
地点的营业时间。

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”。

Photo

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
一种 Plus Code,覆盖面积为 1/8000 度乘以 1/8000 度,其中前四个字符(区域代码)被舍弃并替换为位置描述。例如,“9G8F+5W Zurich, Switzerland”。
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
一个格式化的近期时间字符串,以适合相应语言和国家/地区的形式表示相对于当前时间的评价时间。例如“一个月前”。
text
类型:  string optional
评价的文本。
textLanguageCode
类型:  string optional
表示相应评价所用语言的 IETF 语言代码。请注意,此代码仅包含主要语言标记,而不包含表示国家或地区的任何辅助标记。例如,所有英语评价都标记为 'en',而不是“en-AU”或“en-UK”。

SearchByTextRequest 接口

google.maps.places.SearchByTextRequest 接口

针对 Place.searchByText 的请求接口。

evSearchOptions optional
类型:  EVSearchOptions optional
可为地点搜索请求指定的与电动汽车相关的选项。
fields optional
类型:  Array<string> optional
Place.searchByText 的必需参数。要包含在响应中的字段,这些字段会产生费用。如果传入的是 ['*'],系统会返回所有可用字段并据此计费(不建议用于生产环境中的部署)。您可以请求 Place 类中的任何属性作为字段。
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 之间(含边界值)。
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
用于将搜索范围限制为标记为特定价位的地点。您可以选择任意价格等级组合。默认为所有价格水平。
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 参考文档

locationRestriction
类型:  Circle|CircleLiteral
要搜索的区域,指定为具有中心和半径的圆。不会返回指定位置以外的结果。
excludedPrimaryTypes optional
类型:  Array<string> optional
排除的主要地点类型。请参阅支持的类型的完整列表。一个地点只能有一个主要类型。最多可以指定 50 种类型。如果您在 includedexcluded 列表中指定了相同的类型,系统会返回 INVALID_ARGUMENT 错误。
excludedTypes optional
类型:  Array<string> optional
排除的地点类型。请参阅支持的类型的完整列表。一个地点可以有多种不同的地点类型。最多可以指定 50 种类型。如果您在 includedexcluded 列表中指定了相同的类型,系统会返回 INVALID_ARGUMENT 错误。
fields optional
类型:  Array<string> optional
Place.searchNearby 的必需参数。要包含在响应中的字段,这些字段会产生费用。如果传入的是 ['*'],系统会返回所有可用字段并据此计费(不建议用于生产环境中的部署)。您可以请求 Place 类中的任何属性作为字段。
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 之间(含边界值)。
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 按热门程度对结果进行排名。