Google Maps API V3 之绘图库信息窗口-白红宇

Google Maps API V3 之绘图库信息窗口

阅读量：5219 次

发布时间：2019-06-14

本文共 5675 字，大约阅读时间需要 18 分钟。

Google官方教程：

绘图库

本文档中的概念仅适用于 google.maps.drawing 库中提供的地图项。默认情况下，系统在加载 Maps JavaScript API 时不会加载该库，您必须使用 libraries 引导程序参数进行明确指定。

http://maps.googleapis.com/maps/api/js?sensor=false&libraries=drawing

DrawingManager 类提供了一个图形界面，以供用户在地图上绘制多边形、矩形、折线、圆形和标记。DrawingManager 对象以如下方式创建：

var drawingManager = new google.maps.drawing.DrawingManager();drawingManager.setMap(map);

DrawingManager 选项

DrawingManager 构造函数采用一组选项，以定义要显示的控件集、控件的位置以及初始绘图状态。

DrawingManager 的 drawingMode 属性用于定义 DrawingManager 的初始绘图状态。该属性接受常量，且默认为 null（在此情况下启动 DrawingManager 时，光标会处于非绘图模式）。

DrawingManager 的 drawingControl 属性用于定义地图上的绘图工具选择界面的可见性。该属性接受布尔值。

您还可以使用 DrawingManager 的 drawingControlOptions 属性，定义控件的位置以及控件中应表示的叠加层的类型。
- position 用于定义绘图控件在地图上的位置，且接受常量。
- drawingModes 是一组常量，且用于定义绘图控件形状选择器中包含的叠加层类型。系统将始终显示手形图标，以便用户无需绘图即可与地图进行交互。

您可为每种叠加层类型都指定一组默认属性，以便定义首次创建相应叠加层时所采用的外观。这些属性可在叠加层的 {overlay}Options 属性（其中 {overlay} 表示叠加层的类型）中进行定义。例如，圆形的填充属性、笔触属性、zIndex 和可点击性可使用 circleOptions 属性进行定义。如果已传递任何大小、位置或地图值，则系统会忽略这些默认属性。

var drawingManager = new google.maps.drawing.DrawingManager({    drawingMode: google.maps.drawing.OverlayType.MARKER,    drawingControl: true,    drawingControlOptions: {      position: google.maps.ControlPosition.TOP_CENTER,      drawingModes: [google.maps.drawing.OverlayType.MARKER, google.maps.drawing.OverlayType.CIRCLE]    },    markerOptions: {      icon: new google.maps.MarkerImage('http://www.example.com/icon.png')    },    circleOptions: {      fillColor: '#ffff00',      fillOpacity: 1,      strokeWeight: 5,      clickable: false,      zIndex: 1,      editable: true    }  });  drawingManager.setMap(map);

更新绘图工具控件

创建 DrawingManager 对象后，您可调用 setOptions() 并传递新的值，以进行更新。

drawingManager.setOptions({    drawingControlOptions: {      position: google.maps.ControlPosition.BOTTOM_LEFT,      drawingModes: [google.maps.drawing.OverlayType.MARKER]    }  });

使用以下方法即可隐藏或显示绘图工具控件：

// To hide:  drawingManager.setOptions({    drawingControl: false  });    // To show:  drawingManager.setOptions({    drawingControl: true  });

要从 map 对象删除绘图工具控件，请使用以下方法：

drawingManager.setMap(null);

隐藏绘图控件会使得该控件不显示，但是DrawingManager类的功能依然可用。如果需要，您可以按照此方式实现自己的控件。从map对象上移除DrawingManager类，则会移除所有绘图功能。如果所有绘制要素要重置的话，那么DrawingManager类通过drawingManager.setMap(map)或者构造新的DrawingManager对象来和地图重新关联。

Drawing事件

当一个图形Overlay被创建时，有两个事件会被激发：

一个是{Overlay}complete事件（{overlay}代表了overlay的类型，比如circlecomplete，polycomplete事件等）。overlay的句柄作为参数传入。

一个是overlaycomplete事件。一个对象数组，包含OverlayType以及overlay的句柄。

google.maps.event.addListener(drawingManager, 'circlecomplete', function(circle) {  var radius = circle.getRadius();});google.maps.event.addListener(drawingManager, 'overlaycomplete', function(event) {  if (event.type == google.maps.drawing.OverlayType.CIRCLE) {    var radius = event.overlay.getRadius();  }});

信息窗口（InfoWindow）

InfoWindow 在地图上方的浮动窗口中显示内容。信息窗口有点像漫画书上的文字气球，它有一个内容区域和锥形引线，引线的头位于地图的指定位置上。通过点击 Google Maps 上的商户标记，您可以看到活动的信息窗口。

InfoWindow 构造函数采用的是 InfoWindow options 对象，该对象指定了用于显示信息窗口的一组初始参数。在创建信息窗口的过程中，系统不会在地图上添加信息窗口。要显示信息窗口，您需要调用 InfoWindow 上的 open() 方法，向其传递要在其中打开信息窗口的 Map，以及向其传递用于锚定信息窗口的 Marker（可选）。（如果未提供任何标记，那么，会在其 position 属性上打开信息窗口）。

InfoWindow options 对象是包含以下字段的对象常量：

content 包含了信息窗口打开时，系统要在其中显示的文本字符串或 DOM 节点。

pixelOffset 包含了从信息窗口的顶部到信息窗口锚定位置的偏移量。实际上，您不应也无需修改此字段。

position 包含了此信息窗口锚定位置的 LatLng。请注意，在标记上执行打开信息窗口操作时，系统会自动使用一个新位置更新该值。

maxWidth 指定了信息窗口的最大宽度（以像素为单位）。默认情况下，信息窗口会根据其中包含的内容进行扩展，如果信息窗口随着地图的大小而扩展，那么，文本将会自动换行。如果您应用了 maxWidth，那么，信息窗口将自动换行以强制适应像素的宽度。如果屏幕的实际使用面积允许的话，信息窗口在达到最大宽度后仍可垂直扩展。

InfoWindow 的内容可以是文本字符串、HTML 代码段或 DOM 元素本身。要设置此内容，请在 InfoWindow options 构造函数中传递该内容，或者对InfoWindow显式调用 setContent()。如果想要显式调整内容的大小，您可以使用 <div> 进行此操作，如果您愿意，还可以启用滚动功能。请注意，如果您没有启用滚动功能，而内容的大小又超过了信息窗口的可用空间，那么，内容可能会从信息窗口中“溢”出。

InfoWindow 可附加到 Marker 对象（在这种情况下，它们的位置取决于标记的位置）上，或附加到地图本身指定的 LatLng 位置上。如果您一次只想显示一个信息窗口（正如 Google Maps 上的相应行为），那么，您只需创建一个信息窗口，然后在地图事件（例如用户点击）执行过程中将此信息窗口重新分配到不同的位置或标记中。但与 Google Maps API 第 2 版中的相应行为不同的是，如果您选择进行上述操作，那么，地图可能会立即显示多个 InfoWindow 对象。

要更改信息窗口的位置，您可以对信息窗口调用 setPosition() 以显式的方式更改其位置，或者使用 InfoWindow.open() 方法将信息窗口附加到新标记上。请注意，如果您在没有传递标记的情况下调用了 open()，那么，InfoWindow 将会使用在构建过程中通过 InfoWindow options 对象指定的位置。

以下代码显示了澳大利亚中心位置的标记。点击该标记可显示信息窗口。

var myLatlng = new google.maps.LatLng(-25.363882,131.044922);var mapOptions = {  zoom: 4,  center: myLatlng,  mapTypeId: google.maps.MapTypeId.ROADMAP}var map = new google.maps.Map(document.getElementById("map_canvas"), mapOptions);var contentString = '
       
        '+    '
        
         '+    '
        
'+    '
        Uluru
'+    '
        
         '+    '
         Uluru, also referred to as Ayers Rock, is a large ' +    'sandstone rock formation in the southern part of the '+    'Northern Territory, central Australia. It lies 335 km (208 mi) '+    'south west of the nearest large town, Alice Springs; 450 km '+    '(280 mi) by road. Kata Tjuta and Uluru are the two major '+    'features of the Uluru - Kata Tjuta National Park. Uluru is '+    'sacred to the Pitjantjatjara and Yankunytjatjara, the '+    'Aboriginal people of the area. It has many springs, waterholes, '+    'rock caves and ancient paintings. Uluru is listed as a World '+    'Heritage Site.
'+    '
         Attribution: Uluru, '+    'http://en.wikipedia.org/w/index.php?title=Uluru (last visited June 22, 2009).
'+    '
        
'+    '
       
';var infowindow = new google.maps.InfoWindow({    content: contentString});var marker = new google.maps.Marker({    position: myLatlng,    map: map,    title:"Uluru (Ayers Rock)"});google.maps.event.addListener(marker, 'click', function() {  infowindow.open(map,marker);});

查看示例 (infowindow-simple.html)

以下显示了将信息窗口 maxWidth 设置为 200 像素的示例：

查看示例 (infowindow-simple-max.html)

转载于:https://www.cnblogs.com/jhlong/p/5394866.html

你可能感兴趣的文章

128 Longest Consecutive Sequence 一个无序整数数组中找到最长连续序列