Map View

LocalContextMapView 类

google.maps.localContext.LocalContextMapView 类

已弃用：Local Context 已被弃用，不再推荐用于新网站。此功能可继续正常使用；我们若计划停止支持，会提前 12 个月发出通知。如果您有兴趣自行打造类似于 Local Context 的体验，建议您在快速构建器中查看“Neighborhood Discovery”解决方案或使用 Maps JavaScript API 的地点库。地点库的代码示例和 Codelab 可以为您提供帮助。

注意：仅适用于 v=beta 渠道。

通过 Map 显示 Local Context 体验。

此类实现 LocalContextMapViewOptions。

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

构造函数
LocalContextMapView	LocalContextMapView(options) 参数： options：LocalContextMapViewOptions

属性
directionsOptions	类型：MapDirectionsOptions|MapDirectionsOptionsLiteral optional 请参阅LocalContextMapViewOptions.directionsOptions。
element optional	类型：HTMLElement|SVGElement optional 此字段是只读字段。支持视图的 DOM 元素。
isTransitioningMapBounds	类型：boolean 设置为 true 在 LocalContextMapView 开始更改内部 Map 的边界之前，并在 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) 参数： eventName：string handler：Function 返回值：MapsEventListener 将指定监听器函数添加到指定事件名称。
hidePlaceDetailsView	hidePlaceDetailsView() 参数：无 返回值：None 隐藏地点详情。
search	search() 参数：无 返回值：None 根据当前的 maxPlaceCount、placeTypePreferences、locationRestriction 和 locationBias 搜索要向用户显示的地点。

活动
error	function(event) 参数： event：ErrorEvent 如果执行搜索出错，则会触发此事件。
placedetailsviewhidestart	function() 参数：None 此事件在地点详情开始以动画形式呈现之前触发。
placedetailsviewshowstart	function() 参数：None 此事件在地点详情开始以动画形式呈现之前触发。

LocalContextMapViewOptions 接口

google.maps.localContext.LocalContextMapViewOptions 接口

注意：仅适用于 v=beta 渠道。

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

属性
maxPlaceCount	类型：number 可显示的地点数量上限。当此参数为 0 时，Local Context Library 不会加载地点。[0,24]
placeTypePreferences	类型：Array<PlaceTypePreference> 要搜索的地点类型（最多 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({   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

注意：仅适用于 v=beta 渠道。

要搜索的地点类型以及要使用的权重。如果省略 weight，该库将确定默认权重，但默认权重可能会随着时间的推移而发生变化和改进。

{
  type:string,
  weight:number optional
}

MapDirectionsOptions 类

google.maps.localContext.MapDirectionsOptions 类

注意：仅适用于 v=beta 渠道。

通过 LocalContextMapView 提供路线设置。

此类实现 MapDirectionsOptionsLiteral。

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

属性
已继承： origin

方法
addListener	addListener(eventName, handler) 参数： eventName：string handler：Function 返回值：MapsEventListener 将指定监听器函数添加到指定事件名称。

MapDirectionsOptionsLiteral 接口

google.maps.localContext.MapDirectionsOptionsLiteral 接口

注意：仅适用于 v=beta 渠道。

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

属性
origin	类型：LatLng|LatLngLiteral 路线和距离的出发地。

PinOptions 接口

google.maps.localContext.PinOptions 接口

注意：仅适用于 v=beta 渠道。

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

属性
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 常量

注意：仅适用于 v=beta 渠道。

地点选择器的布局模式。

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

常量
HIDDEN	地点选择器已隐藏。
SHEET	地点选择器以工作表的形式显示。

PlaceChooserPosition 常量

google.maps.localContext.PlaceChooserPosition 常量

注意：仅适用于 v=beta 渠道。

地点选择器的显示位置。

通过调用 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 常量

注意：仅适用于 v=beta 渠道。

地点详情的布局模式。

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

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

PlaceDetailsPosition 常量

google.maps.localContext.PlaceDetailsPosition 常量

注意：仅适用于 v=beta 渠道。

显示地点详情的位置。

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

常量
INLINE_END	地点详情会以内嵌方式显示在地图行末尾。（从左到右的语言表示地点详情位于地图右侧。）
INLINE_START	地点详情会在线条的起点与地图内嵌显示。（从左到右的语言表示地点详情位于地图左侧。）