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 |
类型:
MapDirectionsOptions|MapDirectionsOptionsLiteral optional |
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> 也受支持。 |
继承的设置:
map 、
pinOptionsSetup 、
placeChooserViewSetup 、
placeDetailsViewSetup
|
方法 | |
---|---|
addListener |
addListener(eventName, handler) 参数:
将给定的监听器函数添加到给定的事件名称。 |
hidePlaceDetailsView |
hidePlaceDetailsView() 参数:无
返回值:无
隐藏地点详情。 |
search |
search() 参数:无
返回值:无
搜索地点,以便根据当前的 maxPlaceCount 、placeTypePreferences 、locationRestriction 和 locationBias 向用户显示。 |
活动 | |
---|---|
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 |
类型:
MapDirectionsOptions|MapDirectionsOptionsLiteral 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({ 根据图标状态配置地点标记图标。每当回调的输入更改时调用。传递一个函数,以便在 LocalContextMapView 绘制地点标记时动态替换默认设置。错误和无效配置可能是异步确定的,并且将被忽略(系统将使用默认值,并且会将错误记录到控制台)。 |
placeChooserViewSetup optional |
类型:
(function({ 覆盖地点选择器视图的设置。传递一个函数,以便在 LocalContextMapView 由于调整大小而改变布局时,动态覆盖默认设置。错误和无效配置可能是异步确定的,并且将被忽略(系统将使用默认值,并且会将错误记录到控制台)。构建期间检测到的错误将导致同步抛出错误。 |
placeDetailsViewSetup optional |
类型:
(function({ 覆盖地点详情视图的设置。传递一个函数,以便在 LocalContextMapView 由于调整大小而改变布局时,动态覆盖默认设置。错误和无效配置可能是异步确定的,并且将被忽略(系统将使用默认值,并且会将错误记录到控制台)。构建期间检测到的错误将导致同步抛出错误。 |
PlaceTypePreference typedef
google.maps.localContext.PlaceTypePreference
类型定义符
要搜索的地点类型和要使用的权重。如果省略 weight
,该库会确定默认权重,这些权重可能会随着时间的推移而变化和改进。
{
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) 参数:
将给定的监听器函数添加到给定的事件名称。 |
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
常量
地点选择器的布局模式。
使用 &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
接口
地点详情的设置选项。详细了解如何设置布局和可见性。
属性 | |
---|---|
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 |
地点详情以内嵌方式显示在行首。(对于从左到右书写的语言,这个地点的详细信息位于地图左侧。) |