Map View

LocalContextMapView

google.maps.localContext.LocalContextMapView

使用 Map 展示 Local Context 体验。

此类实现 LocalContextMapViewOptions

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

LocalContextMapView
LocalContextMapView(options)
参数
directionsOptions
element optional
类型HTMLElement|SVGElement optional
此字段为只读字段。支持视图的 DOM 元素。
isTransitioningMapBounds
类型boolean
LocalContextMapView 开始更改内部 Map 的边界之前,设置为 true,在 LocalContextMapView 更改内部 Map 的边界后,设置为 false。(当布局模式因自适应大小调整而发生变化时未设置。)
locationBias
类型LocationBias optional
请参阅 LocalContextMapViewOptions.locationBias。更改LocalContextMapView上的此属性可能会触发新的搜索。
locationRestriction
类型LocationRestriction optional
请参阅 LocalContextMapViewOptions.locationRestriction。更改LocalContextMapView上的此属性可能会触发新的搜索。
maxPlaceCount
类型number
请参阅 LocalContextMapViewOptions.maxPlaceCount。更改LocalContextMapView上的此属性可能会触发新的搜索。
placeTypePreferences
请参阅 LocalContextMapViewOptions.placeTypePreferences。更改LocalContextMapView上的此属性可能会触发新的搜索。Iterable<string|PlaceTypePreference> 也受支持。
继承的设置mappinOptionsSetupplaceChooserViewSetupplaceDetailsViewSetup
addListener
addListener(eventName, handler)
参数
返回值MapsEventListener
将给定的监听器函数添加到给定的事件名称。
hidePlaceDetailsView
hidePlaceDetailsView()
参数:无
返回值:无
隐藏地点详情。
search
search()
参数:无
返回值:无
搜索地点,以便根据当前的 maxPlaceCountplaceTypePreferenceslocationRestrictionlocationBias 向用户显示。
error
function(event)
参数
如果在执行搜索时出错,则会触发此事件。
placedetailsviewhidestart
function()
参数:None
此事件在地点详情开始呈现动画效果之前触发。
placedetailsviewshowstart
function()
参数:None
此事件在地点详情开始呈现动画效果之前触发。

LocalContextMapViewOptions 接口

google.maps.localContext.LocalContextMapViewOptions接口

用于构造 LocalContextMapView 或访问现有 LocalContextMapView 的选项。

maxPlaceCount
类型number
可显示的地点数量上限。当此参数为 0 时,Local Context Library 不会加载地点。[0,24]
placeTypePreferences
要搜索的地点类型(最多 10 个)。Iterable<string|PlaceTypePreference> 类型也是可以接受的,但只有原生支持 JavaScript 符号的浏览器才支持该类型。
directionsOptions optional
用于自定义路线的选项。如果未设置,系统将停用路线和距离功能。
element optional
类型HTMLElement|SVGElement optional
此字段为只读字段。支持视图的 DOM 元素。
locationBias optional
类型LocationBias optional
默认null
搜索地点时使用的软边界或提示。
locationRestriction optional
类型LocationRestriction optional
用于限制搜索结果的边界。如果未指定,结果将限制在地图视口内。
map optional
类型Map optional
已实例化的 Map 实例。如果传入,则地图将会移到 LocalContextMapView 的 DOM 中,并且不会重新设置样式。与地图关联的元素可能还有由 LocalContextMapView 应用的样式和类。
pinOptionsSetup optional
类型(function({
  isSelected:boolean,
  isHighlighted:boolean
}): (PinOptions optional))|PinOptions optional
根据图标状态配置地点标记图标。每当回调的输入更改时调用。传递一个函数,以便在 LocalContextMapView 绘制地点标记时动态替换默认设置。错误和无效配置可能是异步确定的,并且将被忽略(系统将使用默认值,并且会将错误记录到控制台)。
placeChooserViewSetup optional
类型(function({
  defaultLayoutMode:PlaceChooserLayoutMode,
  defaultPosition:PlaceChooserPosition optional
}): (PlaceChooserViewSetupOptions optional))|PlaceChooserViewSetupOptions optional
覆盖地点选择器视图的设置。传递一个函数,以便在 LocalContextMapView 由于调整大小而改变布局时,动态覆盖默认设置。错误和无效配置可能是异步确定的,并且将被忽略(系统将使用默认值,并且会将错误记录到控制台)。构建期间检测到的错误将导致同步抛出错误。
placeDetailsViewSetup optional
类型(function({
  defaultLayoutMode:PlaceDetailsLayoutMode,
  defaultPosition:PlaceDetailsPosition optional
}): (PlaceDetailsViewSetupOptions optional))|PlaceDetailsViewSetupOptions optional
覆盖地点详情视图的设置。传递一个函数,以便在 LocalContextMapView 由于调整大小而改变布局时,动态覆盖默认设置。错误和无效配置可能是异步确定的,并且将被忽略(系统将使用默认值,并且会将错误记录到控制台)。构建期间检测到的错误将导致同步抛出错误。

PlaceTypePreference typedef

google.maps.localContext.PlaceTypePreference类型定义符

要搜索的地点类型和要使用的权重。如果省略 weight,该库会确定默认权重,这些权重可能会随着时间的推移而变化和改进。

{
  type:string,
  weight:number optional
}

MapDirectionsOptions

google.maps.localContext.MapDirectionsOptions

使用 LocalContextMapView 提供路线设置。

此类实现 MapDirectionsOptionsLiteral

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

继承的设置origin
addListener
addListener(eventName, handler)
参数
返回值MapsEventListener
将给定的监听器函数添加到给定的事件名称。

MapDirectionsOptionsLiteral 接口

google.maps.localContext.MapDirectionsOptionsLiteral接口

为方便起见,在许多地方都可使用对象字面量代替 MapDirectionsOptions 对象。当 Maps API 遇到这些对象时,它们会转换为 MapDirectionsOptions 对象。

origin
路线和距离的起点。

PinOptions 接口

google.maps.localContext.PinOptions接口

用于自定义图钉标记的选项。

background optional
类型string optional
图标形状的颜色可以是任何有效的 CSS 颜色。
glyphColor optional
类型string optional
图标的字形的颜色,可以是任何有效的 CSS 颜色。
scale optional
类型number optional
图标的比例。该值是绝对值,而不是相对于每种状态的默认尺寸。

PlaceChooserViewSetupOptions 接口

google.maps.localContext.PlaceChooserViewSetupOptions接口

地点选择器的设置选项。详细了解如何设置布局和可见性

layoutMode optional
类型PlaceChooserLayoutMode optional
position optional
类型PlaceChooserPosition optional
layoutMode:HIDDEN 时被忽略。如果未通过,系统将根据layoutMode自动确定排名。

PlaceChooserLayoutMode 常量

google.maps.localContext.PlaceChooserLayoutMode 常量

地点选择器的布局模式。

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

HIDDEN 地点选择器已隐藏。
SHEET 地点选择器显示为工作表。

PlaceChooserPosition 常量

google.maps.localContext.PlaceChooserPosition 常量

显示地点选择器的位置。

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

BLOCK_END 地点选择器显示在地图下方延伸至容器末尾的一行上。
INLINE_END 地点选择器以内嵌方式显示在行末。(对于从左到右书写的语言,这表示地点选择器位于地图右侧。)
INLINE_START 地点选择器以内嵌方式显示在行首。(从左到右,这意味着地点选择器位于地图左侧)。

PlaceDetailsViewSetupOptions 接口

google.maps.localContext.PlaceDetailsViewSetupOptions接口

地点详情的设置选项。详细了解如何设置布局和可见性

hidesOnMapClick optional
类型boolean optional
layoutMode optional
类型PlaceDetailsLayoutMode optional
position optional
类型PlaceDetailsPosition optional
layoutMode:INFO_WINDOW 时被忽略。如果未通过,系统将根据layoutMode自动确定排名。

PlaceDetailsLayoutMode 常量

google.maps.localContext.PlaceDetailsLayoutMode 常量

地点详情的布局模式。

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

INFO_WINDOW 地点详情显示在 InfoWindow 中。
SHEET 地点详情会显示在工作表中。

PlaceDetailsPosition 常量

google.maps.localContext.PlaceDetailsPosition 常量

显示地点详情的位置。

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

INLINE_END 地点详情在行末以内嵌方式显示在地图中。(对于从左到右书写的语言,这个地点的详细信息位于地图右侧。)
INLINE_START 地点详情以内嵌方式显示在行首。(对于从左到右书写的语言,这个地点的详细信息位于地图左侧。)