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

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 的初始绘图状态。该属性接受 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)