搜狗地图 Javascript API 参考

包含了所有开发中用到的类，方法及事件。

使用前请您认真阅读《搜狗地图API使用条款》，如果您已开始使用，表示您已确认并同意该条款中的所有内容。

参考目录

此类是地图API的核心类，用来实例化一个地图。[查看简单示例] [查看所有示例]

构造函数

构造函数说明

Map(mapDiv:Node, opts?:MapOptions)

在指定的 HTML 容器中创建新的地图，该容器通常是一个 DIV 元素。

方法

方法返回值说明

fitBounds(bounds:Bounds|LatLngBounds,maxLevel:Number)

None

设置地图，使其与指定范围相符；第二个参数maxLevel用于限制最大级数，缺省则不限制。 [查看示例1] [查看示例2]

getBounds()

返回当前地图区域的范围。如果还未启动地图(即 mapType 仍为 Null)，或者没有设置中心和缩放，则结果为 Null。

getCenter()

获取地图当前中心坐标值。

getContainer()

Node

获取地图容器层。

getDiv()

Node

获取覆盖层和地图瓦片所在的容器DIV。

getPanel()

Node

获取绘图DIV,可添加测距，拉框等工具图标。

getMapHeight()

Number

获取地图区域视窗高度。

getMapWidth()

Number

获取地图区域视窗宽度。

getMapTypeId()

获取当前地图类型ID。

getProjection()

获取投影对象。

getZoom()

Number

获取当前地图级别。

init()

None

仅当实例化Map时无MapOptions参数，才需要调用此方法初始化地图。(兼容1.0)

panBy(x:Number, y:Number)

None

将地图中心移动一段指定的距离(以像素为单位)。如果这段距离既小于地图的宽度，又小于地图的高度，那么移动的动画效果将会十分流畅。请注意，地图坐标系的 x 值从西向东增加，y 值从北向南增加。

panTo(latLng:LatLng|point:Point)

None

将地图中心更改为指定的 LatLng|Point。如果更改幅度既小于地图的宽度，又小于地图的高度，那么移动的动画效果将会十分流畅。

resetMap()

None

还原地图到初始的状态。

resizeTo(width:Number,height:Number)

None

设置地图的宽度。

setCenter(latlng:LatLng|point:Point , zoom:Number)

None

将地图中心更改为指定的 LatLng|Point，如果更改幅度既小于地图的宽度，又小于地图的高度，那么移动的动画效果将会十分流畅。还可以同时将地图级别指定为zoom(取值0~18)，zoom可以缺省。 [查看各城市中心坐标]。

setMapTypeId(mapTypeId:MapTypeId)

None

设置地图类型，如：sogou.maps.MapTypeId.ROADMAP 普通地图、sogou.maps.MapTypeId.SATELLITE 卫星地图、sogou.maps.MapTypeId.HYBRID 卫星和路网混合地图

setOptions(options:MapOptions)

None

设置地图参数

setZoom(zoom:Number)

None

设置地图当前缩放级别，取值范围：0~18

clearAll()

None

清除地图上所有绘制的覆盖物，包括：Marker、PolyLine、Label等等。如果覆盖的isFixed属性为true，则不会被清除。[查看示例]

事件

事件参数说明

zoom

None

当地图缩放属性更改时会触发此事件。

bounds_changed

None

当地图可视区域范围更改时会触发此事件。

center_changed

None

当地图中心属性更改时会触发此事件。

click

当用户点击地图(但不是点击标记或信息窗口)时会触发此事件。

dblclick

当用户双击地图时会触发此事件。请注意，触发此事件前还会触发点击事件。

drag

None

当用户拖动地图时会反复触发此事件。

dragend

None

当用户停止拖动地图时会触发此事件。

dragstart

None

当用户开始拖动地图时会触发此事件。

idle

None

如果地图在平移或缩放之后变为闲置状态，则会触发此事件。

maptypeid_changed

None

当 mapTypeId 属性更改时会触发此事件。

mousedown

只要用户的鼠标在地图容器上按下，就会触发此事件。

mousemove

只要用户的鼠标在地图容器上移动，就会触发此事件。

mouseup

只要用户的鼠标在地图容器上抬起，就会触发此事件。

rightclick

在地图容器中触发 DOM contextmenu 事件时会触发此事件。

resize

None

当地图区域宽高改变时触发此事件。

tilesloaded

None

可见图块载入完成后会触发此事件。仅当实例化Map时无MapOptions参数，且调用init()初始化地图时才有效。如果是要在地图初始化完后执行一些操作，使用MapOptions的callback参数可以得到同样的效果。

inited

None

地图初始化完成后会触发此事件。仅当实例化Map时无MapOptions参数，且调用init()初始化地图时才有效。如果是要在地图初始化完后执行一些操作，使用MapOptions的callback参数可以得到同样的效果。

clearall

None

调用clearAll方法清除覆盖层对象后会触发此事件。(兼容1.0)

实例化 Map 类时，可以送入的参数规范。[查看示例]

属性

属性类型说明

bounds

初始化时设置地图，使其与指定范围相符。如果同时设置了bounds和center两个参数，则bounds优先级高，忽略center参数。[查看示例]

maxLevel

Number

maxLevel用于限制有bounds参数时的最大级数，缺省则不限制。无bounds参数时此参数无效。[查看示例]

center

初始的地图中心。必填。[查看各城市中心坐标]。

draggable

boolean

如果为 False，则禁止拖动地图。默认情况下启用拖动。

mapTypeId

初始的地图 mapTypeId。取值：

sogou.maps.MapTypeId.ROADMAP 普通地图 [查看城市列表]、

sogou.maps.MapTypeId.SATELLITE 卫星地图、

sogou.maps.MapTypeId.HYBRID 卫星和路网混合地图、

sogou.maps.MapTypeId.EDUSHIMAP 三维地图 [查看支持的城市],[查看三维地图示例]，

默认为ROADMAP。

mapControl

boolean

缩放、漫游控件的初始启用/停用状态。

mapControlType

Number

缩放、漫游控件的样式类型，取值：1~5。分别表示：

1 完整样式。

2 去掉滑动条，只有加减按钮、漫游箭头和地图类型控制。

3 只有加减按钮、地图类型控制(居右上角)。

4 只有加减按钮。

5 只有地图类型控制(居右上角)。

panControlOptions

设置漫游控件的初始化参数。

scaleControl

boolean

比例尺控件的初始启用/停用状态。

scrollwheel

boolean

如果为 False，则停用通过滚轮缩放地图的功能。默认情况下启用滚轮功能。

zoom

Number

初始的地图缩放级别。

callback

Function

指定回调函数，地图初始化完毕后回调此函数，函数中的this引用指向Map。

dblclickable

boolean

如果为 false，则禁止双击放大地图。默认为true。

hdMap

boolean

是否使用高清地图，仅建议在高清移动设备上使用，如果为 true，则显示高清地图，默认为false。[查看示例]

rmpid

Number

设置不同样式的地图底图，如:rmpid为191时，为比较素的风格的底图。

tileSize

设置地图瓦片大小。与hdMap配合使用，用于在不同分辨率的显示屏上设置清晰度。普清的瓦片大小为new Size(256,256)，高清的瓦片大小默认为new Size(192,192)，在new ipad和iphone 4s上建议设置为new Size(128,128)。

disableMouseWheel

boolean

设置鼠标在地图上滚轮时，禁止缩放地图，而且整个页面会随着滚轮滚动。

常见 MapTypes 的标识符。[查看示例]

常数

常数说明

ROADMAP

该地图类型显示普通的街道地图 [查看城市列表]。

SATELLITE

该地图类型显示卫星图像。

HYBRID

该地图类型显示卫星图像上的主要街道透明层。

EDUSHIMAP

该地图类型显示三维地图[查看支持的城市]。

PanControlOptions 对象规范

用于设漫游控件的初始化参数。[查看示例]

属性

类型

说明

center

设置默认还原的地图中心。

level

Number

设置默认还原的地图级别。

Projection 对象规范

用于在像素坐标和地理坐标的互转。[查看示例]

fromContainerPixelToLatLng(pixel:Point)

根据地图容器中的像素坐标计算地理坐标。

fromDivPixelToLatLng(pixel:Point)

根据存放可拖动地图的 div 中的像素坐标计算地理坐标。

fromLatLngToContainerPixel(point:Point)

计算地图外部容器的 DOM 元素中指定地理位置的像素坐标。

fromLatLngToDivPixel(point:Point)

计算存放可拖动地图的 DOM 元素中指定地理位置的像素坐标。

标记类 ，又名 点对象类，用于在地图上添加标记(点对象)。[查看简单示例] [查看所有示例]

构造函数

构造函数

说明

Marker(

创建带有指定选项的标记。如果已指定地图，则标记会在构造完成后立即添加到该地图。请注意，您必须设置标记的显示位置。

方法

方法返回值说明

getDraggable()

boolean

获取当前改标记是否可拖拽。

getIcon()

获取当前标记对象的前景图标。

getMap()

获取显示所在的Map对象。

getPosition()

获取标记所在的位置坐标。

getShadow()

获取阴影图像。

getShape()

获取鼠标可感应区域对象。

getTitle()

String

获取标记的名称。

getVisible()

boolean

获取标记当前是否可见。

getZIndex()

Number

获取标记当前的叠加顺序。

setDraggable(flag:boolean)

None

设置标记可被拖拽。

setIcon(

None

设置标记的前景图标。

setIcons(icons:Array.)

None

设置标记的默认前景图标和鼠标悬停时前景图标，参数为数组，有2个元素，第1个表示默认前景图标，第2个表示鼠标悬停时的前景图标。

setMap(map:Map)

None

在指定地图上渲染标记。如果地图设置为 Null，则会删除此标记。

setPosition(point:Point|latlng:LatLng)

None

设置标记的位置，支持搜狗地图坐标和经纬度坐标。

setShadow(

None

设置标记的阴影。

setTitle(title:String)

None

设置标记的名称，用于显示tip和Label。

setVisible(visible:boolean)

None

设置标记可见/不可见。

setZIndex(zIndex:Number)

None

设置标记的叠加顺序。

getFeature()

FeatureNode|None

如果此标记有附加数据信息。将会有数据返回。否则无。

事件

事件

参数

说明

icon_changed

None

当标记图标属性更改时会触发此事件。

click

Event

点击标记图标后会触发此事件。

dblclick

Event

当双击标记图标时会触发此事件。

drag

当用户拖动标记时会反复触发此事件。

dragend

当用户停止拖动标记时会触发此事件。

draggable_changed

None

当标记的可拖动属性更改时会触发此事件。

dragstart

当用户开始拖动标记时会触发此事件。

mousedown

Event

对标记图标触发 DOM mousedown 事件时会触发此事件。

mouseout

Event

当鼠标离开标记图标区域时会触发此事件。

mouseover

Event

当鼠标进入标记图标区域时会触发此事件。

mouseup

Event

对标记触发 DOM mouseup 事件时会触发此事件。

position_changed

None

当标记位置属性更改时会触发此事件。

rightclick

Event

右键点击标记时会触发此事件。

title_changed

None

当标记名称属性更改时会触发此事件。

visible_changed

None

当标记的可见属性更改时会触发此事件。

zindex_changed

None

当标记的 zIndex 属性更改时会触发此事件。

MarkerOptions 对象规范

用于设置Marker的初始化参数。[查看示例]

属性

类型

说明

disableLabel

boolean

设置是否在鼠标悬停时显示Label。

draggable

boolean

如果为 true，则可拖动标记。默认值为 false。

feature

兼容1.0的FeatureNode对象创建。

icon

前景的默认图标

icons

0 前景的默认图标，1 前景鼠标悬停时的图标

id

String

Marker的编号标识。

isFixed

boolean

是否钉住，默认false。如果为true则不会被Map对象的clearAll方法清除；但setMap(null)忽略此属性，无论true还是false都删除。

label

设置Label对象的参数。

map

待显示标记的地图。

position

标记位置。必填。

shadows

0 阴影默认图像，1 阴影鼠标悬停时图像。

shape

用于拖动/点击的图像地图区域定义。

stopEvent

boolean

阻止事件冒泡到Map。

styleId

String

指定样式id，以使用系统样式或者用StyleLib类预加载的样式。系统样式id有：S1980、S1890、S1891、S1892、S1893、S1894、S1895、S1896、S1897、S1898、S1899。

title

String

Label文本或者鼠标悬停时显示的tip。

visible

boolean

如果为 true，则显示标记。

zIndex

Number

所有标记按其 zIndex 值的大小顺序在地图上显示，zIndex

值较大的标记显示在值较小的标记之前。

MarkerImage 类

用于定义Marker对象的图标、阴影等。[示例1][示例2][示例3]

构造函数

构造函数

说明

MarkerImage(url:String, size:Size,

origin:Point,

anchor:Point,

scaledSize:Size)

定义一张用作标记图标或者阴影的图像。

"url" 指定图标图片路径；

"size"为图标或者阴影的大小；

为了减少连接数，提高下载速度，API支持将多个图标合并到一张图片中，"origin"和"size"用于选择拼合图片中的图标所在的图块；

"anchor"用于重写锚点默认所处的位置，图像的锚点是系统在跟踪图像位置时引用的像素，默认情况下，锚点设置为图像的中间位置

("size"宽度/2, "size"高度/2)；因此，当标记放置在指定的 Point或者LatLng 上时，定义为锚点的像素就定位于指定的 Point或者LatLng

上。

无论该图像是否为拼合图片，都请将 scaledSize

的值设置为整个图片的大小，并用其左上角作为原点设置"origin"。

注：MarkerImage 在构造完成后就无法更改。

MarkerShape 对象规范

用于确定标记的可点击区域的标记形状。该形状包括两个属性(type 和

coord)，分别为类型和坐标。与在图片上定义可点击热区的原理相同。[示例1][示例2]

属性

属性

类型

说明

coord

Array.

此属性的格式取决于 type 的值，并且遵循 http://www.w3.org/tr/REC-html40/struct/objects.html#adef-coords

上的 w3 AREA coords 规范。

coord

是一个整数数组，其中的整数指定形状相对于目标图像左上角的像素位置。坐标取决于下面所示的 type 值：

- circ 或 circle：coord 是

[x1,y1,r]，其中 x1,y2 是圆心的坐标，而 r 是圆的半径。

-

poly 或 polygon：coord 是

[x1,y1,x2,y2...xn,yn]，其中每个 x,y 对包含多边形的一个顶点的坐标。

- rect 或 rectangle：coord 是

[x1,y1,x2,y2]，其中 x1,y1 是矩形的左上角的坐标，而 x2,y2 是矩形的右下角的坐标。

type

String

描述形状的类型，并且可以是 circle、poly 或

rectangle。rectangle支持简写rect

Polyline 类

折线是地图上的连接线段的线性叠加层。[示例1][示例2][示例3][示例4]

构造函数

构造函数

说明

Polyline(

使用传递的 Point 数组或 LatLng 的 数组。

方法

方法

返回值

说明

getMap()

传回已附加此折线或多边形的地图。

getPath()

Array. | Array.

检索第一条路径,返回的坐标类型取决于创建时送入的path。

getBounds()

获取折线的边界(范围)。

setMap(map:Map)

None

在指定地图上渲染此折线或多边形。如果地图设置为 Null，则会删除此折线或多边形。

setOptions(

None

设置折线参数。

setPath(path:

Array.|

Array.)

None

setPaths(paths:

Array.>|

Array.>)

None

设置路径。支持多段不连接的折线。有关详细信息，请参见

setStyle(style:LineStyle)

None

设置样式，包括：笔触、终点箭头等。

setTitle(title:String)

None

设置名称，用于显示tip和Label。

focus()

None

如果在

blur()

None

取消高亮，还原折线默认的样式。

hide()

None

设置折线隐藏。

show()

None

使隐藏的折线显示。

事件

事件

参数

说明

click

对折线触发 DOM click 事件时会触发此事件。

dblclick

对折线触发 DOM dblclick 事件时会触发此事件。

mousedown

对折线触发 DOM mousedown 事件时会触发此事件。

mousemove

对折线触发 DOM mousemove 事件时会触发此事件。

mouseout

此事件针对折线 mouseout 触发。

mouseover

此事件针对折线 mouseover 触发。

mouseup

对折线触发 DOM mouseup 事件时会触发此事件。

rightclick

右键点击折线时会触发此事件。

PolylineOptions 对象规范

用于初始化Polyline对象。[示例]

属性

属性

类型

说明

id

String

折线的标识ID。

title

String

鼠标悬停时显示的Label文字；Label是否显示需要用label参数和disableLabel参数来控制。

label

设置鼠标悬停时显示的Label的样式。

disableLabel

boolean

设置是否在鼠标悬停时显示Label。

map

要在其上显示折线的地图。

path

Array.|

Array.

折线坐标的有序序列。可以使用一个 Point 数组或者 LatLng 的

数组 指定此路径。

paths

Array.>|

Array.>

如果一个折线对象由多个不连续的折线组成，可用此参数来设置。取值为一个二维 Point 数组或者 LatLng 的

数组。

strokeColor

String

采用 HTML 十六进制样式的笔触颜色，即"#FFAA00";优先级高于style参数。

strokeOpacity

Number

介于 0.0 和 1.0 之间的笔触不透明度;优先级高于style参数。

strokeWeight

Number

笔触宽度(以像素为单位);优先级高于style参数。

style

设置折线默认样式。

styles

设置折线默认样式，以及鼠标悬停时的样式。取值为一个LineStyle的数组，共2个数组元素，第1个元素为折线默认样式，第2个为鼠标悬停时的样式。

zIndex

Number

相对于其他折线的 zIndex。

feature

兼容1.0的FeatureNode对象创建。

isFixed

boolean

是否钉住，默认false。如果为true则不会被Map对象的clearAll方法清除；但setMap(null)忽略此属性，无论true还是false都删除。

Polygon 类

多边形(类似于折线)可在一个有序序列中定义一系列连接坐标；此外，多边形会形成一个闭合环并定义一个填充区域。

[示例1][示例2][示例3]

构造函数

构造函数

说明

Polygon(

使用传递的 Point 数组 或者 LatLng 数组组成。您可以在构造这些路径时传递一个 Point 数组 或者 LatLng 数组。

方法

方法

返回值

说明

getMap()

传回已附加此折线或多边形的地图。

getPath()

Array. | Array.

检索第一条路径,返回的坐标类型取决于创建时送入的path。

getBounds()

获取多边形面的边界(范围)。

setMap(map:Map)

None

在指定地图上渲染此折线或多边形。如果地图设置为 Null，则会删除此折线或多边形面。

setOptions(

None

设置多边形面参数。

setPath(path:

Array.|

Array.)

None

setPaths(paths:

Array.>|

Array.>)

None

设置路径。支持多个不连接的多边形面。有关详细信息，请参见

setStyle(style:RegionStyle)

None

设置样式，包括：笔触、填充颜色、终点箭头等。

focus()

None

如果在

blur()

None

取消高亮，还原多边形面默认的样式。

事件

事件

参数

说明

click

对多边形触发 DOM click 事件时会触发此事件。

dblclick

对多边形触发 DOM dblclick 事件时会触发此事件。

mousedown

对多边形触发 DOM mousedown 事件时会触发此事件。

mousemove

对多边形触发 DOM mousemove 事件时会触发此事件。

mouseout

此事件针对多边形 mouseout 触发。

mouseover

此事件针对多边形 mouseover 触发。

mouseup

对多边形触发 DOM mouseup 事件时会触发此事件。

rightclick

右键点击多边形时会触发此事件。

PolygonOptions 对象规范

用于初始化Polygon对象。[示例]

属性

属性

类型

说明

id

String

多边形的标识ID。

title

String

鼠标悬停时显示的Label文字；Label是否显示需要用label参数和disableLabel参数来控制。

label

设置鼠标悬停时显示的Label的样式。

disableLabel

boolean

设置是否在鼠标悬停时显示Label。

map

要在其上显示多边形的地图。

path

Array.|

Array.

多边形面坐标的有序序列。可以使用一个 Point 数组或者 LatLng 的

数组 指定此路径。

paths

Array.>|

Array.>

用于指定闭合环的坐标的有序序列。一个多边形面对象可以由多个不连接的多边形组成，类似应用于一个岛屿或者多个岛屿。因此，路径属性可以指定一个或多个 Point|LatLng 坐标数组。可以使用一个 Point|LatLng 数组定义简单的多边形。多个复杂的多边形可以指定一系列数组。

strokeColor

String

采用 HTML 十六进制样式的笔触颜色，即"#FFAA00";优先级高于style参数。

strokeOpacity

Number

介于 0.0 和 1.0 之间的笔触不透明度;优先级高于style参数。

strokeWeight

Number

笔触宽度(以像素为单位);优先级高于style参数。

fillColor

String

采用 HTML 十六进制样式的填充颜色，即"#00AAFF";优先级高于style参数。

fillOpacity

Number

介于 0.0 和 1.0 之间的填充不透明度;优先级高于style参数。

style

设置多边形默认样式。

styles

设置多边形默认样式，以及鼠标悬停时的样式。取值为一个RegionStyle的数组，共2个数组元素，第1个元素为多边形默认样式，第2个为鼠标悬停时的样式。

zIndex

Number

相对于其他多边形面的 zIndex。

feature

兼容1.0的FeatureNode对象创建。

isFixed

boolean

是否钉住，默认false。如果为true则不会被Map对象的clearAll方法清除；但setMap(null)忽略此属性，无论true还是false都删除。

Circle 类

用于创建圆形对象。需指定中心点和半径，自动绘制成一个圆形的区域，还可指定区域的填充颜色。[示例]

构造函数

构造函数

说明

Circle(

使用传递的

方法

方法

返回值

说明

getBounds()

获取此圆的 LatLngBounds。

getCenter()

传回此圆的中心。

getMap()

传回在其上显示此圆的地图。

getRadius()

Number

传回此圆的半径(以米为单位)。

setCenter(center:LatLng)

None

设置此圆的中心。

setMap(map:Map)

None

在指定地图上渲染此圆。如果地图设置为 Null，则会删除此圆。

setOptions(

None

setRadius(radius:Number)

None

设置此圆的半径(以米为单位)。

setStyle(style:RegionStyle)

None

设置样式，包括：笔触、填充颜色等。

focus()

None

如果在

blur()

None

取消高亮，还原圆形默认的样式。

事件

事件

参数

说明

click

对圆触发 DOM click 事件时会触发此事件。

dblclick

对圆触发 DOM dblclick 事件时会触发此事件。

mousedown

对圆触发 DOM mousedown 事件时会触发此事件。

mousemove

对圆触发 DOM mousemove 事件时会触发此事件。

mouseout

此事件针对圆 mouseout 触发。

mouseover

此事件针对圆 mouseover 触发。

mouseup

对圆触发 DOM mouseup 事件时会触发此事件。

rightclick

右键点击圆时会触发此事件。

CircleOptions 对象规范

用于初始化Circle对象。[示例]

属性

属性

类型

说明

id

String

圆形的标识ID。

title

String

鼠标悬停时显示的Label文字；Label是否显示需要用label参数和disableLabel参数来控制。

label

设置鼠标悬停时显示的Label的样式。

disableLabel

boolean

设置是否在鼠标悬停时显示Label。

map

要在其上显示圆的地图。

radius

Number

地球表面的半径(以米为单位)。

strokeColor

String

采用 HTML 十六进制样式的笔触颜色，即"#FFAA00";优先级高于style参数。

strokeOpacity

Number

介于 0.0 和 1.0 之间的笔触不透明度;优先级高于style参数。

strokeWeight

Number

笔触宽度(以像素为单位);优先级高于style参数。

fillColor

String

采用 HTML 十六进制样式的填充颜色，即"#00AAFF";优先级高于style参数。

fillOpacity

Number

介于 0.0 和 1.0 之间的填充不透明度;优先级高于style参数。

style

设置折线默认样式。

styles

设置于圆形默认样式，以及鼠标悬停时的样式。取值为一个RegionStyle的数组，共2个数组元素，第1个元素为圆形默认样式，第2个为鼠标悬停时的样式。

zIndex

Number

相对于其他圆形的 zIndex。

feature

兼容1.0的FeatureNode对象创建。

isFixed

boolean

是否钉住，默认false。如果为true则不会被Map对象的clearAll方法清除；但setMap(null)忽略此属性，无论true还是false都删除。

Rectangle 类

用于创建矩形叠加层。[示例]

构造函数

构造函数

说明

Rectangle(

使用传递的

方法

方法

返回值

说明

getBounds()

传回此矩形的范围。

getMap()

传回显示此矩形的地图。

setBounds(

None

设置此矩形的范围。

setMap(map:Map)

None

在指定地图上渲染此矩形。如果地图设置为 Null，则会删除此矩形。

setOptions(

None

设置初始化参数。

setStyle(style:RegionStyle)

None

设置样式，包括：笔触、填充颜色等。

focus()

None

如果在

blur()

None

取消高亮，还原矩形默认的样式。

事件

事件

参数

说明

click

对矩形触发 DOM click 事件时会触发此事件。

dblclick

对矩形触发 DOM dblclick 事件时会触发此事件。

mousedown

对矩形触发 DOM mousedown 事件时会触发此事件。

mousemove

对矩形触发 DOM mousemove 事件时会触发此事件。

mouseout

此事件针对矩形 mouseout 触发。

mouseover

此事件针对矩形 mouseover 触发。

mouseup

对矩形触发 DOM mouseup 事件时会触发此事件。

rightclick

右键点击矩形时会触发此事件。

RectangleOptions 对象规范

用于初始化Rectangle对象。[示例]

属性

属性

类型

说明

id

String

圆形的标识ID。

title

String

鼠标悬停时显示的Label文字；Label是否显示需要用label参数和disableLabel参数来控制。

label

设置鼠标悬停时显示的Label的样式。

disableLabel

boolean

设置是否在鼠标悬停时显示Label。

map

要在其上显示矩形的地图。

strokeColor

String

采用 HTML 十六进制样式的笔触颜色，即"#FFAA00";优先级高于style参数。

strokeOpacity

Number

介于 0.0 和 1.0 之间的笔触不透明度;优先级高于style参数。

strokeWeight

Number

笔触宽度(以像素为单位);优先级高于style参数。

fillColor

String

采用 HTML 十六进制样式的填充颜色，即"#00AAFF";优先级高于style参数。

fillOpacity

Number

介于 0.0 和 1.0 之间的填充不透明度;优先级高于style参数。

style

设置折线默认样式。

styles

设置矩形默认样式，以及鼠标悬停时的样式。取值为一个RegionStyle的数组，共2个数组元素，第1个元素为矩形默认样式，第2个为鼠标悬停时的样式。

zIndex

Number

相对于其他矩形的 zIndex。

feature

兼容1.0的FeatureNode对象创建。

isFixed

boolean

是否钉住，默认false。如果为true则不会被Map对象的clearAll方法清除；但setMap(null)忽略此属性，无论true还是false都删除。

InfoWindow 类

用于创建信息窗，通常会连接到某个标记。[示例1][示例2][示例3]

构造函数

构造函数

说明

InfoWindow(

创建带有指定选项的信息窗口。信息窗口可以放置在地图的特定位置，也可以位于标记上方，具体取决于选项中指定的内容。除非停用自动平移，否则，信息窗口会在打开后平移地图，以便让自己显示出来。信息窗口构建完成后，您需要调用

open 函数，才能在地图上显示该窗口。用户可以点击信息窗口上的关闭按钮将其从地图中关闭，开发人员也可以调用 close() 函数实现同样的效果。

方法

方法

返回值

说明

close()

None

关闭此信息窗口。

getContent()

String|Node

获取信息窗显示区的内容。

getMarker()

获取信息窗口当前连接的Marker对象，如果open时未指定Marker则返回null。

getPosition()

获取信息窗口当前的坐标位置。

getZIndex()

Number

获取叠加顺序。

remove()

None

删除信息窗。close方法只是隐藏信息窗，而此方法将移除信息窗的DOM对象，一旦移除，信息窗将不能再用open方法打开。

open(map:Map,

anchor:Marker)

None

在指定的地图上打开这个信息窗口。信息窗口可以与锚点相关联，但这属于可选操作。在API 中，目前唯一的锚点是 Marker

类。建议一个地图只创建一个信息窗对象，一个信息窗可以通过open方法连接到不同的Marker对象。

setContent(content:String|Node)

None

设置信息窗中显示的内容。信息窗的内容区根据显示的内容大小自动调整适合的大小。建议使用Node类型，如：DIV 元素，将显示的内容都放在该DIV中，设置DIV元素的宽和高。

setOptions(

None

设置初始化的参数。

setPosition(

None

设置信息窗的位置，支持两种坐标。

setSize(width:Number,height:Number)

None

设置信息窗的宽和高。

setTitle(title:String)

None

设置信息窗的标题文字。

setZIndex(zIndex:Number)

None

设置叠加顺序。

setDisableMapClickClose(disableMapClickClose:boolean)

None

设置是否当点击地图空白地方时关闭信息窗。[示例]

事件

事件

参数

说明

closeclick

None

点击关闭按钮时会触发此事件。

close

None

任何情况下关闭窗口会触发此事件。

content_changed

None

内容属性更改时会触发此事件。

domready

None

当包含 InfoWindow 的内容的