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

绘图库

本文档中的概念仅适用于 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 的初始绘图状态。该属性接受 google.maps.drawing.OverlayType 常量，且默认为 null（在此情况下启动 DrawingManager 时，光标会处于非绘图模式）。
• DrawingManager 的 drawingControl 属性用于定义地图上的绘图工具选择界面的可见性。该属性接受布尔值。
• 您还可以使用 DrawingManager 的 drawingControlOptions 属性，定义控件的位置以及控件中应表示的叠加层的类型。
  • position 用于定义绘图控件在地图上的位置，且接受 google.maps.ControlPosition 常量。
  • drawingModes 是一组 google.maps.drawing.OverlayType 常量，且用于定义绘图控件形状选择器中包含的叠加层类型。系统将始终显示手形图标，以便用户无需绘图即可与地图进行交互。
• 您可为每种叠加层类型都指定一组默认属性，以便定义首次创建相应叠加层时所采用的外观。这些属性可在叠加层的 {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 = ‘<div id="content">‘+
    ‘<div id="siteNotice">‘+
    ‘</div>‘+
    ‘<h2 id="firstHeading" class="firstHeading">Uluru</h2>‘+
    ‘<div id="bodyContent">‘+
    ‘<p><b>Uluru</b>, also referred to as <b>Ayers Rock</b>, 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.</p>‘+
    ‘<p>Attribution: Uluru, <a href="http://en.wikipedia.org/w/index.php?title=Uluru&oldid=297882194">‘+
    ‘http://en.wikipedia.org/w/index.php?title=Uluru</a> (last visited June 22, 2009).</p>‘+
    ‘</div>‘+
    ‘</div>‘;

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)