Map View

LocalContextMapView 类

google.maps.localContext.LocalContextMapView 类

已弃用：本地情境已弃用，不再建议新网站使用。此功能可继续正常使用；我们若计划停止支持，会提前 12 个月发出通知。如果您有兴趣自行打造类似于 Local Context 的体验，建议您在快速构建器中查看“街区探索”解决方案或使用 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 在 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 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({   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	地点详情显示在行开头，与地图内嵌显示。（对于从左到右书写的语言，这意味着地点详情位于地图的左侧。）