LocalContextMapView 类
google.maps.localContext.LocalContextMapView 类
显示具有 Map 的 Local Context 体验。
此类实现了 LocalContextMapViewOptions。
通过调用 const {LocalContextMapView} = await google.maps.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 | 类型:   Array<PlaceTypePreference>请参阅  LocalContextMapViewOptions.placeTypePreferences。在LocalContextMapView上更改此属性可能会触发新的搜索。Iterable<string|PlaceTypePreference>也可接受。 | 
| 继承自: map、pinOptionsSetup、placeChooserViewSetup、placeDetailsViewSetup | |
| 方法 | |
|---|---|
| addListener | addListener(eventName, handler)参数:   
 返回值:   MapsEventListener将给定的监听器函数添加到给定的事件名称。 | 
| 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 | 类型:   Array<PlaceTypePreference>要搜索的地点类型(最多 10 种)。系统也接受  Iterable<string|PlaceTypePreference>类型,但仅在原生支持 JavaScript Symbol 的浏览器中受支持。 | 
| 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
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 | 类型:   LatLng|LatLngLiteral路线和距离的起点。 | 
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 | 地点详情显示在行开头,与地图内嵌显示。(对于从左到右书写的语言,这意味着地点详情位于地图的左侧。) |