Place

Place 类

google.maps.places.Place 类

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

构造函数
Place	Place(options) 参数： options：PlaceOptions

静态方法
searchByText	searchByText(request) 参数： request：SearchByTextRequest 返回值：Promise<{places:Array<Place>}> 基于文本查询的地点搜索。
searchNearby	searchNearby(request) 参数： request：SearchNearbyRequest 返回值：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。
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
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	已废弃：请改用 Place.regularOpeningHours。 类型：OpeningHours optional

方法
fetchFields	fetchFields(options) 参数： options：FetchFieldsRequest 返回值：Promise<{place:Place}>
getNextOpeningTime	注意：仅可在 v=beta 渠道中使用。 getNextOpeningTime([date]) 参数： date：Date optional 返回值：Promise<Date optional> 计算表示下一个 OpeningHoursTime 的日期。如果数据不足以计算结果，或此地点已停止运营，则返回 undefined。
isOpen	注意：仅可在 v=beta 渠道中使用。 isOpen([date]) 参数： date：Date 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 类

注意：仅可在 v=beta 渠道中使用。

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

属性
longText	类型：string optional 地址组成部分的完整文本。
shortText	类型：string optional 给定地址组成部分的缩写短文本。
types	类型：Array<string> 一个字符串数组，用于表示该地址组成部分的类型。请点击此处查看有效类型的列表。

Attribution 类

google.maps.places.Attribution 类

注意：仅可在 v=beta 渠道中使用。

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

属性
provider	类型：string optional 要针对该“地点”结果显示的提供方说明文本。
providerURI	类型：string optional

AuthorAttribution 类

google.maps.places.AuthorAttribution 类

注意：仅可在 v=beta 渠道中使用。

可通过调用 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	类型：Array<ConnectorAggregation> 电动汽车充电连接器汇总列表，其中包含类型相同、充电费率相同的连接器。
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	卡车柴油。

Money 类

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 类

注意：仅可在 v=beta 渠道中使用。

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

属性
periods	类型：Array<OpeningHoursPeriod> 一周中每一天的开始时段，从星期日开始，按时间顺序排列。不包括该地点未营业的日期。
weekdayDescriptions	类型：Array<string> 七个字符串的数组，表示以特定格式表示一周内每天的营业时间。地点服务会根据当前语言对营业时间进行格式调整并进行本地化。此数组中元素的顺序取决于语言。有些语言以星期一作为一周的开始，而有些语言则以星期日作为开始。

OpeningHoursPeriod 类

google.maps.places.OpeningHoursPeriod 类

注意：仅可在 v=beta 渠道中使用。

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

属性
close	类型：OpeningHoursPoint optional 地点的打烊时间。
open	类型：OpeningHoursPoint 地点的开始营业时间。

OpeningHoursPoint 类

google.maps.places.OpeningHoursPoint 类

注意：仅可在 v=beta 渠道中使用。

可通过调用 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 类

注意：仅可在 v=beta 渠道中使用。

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

属性
authorAttributions	类型：Array<AuthorAttribution> 要为此照片显示的提供方说明文本。
heightPx	类型：number 照片的高度（以像素为单位）。
widthPx	类型：number 照片的宽度（以像素为单位）。

方法
getURI	getURI([options]) 参数： options：PhotoOptions optional 返回值：string 返回与指定选项对应的图片网址。

PlusCode 类

google.maps.places.PlusCode 类

注意：仅可在 v=beta 渠道中使用。

可通过调用 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 常量

注意：仅可在 v=beta 渠道中使用。

Place 对象的价格级枚举。

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

常量
EXPENSIVE
FREE
INEXPENSIVE
MODERATE
VERY_EXPENSIVE

Review 类

google.maps.places.Review 类

注意：仅可在 v=beta 渠道中使用。

可通过调用 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	类型：LatLng|LatLngLiteral|LatLngBounds|LatLngBoundsLiteral|CircleLiteral|Circle 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]（包括 1 和 5.0]）。输入的评分将四舍五入到最接近的 0.5（上限）。例如，评分为 0.6 将排除评分低于 1.0 的所有结果。
priceLevels optional	类型：Array<PriceLevel> optional 用于将搜索范围限制为标记为特定价位的地点。可以选择任意价位组合。默认为所有价位。
query optional	已废弃：请改用 textQuery 类型：string optional
rankBy optional	已弃用：请改用 rankPreference。 注意：仅可在 v=beta 渠道中使用。 类型：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	类型：Circle|CircleLiteral 要搜索的地区，以具有中心和半径的圆形的形式指定。不返回指定位置以外的结果。
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 返回的结果数上限。它必须介于 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	按热门程度对结果进行排名。