Map View

LocalContextMapView

google.maps.localContext.LocalContextMapView

使用 Map 展示 Local Context 体验。

此类实现 LocalContextMapViewOptions

使用 &libraries=localContext 网址参数加载。请参阅 Maps JavaScript API 中的库

使用 v=beta 时,可通过调用 const {LocalContextMapView} = await google.map.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 的选项。

使用 &libraries=localContext 网址参数加载。请参阅 Maps JavaScript API 中的库

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,该库会确定默认权重,这些权重可能会随着时间的推移而变化和改进。

使用 &libraries=localContext 网址参数加载。请参阅 Maps JavaScript API 中的库

{
  type:string,
  weight:number optional
}

MapDirectionsOptions

google.maps.localContext.MapDirectionsOptions

使用 LocalContextMapView 提供路线设置。

此类实现 MapDirectionsOptionsLiteral

使用 &libraries=localContext 网址参数加载。请参阅 Maps JavaScript API 中的库

使用 v=beta 时,可通过调用 const {MapDirectionsOptions} = await google.map.importLibrary("localContext") 进行访问。请参阅 Maps JavaScript API 中的库

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

MapDirectionsOptionsLiteral 接口

google.maps.localContext.MapDirectionsOptionsLiteral接口

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

使用 &libraries=localContext 网址参数加载。请参阅 Maps JavaScript API 中的库

origin
路线和距离的起点。

PinOptions 接口

google.maps.localContext.PinOptions接口

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

使用 &libraries=localContext 网址参数加载。请参阅 Maps JavaScript API 中的库

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

PlaceChooserViewSetupOptions 接口

google.maps.localContext.PlaceChooserViewSetupOptions接口

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

使用 &libraries=localContext 网址参数加载。请参阅 Maps JavaScript API 中的库

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

PlaceChooserLayoutMode 常量

google.maps.localContext.PlaceChooserLayoutMode 常量

地点选择器的布局模式。

使用 &libraries=localContext 网址参数加载。请参阅 Maps JavaScript API 中的库

使用 v=beta 时,可通过调用 const {PlaceChooserLayoutMode} = await google.map.importLibrary("localContext") 进行访问。请参阅 Maps JavaScript API 中的库

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

PlaceChooserPosition 常量

google.maps.localContext.PlaceChooserPosition 常量

显示地点选择器的位置。

使用 &libraries=localContext 网址参数加载。请参阅 Maps JavaScript API 中的库

使用 v=beta 时,可通过调用 const {PlaceChooserPosition} = await google.map.importLibrary("localContext") 进行访问。请参阅 Maps JavaScript API 中的库

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

PlaceDetailsViewSetupOptions 接口

google.maps.localContext.PlaceDetailsViewSetupOptions接口

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

使用 &libraries=localContext 网址参数加载。请参阅 Maps JavaScript API 中的库

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

PlaceDetailsLayoutMode 常量

google.maps.localContext.PlaceDetailsLayoutMode 常量

地点详情的布局模式。

使用 &libraries=localContext 网址参数加载。请参阅 Maps JavaScript API 中的库

使用 v=beta 时,可通过调用 const {PlaceDetailsLayoutMode} = await google.map.importLibrary("localContext") 进行访问。请参阅 Maps JavaScript API 中的库

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

PlaceDetailsPosition 常量

google.maps.localContext.PlaceDetailsPosition 常量

显示地点详情的位置。

使用 &libraries=localContext 网址参数加载。请参阅 Maps JavaScript API 中的库

使用 v=beta 时,可通过调用 const {PlaceDetailsPosition} = await google.map.importLibrary("localContext") 进行访问。请参阅 Maps JavaScript API 中的库

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