Place 类
google.maps.places.Place 类
通过调用 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 | 
| priceLevel | 类型:   PriceLevel optional相应地点的价格水平。此属性可以返回以下任一值  
 | 
| 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 型连接器。 | 
| 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 | 柴油。 | 
| 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”。 | 
| 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 | 类型:   Array<AuthorAttribution>要为此照片显示的提供方文本。 | 
| 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> optionalPlace.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 | 类型:   LatLng|LatLngLiteral|LatLngBounds|LatLngBoundsLiteral|CircleLiteral|Circle 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用于将搜索范围限制为标记为特定价位的地点。您可以选择任意价格等级组合。默认为所有价格水平。 | 
|  | 类型:   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 参考文档。
| 属性 | |
|---|---|
| locationRestriction | 类型:   Circle|CircleLiteral要搜索的区域,指定为具有中心和半径的圆。不会返回指定位置以外的结果。 | 
| excludedPrimaryTypes optional | 类型:   Array<string> optional排除的主要地点类型。请参阅支持的类型的完整列表。一个地点只能有一个主要类型。最多可以指定 50 种类型。如果您在  included和excluded列表中指定了相同的类型,系统会返回 INVALID_ARGUMENT 错误。 | 
| excludedTypes optional | 类型:   Array<string> optional排除的地点类型。请参阅支持的类型的完整列表。一个地点可以有多种不同的地点类型。最多可以指定 50 种类型。如果您在  included和excluded列表中指定了相同的类型,系统会返回 INVALID_ARGUMENT 错误。 | 
| fields optional | 类型:   Array<string> optionalPlace.searchNearby的必需参数。要包含在响应中的字段,这些字段会产生费用。如果传入的是['*'],系统会返回所有可用字段并据此计费(不建议用于生产环境中的部署)。您可以请求Place类中的任何属性作为字段。 | 
| 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 之间(含边界值)。 | 
| 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 | 按热门程度对结果进行排名。 |