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
设置为 trueLocalContextMapView 开始更改内部 Map 的边界之前,并在 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()
参数:无
返回值:None
隐藏地点详情。
search
search()
参数:无
返回值:None
根据当前的 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 typedef

要搜索的地点类型以及要使用的权重。如果省略 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 地点详情会在线条的起点与地图内嵌显示。(从左到右的语言表示地点详情位于地图左侧。)