Map View

LocalContextMapView 类

google.maps.localContext.LocalContextMapView 类

已弃用：Local Context 已弃用，不再推荐用于新网站。此功能将继续正常运行，并在我们停止支持前 12 个月发出通知。如果您想自行打造类似 Local Context 的体验，不妨试试快速构建器中的“街区探索”解决方案，或使用 Maps JavaScript API 地点库。地点库的代码示例和 Codelab 可以助您一臂之力。

注意：仅在 v=beta 渠道中提供。

使用 Map 展示 Local Context 体验。

此类实现 LocalContextMapViewOptions。

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

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

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

属性
directionsOptions	类型：MapDirectionsOptions|MapDirectionsOptionsLiteral optional 请参阅LocalContextMapViewOptions.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	类型：Array<PlaceTypePreference> 请参阅 LocalContextMapViewOptions.placeTypePreferences。更改LocalContextMapView上的此属性可能会触发新的搜索。Iterable<string|PlaceTypePreference> 也受支持。
继承的设置： map、 pinOptionsSetup、 placeChooserViewSetup、 placeDetailsViewSetup

方法
addListener	addListener(eventName, handler) 参数： eventName：string handler：Function 返回值：MapsEventListener 将给定的监听器函数添加到给定的事件名称。
hidePlaceDetailsView	hidePlaceDetailsView() 参数：无 返回值：无 隐藏地点详情。
search	search() 参数：无 返回值：无 搜索地点，以便根据当前的 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类型定义符

注意：仅在 v=beta 渠道中提供。

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

{
  type:string,
  weight:number optional
}

MapDirectionsOptions 类

google.maps.localContext.MapDirectionsOptions 类

注意：仅在 v=beta 渠道中提供。

使用 LocalContextMapView 提供路线设置。

此类实现 MapDirectionsOptionsLiteral。

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

使用 v=beta 时，可通过调用 const {MapDirectionsOptions} = await google.map.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 渠道中提供。

地点选择器的布局模式。

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

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

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

PlaceChooserPosition 常量

google.maps.localContext.PlaceChooserPosition 常量

注意：仅在 v=beta 渠道中提供。

显示地点选择器的位置。

使用 &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 常量

注意：仅在 v=beta 渠道中提供。

地点详情的布局模式。

使用 &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 常量

注意：仅在 v=beta 渠道中提供。

显示地点详情的位置。

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

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

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