Ajax api（flash地图展现）用户手册—企业版—v2.3.4

MapABC 地图应用程序编程接口-用户手册

北京图盟科技有限公司

MapABC 地图应用程序编程接口

用户手册

文件状态：

[ ] 草稿

[√] 正式发布

[ ] 正在修改

文件标识： MapABC-Map API-UM

当前版本： Ajax API（Flash 地图展现）2.3.4 企业版

作者：

创建日期：

最后更新：

密级：秘密

版权说明：版权© 2010 归北京图盟科技有限公司所有



版版本本管管理理

【修改记录】

版本/状态作者起止日期备注

【审阅】

版本/状态审阅时间审阅人职务备注



说明本文档是 Ajax API（Flash 地图展现）的用户使用手册，具体来讲，是 Mapabc 向广大

公众用户提供的地图和搜索调用接口方法的操作指南。Ajax API（Flash 地图展现）包括地

图 API 和搜索 API。地图 API 采用 Flash 地图展现，向用户提供 JavaScript 地图接口，能够

让用户在 HTML 页面中构建自己的 Flash 地图应用；搜索 API 向用户提供 JavaScript 的数据

检索计算接口，所有查询结果都可以展现在 Flash 地图中。

地图 API 中定义了若干个对象类。其中，地图类 MMap 是 API 的核心部分，它封装了

地图 flash 组件，通过创建该对象并使用该对象的方法可以实现地图的一些基本操作，与此

类性质类似的还有 MMapTool 类、MMenuItem 类、MTileLayer 类、MOverlay 对象类及其子

类 MLabel、MGroundImage、MMarker、MPolyline、MArea(包括其子类 MCircle、MRectangle、

MPolygon)等。MClusterOptions 类、MassOverlayOptions 类、MWMSLayerOptions 类、

MTileLayerOptions 类、MLabelOptions 类、MGroundImageOptions、MTipOptions 类、

MMapOptions 类、MMarkerOptions 类、MAreaOptions 类及 MLineOptions 类是针对不同对象

构建的参数选项对象，通过设置参数选项对象的属性值完成针对不同对象的选项参数的设置；

MFontStyle 类、MLineStyle 类、MFillStyle 类及 MAreaStyle 类分别完成对字体样式、线样式、

填充样式及面样式的设置；MLngLat 类、MLngLats 类、MPoint 类、MPixelBounds 类、

MLngLatBounds 类及 MSize 类则是用来创建位置或边界对象；事件类 MEvent 主要是指执行

不同的事件时调用相应对象的函数操作。

搜索 API 中定义了若干个对象类，即 MLocalSearch 类、MLocalSearchOptions 类、

MRoutSearch 类及 MRoutSearchOptions 类。MLocalSearch 类封装了本地搜索功能，包括关

键字查询和周边查询。MLocalSearchOptions 类是 MLocalSearch 查询方法的可选参数。

MRoutSearch 封装了路径查询功能,包括公交查询和驾车查询。通过创建一个 MRoutSearch

对象并调用公交驾车的相应方法就可以实现路径查询功能。MRoutSearchOptions 类是

MRoutSearch 类的选项参数类。

用户在阅读下面的文档时，可以通过各个相似功能对象的对比加深对 API 类方法、属

性、用途的理解，从而更好地应用 API 类服务于自己的领域。



目录

MapABC 地图应用程序编程接口 ...................................................................................................... 1

用户手册 ................................................................................................................................................. 1

地图 API: ......................................................................................................................................27

命名空间：com.mapabc.maps.api ......................................................................................................27

1 全局常量 .......................................................................................................................................27

1.1. 说明...............................................................................................................................27

1.2. 常量...............................................................................................................................27

地图类型 ..............................................................................................................................27

1.2.1 MAP_EN ..............................................................................................................27

1.2.2 MAP_CN ..............................................................................................................27

地图控件名称 ......................................................................................................................27

1.2.3 OVERVIEW_CTRL ............................................................................................27

1.2.4 TOOLBAR_CTRL ..............................................................................................28

1.2.5 SCALE_CTRL .....................................................................................................28

工具条样式 ..........................................................................................................................28

1.2.6 DEFAULT ............................................................................................................28

1.2.7 ROUND ................................................................................................................28

1.2.8 BLACK ................................................................................................................28

1.2.9 SMALL ................................................................................................................28

1.2.10 MINI .....................................................................................................................29

地图控件状态 ......................................................................................................................29

1.2.11 MINIMIZE ...........................................................................................................29

1.2.12 SHOW ..................................................................................................................29

1.2.13 HIDE.....................................................................................................................29

鼠标工具 ..............................................................................................................................29

1.2.14 PAN_WHEELZOOM ..........................................................................................29

1.2.15 ADD_MARKER..................................................................................................30

1.2.16 DRAW_LINE.......................................................................................................30

1.2.17 DRAW_POLYGON.............................................................................................30

1.2.18 DRAW_RECTANGLE ........................................................................................30

1.2.19 DRAW_CIRCLE .................................................................................................30

1.2.20 RULER .................................................................................................................30

1.2.21 COMPUTE_AREA .............................................................................................31

1.2.22 FRAME_ZOOMIN .............................................................................................31

1.2.23 FRAME_ZOOMOUT .........................................................................................31

事件类型 ..............................................................................................................................31

1.2.24 MAP_READY .....................................................................................................31

1.2.25 TIP_OPEN ...........................................................................................................31

1.2.26 TIP_CLOSE .........................................................................................................32

1.2.27 TIP_BEFORE_CLOSE .......................................................................................32

1.2.28 ADD_OVERLAY ................................................................................................32

1.2.29 REMOVE_OVERLAY .......................................................................................32



1.2.30 CLEAR_OVERLAYS .........................................................................................32

1.2.31 MOUSE_CLICK .................................................................................................32

1.2.32 MOUSE_DBCLICK............................................................................................33

1.2.33 MOUSE_DOWN .................................................................................................33

1.2.34 MOUSE_UP.........................................................................................................33

1.2.35 MOUSE_MOVING .............................................................................................33

1.2.36 MOUSE_OVER...................................................................................................33

1.2.37 MOUSE_OUT .....................................................................................................33

1.2.38 DRAG_START ....................................................................................................34

1.2.39 DRAGGING ........................................................................................................34

1.2.40 DRAG_END ........................................................................................................34

1.2.41 MAP_MOVE_START ........................................................................................34

1.2.42 MAP_MOVING ..................................................................................................34

1.2.43 MAP_MOVE_END.............................................................................................34

1.2.44 ZOOM_START....................................................................................................35

1.2.45 ZOOM_END ........................................................................................................35

1.2.46 ZOOM_CHANGED ............................................................................................35

1.2.47 ROLL_BACK ......................................................................................................35

1.2.48 MEASURE_STEP ...............................................................................................35

1.2.49 MEASURE_END ................................................................................................35

1.2.50 COMPUTE_AREA_END...................................................................................36

1.2.51 MENUITEM_CLICK..........................................................................................36

1.2.52 GPS_MOVEALONG_COMPLETE ..................................................................36

1.2.53 ADD_TILELAYER .............................................................................................36

1.2.54 TILE_MOUSE_OVER .......................................................................................36

1.2.55 OVERVIEWMAP_CHANGE ............................................................................36

1.2.56 RADAR_INITIALIZED .....................................................................................37

1.2.57 RADAR_POSITION_CHANGED ....................................................................37

1.2.58 RADAR_ROTATION_CHANGED ...................................................................37

切片图层 ..............................................................................................................................37

1.2.59 TL_TRAFFIC ......................................................................................................37

1.2.60 TL_USERMAP ....................................................................................................37

1.2.61 TL_SATELLITE ..................................................................................................37

1.2.62 TL_MASS_TRANSIT ........................................................................................38

1.2.63 TL_REAL_ESTATE ............................................................................................38

1.2.64 TL_CUSTOM_MAP ...........................................................................................38

信息窗体 ..............................................................................................................................38

1.2.65 FLASH_BUBBLE_TIP.......................................................................................38

1.2.66 HTML_BUBBLE_TIP ........................................................................................38

1.2.67 HTML_CUSTOM_TIP .......................................................................................39

1.2.68 IMG_BUBBLE_TIP............................................................................................39

线体类型 ..............................................................................................................................39

1.2.69 LINE_SOLID .......................................................................................................39

1.2.70 LINE_DASHED ..................................................................................................39



坐标类型 ..............................................................................................................................39

1.2.71 COORD_TYPE_ENCODE.................................................................................39

1.2.72 COORD_TYPE_OFFSET ..................................................................................40

焦点模式 ..............................................................................................................................40

1.2.73 NOFOCUS ...........................................................................................................40

1.2.74 FOCUS .................................................................................................................40

1.2.75 CENTER_FOCUS ...............................................................................................40

方向名称 ..............................................................................................................................40

1.2.76 EAST ....................................................................................................................40

1.2.77 WEST ...................................................................................................................41

1.2.78 SOUTH .................................................................................................................41

1.2.79 NORTH ................................................................................................................41

位置名称 ..............................................................................................................................41

1.2.80 TOP_LEFT ...........................................................................................................41

1.2.81 TOP_CENTER ....................................................................................................41

1.2.82 TOP_RIGHT ........................................................................................................41

1.2.83 MIDDLE_LEFT ..................................................................................................42

1.2.84 MIDDLE_CENTER ............................................................................................42

1.2.85 MIDDLE_RIGHT................................................................................................42

1.2.86 BOTTOM_LEFT .................................................................................................42

1.2.87 BOTTOM_CENTER ...........................................................................................42

1.2.88 BOTTOM_RIGHT ..............................................................................................42

弹跳效果定位方式 ..............................................................................................................43

1.2.89 BOUNCE_CROSS ..............................................................................................43

1.2.90 BOUNCE_CIRCLE.............................................................................................43

2 MMap ............................................................................................................................................43

2.1 说明...............................................................................................................................43

2.2 命名空间 ......................................................................................................................43

2.3 构造方法 ......................................................................................................................43

2.3.1 MMap(container,mapOption) .............................................................................43

2.4 方法...............................................................................................................................44

获取地图状态 ......................................................................................................................44

2.4.1 getCenter()............................................................................................................44

2.4.2 getZoomLevel() ...................................................................................................45

2.4.3 getSize()................................................................................................................45

2.4.4 getScale() ..............................................................................................................45

2.4.5 getPixelBounds() .................................................................................................46

2.4.6 getLngLatBounds() ..............................................................................................46

2.4.7 getLngLatByOffset(originalLngLat,WEOffset,SNOffset, radius) ...................47

2.4.8 isContinuousZoom() ............................................................................................47

2.4.9 getMapTilesId() ...................................................................................................48

2.4.10 getDragEnabled() .................................................................................................48

2.4.11 getZoomEnabled() ...............................................................................................48

2.4.12 getKeyboardEnabled().........................................................................................49



修改地图状态 ......................................................................................................................49

2.4.13 setCenter(center) ..................................................................................................49

2.4.14 setZoomLevel(zoomLevel) .................................................................................50

2.4.15 setZoomAndCenter(zoom,center) ......................................................................50

2.4.16 setContinuousZoom(isContinuous) ....................................................................51

2.4.17 setMapColor(color) .............................................................................................51

2.4.18 setDragEnabled(dragEnabled) ............................................................................52

2.4.19 setZoomEnabled(zoomEnabled) .........................................................................52

2.4.20 setLngLatBounds(bounds) ..................................................................................53

2.4.21 zoomIn(lnglat)......................................................................................................53

2.4.22 zoomOut(lnglat) ...................................................................................................54

2.4.23 panDirection(dx,dy) .............................................................................................54

2.4.24 panTo(center) .......................................................................................................55

2.4.25 panBy(position,speed) .........................................................................................55

2.4.26 setCtrlPanelState (ctrlName,state) ......................................................................56

2.4.27 setOverviewState(state) .......................................................................................56

2.4.28 loadCtrlPanel(ctrlName,opt) ...............................................................................57

2.4.29 setKeyboardEnabled(enabled) ............................................................................58

2.4.30 savePosition() .......................................................................................................58

2.4.31 returnToSavedPosition() ......................................................................................58

2.4.32 clearMap(clearType) ............................................................................................59

添加覆盖物 ..........................................................................................................................59

2.4.33 addOverlay(overlay,isToFitView).......................................................................59

2.4.34 addOverlays(overlays,azc) ..................................................................................61

2.4.35

createLightMarker(x,y,id,imageUrl,picAgent,alpha,isDimorphic,dimorphicCol

or) 61

2.4.36 updateOverlay(overlay) .......................................................................................62

2.4.37 setOverlayEditableById(overlayId,isEditable) ..................................................63

2.4.38 setOverlayToTopById(overlayId) .......................................................................64

2.4.39 setOverlayVisibleById(overlayId,isVisible) ......................................................64

2.4.40 setOverlayDimorphicById(overlayId,dimorphic) .............................................65

2.4.41 setFitview(overlays) ............................................................................................65

2.4.42 setClusterState(state,clusterOption) ...................................................................66

2.4.43 getOverlayById(overlayId) .................................................................................66

2.4.44 getOverlaysByType(type) ...................................................................................67

2.4.45 expOverlay(overlayId) ........................................................................................68

2.4.46 removeOverlaysByType(type) ............................................................................69

2.4.47 removeOverlay(overlay) .....................................................................................69

2.4.48 removeOverlays(overlays) ..................................................................................69

2.4.49 removeOverlayById(overlayId)..........................................................................70

2.4.50 removeAllOverlays() ...........................................................................................70

2.4.51 setDefaultMarkerOption(option) ........................................................................71

2.4.52 setDefaultLineOption(option) .............................................................................72



2.4.53 setDefaultAreaOption(option) ............................................................................73

叠加层 74

2.4.54 addWMSLayer(options) ......................................................................................74

2.4.55 addTileLayer(tileLayer) ......................................................................................74

2.4.56 addDataLayer(dataLayer)....................................................................................75

2.4.57 addGradientMapLayer(options)..........................................................................75

2.4.58 updateGradientMapLayer(options) ....................................................................76

2.4.59 removeWMSLayer()............................................................................................77

2.4.60 removeTileLayer(layerType,tileLayerId) ...........................................................77

2.4.61 removeDataLayer(layerType,dataLayerId) ........................................................78

2.4.62 removeGradientMapLayer() ...............................................................................78

右键菜单 ..............................................................................................................................79

2.4.63 addMenuItems(arr) ..............................................................................................79

2.4.64 removeMenuItem (menuItemId).........................................................................79

信息窗口 ..............................................................................................................................80

2.4.65 openTip(position, tipOptions) .............................................................................80

2.4.66 openOverlayTip(overlayId) .................................................................................80

2.4.67 closeTip()..............................................................................................................81

鼠标工具 ..............................................................................................................................81

2.4.68 setCurrentMouseTool(ctrlName, option) ...........................................................81

GSP 行业应用 ......................................................................................................................83

2.4.69 markerMoveAlong(markerId,lnglatArr,speed) ..................................................83

2.4.70 startMoveAlong(markerId,isLoop).....................................................................84

2.4.71 pauseMoveAlong(markerId) ...............................................................................84

2.4.72 stopMoveAlong(markerId) .................................................................................85

2.4.73 setGPSFocus(focusType,markerIds) ..................................................................85

2.4.74 markerMoveTo(markerId,lnglat,rotation,speed) ................................................86

注册（反注册）事件 ..........................................................................................................87

2.4.75 addEventListener(object,eventType,functionname) ..........................................87

2.4.76 removeEventListener(object,eventType,functionName)...................................88

2.4.77 removeClosuresListeners() .................................................................................89

地图工具 ..............................................................................................................................90

2.4.78 calculateDistance(IIs) ..........................................................................................90

2.4.79 fromLngLatToContainerPixel(lnglat).................................................................90

2.4.80 fromContainerPixelToLngLat(containerPt) .......................................................91

2.4.81 saveMap2JPG() ....................................................................................................91

2.4.82 printMap() ............................................................................................................91

3 MMapOptions() ............................................................................................................................92

3.1 说明...............................................................................................................................92

3.2 命名空间 ......................................................................................................................92

3.3 构造方法 ......................................................................................................................92

3.3.1 MMapOptions() ...................................................................................................92

3.4 属性...............................................................................................................................92

3.4.1 zoom .....................................................................................................................92



3.4.2 center ....................................................................................................................93

3.4.3 toolbarUrl .............................................................................................................93

3.4.4 toolbar ...................................................................................................................93

3.4.5 toolbarPos .............................................................................................................94

3.4.6 overviewMap .......................................................................................................94

3.4.7 scale ......................................................................................................................94

3.4.8 isCongruence ........................................................................................................95

3.4.9 returnCoordType ..................................................................................................95

3.4.10 hasDefaultMenu ...................................................................................................95

3.4.11 OVZoomLevels ...................................................................................................95

3.4.12 language................................................................................................................96

3.4.13 fullScreenButton ..................................................................................................96

3.4.14 centerCross ...........................................................................................................96

3.4.15 minZoomLevel .....................................................................................................97

3.4.16 maxZoomLevel ....................................................................................................97

3.4.17 totalLevel ..............................................................................................................97

3.4.18 viewBounds ..........................................................................................................98

3.4.19 logoUrl..................................................................................................................98

3.4.20 groundLogo ..........................................................................................................98

3.4.21 mapComButton ....................................................................................................98

3.4.22 requestNum ..........................................................................................................99

3.5 方法...............................................................................................................................99

3.6 示例...............................................................................................................................99

4 MMenuItem() ..............................................................................................................................100

4.1 说明.............................................................................................................................100

4.2 命名空间 ....................................................................................................................100

4.3 构造方法 ....................................................................................................................100

4.3.1 MMenuItem() .....................................................................................................100

4.4 属性.............................................................................................................................100

4.4.1 menuType ...........................................................................................................100

4.4.2 objectType ..........................................................................................................101

4.4.3 overlayId.............................................................................................................101

4.4.4 order ....................................................................................................................101

4.4.5 menuText ............................................................................................................101

4.4.6 functionName .....................................................................................................102

4.4.7 isEnabled ............................................................................................................102

4.4.8 isHaveSeparator .................................................................................................102

4.4.9 id .........................................................................................................................102

命名空间：com.mapabc.maps.api.overlays .....................................................................................103

5 MOverlay() ..................................................................................................................................103

5.1 说明.............................................................................................................................103

5.2 命名空间 ....................................................................................................................103

5.3 构造方法 ....................................................................................................................104

5.3.1 MOverlay(id) .....................................................................................................104



5.4 属性.............................................................................................................................104

5.4.1 id .........................................................................................................................104

5.4.2 TYPE ..................................................................................................................104

5.5 常量.............................................................................................................................105

5.5.1 TYPE_MARKER ..............................................................................................105

5.5.2 TYPE_RADAR .................................................................................................105

5.5.3 TYPE_LABEL ...................................................................................................105

5.5.4 TYPE_GROUNDIMAGE.................................................................................105

5.5.5 TYPE_POLYLINE ............................................................................................105

5.5.6 TYPE_POLYGON.............................................................................................106

5.5.7 TYPE_CIRCLE .................................................................................................106

5.5.8 TYPE_RECTANGLE ........................................................................................106

5.5.9 TYPE_AREA .....................................................................................................106

6 MMarker() ...................................................................................................................................106

6.1 说明.............................................................................................................................106

6.2 命名空间 ....................................................................................................................107

6.3 继承.............................................................................................................................107

6.4 构造方法 ....................................................................................................................107

6.4.1 MMarker(lnglat,option) .....................................................................................107

6.5 属性.............................................................................................................................107

6.5.1 id .........................................................................................................................107

6.5.2 TYPE ..................................................................................................................108

6.5.3 lnglat ...................................................................................................................108

6.5.4 option ..................................................................................................................108

6.5.5 size ......................................................................................................................108

7 MRadar () ....................................................................................................................................109

7.1 说明.............................................................................................................................109

7.2 命名空间 ....................................................................................................................109

7.3 继承.............................................................................................................................109

7.4 构造方法 ....................................................................................................................109

7.4.1 MRadar(lnglat,option) .......................................................................................109

8 MLabel()......................................................................................................................................110

8.1 说明.............................................................................................................................110

8.2 命名空间 ....................................................................................................................110

8.3 继承.............................................................................................................................110

8.4 构造方法 ....................................................................................................................110

8.4.1 MLabel(lnglat,option) .......................................................................................110

8.5 属性.............................................................................................................................111

8.5.1 id .........................................................................................................................111

8.5.2 TYPE ..................................................................................................................111

8.5.3 lnglat ...................................................................................................................111

8.5.4 option ..................................................................................................................112

9 MPolyline() .................................................................................................................................112

9.1 说明.............................................................................................................................112



9.2 命名空间 ....................................................................................................................112

9.3 继承.............................................................................................................................112

9.4 构造方法 ....................................................................................................................112

9.4.1 MPolyline(lnglatArr,option) .............................................................................112

9.5 属性.............................................................................................................................113

9.5.1 id .........................................................................................................................113

9.5.2 TYPE ..................................................................................................................113

9.5.3 lnglatArr .............................................................................................................113

9.5.4 option ..................................................................................................................114

10 MArea() .......................................................................................................................................114

10.1 说明.............................................................................................................................114

10.2 命名空间 ....................................................................................................................114

10.3 继承.............................................................................................................................114

10.4 构造方法 ....................................................................................................................115

10.4.1 MArea(lnglatArr, option) ..................................................................................115

10.5 属性.............................................................................................................................115

10.5.1 TYPE ..................................................................................................................115

11 MRectangle() ..............................................................................................................................115

11.1 说明.............................................................................................................................115

11.2 命名空间 ....................................................................................................................115

11.3 继承.............................................................................................................................116

11.4 构造方法 ....................................................................................................................116

11.4.1 MRectangle(lnglatArr, option)..........................................................................116

11.5 属性.............................................................................................................................117

11.5.1 id .........................................................................................................................117

11.5.2 TYPE ..................................................................................................................117

11.5.3 lnglatArr .............................................................................................................117

11.5.4 option ..................................................................................................................117

12 MCircle() .....................................................................................................................................118

12.1 说明.............................................................................................................................118

12.2 命名空间 ....................................................................................................................118

12.3 继承.............................................................................................................................118

12.4 构造方法 ....................................................................................................................118

12.4.1 MCircle(lnglat, radius, option) .........................................................................118

12.5 属性.............................................................................................................................119

12.5.1 id .........................................................................................................................119

12.5.2 TYPE ..................................................................................................................119

12.5.3 center ..................................................................................................................120

12.5.4 radius ..................................................................................................................120

12.5.5 option ..................................................................................................................120

12.5.6 bounds.................................................................................................................120

13 MPolygon() .................................................................................................................................121

13.1 说明.............................................................................................................................121

13.2 命名空间 ....................................................................................................................121



13.3 继承.............................................................................................................................121

13.4 构造方法 ....................................................................................................................121

13.4.1 MPolygon(lnglatArr, option) ............................................................................121

13.5 属性.............................................................................................................................122

13.5.1 id .........................................................................................................................122

13.5.2 TYPE ..................................................................................................................122

13.5.3 lnglatArr .............................................................................................................123

13.5.4 option ..................................................................................................................123

14 MGroundImage() ........................................................................................................................123

14.1 说明.............................................................................................................................123

14.2 命名空间 ....................................................................................................................123

14.3 继承.............................................................................................................................123

14.4 构造方法 ....................................................................................................................124

14.4.1 MGroundImage(lnglat,option) ..........................................................................124

14.5 属性.............................................................................................................................124

14.5.1 id .........................................................................................................................124

14.5.2 TYPE ..................................................................................................................124

14.5.3 lnglat ...................................................................................................................125

14.5.4 option ..................................................................................................................125

14.5.5 size ......................................................................................................................125

14.5.6 bounds.................................................................................................................125

命名空间：com.mapabc.maps.api.overlays.options .......................................................................126

15 MMarkerOptions()......................................................................................................................126

15.1 说明.............................................................................................................................126

15.2 命名空间 ....................................................................................................................126

15.3 构造方法 ....................................................................................................................126

15.3.1 MMarkerOptions().............................................................................................126

15.4 属性.............................................................................................................................126

15.4.1 imageUrl .............................................................................................................126

15.4.2 anchor .................................................................................................................127

15.4.3 imageAlign .........................................................................................................127

15.4.4 labelPosition .......................................................................................................128

15.4.5 labelAlign ...........................................................................................................128

15.4.6 labelOption .........................................................................................................128

15.4.7 isBounce .............................................................................................................128

15.4.8 bounceLocation ..................................................................................................129

15.4.9 tipOption.............................................................................................................129

15.4.10 canShowTip ........................................................................................................129

15.4.11 rotation................................................................................................................130

15.4.12 isEditable ............................................................................................................130

15.4.13 hasShadow..........................................................................................................130

15.4.14 picAgent .............................................................................................................130

15.4.15 zoomLevels ........................................................................................................131

15.4.16 isDimorphic ........................................................................................................131



15.4.17 dimorphicColor ..................................................................................................131

15.4.18 attributeValue .....................................................................................................131

16 MRadarOptions() ........................................................................................................................133

16.1 说明.............................................................................................................................133

16.2 命名空间 ....................................................................................................................133

16.3 构造方法 ....................................................................................................................133

16.3.1 MRadarOptions() ...............................................................................................133

16.4 属性.............................................................................................................................134

16.4.1 rotation................................................................................................................134

16.4.2 color ....................................................................................................................134

16.4.3 radius ..................................................................................................................134

16.4.4 fovea ...................................................................................................................134

16.4.5 isClosed ..............................................................................................................135

16.4.6 visible .................................................................................................................135

17 MLabelOptions() ........................................................................................................................136

17.1 说明.............................................................................................................................136

17.2 命名空间 ....................................................................................................................136

17.3 构造方法 ....................................................................................................................136

17.3.1 MLabelOptions() ...............................................................................................136

17.4 属性.............................................................................................................................136

17.4.1 fontStyle .............................................................................................................136

17.4.2 alpha....................................................................................................................136

17.4.3 hasBackground ...................................................................................................137

17.4.4 hasBorder ...........................................................................................................137

17.4.5 backgroundColor ...............................................................................................137

17.4.6 borderColor ........................................................................................................138

17.4.7 content ................................................................................................................138

17.4.8 zoomLevels ........................................................................................................138

18 MTipOptions() ............................................................................................................................139

18.1 说明.............................................................................................................................139

18.2 命名空间 ....................................................................................................................139

18.3 构造方法 ....................................................................................................................139

18.3.1 MTipOptions() ...................................................................................................139

18.4 属性.............................................................................................................................140

所有信息窗口共有属性 ...................................................................................................140

18.4.1 tipType ................................................................................................................140

18.4.2 content ................................................................................................................140

各种类型信息窗私有属性 ...............................................................................................140

18.4.3 title ......................................................................................................................140

18.4.4 hasShadow..........................................................................................................141

18.4.5 roundRectSize ....................................................................................................141

18.4.6 borderStyle .........................................................................................................141

18.4.7 titleFontStyle ......................................................................................................141

18.4.8 contentFontStyle ................................................................................................142



18.4.9 fillStyle ...............................................................................................................142

18.4.10 titleFillStyle ........................................................................................................142

18.4.11 tipHeight .............................................................................................................142

18.4.12 tipWidth ..............................................................................................................143

18.4.13 tipAlign ...............................................................................................................143

18.4.14 offset ...................................................................................................................143

19 MCorrectionTipOptions() ..........................................................................................................145

19.1 说明.............................................................................................................................145

19.2 命名空间 ....................................................................................................................145

19.3 构造方法 ....................................................................................................................145

19.3.1 MCorrectionTipOptions() .................................................................................145

19.4 属性.............................................................................................................................146

19.4.1 titleName ............................................................................................................146

19.4.2 address ................................................................................................................146

19.4.3 telephone ............................................................................................................146

19.4.4 details ..................................................................................................................146

19.4.5 imgUrl.................................................................................................................147

20 MLineOptions() ..........................................................................................................................147

20.1 说明.............................................................................................................................147

20.2 命名空间 ....................................................................................................................147

20.3 构造方法 ....................................................................................................................147

20.3.1 MLineOptions() .................................................................................................147

20.4 属性.............................................................................................................................148

20.4.1 lineStyle ..............................................................................................................148

20.4.2 tipOption.............................................................................................................148

20.4.3 canShowTip ........................................................................................................148

20.4.4 isEditable ............................................................................................................148

20.4.5 zoomLevels ........................................................................................................149

20.4.6 isDimorphic ........................................................................................................149

20.4.7 dimorphicColor ..................................................................................................149

21 MAreaOptions() ..........................................................................................................................151

21.1 说明.............................................................................................................................151

21.2 命名空间 ....................................................................................................................151

21.3 构造方法 ....................................................................................................................151

21.3.1 MAreaOptions() .................................................................................................151

21.4 属性.............................................................................................................................152

21.4.1 areaStyle .............................................................................................................152

21.4.2 tipOption.............................................................................................................152

21.4.3 canShowTip ........................................................................................................152

21.4.4 isEditable ............................................................................................................153

21.4.5 zoomLevels ........................................................................................................153

21.4.6 labelOption .........................................................................................................155

21.4.7 labelPosition .......................................................................................................155

21.4.8 isDimorphic ........................................................................................................155



21.4.9 dimorphicColor ..................................................................................................156

22 MGroundImageOptions() ...........................................................................................................157

22.1 说明.............................................................................................................................157

22.2 命名空间 ....................................................................................................................157

22.3 构造方法 ....................................................................................................................157

22.3.1 MGroundImageOptions() ..................................................................................157

22.4 属性.............................................................................................................................157

22.4.1 imageUrl .............................................................................................................157

22.4.2 picAgent .............................................................................................................158

22.4.3 originalLevel ......................................................................................................158

22.4.4 zoomLevels ........................................................................................................159

22.4.5 imageAlign .........................................................................................................159

23 MClusterOptions() ......................................................................................................................160

23.1 说明.............................................................................................................................160

23.2 命名空间 ....................................................................................................................160

23.3 构造方法 ....................................................................................................................160

23.3.1 MClusterOptions() .............................................................................................160

23.4 属性.............................................................................................................................160

所有类型点聚合通用属性 ...............................................................................................160

23.4.1 gridSize ...............................................................................................................160

23.4.2 maxZoom ...........................................................................................................161

23.4.3 attributeValue .....................................................................................................161

23.4.4 fontStyle .............................................................................................................161

绽放类型点聚合专用属性 ...............................................................................................161

23.4.5 centerMarkerURL ..............................................................................................161

23.4.6 aroundMarkerURL ............................................................................................162

23.4.7 flareDistance ......................................................................................................162

23.4.8 isUseMarkerIcon ................................................................................................162

23.5 常量.............................................................................................................................163

23.5.1 NORMAL_CLUSTER ......................................................................................163

23.5.2 FLARE_CLUSTER ...........................................................................................163

23.5.3 NO_CLUSTER ..................................................................................................163

23.5.4 TOTAL_NUMBER ...........................................................................................163

23.5.5 TOTAL_SUM ....................................................................................................164

命名空间：com.mapabc.maps.api.layers .........................................................................................164

24 MTileLayer () ..............................................................................................................................164

24.1 说明.............................................................................................................................164

24.2 命名空间 ....................................................................................................................164

24.3 构造方法 ....................................................................................................................164

24.3.1 MTileLayer (layerType,option) ........................................................................164

25 MDataLayer()..............................................................................................................................165

25.1 说明.............................................................................................................................165

25.2 命名空间 ....................................................................................................................165

25.3 构造方法 ....................................................................................................................165



25.3.1 MDataLayer(layerType,option) ........................................................................165

命名空间：com.mapabc.maps.api.layers.options............................................................................166

26 MTileLayerOptions()..................................................................................................................166

26.1 说明.............................................................................................................................166

26.2 命名空间 ....................................................................................................................166

26.3 构造方法 ....................................................................................................................166

26.3.1 MTileLayerOptions().........................................................................................166

26.4 属性.............................................................................................................................166

26.4.1 tileUrl ..................................................................................................................166

26.4.2 userId ..................................................................................................................167

26.4.3 tempId .................................................................................................................167

26.4.4 layerId .................................................................................................................167

26.4.5 alpha....................................................................................................................167

27 MDataLayerOptions() ................................................................................................................168

27.1 说明.............................................................................................................................168

27.2 命名空间 ....................................................................................................................168

27.3 构造方法 ....................................................................................................................168

27.3.1 MDataLayerOptions() .......................................................................................168

27.4 属性.............................................................................................................................168

27.4.1 layerId .................................................................................................................168

27.4.2 url ........................................................................................................................169

28 MGradientMapOptions() ............................................................................................................169

28.1 说明.............................................................................................................................169

28.2 命名空间 ....................................................................................................................169

28.3 构造方法 ....................................................................................................................169

28.3.1 MGradientMapOptions() ...................................................................................169

28.4 属性.............................................................................................................................170

28.4.1 pointsXMLString ...............................................................................................170

28.4.2 pointsXMLURL .................................................................................................170

28.4.3 radiusRatio .........................................................................................................170

28.4.4 maxRadius ..........................................................................................................170

28.4.5 minRadius...........................................................................................................171

28.4.6 maxValue ............................................................................................................171

28.4.7 colors ..................................................................................................................171

28.4.8 alpha....................................................................................................................171

29 MWMSLayerOptions() ..............................................................................................................172

29.1 说明.............................................................................................................................172

29.2 命名空间 ....................................................................................................................172

29.3 构造方法 ....................................................................................................................172

29.3.1 MWMSLayerOptions() .....................................................................................172

29.4 属性.............................................................................................................................173

29.4.1 WMSUrl .............................................................................................................173

命名空间：com.mapabc.maps.api.styles .........................................................................................173

30 MFontStyle() ...............................................................................................................................173



30.1 说明.............................................................................................................................173

30.2 命名空间 ....................................................................................................................173

30.3 构造方法 ....................................................................................................................173

30.3.1 MFontStyle() ......................................................................................................173

30.4 属性.............................................................................................................................174

30.4.1 name....................................................................................................................174

30.4.2 size ......................................................................................................................174

30.4.3 color ....................................................................................................................174

30.4.4 bold .....................................................................................................................175

31 MLineStyle() ...............................................................................................................................175

31.1 说明.............................................................................................................................175

31.2 命名空间 ....................................................................................................................175

31.3 构造方法 ....................................................................................................................175

31.3.1 MLineStyle() ......................................................................................................175

31.4 属性.............................................................................................................................176

31.4.1 thickness .............................................................................................................176

31.4.2 color ....................................................................................................................176

31.4.3 alpha....................................................................................................................176

31.4.4 lineType ..............................................................................................................176

32 MAreaStyle() ..............................................................................................................................177

32.1 说明.............................................................................................................................177

32.2 命名空间 ....................................................................................................................177

32.3 构造方法 ....................................................................................................................177

32.3.1 MAreaStyle() .....................................................................................................177

32.4 属性.............................................................................................................................178

32.4.1 borderStyle .........................................................................................................178

32.4.2 fillStyle ...............................................................................................................178

33 MFillStyle() .................................................................................................................................178

33.1 说明.............................................................................................................................178

33.2 命名空间 ....................................................................................................................178

33.3 构造方法 ....................................................................................................................178

33.3.1 MFillStyle() ........................................................................................................178

33.4 属性.............................................................................................................................179

33.4.1 color ....................................................................................................................179

33.4.2 alpha....................................................................................................................179

命名空间：com.mapabc.maps.api.basetypes ...................................................................................179

34 MLngLat() ...................................................................................................................................179

34.1 说明.............................................................................................................................179

34.2 命名空间 ....................................................................................................................180

34.3 构造方法 ....................................................................................................................180

34.3.1 MLngLat(longitude,latitude,TYPE) .................................................................180

34.4 属性.............................................................................................................................180

34.4.1 lngX ....................................................................................................................180

34.4.2 latY .....................................................................................................................181



34.4.3 TYPE ..................................................................................................................181

35 MLngLats() .................................................................................................................................181

35.1 说明.............................................................................................................................181

35.2 命名空间 ....................................................................................................................182

35.3 构造方法 ....................................................................................................................182

35.3.1 MLngLats(lnglatArr) .........................................................................................182

35.4 属性.............................................................................................................................182

35.4.1 lnglatArr .............................................................................................................182

36 MPoint() ......................................................................................................................................183

36.1 说明.............................................................................................................................183

36.2 命名空间 ....................................................................................................................183

36.3 构造方法 ....................................................................................................................183

36.3.1 MPoint(x,y) ........................................................................................................183

36.4 属性.............................................................................................................................183

36.4.1 x ..........................................................................................................................183

36.4.2 y ..........................................................................................................................184

37 MSize() ........................................................................................................................................184

37.1 说明.............................................................................................................................184

37.2 命名空间 ....................................................................................................................184

37.3 构造方法 ....................................................................................................................184

37.3.1 MSize(width,height) ..........................................................................................184

37.4 属性.............................................................................................................................185

37.4.1 width ...................................................................................................................185

37.4.2 height ..................................................................................................................185

38 MLngLatBounds() ......................................................................................................................185

38.1 说明.............................................................................................................................185

38.2 命名空间 ....................................................................................................................185

38.3 构造方法 ....................................................................................................................186

38.3.1 MLngLatBounds(southWest,northEast) ...........................................................186

38.4 属性.............................................................................................................................186

38.4.1 southWest ...........................................................................................................186

38.4.2 northEast.............................................................................................................186

39 MPixelBounds() ..........................................................................................................................187

39.1 说明.............................................................................................................................187

39.2 命名空间 ....................................................................................................................187

39.3 构造方法 ....................................................................................................................187

39.3.1 MPixelBounds(topLeftPt,rightBottomPt) ........................................................187

39.4 属性.............................................................................................................................187

39.4.1 maxX ..................................................................................................................187

39.4.2 maxY ..................................................................................................................188

39.4.3 minX ...................................................................................................................188

39.4.4 minY ...................................................................................................................188

命名空间：com.mapabc.maps.api.events ........................................................................................188

40 MEvent ........................................................................................................................................188



40.1 说明.............................................................................................................................188

40.2 命名空间 ....................................................................................................................189

40.3 事件回调返回属性....................................................................................................189

40.3.1 mapId ..................................................................................................................189

40.3.2 overlayId.............................................................................................................189

40.3.3 eventType ...........................................................................................................189

40.3.4 eventX.................................................................................................................189

40.3.5 eventY.................................................................................................................190

40.3.6 zoom ...................................................................................................................190

40.3.7 measureResult ....................................................................................................190

40.3.8 menuItemId ........................................................................................................190

40.3.9 objectType ..........................................................................................................191

40.3.10 tileLayerId ..........................................................................................................191

40.3.11 bounds.................................................................................................................191

40.3.12 dotId ....................................................................................................................191

40.3.13 value....................................................................................................................191

40.4 事件.............................................................................................................................192

40.4.1 MAP_READY 事件 ..........................................................................................192

40.4.2 TIP_OPEN 事件 ................................................................................................192

40.4.3 TIP_CLOSE 事件 ..............................................................................................193

40.4.4 TIP_BEFORE_CLOSE 事件............................................................................193

40.4.5 ADD_OVERLAY 事件.....................................................................................194

40.4.6 REMOVE_OVERLAY 事件 ............................................................................194

40.4.7 CLEAR_OVERLAYS 事件..............................................................................195

40.4.8 ADD_TILELAYER 事件..................................................................................195

40.4.9 TILE_MOUSE_OVER 事件 ............................................................................196

40.4.10 MOUSE_CLICK 事件 ......................................................................................196

40.4.11 MOUSE_DBCLICK 事件 ................................................................................197

40.4.12 MOUSE_DOWN 事件......................................................................................198

40.4.13 MOUSE_MOVING 事件 .................................................................................198

40.4.14 MOUSE_UP 事件 .............................................................................................199

40.4.15 MOUSE_OVER 事件 .......................................................................................200

40.4.16 MOUSE_OUT 事件 ..........................................................................................200

40.4.17 DRAG_START 事件 .........................................................................................201

40.4.18 DRAGGING 事件 .............................................................................................202

40.4.19 DRAG_END 事件 .............................................................................................203

40.4.20 MAP_MOVE_START 事件 .............................................................................203

40.4.21 MAP_MOVING 事件 .......................................................................................204

40.4.22 MAP_MOVE_END 事件 .................................................................................204

40.4.23 ZOOM_START 事件 ........................................................................................205

40.4.24 ZOOM_END 事件 ............................................................................................206

40.4.25 ZOOM_CHANGED 事件 ................................................................................206

40.4.26 ROLL_BACK 事件 ...........................................................................................207

40.4.27 MEASURE_STEP 事件 ...................................................................................208



40.4.28 MEASURE_END 事件 .....................................................................................208

40.4.29 COMPUTE_AREA_END 事件 .......................................................................209

40.4.30 MENUITEM_CLICK 事件 ..............................................................................210

40.4.31 GPS_MOVEALONG_COMPLETE 事件.......................................................211

40.4.32 OVERVIEWMAP_CHANGED 事件 ..............................................................211

40.4.33 RADAR_INITIALIZED 事件 ..........................................................................212

40.4.34 RADAR_POSITION_CHANGED 事件 .........................................................212

40.4.35 RADAR_ROTATION_CHANGED 事件........................................................213

命名空间：com.mapabc.maps.api.maptools....................................................................................214

41 MMapTools() ..............................................................................................................................214

41.1 说明.............................................................................................................................214

41.2 命名空间 ....................................................................................................................214

41.3 构造方法 ....................................................................................................................214

41.3.1 MMapTools(mapObj) ........................................................................................214

41.4 方法.............................................................................................................................214

41.4.1 addMassOverlay(massType,serverLayer,options) ...........................................214

41.4.2 removeMassOverlay(massType,options) .........................................................215

41.4.3 addSpecialLayer() ..............................................................................................216

41.4.4 removeSpecialLayer() .......................................................................................216

41.4.5 setCenterByCity(city) ........................................................................................216

42 MassOverlayOptions() ...............................................................................................................217

42.1 说明.............................................................................................................................217

42.2 命名空间 ....................................................................................................................217

42.3 构造方法 ....................................................................................................................217

42.3.1 MassOverlayOptions() ......................................................................................217

42.4 属性.............................................................................................................................217

42.4.1 tileLayerType .....................................................................................................217

42.4.2 tileLayerOptions ................................................................................................218

42.4.3 dataLayerOptions ...............................................................................................218

43 错误代码表 .................................................................................................................................218

搜索 API: ....................................................................................................................................219

命名空间：com.mapabc.search.api ..................................................................................................219

44 MPoiSearch() ..............................................................................................................................219

44.1 说明.............................................................................................................................219

44.2 命名空间 ....................................................................................................................219

44.3 构造方法 ....................................................................................................................219

44.3.1 MPoiSearch() .....................................................................................................219

44.4 方法.............................................................................................................................219

关键字查询 ........................................................................................................................219

44.4.1 poiSearchByKeywords(keywords,city,options) ...............................................219

周边查询 ............................................................................................................................221

44.4.2 poiSearchByCenPoi(centerPoiXY,keywords,city,options) .............................221

44.4.3 poiSearchByCenKeywords(centerKeywords,keywords,city,options) ............223

44.4.4 poiSearchByCenGridCode(centerGridCode,keywords,city,options) .............225



44.4.5 poiSearchByCenLineCross(lineXY1,lineXY2,keywords,option) ..................227

PGUID 查询 .......................................................................................................................230

44.4.6 poiSearchByPguid(pguid,city,options) .............................................................230

拉框查询 ............................................................................................................................231

44.4.7 poiSearchByRegion(regionType,regionXY,keywords,options)......................231

缓冲区查询 ........................................................................................................................235

44.4.8 poiSearchByLine(lineXY,keywords,city,options) ...........................................235

44.4.9 poiSearchByRoadId(roadId,keywords,city,options) ........................................237

输入提示 ............................................................................................................................239

44.4.10 typeAhead(keywords,city,options) ...................................................................239

行政区域查询 ....................................................................................................................240

44.4.11 poiSearchByDistrictName(districtName,keywords,city,options) ...................240

45 MPoiSearchOptions() .................................................................................................................242

45.1 说明.............................................................................................................................242

45.2 命名空间 ....................................................................................................................242

45.3 构造方法 ....................................................................................................................242

45.3.1 MPoiSearchOptions() ........................................................................................242

45.4 属性.............................................................................................................................242

45.4.1 dataSources ........................................................................................................242

45.4.2 srcType ...............................................................................................................242

45.4.3 dataType .............................................................................................................243

45.4.4 recordsPerPage ...................................................................................................243

45.4.5 pageNum ............................................................................................................243

45.4.6 resType ...............................................................................................................243

45.4.7 range ...................................................................................................................244

45.4.8 naviFlag ..............................................................................................................244

45.4.9 sr..........................................................................................................................244

45.4.10 extId ....................................................................................................................244

45.4.11 eid .......................................................................................................................245

45.4.12 userId ..................................................................................................................245

45.4.13 tempId .................................................................................................................245

45.4.14 buffer ..................................................................................................................245

45.4.15 sortRule ..............................................................................................................246

45.4.16 resData ................................................................................................................246

45.4.17 cenXY .................................................................................................................246

45.4.18 sign......................................................................................................................246

45.4.19 custom.................................................................................................................247

45.4.20 custom_and ........................................................................................................247

45.4.21 requestMethod....................................................................................................247

45.5 方法.............................................................................................................................247

45.6 示例.............................................................................................................................247

46 MRouteSearch() ..........................................................................................................................248

46.1 说明.............................................................................................................................248

46.2 命名空间 ....................................................................................................................248



46.3 构造方法 ....................................................................................................................248

46.3.1 MRouteSearch() .................................................................................................248

46.4 方法.............................................................................................................................248

导航路径查询 ....................................................................................................................248

46.4.1 routeSearchByTwoPoi(startPoiXY,endPoiXY,options)...................................248

46.4.2 routeSearchByMultiPoi(multiPoiXY,options) .................................................250

46.4.3 calculaNaviDistance(multiPoiXY,option) ........................................................252

47 MRouteSearchOptions().............................................................................................................253

47.1 说明.............................................................................................................................253

47.2 命名空间 ....................................................................................................................253

47.3 构造方法 ....................................................................................................................253

47.3.1 MRouteSearchOptions()....................................................................................253

47.4 属性.............................................................................................................................253

47.4.1 routeType ............................................................................................................253

47.4.2 per .......................................................................................................................254

47.4.3 resType ...............................................................................................................254

47.4.4 passByXY...........................................................................................................254

47.4.5 region ..................................................................................................................255

47.4.6 name....................................................................................................................255

47.4.7 avoidanceType ...................................................................................................255

47.4.8 ext .......................................................................................................................255

47.4.9 requestMethod....................................................................................................256

47.5 方法.............................................................................................................................256

47.6 示例.............................................................................................................................256

48 MBusSearch() .............................................................................................................................256

48.1 说明.............................................................................................................................256

48.2 命名空间 ....................................................................................................................256

48.3 构造方法 ....................................................................................................................256

48.3.1 MBusSearch() ....................................................................................................256

48.4 方法.............................................................................................................................257

公交路径查询 ....................................................................................................................257

48.4.1 busSearchByTwoPoi(startPoiXY,endPoiXY,city,options) ..............................257

公交线路信息查询 ............................................................................................................259

48.4.2 busSearchByBusId(busId,city,option) ..............................................................259

48.4.3 busSearchByBusName(busName,city,option) .................................................261

48.4.4 busSearchByBusStation(stationName,city,option) ..........................................264

49 MBusSearchOptions() ................................................................................................................267

49.1 说明.............................................................................................................................267

49.2 命名空间 ....................................................................................................................267

49.3 构造方法 ....................................................................................................................267

49.3.1 MBusSearchOptions() .......................................................................................267

49.4 属性.............................................................................................................................268

49.4.1 routeType ............................................................................................................268

49.4.2 per .......................................................................................................................268



49.4.3 resType ...............................................................................................................268

49.4.4 resData ................................................................................................................268

49.4.5 recordsPerPage ...................................................................................................269

49.4.6 pageNum ............................................................................................................269

49.4.7 requestMethod....................................................................................................269

49.5 方法.............................................................................................................................269

49.6 示例.............................................................................................................................269

50 MGeoCodeSearch() ....................................................................................................................270

50.1 说明.............................................................................................................................270

50.2 命名空间 ....................................................................................................................270

50.3 构造方法 ....................................................................................................................270

50.3.1 MGeoCodeSearch() ...........................................................................................270

50.4 方法.............................................................................................................................270

50.4.1 addressToGeocode(address,options) ................................................................270

51 MGeoCodeSearchOptions() .......................................................................................................272

51.1 说明.............................................................................................................................272

51.2 命名空间 ....................................................................................................................272

51.3 构造方法 ....................................................................................................................272

51.3.1 MGeoCodeSearchOptions() ..............................................................................272

51.4 属性.............................................................................................................................272

51.4.1 resType ...............................................................................................................272

51.4.2 requestMethod....................................................................................................273

51.5 方法.............................................................................................................................273

51.6 示例.............................................................................................................................273

52 MReGeoCodeSearch() ...............................................................................................................273

52.1 说明.............................................................................................................................273

52.2 命名空间 ....................................................................................................................273

52.3 构造方法 ....................................................................................................................273

52.3.1 MReGeoCodeSearch() ......................................................................................273

52.4 方法.............................................................................................................................274

52.4.1 poiToAddress(poiXY,options)..........................................................................274

52.4.2 poiToAddressSimple(poiXY,options) ..............................................................276

52.4.3 multiPoiToAddress(multiPoiXY,Options).......................................................276

53 MReGeoCodeSearchOptions() ..................................................................................................279

53.1 说明.............................................................................................................................279

53.2 命名空间 ....................................................................................................................279

53.3 构造方法 ....................................................................................................................279

53.3.1 MReGeoCodeSearchOptions() .........................................................................279

53.4 属性.............................................................................................................................280

53.4.1 resType ...............................................................................................................280

53.4.2 poiNumber..........................................................................................................280

53.4.3 range ...................................................................................................................280

53.4.4 pattern .................................................................................................................280

53.4.5 roadlevel .............................................................................................................281



53.4.6 exkey...................................................................................................................281

53.4.7 requestMethod....................................................................................................281

53.5 方法.............................................................................................................................282

53.6 示例.............................................................................................................................282

54 MRoadSearch() ...........................................................................................................................282

54.1 说明.............................................................................................................................282

54.2 命名空间 ....................................................................................................................282

54.3 构造方法 ....................................................................................................................282

54.3.1 MRoadSearch() ..................................................................................................282

54.4 方法.............................................................................................................................282

54.4.1 roadSearchByRoadName(roadName,city,options) ..........................................282

54.4.2 roadCrossSearchByRoadId(roadId1,roadId2,city,options） ..........................284

54.4.3 roadCrossSearchByRoadName(roadName1,roadName2,city,options） .......286

54.4.4 allRoadCrossSearchByRoadName(roadName,city,options) ...........................287

55 MRoadSearchOptions() ..............................................................................................................289

55.1 说明.............................................................................................................................289

55.2 命名空间 ....................................................................................................................289

55.3 构造方法 ....................................................................................................................289

55.3.1 MRoadSearchOptions() .....................................................................................289

55.4 属性.............................................................................................................................289

55.4.1 resType ...............................................................................................................289

55.4.2 keyType ..............................................................................................................290

55.4.3 rexy .....................................................................................................................290

55.4.4 sortRule ..............................................................................................................290

55.4.5 buffer ..................................................................................................................290

55.4.6 roadlevel .............................................................................................................290

55.4.7 requestMethod....................................................................................................291

55.5 方法.............................................................................................................................291

55.6 示例.............................................................................................................................291

56 MSpatialSearch() ........................................................................................................................291

56.1 说明.............................................................................................................................291

56.2 命名空间 ....................................................................................................................292

56.3 构造方法 ....................................................................................................................292

56.3.1 MSpatialSearch() ...............................................................................................292

56.4 方法.............................................................................................................................292

56.4.1 isPoiInRegion(regionType,poiXY,regionXY,options) .....................................292

56.4.2 isMultiPoiInRegion(regionType,multiPoiXY,regionXY,options) ..................293

56.4.3 calculaDistance(PoiXY1,PoiXY2,lineXY,options) .........................................295

56.4.4 calculaBufferZone(lineArr,options) .................................................................296

57 MSpatialSearchOptions() ...........................................................................................................298

57.1 说明.............................................................................................................................298

57.2 命名空间 ....................................................................................................................298

57.3 构造方法 ....................................................................................................................298

57.3.1 MSpatialSearchOptions() ..................................................................................298



57.4 属性.............................................................................................................................298

57.4.1 resType ...............................................................................................................298

57.4.2 buffer ..................................................................................................................299

57.4.3 range ...................................................................................................................299

57.4.4 coorType .............................................................................................................299

57.4.5 requestMethod....................................................................................................299

57.5 方法.............................................................................................................................299

57.6 示例.............................................................................................................................300

58 MCoordinateSearch() .................................................................................................................300

58.1 说明.............................................................................................................................300

58.2 命名空间 ....................................................................................................................300

58.3 构造方法 ....................................................................................................................300

58.3.1 MCoordinateSearch() ........................................................................................300

58.4 方法.............................................................................................................................300

58.4.1 GPSToOffsetGet(poiXY1,poiXY2,options) ....................................................300

58.4.2 GPSToOffsetPost(multiPoiXY,options) ...........................................................302

58.4.3 pathCorrection(poiXY,radian,city,options) ......................................................303

58.4.4 fromLngLatToPixel(LngLats,centerPoiXY,zoom,mapSize,options) .............304

58.4.5 fromPixelToLngLat(Pixels, centerPoiXY,zoom, mapSize ,options) ..............306

59 MCoordinateSearchOptions() ....................................................................................................307

59.1 说明.............................................................................................................................307

59.2 命名空间 ....................................................................................................................307

59.3 构造方法 ....................................................................................................................308

59.3.1 MCoordinateSearchOptions() ...........................................................................308

59.4 属性.............................................................................................................................308

59.4.1 resType ...............................................................................................................308

59.4.2 angle....................................................................................................................308

59.4.3 range ...................................................................................................................308

59.4.4 cr .........................................................................................................................309

59.4.5 ver .......................................................................................................................309

59.4.6 flag ......................................................................................................................309

59.4.7 requestMethod....................................................................................................309

59.5 方法.............................................................................................................................310

59.6 示例.............................................................................................................................310

60 MSearchTools()...........................................................................................................................310

60.1 说明.............................................................................................................................310

60.2 命名空间 ....................................................................................................................310

60.3 构造方法 ....................................................................................................................310

60.3.1 MSearchTools()..................................................................................................310

60.4 方法.............................................................................................................................310

60.4.1 weatherSearchByCity(city,options) ..................................................................310

60.4.2 weatherSearchByAdCode(adCode,options) ....................................................312

60.4.3 weatherSearchByPoi(poiXY,options) ...............................................................314

60.4.4 addressSearchByIP(ip,options) .........................................................................316



60.4.5 cityInfoSearchByCity(city,option)....................................................................318

60.4.6 districtSearchByNameAndCode(searchType,name,code,options) .................319

60.4.7 districtSearchByPoiAndZoom(poiXY,zoom,options) .....................................321

61 MSearchToolsOptions() .............................................................................................................322

61.1 说明.............................................................................................................................322

61.2 命名空间 ....................................................................................................................323

61.3 构造方法 ....................................................................................................................323

61.3.1 MSearchToolsOptions() ....................................................................................323

61.4 属性.............................................................................................................................323

61.4.1 resType ...............................................................................................................323

61.4.2 ver .......................................................................................................................323

61.4.3 requestMethod....................................................................................................323

61.5 方法.............................................................................................................................324

61.6 示例.............................................................................................................................324

62 MDynamicRendering() ..............................................................................................................324

62.1 说明.............................................................................................................................324

62.2 命名空间 ....................................................................................................................324

62.3 构造方法 ....................................................................................................................324

62.3.1 MDynamicRendering() .....................................................................................324

62.4 方法.............................................................................................................................325

62.4.1 poiSearchByPoiId(poiId,serverLayer,options) ................................................325

62.4.2 poiSearchByCenPoi(centerPoiXY,serverLayer,options) .................................326

62.4.3 spatialSearchByRegion(regionXY, serverLayer,options) ...............................328

63 MDynamicRenderingOptions() .................................................................................................329

63.1 说明.............................................................................................................................329

63.2 命名空间 ....................................................................................................................329

63.3 构造方法 ....................................................................................................................330

63.3.1 MDynamicRenderingOptions() ........................................................................330

63.4 属性.............................................................................................................................330

63.4.1 resType ...............................................................................................................330

63.4.2 range ...................................................................................................................330

63.4.3 requestMethod....................................................................................................330

63.5 方法.............................................................................................................................331

63.6 示例.............................................................................................................................331

64 错误代码附录： ........................................................................................................................331

64.1 400 错误请求 .............................................................................................................331

64.2 403 无权访问 .............................................................................................................331



地图 API:

命名空间：com.mapabc.maps.api

1 全局常量

1.1. 说明

1.2. 常量

地图类型

1.2.1 MAP_EN

说明：

地图类型常量，英文地图

示例：

MAP_EN

1.2.2 MAP_CN

说明：

地图类型常量，中文地图

示例：

MAP_CN

地图控件名称

1.2.3 OVERVIEW_CTRL

说明：

地图控件名称常量，鹰眼

示例：

OVERVIEW_CTRL



1.2.4 TOOLBAR_CTRL

说明：

地图控件名称常量，工具条

示例：

TOOLBAR_CTRL

1.2.5 SCALE_CTRL

说明：

地图控件名称常量，比例尺

示例：

SCALE_CTRL

工具条样式

1.2.6 DEFAULT

说明：

工具条样式常量，默认样式工具条

示例：

DEFAULT

1.2.7 ROUND

说明：

工具条样式常量，圆形工具条

示例：

ROUND

1.2.8 BLACK

说明：

工具条样式常量，黑色工具条

示例：

BLACK

1.2.9 SMALL

说明：

工具条样式常量，小型工具条



示例：

SMALL

1.2.10 MINI

说明：

工具条样式常量，迷你型工具条

示例：

MINI

地图控件状态

1.2.11 MINIMIZE

说明：

地图控件状态常量，最小化鹰眼

示例：

MINIMIZE

1.2.12 SHOW

说明：

地图控件状态常量，显示

示例：

SHOW

1.2.13 HIDE

说明：

地图控件状态常量，隐藏

示例：

HIDE

鼠标工具

1.2.14 PAN_WHEELZOOM

说明：

鼠标工具常量，设置鼠标焦点滚轮缩放

示例：



PAN_WHEELZOOM

1.2.15 ADD_MARKER

说明：

鼠标工具常量，鼠标标点

示例：

ADD_MARKER

1.2.16 DRAW_LINE

说明：

鼠标工具常量，鼠标画线

示例：

DRAW_LINE

1.2.17 DRAW_POLYGON

说明：

鼠标工具常量，鼠标画多边形

示例：

DRAW_POLYGON

1.2.18 DRAW_RECTANGLE

说明：

鼠标工具常量，鼠标画矩形

示例：

DRAW_RECTANGLE

1.2.19 DRAW_CIRCLE

说明：

鼠标工具常量，鼠标画圆

示例：

DRAW_CIRCLE

1.2.20 RULER

说明：

鼠标工具常量，鼠标测距

示例：



RULER

1.2.21 COMPUTE_AREA

说明：

鼠标工具常量，鼠标测面积

示例：

COMPUTE_AREA

1.2.22 FRAME_ZOOMIN

说明：

鼠标工具常量，拉框放大

示例：

FRAME_ZOOMIN

1.2.23 FRAME_ZOOMOUT

说明：

鼠标工具常量，拉框缩小

示例：

FRAME_ZOOMOUT

事件类型

1.2.24 MAP_READY

说明：

事件常量，地图准备完毕

示例：

MAP_READY

1.2.25 TIP_OPEN

说明：

事件常量，打开信息窗体

示例：

TIP_OPEN



1.2.26 TIP_CLOSE

说明：

事件常量，关闭信息窗体

示例：

TIP_CLOSE

1.2.27 TIP_BEFORE_CLOSE

说明：

事件常量，信息窗体关闭之前

示例：

TIP_BEFORE_CLOSE

1.2.28 ADD_OVERLAY

说明：

事件常量，添加 overlay

示例：

ADD_OVERLAY

1.2.29 REMOVE_OVERLAY

说明：

事件常量，删除 overlay

示例：

REMOVE_OVERLAY

1.2.30 CLEAR_OVERLAYS

说明：

事件常量，删除所有覆盖物对象

示例：

CLEAR_OVERLAYS

1.2.31 MOUSE_CLICK

说明：

事件常量，单击鼠标左键

示例：

MOUSE_CLICK



1.2.32 MOUSE_DBCLICK

说明：

事件常量，双击鼠标左键

示例：

MOUSE_DBCLICK

1.2.33 MOUSE_DOWN

说明：

事件常量，鼠标左键落下

示例：

MOUSE_DOWN

1.2.34 MOUSE_UP

说明：

事件常量，鼠标左键抬起

示例：

MOUSE_UP

1.2.35 MOUSE_MOVING

说明：

事件常量，鼠标移动过程中

示例：

MOUSE_MOVING

1.2.36 MOUSE_OVER

说明：

事件常量，鼠标移到地图上

示例：

MOUSE_OVER

1.2.37 MOUSE_OUT

说明：

事件常量，鼠标移出地图

示例：

MOUSE_OUT



1.2.38 DRAG_START

说明：

事件常量，鼠标开始拖拽

示例：

DRAG_START

1.2.39 DRAGGING

说明：

事件常量，鼠标拖拽过程中

示例：

DRAGGING

1.2.40 DRAG_END

说明：

事件常量，鼠标结束拖拽

示例：

DRAG_END

1.2.41 MAP_MOVE_START

说明：

事件常量，地图开始移动

示例：

MAP_MOVE_START

1.2.42 MAP_MOVING

说明：

事件常量，地图移动过程中

示例：

MAP_MOVING

1.2.43 MAP_MOVE_END

说明：

事件常量，地图结束移动

示例：

MAP_MOVE_END



1.2.44 ZOOM_START

说明：

事件常量，地图开始缩放

示例：

ZOOM_START

1.2.45 ZOOM_END

说明：

事件常量，地图结束缩放

示例：

ZOOM_END

1.2.46 ZOOM_CHANGED

说明：

事件常量，地图缩放级别改变

示例：

ZOOM_CHANGED

1.2.47 ROLL_BACK

说明：

事件常量，地图状态回滚

示例：

ROLL_BACK

1.2.48 MEASURE_STEP

说明：

事件常量，测量一次直线距离

示例：

MEASURE_STEP

1.2.49 MEASURE_END

说明：

事件常量，测距结束

示例：

MEASURE_END



1.2.50 COMPUTE_AREA_END

说明：

事件常量，测量面积结束

示例：

COMPUTE_AREA_END

1.2.51 MENUITEM_CLICK

说明：

事件常量，单击菜单

示例：

MENUITEM_CLICK

1.2.52 GPS_MOVEALONG_COMPLETE

说明：

事件常量，调用 markerMoveAlong 方法移动结束

示例：

GPS_MOVEALONG_COMPLETE

1.2.53 ADD_TILELAYER

说明：

事件常量，添加切片图层

示例：

ADD_TILELAYER

1.2.54 TILE_MOUSE_OVER

说明：

事件常量，鼠标移动到切片图层上

示例：

TILE_MOUSE_OVER

1.2.55 OVERVIEWMAP_CHANGE

说明：

事件常量，改变鹰眼地图状态

示例：

OVERVIEWMAP_CHANGE



1.2.56 RADAR_INITIALIZED

说明：

事件常量，雷达初始化完成

示例：

RADAR_INITIALIZED

1.2.57 RADAR_POSITION_CHANGED

说明：

事件常量，雷达位置改变

示例：

RADAR_POSITION_CHANGED

1.2.58 RADAR_ROTATION_CHANGED

说明：

事件常量，雷达角度改变

示例：

RADAR_ROTATION_CHANGED

切片图层

1.2.59 TL_TRAFFIC

说明：

切片图层常量，实时交通图层

示例：

TL_TRAFFIC

1.2.60 TL_USERMAP

说明：

切片图层常量，用户编辑器图层

示例：

TL_USERMAP

1.2.61 TL_SATELLITE

说明：



切片图层常量，卫星图层

示例：

TL_SATELLITE

1.2.62 TL_MASS_TRANSIT

说明：

切片图层常量，轨道交通图层

示例：

TL_MASS_TRANSIT

1.2.63 TL_REAL_ESTATE

说明：

切片图层常量，房地产图层

示例：

TL_REAL_ESTATE

1.2.64 TL_CUSTOM_MAP

说明：

切片图层常量，用户自定义图层

示例：

TL_CUSTOM_MAP

信息窗体

1.2.65 FLASH_BUBBLE_TIP

说明：

信息窗常量，flash 气泡信息窗

示例：

FLASH_BUBBLE_TIP

1.2.66 HTML_BUBBLE_TIP

说明：

信息窗常量，纯 HTML 气泡信息窗

示例：

HTML_BUBBLE_TIP



1.2.67 HTML_CUSTOM_TIP

说明：

信息窗常量，纯 HTML 用户自定义形状信息窗

示例：

HTML_CUSTOM_TIP

1.2.68 IMG_BUBBLE_TIP

说明：

信息窗常量，IMG 背景 HTML 气泡信息窗

示例：

IMG_BUBBLE_TIP

线体类型

1.2.69 LINE_SOLID

说明：

线类型，实线

示例：

LINE_SOLID

1.2.70 LINE_DASHED

说明：

线类型，虚线

示例：

LINE_DASHED

坐标类型

1.2.71 COORD_TYPE_ENCODE

说明：

坐标类型常量，加密坐标

示例：

COORD_TYPE_ENCODE



1.2.72 COORD_TYPE_OFFSET

说明：

坐标类型常量，明码偏移坐标

示例：

COORD_TYPE_OFFSET

焦点模式

1.2.73 NOFOCUS

说明：

焦点模式常量，非焦点模式

示例：

NOFOCUS

1.2.74 FOCUS

说明：

焦点模式常量，焦点模式

示例：

FOCUS

1.2.75 CENTER_FOCUS

说明：

焦点模式常量，中心点模式

示例：

CENTER_FOCUS

方向名称

1.2.76 EAST

说明：

方位常量，东

示例：

EAST



1.2.77 WEST

说明：

方位常量，西

示例：

WEST

1.2.78 SOUTH

说明：

方位常量，南

示例：

SOUTH

1.2.79 NORTH

说明：

方位常量，北

示例：

NORTH

位置名称

1.2.80 TOP_LEFT

说明：

位置名称常量，上左

示例：

TOP_LEFT

1.2.81 TOP_CENTER

说明：

位置名称常量，上中

示例：

TOP_CENTER

1.2.82 TOP_RIGHT

说明：



位置名称常量，上右

示例：

TOP_RIGHT

1.2.83 MIDDLE_LEFT

说明：

位置名称常量，中左

示例：

MIDDLE_LEFT

1.2.84 MIDDLE_CENTER

说明：

位置名称常量，正中

示例：

MIDDLE_CENTER

1.2.85 MIDDLE_RIGHT

说明：

位置名称常量，中右

示例：

MIDDLE_RIGHT

1.2.86 BOTTOM_LEFT

说明：

位置名称常量，下左

示例：

BOTTOM_LEFT

1.2.87 BOTTOM_CENTER

说明：

位置名称常量，下中

示例：

BOTTOM_CENTER

1.2.88 BOTTOM_RIGHT

说明：



位置名称常量，下右

示例：

BOTTOM_RIGHT

弹跳效果定位方式

1.2.89 BOUNCE_CROSS

说明：

弹跳效果定位方式，十字定位

示例：

BOUNCE_CROSS

1.2.90 BOUNCE_CIRCLE

说明：

弹跳效果定位方式，圆圈定位

示例：

BOUNCE_CIRCLE

2 MMap

2.1 说明

MMap 封装 Flash 地图组件，对地图的操作都是通过它完成。通过创建一个 MMap 对象

并调用地图的相应方法就可以在页面中显示地图，实现基本的地图功能。

2.2 命名空间

com.mapabc.maps.api.MMap。

2.3 构造方法

2.3.1 MMap(container,mapOption)

说明：

初始化 MMap 类的一个新实例。

参数：



（1）container：

说明：装载地图组件容器的 Id，例如<div>标签的 Id。

类型：string。

（2）mapOption：

说明：地图初始化时的参数选项。

类型：MMapOptions。

返回值：

无

注释：

无

示例：

<script type="text/javascript">

var mapObj;

function mapInit() {

mapObj = new MMap("map"); //地图初始化

}

</script>

……

<body onload="mapInit();">

<div id="map" style="width: 500px; height: 300px"></div>

</body>

2.4 方法

获取地图状态

2.4.1 getCenter()

说明：

返回 MLngLat 类对象，该对象代表当前地图中心点的位置。

参数：

无

返回值：

说明：地图中心点经纬度对象。

类型：MLngLat。

事件：

无

注释：

无

示例：

var center = mapObj.getCenter(); //获取中心点经纬度对象。

alert(center.lngX+" , "+center.latY); //通过对象的属性返回经纬度坐标。



2.4.2 getZoomLevel()

说明：

返回当前地图的 zoom 级别。

参数：

无

返回值：

说明：地图 zoom 级别，范围为从 3 到 17，数值越大，地图内容越详细。

类型：number。

事件：

无

注释：

无

示例：

alert(mapObj.getZoomLevel()); //通过警告框返回地图 zoom 级别。

2.4.3 getSize()

说明：

返回 Msize 类对象，该对象表示地图视口的像素大小。

参数：

无

返回值：

说明：返回地图视口的像素大小。

类型：MSize。

事件：

无

注释：

无

示例：

var size = mapObj.getSize();

alert(size.height+","+size.width); //通过警告框返回像素大小

2.4.4 getScale()

说明：

返回当前地图中心点的比例尺，即一个像素代表的距离，单位为米。

参数：

无

返回值：

说明：当前地图中心点的一个像素代表的距离，单位为米。

类型：number。

事件：



无

注释：

无

示例：

alert(mapObj.getScale());

2.4.5 getPixelBounds()

说明：

返回地图视野范围矩形区域左上方和右下方的像素坐标。其中左上方像素坐标为（minX，

minY），右下方坐标为（maxX，maxY）。

参数：

无

返回值：

说明：返回当前地图视野范围像素坐标的范围。

类型：MPixelBounds。

事件：

无

注释：

无

示例：

var pixelBounds = mapObj.getPixelBounds();

alert(pixelBounds.maxX+","+ pixelBounds.maxY+","+ pixelBounds.minX+"

,"+ pixelBounds.minY);

2.4.6 getLngLatBounds()

说明：

返回 MLngLatBounds 类对象，该对象表示地图视野范围矩形区域西南和东北角点的经

纬度坐标。

参数：

无

返回值：

说明：地图窗口矩形区域框经纬度坐标。

类型：MLngLatBounds。

事件：

无

注释：

无

示例：

var bounds=mapObj.getLngLatBounds();

alert(bounds.southWest.lngX+","+bounds.southWest.latY+";"+bounds.northEast.lngX+","+b

ounds.northEast.latY);



2.4.7 getLngLatByOffset(originalLngLat,WEOffset,SNOffset, radius)

说明：

根据原始点经纬度坐标和偏移量计算新的经纬度坐标，注意偏移量的单位为米。

参数：

（1）originalLngLat:

说明：原始点经纬度坐标。

类型：MLngLat。

（2）WEOffset：

说明：东西方向的偏移量，向东为正，向西为负。

类型：number。

（3）SNOffset：

说明：南北方向的偏移量，向北为正，向南为负。

类型：number。

（4）radius：

说明：地球半径，可选项，默认为 6378137 米。

类型：number。

返回值：

说明：偏移后位置点的经纬度坐标。

类型：MLngLat。

事件：

无

注释：

该方法不支持真实坐标。使用该方法返回的纬度坐标范围应该在-90 度到 90 度之间，

超过该范围说明该参数设置有误。

示例：

var cen=mapObj.getLngLatByOffset(new MLngLat

("116.39746427536011","39.9086663756386"),5000,5000,6378137);

alert(cen.lngX+","+cen.latY);

2.4.8 isContinuousZoom()

说明：

返回地图缩放时是否具有连续缩放效果的参数。

参数:

无

返回值:

说明：如果地图缩放时带连续缩放效果返回 true，否则返回 false。

类型：boolean。

事件：

无

注释：

无



示例：

alert(mapObj.isContinuousZoom());

2.4.9 getMapTilesId()

说明：

获取当前地图所有切片的 id。

参数：

无

返回值：

说明：当前地图所有切片的 id。

类型：array。

事件：

无

注释：

无

示例：

var array=new Array();

array=mapObj.getMapTilesId();

for (i=0;i<array.length ;i++ )

{

alert(array[i]);

}

2.4.10 getDragEnabled()

说明：

返回地图是否允许拖拽的状态。

参数:

无

返回值:

说明：如果允许地图拖拽返回 true，否则返回 false。

类型：boolean。

事件：

无

注释：

无

示例：

alert(mapObj.getDragEnabled());

2.4.11 getZoomEnabled()

说明：



返回地图是否允许缩放的状态。

参数:

无

返回值:

说明：如果允许地图缩放返回 true，否则返回 false。

类型：boolean。

事件：

无

注释：

无

示例：

alert(mapObj.getZoomEnabled());

2.4.12 getKeyboardEnabled()

说明：

返回键盘工具是否有效参数。键盘工具操作地图包括用键盘方向键移动地图和用主键盘

“+”、“-”来缩放地图。

参数:

无

返回值:

说明：如果允许键盘操作地图返回 true，否则返回 false。

类型：boolean。

事件：

无

注释：

无

示例：

alert(mapObj.getKeyboardEnabled());

修改地图状态

2.4.13 setCenter(center)

说明：

设置地图中心点的经纬度坐标。

参数：

（1）center：

说明：地图中心点的经纬度坐标。

类型：MLngLat。

返回值：

说明：如果返回值为 0，表示操作正确，如果非 0，则表示操作有误，对照附录的错误

代码表可以查看错误代码类型。



类型：number。

事件：

MAP_MOVE_END 事件。

注释：

无

示例：

以下代码片在创建一个地图对象之后，通过经纬度坐标设置其中心点。

var mapObj=MMap("mapObj”);

mapObj.setCenter(new MLngLat("116.49746427536011","39.9086663756386"));

2.4.14 setZoomLevel(zoomLevel)

说明：

设置地图的缩放级别。

参数:

（1）zoomLevel：

说明：地图的 zoom 级别，范围从 3 到 17，数值越大，图上信息越详细。

类型：number。

返回值:



类型：number。

事件：

ZOOM_START 事件、ZOOM_END 事件、ZOOM_CHANGED 事件。

注释：

无

示例：

mapObj.setZoomLevel(17); //设置地图 zoom 级别为 17。

2.4.15 setZoomAndCenter(zoom,center)

说明：

同时设置地图的中心点及 zoom 级别。

参数：

（1）zoom：

说明：显示缩放等级。

类型：number。

（2）center：

说明：设定的地图中心点经纬度坐标。

类型：MLngLat。

返回值：





类型：number。

事件：

ZOOM_CHANGED 事件、ZOOM_END 事件、MAP_MOVE_END 事件。

注释：

如果要同时设置中心点和缩放级别，应使用 MMap.setZoomAndCenter 方法，而不是分

别调用 MMap.setCenter 方法和 MMap.setZoomLevel 方法。

示例:

mapObj.setZoomAndCenter(17,new MLngLat("116.39746427536011",

"39.9086663756386"));

2.4.16 setContinuousZoom(isContinuous)

说明：

设置地图缩放时是否有连续缩放效果。

参数：

（1）isContinuous：

说明：是否具有连续缩放的效果。

类型：boolean。

返回值：



类型：number。

事件：

无

注释：

无

示例：

mapObj.setContinuousZoom(true);

2.4.17 setMapColor(color)

说明：

设置地图颜色。

参数：

（1） color：

说明：地图的颜色，该属性值为 16 进制，例如"#ff0000"，默认为"#000000"。

类型：String。

返回值：



类型：number。

事件：

http://msdn.microsoft.com/zh-cn/library/bb412439.aspx

http://msdn.microsoft.com/zh-cn/library/bb429618.aspx



无

注释：

无

示例：

mapObj.setMapColor('#ff0000');

2.4.18 setDragEnabled(dragEnabled)

说明：

设置地图是否允许拖拽。

参数：

（1）dragEnabled

说明：是否允许地图拖拽。

类型：boolean。

返回值：



类型：number。

事件：

无

注释：

该方法只限于控制地图是否可以被鼠标拖拽，不能控制鹰眼拖图，不限制其他移图接口。

示例：

mapObj.setDragEnabled(false);

2.4.19 setZoomEnabled(zoomEnabled)

说明：

设置是否允许地图缩放。

参数：

（1）zoomEnabled：

说明：是否允许地图缩放。

类型：boolean。

返回值：



类型：number。

事件：

无

注释：

地图缩放方法包括通过鱼骨条缩放地图、鼠标双击放大、键盘缩放地图以及 zoomIn()、

zoomOut()方法。

示例：



mapObj.setZoomEnabled(false);

2.4.20 setLngLatBounds(bounds)

说明：

根据经纬度 bounds 设置最合适的地图位置和 zoom 级别。其中 bounds 表示

MLngLatBounds 对象。

参数：

（1）bounds：

说明：通过西南、东北角的经纬度坐标构建的经纬度矩形区域。


返回值：



类型：number。

事件：


注释：

该方法不支持真实坐标。

示例：

mapObj.setLngLatBounds(new MLngLatBounds(new MLngLat('58','23',1),new

MLngLat('116','24',1)));

2.4.21 zoomIn(lnglat)

说明：

放大地图的一个级别。除了使用该方法进行放大地图以外，还可以使用鱼骨条、鼠标双

击、键盘“+”方法来放大地图。

参数：

（1）lngLat：

说明：地图缩放时的焦点坐标。默认为空，即中心点放大。

类型：MLngLat。

返回值：



类型：number。

事件：


注释：

无

示例：

mapObj.zoomIn(new MLngLat("116.39746427536011","39.9086663756386"));



2.4.22 zoomOut(lnglat)

说明：

缩小地图的一个级别。除了使用该方法，还可以使用鱼骨条、键盘“减号”来缩小地图。

参数：

lngLat：

说明：地图缩放时的焦点坐标。默认为空，即中心点缩小。

类型：MLngLat。

返回值：



类型：number。

事件：


注释：

无

示例：

mapObj.zoomOut(new MLngLat("116.39746427536011","39.9086663756386"));

2.4.23 panDirection(dx,dy)

说明：

朝着指定的方向滑动地图宽度一半的距离。

参数：

（1）dx：

说明：其值为 EAST 和 WEST，其中 EAST 表示向右方滑动，WEST 表示向左方滑动。

类型：constant。

（2）dy：

说明：其值为 NORTH 和 SOUTH，其中 NORTH 表示向上方滑动，SOUTH 表示向下

方滑动。


返回值：



类型：number。

事件：

MAP_MOVE_START 事件、MAP_MOVE_END 事件、MAP_MOVING 事件。

注释：

无

示例：

mapObj.panDirection(EAST,SOUTH);//地图朝右下滑动地图宽度一半的距离。



2.4.24 panTo(center)

说明：

移动地图的中心点到指定的坐标。

参数：

（1）center：

说明：目标位置中心点经纬度。

类型：MLngLat。

返回值：



类型：number。

事件：


注释：

如果该点已经在当前的视口之中，则地图中心会滑动到该位置；如果该点不在当前的视

口之中，地图中心点跳转到指定坐标。

示例：

mapObj.panTo(new MLngLat("116.49746427536011","39.9086663756386"));

2.4.25 panBy(position,speed)

说明：

地图按指定速度滑动指定的像素距离。

参数：

（1）position：

说明：地图移动的像素距离。

类型：MSize。

（2）speed：

说明：地图移动速度。

取值：单位为像素每秒

类型：number。

返回值：



类型：number。

事件：

MAP_MOVE_START 事件、MAP_MOVE_END 事件、MAP_MOVING 事件。

注释：

无

示例：

mapObj.panBy(new MSize(50,40),300);



2.4.26 setCtrlPanelState (ctrlName,state)

说明：

设置地图上的控制面板是否显示。

参数：

（1）ctrlName :

说明：控件名称。

取值：OVERVIEW_CTRL：鹰眼

TOOLBAR_CTRL：工具条

SCALE_CTRL：比例尺


（2）state ：

说明：显示状态。

取值：SHOW：显示

HIDE：隐藏

MINIMIZE：最小化（只适用鹰眼）


返回值：



类型：number。

事件：

仅当改变鹰眼状态时触发 OVERVIEWMAP_CHANGED 事件。

注释：

无

示例：

在地图初始化加载了鹰眼、工具条和比例尺后，可以通过以下方法控制其显示或隐藏的

状态。

mapObj.setCtrlPanelState(OVERVIEW_CTRL, SHOW); //显示鹰眼

mapObj.setCtrlPanelState(OVERVIEW_CTRL,HIDE); //隐藏鹰眼

mapObj.setCtrlPanelState(OVERVIEW_CTRL,MINIMIZE); //最小化鹰眼

mapObj.setCtrlPanelState(TOOLBAR_CTRL,SHOW); //显示工具条

mapObj.setCtrlPanelState(TOOLBAR_CTRL,HIDE); //隐藏工具条

mapObj.setCtrlPanelState(SCALE_CTRL,SHOW); //显示比例尺

mapObj.setCtrlPanelState(SCALE_CTRL,HIDE); //隐藏比例尺

2.4.27 setOverviewState(state)

说明：

通过改变参数来操纵鹰眼。

参数:

（1）state：

说明：鹰眼状态



取值：MINIMIZE：最小化鹰眼

SHOW：打开鹰眼（默认）

HIDE：隐藏鹰眼


返回值：



类型：number。

事件：

OVERVIEWMAP_CHANGED 事件

注释：

无

示例：

mapObj.setOverviewState(SHOW); //打开鹰眼

mapObj.setOverviewState(MINIMIZE); //最小化鹰眼

mapObj.setOverviewState(HIDE); //隐藏鹰眼

2.4.28 loadCtrlPanel(ctrlName,opt)

说明：

加载地图控制面板。

参数:

（1）ctrlName：

说明：地图控件名称

取值：TOOLBAR_CTRL（工具条）


（2）opt：

说明：加载地图控制面板参数选项

取值：opt 结构为：{toolbarPos:MPoint, toolbar:constant,toolbarUrl:String}，其中第

一个属性表示工具条的位置，第二个参数表示工具条的类型（必填），第三个参数

表示工具条的 url。

类型：object。

返回值：



类型：number。

事件：

无

注释：

无

示例：

var toolbarOpt={};

toolbarOpt.toolbarPos=new MPoint(2,5);

toolbarOpt.toolbar=SMALL;



toolbarOpt.toolbarUrl="";

mapObj.loadCtrlPanel(TOOLBAR_CTRL,toolbarOpt);//加载小型鱼骨条

2.4.29 setKeyboardEnabled(enabled)

说明：

设置键盘操作是否有效。

参数:

（1）enabled：

说明：当该参数值为“true”时表示可以使用键盘操作地图；当为“false”时表示禁止

键盘操作地图。

类型：boolean。

返回值：

无

事件：

无

注释：

无

示例：

mapObj.setKeyboardEnabled(true);

2.4.30 savePosition()

说明：

保存地图当前中心点位置和 zoom 级别，只是存储下来，并不能被调用返回存储值。

参数：

无

返回值：



类型：number。

事件：

无

注释：

无

示例：

mapObj.savePosition();

2.4.31 returnToSavedPosition()

说明：

返回到由上次保存的地图中心点位置和 zoom 级别所确定的视野范围状态。

参数：



无

返回值：



类型：number。

事件：

ROLL_BACK 事件。

注释：

该方法需与 savePosition 方法成对使用。

示例：

mapObj.returnToSavedPosition();

2.4.32 clearMap(clearType)

说明：

清除地图上的覆盖物和层。

参数：

（1）clearType

说明：清除类型

类型：constant

取值：CLEAR_ALL，删除所有覆盖物和层

CLEAR_MEASURES，删除测距测面结果

返回值：



类型：number。

事件：

CLEAR_OVERLAYS 事件

注释：

无

示例：

mapObj.clearMap(CLEAR_ALL);

添加覆盖物

2.4.33 addOverlay(overlay,isToFitView)

说明：

向地图添加覆盖物（如标记，线，面等）。

参数：

（1）overlay：

说明：地图覆盖对象，继承自 MOverlay 对象。

类型：MOverlay。



（2）isToFitView：

说明：设置是否为自动适应视野，默认为 false。当设置为 ture 时，所添加的点线

面覆盖物能自动适应地图视野级别。

类型：boolean。

返回值：



类型：number。

事件：

ADD_OVERLAY 事件。

当第二个参数为 true 时，触发 MAP_END 事件

注释：

当添加 GroudImage 时地图会自适应到初始加载 GroudImage 的视野级别，并且图片左

上角与地图左上角对齐。

当第二个参数为 true 时，只触发 MAP_END 事件，不触发 MAP_MOVE_START 和

MAP_MOVING 事件。因为该方法不是平移地图到合适位置，而是直接定位到该位置，

不存在地图平移的过程，所以没有开始移图和移图过程事件。

示例：

以下给出在地图上添加一个线状覆盖物的代码片。

var arr = new Array();

arr.push(new MLngLat(116.36890411376953 ,39.913423004886866));

arr.push(new MLngLat(116.38212203979492,39.9011768955094));



//设置线样式

var linest = new MLineStyle();

linest.alpha = 1;

linest.color = 0xFF3300;

linest.thickness = 3;

linest.lineType=LINE_SOLID;

//设置标注参数选项

var tipOption = new MTipOptions();

tipOption.title="title";

tipOption.content="content"; //tip 内容

//设置线的参数选项

var lineopt = new MLineOptions();

lineopt.lineStyle = linest;

lineopt.tipOption = tipOption;

lineopt.canShowTip = true;

//在地图上添加多折线覆盖物

var line = new MPolyline(arr,lineopt);

mapObj.addOverlay(line,true);



2.4.34 addOverlays(overlays,azc)

说明：

向地图添加一组覆盖物（如标记，线，面等）。

参数：

（1）overlays：

说明：地图覆盖对象数组，继承自 MOverlay 对象。

类型：Array。

（2）azc：

说明：是否自动调整视野到能在地图范围内显示这些 Overlays，默认为 false。

类型：boolean。

返回值：



类型：number。

事件：


注释：

无

示例：

在本例中，marker、line、polygon 分别是标注点、多折线、多边形的覆盖物。代码片将

三种覆盖物加到数组中，然后通过该方法同时显示到地图上。

var arr=new Array();

arr.push(marker);

arr.push(line);

arr.push(polygon);

mapObj.addOverlays(arr,true);

2.4.35 createLightMarker(x,y,id,imageUrl,picAgent,alpha,isDimorphic,dimorph

icColor)

说明：

向地图添加轻量级点覆盖物。

参数：

（1）x：

说明：点 X 坐标。

类型：string。

（2）y：

说明：点 Y 坐标。

类型：string。

（3）id：

说明：点的 ID。



类型：string。

（4）imageUrl：

说明：点图标的 Url 地址，如果为空则使用默认圆点形状的点图标。

类型：string。

（5）picAgent：

说明：点图标是否使用代理方式添加。

类型：Boolean。

（6）alpha：

说明：如果使用默认的点图标，点图标的透明度。

类型：number。

（7）isDimorohic：

说明：是否有二态效果。

类型：Boolean。

（8）dimorphicColor：

说明：二态效果的颜色。

类型：十六进制整数。

返回值：



类型：number。

事件：


注释：

本方法只适用于添加点覆盖物，所谓轻量级是指不用对象的形式创建点覆盖物，并且创

建的点覆盖物只包含几个属性。

使用代理方式加载点图标，可以方便用户不担心跨域问题，如果用户不选择使用代理方

式，则需要保证有权限控制文件。

示例：

mapObj. createLightMarker("116.397428", "39.90923", "mark1","", true, 1, true, 0xFF0000);

2.4.36 updateOverlay(overlay)

说明：

更新 MOverlay 对象，可以更新 MMarker、MPolyline 及 MArea 对象。使用该方法既可

以更新整个对象，也可以更新原始对象的部分属性特征。

参数：

（1）overlay：

说明：地图覆盖物对象，可以更新 MMarker、MPolyline 及 MArea 对象。


返回值：



类型：number。



事件：

无

注释：

使用该方法更新 marker 时不能更新其经纬度坐标。

示例：

以下代码片使用 updateOverlay()方法更新原始对象的部分属性特征。

function addLine() {







tipOption.title="多折线";

tipOption.content="这是一条多折线";

var lineOpt = new MLineOptions();

lineOpt.tipOption = tipOption;

lineOpt.canShowTip = true;

PolylineAPI = new MPolyline(arr,lineOpt);

PolylineAPI.id = "polylineapi";

mapObj.addOverlay(PolylineAPI,true);

}

function updateline() {

var obj= mapObj.getOverlayById("polylineapi");

obj.option.tipOption.title="更新后的线";

obj.option.tipOption.content="这是一个更新后的线";

obj.option.canShowTip=true;

mapObj.updateOverlay(obj);

}

2.4.37 setOverlayEditableById(overlayId,isEditable)

说明：

设置 overlay 是否为可编辑状态。

参数：

（1）overlayId：

说明：要修改的 overlay 对象的 id。

类型：string。

（2）isEditable：

说明：overlay 是否为可编辑状态。缺省该参数时，默认为不可编辑状态。

类型：boolean。

返回值:





类型：number。

事件：

无

注释：

背景图片目前无法编辑。

示例:

mapObj.setOverlayEditableById("polylineapi",true);

2.4.38 setOverlayToTopById(overlayId)

说明：

设置指定的覆盖物位于同类覆盖物的最顶层。

参数：

（1）overlayId：

说明：要置顶的 overlay 对象的 id。

类型：string。

返回值:



类型：number。

事件：

无

注释：

一般来讲，在地图引擎中点对象位于顶层，线对象位于中间层，面对像位于最底层，该

方法只能调整同类覆盖物之间的位置关系，并不能调整不同类覆盖物之间相对位置。

示例：

mapObj.setOverlayToTopById("marker"); //将 id 为"marker"的点覆盖物置于所有点的最

顶层

2.4.39 setOverlayVisibleById(overlayId,isVisible)

说明：

设置 overlay 是否显示。

参数:

（1）overlayId：

说明：覆盖物对象的 id。

类型：string。

（2）isVisible：

说明：指定 id 的覆盖物是否可见。

类型：boolean。

返回值：





类型：number。

事件：

无

注释：

当在 marker 移动时将其隐藏，则该 marker 停止移动

通过 zoomLevels 设定的隐藏显示状态比通过本方法设定的隐藏显示状态优先级高

示例：

mapObj.setOverlayVisibleById("marker ",true); //“marker”是加载到地图上的 marker 对

象的 id。

2.4.40 setOverlayDimorphicById(overlayId,dimorphic)

说明：

设置 overlay 是否二态。

参数:

（1）overlayId：

说明：覆盖物对象的 id。

类型：string。

（2）dimorphic：

说明：指定 id 的覆盖物是否二态。

类型：boolean。

返回值：



类型：number。

事件：

无

注释：

本方法支持点线面覆盖物。本方法不受鼠标事件控制。

示例：

mapObj.setOverlayDimorphicById ("marker",true); //“marker”是加载到地图上的点对

象的 id。

2.4.41 setFitview(overlays)

说明：

设置覆盖物到合适的地图视野级别。

参数：

（1）overlays：

说明：覆盖物对象列表或覆盖物对象 id 列表。

类型：array。

返回值：





类型：number。

事件：

ZOOM_CHANGED 事件、ZOOM_END 事件、MAP_MOVE_END 事件。

注释：

无

示例:

mapObj.setFitview(overlayArr);

2.4.42 setClusterState(state,clusterOption)

说明：

设置点聚合，只对点对象起作用。

参数：

（1）state：

说明：设置聚合的状态，

取值：MClusterOptions.NO_CLUSTER，不聚合（默认）；

MClusterOptions.NORMAL_CLUSTER，普通点聚合。

MClusterOptions.FLARE_CLUSTER，绽放效果点聚合


（2）clusterOption：

说明：点聚合参数选项。

类型：MClusterOptions。

返回值：



类型：number。

事件：

无

注释：

只对点对象起作用。

示例：

var clusterOptions=new MClusterOptions();

clusterOptions.gridSize=40;

clusterOptions.maxZoom=12;

map.setClusterState(MClusterOptions.NORMAL_CLUSTER, clusterOptions)

2.4.43 getOverlayById(overlayId)

说明：

通过 Id 获得指定的覆盖物对象，并可以通过该对象获得对象属性值。

参数：



（1）overlayId：

说明：覆盖物的 Id。

类型：string。

返回值：

说明：指定 Id 的覆盖物对象。

类型：参见 MOverlay。

事件：

无

注释：

要想获得指定覆盖物对象，首先必须添加该覆盖物。

示例：

var overlay=mapObj.getOverlayById("marker");

alert(overlay.lnglat.lngX);

2.4.44 getOverlaysByType(type)

说明：

根据 overlay 类型得到 overlay 对象。

参数：

（1）type:

说明：覆盖物的对象，

取值： MOverlay.TYPE


返回值：

说明：指定类型的覆盖物对象数组。

类型：array。

事件：

无

注释：

要想获得指定覆盖物对象，首先必须添加该覆盖物。

示例：

以下函数简单介绍了 getOverlaysByType(type)方法的使用。

function getOverlaysByType(type) {

var arr = mapObj.getOverlaysByType(type);

if(arr.length==0){

return ;

}

if(arr[0].TYPE==MOverlay.TYPE_MARKER){

alert(" 第一个对象的 Id 是 :"+arr[1].id+"; 位置点

是:"+arr[1].lnglat.lngX+";"+arr[1].lnglat.latY);

}

}



2.4.45 expOverlay(overlayId)

说明：

根据 overlayID 导出 json 形式的 overlay 对象。

参数：

（1）overlayId:


类型：string。

返回值：

说明：JSOM 格式的覆盖物对象：

（1）MMarker：

type：Point

id：MMarker.id

coordinates.x：点对象的 x 坐标

coordinates.y：点对象的 y 坐标

（2）MPolygon ：

type：Polygon

id：MPolygon.id

coordinates：坐标数组，每个元素根据属性 x，y 取得经纬度坐标

（3）MPolyline ：

type：Polyline

id：MPolyline.id

coordinates:坐标数组，每个元素根据属性 x，y 取得经纬度坐标

（4）MRectangle ：

type：Rectangle

id：MRectangle.id

coordinates：坐标数组，每个元素根据属性 x，y 取得经纬度坐标

（5）MCircle ：

type：Circle

id：MCircle.id

coordinates：中心点坐标

radius：MCircle.radius;

类型：（JSON）object。

事件：

无

注释：

无

示例：

var jason=mapObj.expOverlay("marker");

alert(jason.id+","+jason.type+","+jason.coordinates.x+";"+jason.coordinates.y);



2.4.46 removeOverlaysByType(type)

说明：

根据 overlay 类型删除 overlay 对象。

参数：

（1）type:

说明：覆盖物的对象

取值： MOverlay.TYPE。


返回值：



类型：number。

事件：

REMOVE_OVERLAY 事件。

注释：

无

示例：

mapObj.removeOverlaysByType(MOverlay.TYPE_MARKER); //删除所有的标识点

2.4.47 removeOverlay(overlay)

说明：

删除地图上指定的地图覆盖物。

参数：

（1）overlay：

说明：待删除的对象。


返回值：



类型：number。

事件：

REMOVE_OVERLAY 事件

注释：

无

示例：

mapObj.removeOverlay(line) ; //删除 line 覆盖物对象。

2.4.48 removeOverlays(overlays)

说明：

一次删除地图上多个覆盖物对象。



参数：

（1）overlays：

说明：待删除的覆盖物对象数组。

类型：array。

返回值：



类型：number。

事件：


注释：

无

示例：

mapObj.removeOverlays(arr) ;

2.4.49 removeOverlayById(overlayId)

说明：

删除地图上指定 id 的地图覆盖物。

参数：

（1）overlayId：

说明：待删除对象的 Id。

类型：string。

返回值:



类型：number。

事件：


注释：

无

示例：

mapObj.removeOverlayById("marker"); //删除 Id 为"marker"的对象

2.4.50 removeAllOverlays()

说明：

删除地图上所有的覆盖物(overlays)对象。

参数：

无

返回值：





类型：number。

事件：

CLEAR_OVERLAYS 事件

注释：

无

示例：

mapObj.removeAllOverlays(); //删除 mapObj 地图对象上所有覆盖物。

2.4.51 setDefaultMarkerOption(option)

说明：

设置默认 Marker 样式。

参数：

（1）option：

说明：marker 样式，遵从 MMarkerOptions 结构。

类型：MMarkerOptions。

返回值：

无

事件：

无

注释：

无

示例：

如下代码片介绍了设置默认点样式的方法。

function setDefaultMarkerOption() {//设置默认点样式


tipOption.title="点";

tipOption.content="<br>这是一个点！<br>"; //tip 内容

var labelOptions=new MLabelOptions();

var fontstyle = new MFontStyle(); //定义字体风格对象

fontstyle.name ="Arial";

fontstyle.size = 15;

fontstyle.color = 0xFFFF66;

fontstyle.bold = true;

labelOptions.fontStyle=fontstyle;

labelOptions.content= "MapABC!";

var markerOption = new MMarkerOptions();//点选项

markerOption.imageUrl="http://api.mapabc.com/flashmap/2.0/marker.png";

markerOption.labelOption=labelOptions;

markerOption.labelPosition = new MPoint(5,0);

markerOption.imageAlign=BOTTOM_CENTER;//设置图片锚点相对于图片的位置

markerOption.tipOption = tipOption;



markerOption.canShowTip= true;

mapObj.setDefaultMarkerOption(markerOption);

}

function addMarkerByMouseTool() {

var test=mapObj.setCurrentMouseTool(ADD_MARKER);

}

2.4.52 setDefaultLineOption(option)

说明：

设置默认线选项。

参数：

（1）option：

说明：线选项，遵从 MLineOptions 结构。

类型：MLineOptions。

返回值：

无

事件：

无

注释：

无

示例：

以下代码片首先创建一个 lineopt 对象，然后设置为默认样式，最后以此默认样式画一

条线。

var linest = new MLineStyle(); //创建一个 MLineStyle 对象

linest.alpha = 0.5;

linest.color = 0x00ff00 ;


var tipOption = new MTipOptions(); //创建一个 MTipOptions 对象



lineopt= new MLineOptions(); //创建一个 lineOptions 对象

lineopt.lineStyle = linest;



mapObj.setDefaultLineOption(lineopt);






var line1=new MPolyline(arr);//此处创建一 line1对象，第二个缺省参数即为默认的 lineopt

mapObj.addOverlay(line1);



2.4.53 setDefaultAreaOption(option)

说明：

设置默认面选项。

参数：

（1）option：

说明：面选项，遵从 MAreaOptions 结构。

类型：MAreaOptions。

返回值：

无

事件：

无

注释：

无

示例：

以下代码片首先创建一个 areOptions 对象，然后设置为默认样式，最后创建一个 polygon

对象，并添加到地图上。

var lineopt1= new MAreaStyle(); //多边形的样式

lineopt1.borderStyle.alpha = 1;

lineopt1.borderStyle.color = 0xFF3300;

lineopt1.borderStyle.thickness = 0.8;

lineopt1.fillStyle.alpha = 0.7;

lineopt1.fillStyle.color = 0xFF6600;

var tipOption = new MTipOptions();//tip 样式


tipOption.content="content";

tipOption.hasShadow= false;

var areopt = new MAreaOptions(); //areOptions 选项

areopt.areaStyle=lineopt1;

areopt.tipOption=tipOption;

areopt.canShowTip = true;

mapObj.setDefaultAreaOption(areopt);






var polygon=new MPolygon(arr); //创建多边形对象，使用默认的样式

mapObj.addOverlay(polygon); //添加到地图上



叠加层

2.4.54 addWMSLayer(options)

说明：

向地图上叠加 WMS 图层。

参数：

（1）options：

说明：WMS 层的参数选项。

类型：MWMSLayerOptions。

返回值：



类型：number。

事件：

无

注释：

无

示例：

mapObj.addWMSLayer(WMSLayerOptions);

2.4.55 addTileLayer(tileLayer)

说明：

向地图叠加切片图层，叠加的切片图层可以是用户编辑图层，也可以是实时交通图层或

轨道交通图层等。

参数：

（1）tileLayer：

说明：地图叠加切片图层对象。

类型：MTileLayer

返回值：



类型：number。

事件：

ADD_TILELAYER 事件。

注释：

无

示例 1：

var tileLayerOptions =new MTileLayerOptions(); //添加用户编辑器图层

tileLayerOptions.userId="20001";

tileLayerOptions.layerId="usermapTile";

var tl = new MTileLayer(TL_USERMAP,tileLayerOptions);



mapObj.addTileLayer(tl);

示例 2：

var tl = new MTileLayer(TL_TRAFFIC); //添加实时交通层


示例 3：

var tl = new MTileLayer(TL_MASS_TRANSIT); //添加轨道交通层


示例 4：

var tileLayerOptions =new MTileLayerOptions(); //添加用户自定义图层

tileLayerOptions.tileUrl =" http://切片取图地址?z=[z]&x=[x]&y=[y]";

tileLayerOptions.layerId="customTile";

var tl = new MTileLayer(TL_CUSTOM_MAP,tileLayerOptions);


2.4.56 addDataLayer(dataLayer)

说明：

向地图添加数据切片图层。

参数：

（1）dataLayer：

说明：地图数据切片图层对象。

类型：MDataLayer。

返回值：



类型：number。

事件：

无。

注释：

只支持点数据，同 addTileLayer(tileLayer)方法成对使用。

示例：

var dataLayerOptions =new MDataLayerOptions();

dataLayerOptions.url="http://";

var datalayer=new MDataLayer(“1”, dataLayerOptions);

mapObj.addDataLayer(datalayer);

2.4.57 addGradientMapLayer(options)

说明：

向地图添加渐变图层。渐变图层，是指给定多个点的经纬度坐标和 value 值，再指定三

种渐变颜色、点的最大显示半径、最小显示半径、value 值的上限，根据这些条件渲染出每



个点的显示范围和渐变颜色，并以图层的形式叠加在地图上。

参数：

（1）options：

说明：地图渐变图层对象。

类型：MGradientMapOptions。

返回值：



类型：number。

事件：

无。

注释：

无。

示例：

var options =new MGradientMapOptions();

options.pointsXMLString='<root>' +

'<point><x>116.1</x><y>39.1</y><value>170</value></point>' +





'<point><x>118.2</x><y>40.5</y><value>990</value></point></root>';

options.radiusRatio=1; //设置半径比率

options.maxValue=1000; //设置最大值

options.maxRadius=100; //设置最大半径

options.minRadius=10; //设置最小半径

options.colors=[0x00ff00,0x00ff0f,0xfff000]; //设置颜色

mapObj.addGradientMapLayer(options);

2.4.58 updateGradientMapLayer(options)

说明：

更新渐变图层。

参数：

（1）options：

说明：地图渐变图层对象。

类型：MGradientMapOptions。

返回值：



类型：number。

事件：

无。

注释：



目前更新方法仅对 radiusRatio，colors，alpha 属性有效。

示例：

var op =new MGradientMapOptions();

op.radiusRatio=0.2;

op.colors=[0x00ff00,0x00ff0f,0xfff000];

op.alpha=0.5;

mapObj.updateGradientMapLayer(op);

2.4.59 removeWMSLayer()

说明：

删除地图上叠加的 WMS 图层。

参数：

无

返回值：



类型：number。

事件：

无

注释：

无

示例：

mapObj.removeWMSLayer();

2.4.60 removeTileLayer(layerType,tileLayerId)

说明：

删除地图上的叠加图层。

参数：

（1）layerType：

说明：地图叠加层类型。

取值：TL_TRAFFIC，实时交通层

TL_USERMAP，用户编辑器图层

TL_MASS_TRANSIT，轨道交通图层

TL_SATELLITE，卫星图层

TL_CUSTOM_MAP，用户自定义图层

TL_REAL_ESTATE，房地产图层


（2）tileLayerId：

说明：地图叠加层 Id。删除 TL_TRAFFIC、TL_MASS_TRANSIT、TL_SATELLITE、

TL_REAL_ESTATE 图层时，不用指定此参数。



类型：string。

返回值：



类型：number。

事件：

无

注释：

删除 TL_TRAFFIC、TL_MASS_TRANSIT、TL_SATELLITE、TL_REAL_ESTATE 图层

时，不用指定 tileLayerId 参数。

示例：

mapObj.removeTileLayer(TL_TRAFFIC);

2.4.61 removeDataLayer(layerType,dataLayerId)

说明：

删除地图上的叠加数据图层。

参数：

（1）layerType：

说明：地图数据叠加层类型。

取值：留为扩展用，目前为空字符串。

类型：string。

（2）dataLayerId：

说明：地图数据层 ID。

类型：string。

返回值：



类型：number。

事件：

无

注释：

无。

示例：

mapObj.removeDataLayer("","layer1");

2.4.62 removeGradientMapLayer()

说明：

删除地图上的叠加渐变图层。

参数：

无

返回值：





类型：number。

事件：

无

注释：

无。

示例：

mapObj.removeGradientMapLayer();

右键菜单

2.4.63 addMenuItems(arr)

说明：

添加右键菜单的菜单项，传入的参数是数组，可以一次传入多个。

参数：

（1）arr:

说明：MMenuItem 实例化对象的数组。

类型：array。

返回值：

说明：返回 MMenuItem 的 id 数组，与传入的 MMenuItem 数组相对应。如果在传入

MMenuItem 对象有 id 时，直接把这个 id 返回，如果没有，自动生成一个 id。

类型：array。

事件：

无

注释：

无

示例：

下列代码片中的 menuItem1、menuItem 是已经实例化的 MMenuItem 对象。

arr.push(menuItem1);

arr.push(menuItem);

var test= mapObj.addMenuItems(ary);

2.4.64 removeMenuItem (menuItemId)

说明：

删除右键菜单子项。

参数：

（1）menuItemId：

说明：右键菜单的 id。

类型：string。

返回值：





类型：number。

事件：

无

注释：

无

示例:

mapObj.removeMenuItem('22') ;

信息窗口

2.4.65 openTip(position, tipOptions)

说明：

显示地图的信息窗口。

参数：

（1）position：

说明：信息窗口的显示位置。

类型：MLngLat。

（2）tipOptions：

说明：tip 窗口显示内容，显示风格选项。

类型：MTipOptions。

返回值：



类型：number。

事件：

TIP_OPEN 事件

注释：

无

示例:

本例中，tipOption 是事先定义好的 tip 选项对象。

mapObj.openTip(new MLngLat(116.39825820922851 ,39.904600759441024)

,tipOption);

2.4.66 openOverlayTip(overlayId)

说明：

显示 Overlay 对象的信息窗口。

参数：

（1）overlayId：

说明：要打开 tip 的覆盖物的 Id。



类型：string。

返回值:



类型：number。

相关事件：

TIP_OPEN 事件

注释：

无

示例：

本例中，“marker”是事先定义好的标注点的 id。

mapObj.openOverlayTip('marker');

2.4.67 closeTip()

说明：

关闭信息窗口。

参数：

无

返回值:

无

事件：

TIP_BEFORE_CLOSE 事件、TIP_CLOSE 事件

注释：

无

示例：

mapObj.closeTip(); //关闭 mapObj 对象上所有的信息窗口。

鼠标工具

2.4.68 setCurrentMouseTool(ctrlName, option)

说明：

设置鼠标当前功能。

参数:

（1）ctrlName:

说明：鼠标当前功能选项

取值：（a）PAN_WHEELZOOM：焦点模式下滚轮放大缩小，拖动移图

（b）ADD_MARKER：添加标注，受到 setDefaultMarkerOption 样式影响

（c）DRAW_LINE：画线，受到 setDefaultLineOption 样式影响

（d）DRAW_POLYGON：画多边形，受到 setDefaultAreaOption 样式影响

（e）DRAW_RECTANGLE：画矩形，受到 setDefaultAreaOption 样式影响

（f）DRAW_CIRCLE：画圆。画圆功能有 option 参数，该参数可设置的属



性值为：showRadius，布尔型，是否显示圆半径，默认为 false（不显示），，

受到 setDefaultAreaOption 样式影响

（g）RULER：测直线距离，当长度小于 1000 米时，结果单位为米；大于

等于 1000 米时，结果单位为公里，并保留小数点后两位。RULER 功能有

option 参数，该参数可设置的的属性为：hasCircle，布尔型，设置是否显示

测距圆，默认为 true（显示）；hasPrompt，布尔型，设置是否有"双击结束

"提示，默认为 true（有提示），受到 setDefaultLineOption 样式影响

（h）COMPUTE_AREA：测量多边形的面积，当面积小于 1000000 米时，

结果单位为平方米；大于等于 1000000 米时，结果单位为平方公里，并保

留小数点后两位，受到 setDefaultAreaOption 样式影响

（i）FRAME_ZOOMIN：拉框放大

（j）FRAME_ZOOMOUT：拉框缩小


（2）option:

说明：当前鼠标功能的参数设置，参数作为 option 的属性值传递，为可选项，目

前只应用到 RULER 和 DRAW_CIRCLE 功能上。

类型：object。

返回值：



类型：number。

事件：

（1）PAN_WHEELZOOM 能触发的事件类型：ZOOM_START 事件、ZOOM_END 事

件、ZOOM_CHANGED 事件 MAP_MOVE_START 事件、MAP_MOVE_END 事件、

MAP_MOVING 事件。

（2）ADD_MARKER、DRAW_RECTANGLE、DRAW_CIRCLE 能触发的事件：

MOUSE_DOWN 事件、MOUSE_UP 事件、MOUSE_CLICK 事件、ADD_OVERLAY 事

件

（3）DRAW_LINE 、DRAW_POLYGON 能触发的事件类型： MOUSE_UP 事件、

MOUSE_DOWN 事件、MOUSE_UP 事件、MOUSE_CLICK 事件、ADD_OVERLAY 事

件

（4）FRAME_ZOOMIN、FRAME_ZOOMOUT 能触发的事件类型：ZOOM_START 事

件、ZOOM_END 事件、ZOOM_CHANGED 事件

（5）RULER 能触发的事件类型： MEASURE_STEP 事件、MEASURE_END 事件、

ADD_OVERLAY 事件、MOUSE_DOWN 事件、MOUSE_UP 事件、MOUSE_CLICK 事

件、

（ 6 ） COMPUTE_AREA 能触发的事件类型： COMPUTE_AREA_END 事件、

ADD_OVERLAY 事件、MOUSE_DOWN 事件、MOUSE_UP 事件、MOUSE_CLICK 事

件。

注释：

无

示例:

mapObj.setCurrentMouseTool(DRAW_LINE); //通过鼠标画线

mapObj.setCurrentMouseTool(DRAW_RECTANGLE); //通过鼠标画矩形



mapObj.setCurrentMouseTool(DRAW_POLYGON); //通过鼠标画多边形

mapObj.setCurrentMouseTool(ADD_MARKER); //鼠标标注

mapObj.setCurrentMouseTool(PAN_WHEELZOOM); //通过鼠标滑轮放大、缩小、拖动地

图，此为鼠标默认的功能

mapObj.setCurrentMouseTool(COMPUTE_AREA);

mapObj.setCurrentMouseTool(FRAME_ZOOMIN);

mapObj.setCurrentMouseTool(FRAME_ZOOMOUT);

//以下为鼠标测距功能用法

var option={};

option.hasCircle=true;

option.hasPrompt=false;

mapObj.setCurrentMouseTool(RULER,option);

//通过鼠标画圆

var option={};

option. showRadius=false;

mapObj.setCurrentMouseTool(DRAW_CIRCLE,option);

GSP 行业应用

2.4.69 markerMoveAlong(markerId,lnglatArr,speed)

说明：

按照指定的路线移动 MMarker 对象。其中，路线是由一个经纬度坐标数组确定。

参数：

（1）markerId：

说明：待移动的 marker 对象的 id。

类型：string。

（2）lnglatArr：

说明：由经纬度坐标对象组成的数组，该数组确定移动路线，为必选项。

类型：MLngLats。

（3）speed：

说明：移动速度。

类型：number。

范围：正整数，默认为 2。

返回值：



类型：number。事件：

GPS_MOVEALONG_COMPLETE 事件

注释：

要想调用此方法，必须先使用MMap.addOverlay()方法将MMarker添加到地图上。同时，



此方法必须与 MMap.startMoveAlong()方法一起使用。

示例：






mapObj.markerMoveAlong("mark",arr,3);

2.4.70 startMoveAlong(markerId,isLoop)

说明：

开始移动指定的 marker 对象。

参数：

（1）markerId：

说明：要开始移动的 marker 的 id。

类型：string。

（2）isLoop：

说明：MMarker 对象是否沿着移动路线循环移动，默认为否。

类型：boolean。

返回值：



类型：number。

事件：

无

注释：

在调用此方法之前必须先使用 moveAlong()方法来设置移动路线。

示例：






mapObj.markerMoveAlong("mark",arr);

mapObj.startMoveAlong("mark",true);//“ marker”为 MMarker 对象的 id

2.4.71 pauseMoveAlong(markerId)

说明：

暂停正在运动中的 marker。

参数：

（1）markerId：



说明：要暂停的 marker 的 id。

类型：string。

返回值:



类型：number。

事件：

无

注释：

该方法只对 startMoveAlong 的移动起作用，对 MoveTo 功能不起作用。

示例：






mapObj.markerMoveAlong("mark",arr);

mapObj.startMoveAlong("mark");//”marker”为 MMarker 对象的 id

mapObj.pauseMoveAlong('marker');//暂停移动 marker

mapObj.startMoveAlong("mark");//继续移动 marker

2.4.72 stopMoveAlong(markerId)

说明：

停止移动覆盖物对象。

参数：

（1）markerId：

说明：指定 marker 对象的 id。

类型：string。

返回值：



类型：number。

事件：

无

注释：

在执行该方法前必须先执行 startMoveAlong()方法。

示例：

mapObj.stopMoveAlong("marker");

2.4.73 setGPSFocus(focusType,markerIds)

说明：



设置 marker 为 GPS 焦点模式。

参数：

（1）focusType：

说明：GPS 定位类型。


取值：NOFOCUS：非焦点模式（默认值）；

FOCUS ：GPS 对象移出地图时，地图自动移动到以 GPS 位置为中心；

CENTER_FOCUS：GPS 总是在地图中心（仅对单点开放）。

（2）markerIds：

说明：设置焦点的 Marker Id 列表，为空表示解除所有点的 GPS 焦点模式，默认空

数组。

类型：array。

返回值：

说明：如果返回值为 0，表示操作正确，如果非 0，则表示操作有误，对照附录的错误代

码表可以查看错误代码类型。

类型：number。

事件：

无

注释：

无

示例：


Arr.push(“marker1”);

Arr.push(“marker2”);

mapObj. setGPSFocus(FOCUS,arr);

2.4.74 markerMoveTo(markerId,lnglat,rotation,speed)

说明：

开始移动指定的 marker 对象。

参数：

（1）markerId：

说明：MMarker 对象的 id。

类型：string。

（2）lnglat：

说明：目标点的经纬度坐标。

类型：MLngLat。

（3）rotation：

说明：MMarker 的 icon 在移动过程中顺时针旋转的角度。此参数为可选参数，默

认为不旋转。范围为 0-360。

类型：number。

（4）speed：

说明：MMarker 的 icon 的移动速度。此参数为可选参数。

取值：0-1，0 为直接跳转到目标位置，无移动效果；值越大，移动速度越慢；默



认值为 0。

类型：number。

返回值：



类型：number。

事件：

无

注释：

要想调用此方法，必须先使用 MMap.addOverlay()方法在地图上添加 marker 对象。

示例：

mapObj.markerMoveTo("mark", new MLngLat (116.39825820922851 ,

39.904600759441024),30, 1);

注册（反注册）事件

2.4.75 addEventListener(object,eventType,functionname)

说明：

添加（注册）事件处理函数，当 eventType 事件发生时，执行 object 对象的 functionName

方法。

参数：

（1）object：

说明：事件发生的对象。

类型：object。

（2）eventType：

说明：事件类型。

取值：MAP_READY：地图准备完毕

TIP_OPEN：打开 tip

TIP_CLOSE：关闭 tip

TIP_BEFORE_CLOSE：tip 关闭之前

ADD_OVERLAY：添加 overlay

REMOVE_OVERLAY：删除 overlay

CLEAR_OVERLAYS：删除所有覆盖物对象

MOUSE_CLICK：单击鼠标左键

MOUSE_DBCLICK：双击鼠标左键

MOUSE_DOWN：鼠标键落下

MOUSE_UP：鼠标键抬起

MOUSE_MOVING：鼠标移动过程中

MOUSE_OVER：鼠标移到地图上

MOUSE_OUT：鼠标移出地图

DRAG_START：开始拖拽

DRAGGING：拖拽过程中



DRAG_END：结束拖拽

MAP_MOVE_START：地图开始移动

MAP_MOVING：地图移动过程中

MAP_MOVE_END：地图结束移动

ZOOM_START：开始缩放

ZOOM_END：结束缩放

ZOOM_CHANGED：缩放级别改变

ROLL_BACK：地图状态回滚

MEASURE_STEP：测量一次直线距离

MEASURE_END：测量结束

COMPUTE_AREA_END：测量面积结束

MENUITEM_CLICK：单击菜单

GPS_MOVEALONG_COMPLETE：调用 markerMoveAlong 方法，移动结束时

ADD_TILELAYER：添加 tileLayer 图层

TILE_MOUSE_OVER；鼠标移动到切片图层上

OVERVIEWMAP_CHANGE：改变鹰眼地图状态

RADAR_INITIALIZED：全景地图雷达初始化

RADAR_POSITION_CHANGED：全景地图雷达位置改变

RADAR_ROTATION_CHANGED：全景地图雷达角度改变


（4）functionName:

说明：事件函数的引用。

类型：function。

返回值：



类型：number。

事件：

无

注释：

可以向一个事件注册多个事件处理函数，在事件发生时，事件处理函数按注册时的顺序

执行。

示例：

下面的代码片段定义了一个函数，执行的操作为隐藏鹰眼。然后把这个函数注册到开始

缩放地图事件上，当开始缩放地图时时，执行该方法，结果为缩放地图之前，隐藏鹰眼。

function startZoom(event)

{

mapObj.setOverviewState(HIDE);

}

mapObj.addEventListener(mapObj,ZOOM_START,startZoom);

2.4.76 removeEventListener(object,eventType,functionName)

说明：



注销事件。

参数：

（1）object：

说明：事件发生的对象。

类型：object。

（2）eventType：

说明：事件类型，具体见 addEventListener()方法中列出的所有事件类型。


（3）functionName:

说明：事件函数的引用。

类型：function。

返回值：



类型：number。

事件：

无

注释：

无

示例：

下面的代码片段卸载了一个地图完成事件函数。

mapObj.removeEventListener(mapObj,MAP_READY, mapReady);

2.4.77 removeClosuresListeners()

说明：

注销所有闭包形式注册的事件（匿名函数）。

参数：

无

返回值：



类型：number。

事件：

无

注释：

无

示例：

mapObj. removeClosuresListeners ();



地图工具

2.4.78 calculateDistance(IIs)

说明：

计算多点的距离。

参数：

（1）IIs：

说明：表示由多点的经纬度坐标组成的数组。

类型：array。

返回值:

说明：返回一个距离数组，其中数组第一个值为各段距离总和，之后的值为各段分距离。

类型：array。

事件：

无

注释：

无

示例:






alert(mapObj.calculateDistance(arr));

2.4.79 fromLngLatToContainerPixel(lnglat)

说明：

将点的经纬度坐标转换成容器的屏幕坐标。

参数：

（1）lnglat：

说明：点的经纬度坐标。

类型：MLngLat。

返回值:

说明：返回点的屏幕坐标。

类型：MPoint。

事件：

无

注释：

无

示例:

var lng=mapObj.getCenter().lngX;

var lat=mapObj.getCenter().latY;



var pixel=mapObj.fromLngLatToContainerPixel(new MLngLat(lng,lat));

alert(pixel.x+";"+pixel.y);

2.4.80 fromContainerPixelToLngLat(containerPt)

说明：

将点的屏幕坐标转换为经纬度坐标。

参数：

（1）containerPt：

说明：点的屏幕坐标。

类型：MPoint。

返回值：

说明：返回点的经纬度坐标。

类型：MLngLat。

事件：

无

注释：

无

示例：

var lnglat=mapObj.fromContainerPixelToLngLat(new MPoint(250,150));

alert(lnglat.lngX+";"+lnglat.latY);

2.4.81 saveMap2JPG()

说明：

将当前地图保存为 jpg 图片。

参数：

无

返回值：

无

事件：

无

注释：

不能保存工具条、鹰眼，同时也不能保存叠加到地图上的 div、图片和信息窗中的图片。

IE 浏览器下，保存图片为当前页面直接跳转。

示例:

mapObj.saveMap2JPG();

2.4.82 printMap()

说明：

打印当前地图。

参数：



无

返回值：

无

事件：

无

注释：

不能打印工具条、鹰眼，同时也不能保存叠加到地图上的 div、图片和信息窗中的图片。

示例:

mapObj.printMap();

3 MMapOptions()

3.1 说明

此类代表 MMap 构造函数的可选参数，用来设置地图初始化时的中心点坐标、缩放级别、

工具条 url 地址、工具条在地图中的显示位置、要加载的鹰眼 url 地址及返回坐标类型等。

3.2 命名空间

com.mapabc.maps.api.MMapOptions。

3.3 构造方法

3.3.1 MMapOptions()

说明：

地图参数选项对象。

参数：

无

注释：

无

示例：

var mapOptions=new MMapOptions();

3.4 属性

3.4.1 zoom

说明：



要加载的地图的缩放级别。

类型：

number。

取值：

范围 minZoomLevel~maxZoomLevel。

默认范围 3~17

注释：

无

3.4.2 center

说明：

要加载的地图的中心点经纬度坐标。

类型：

MLngLat。

取值：

偏明码坐标的范围：经度方向上为-180-180，纬度方向上为-90-90。

注释：

无

3.4.3 toolbarUrl

说明：

要加载的鱼骨条的url。

类型：

string。

注释：

用户可以指定此属性为自己的 url。当用户指定自己的 url 时，可能会存在跨域问题。解

决方案如下：第一步，将 crossdomain.xml 文件拷贝到顶级域名下，即用”http://顶级域

名/crossdomain.xml“地址能访问到 crossdomain.xml 文件；第二步，在.SWF 中加入如下

代码： AS3 ： flash.system.Security.allowDomain("*");AS2 ：

System.security.allowDomain("*")。注意，所有 as2 编写的 swf 能正常加载，但是不一定

能响应所有事件。

3.4.4 toolbar

说明：

设置地图初始化工具条。

类型：

constant。

取值：

DEFAULT，默认工具条，

BLACK，黑色工具条，



SMALL，小工具条，

MINI，迷你工具条，

ROUND，新版圆工具条。

注释：

同时设置 toolbarUrl 和 toolbar 属性时，以 toolbarUrl 属性为准。

3.4.5 toolbarPos

说明：

工具条在地图上的显示位置。

类型：

MPoint。

取值：

取值范围：x 方向上为 0-width，y 方向上为 0-height。

注释：

无

3.4.6 overviewMap

说明：

设置鹰眼地图的状态。

类型：

constant。

取值：

SHOW，显示，

HIDE，隐藏（默认），

MINIMIZE，最小化。

注释：

无

3.4.7 scale

说明：

设置地图初始化比例尺

类型：

constant。

取值：

SHOW，显示（默认），

HIDE，隐藏。

注释：

无



3.4.8 isCongruence

说明：

是否能在地图上叠加 div 层。

类型：

boolean。

取值：

true，能叠加（默认），

false，不能叠加。

注释：

无

3.4.9 returnCoordType

说明：

返回坐标类型。

类型：

constant。

取值：

COORD_TYPE_ENCODE，加密坐标，

COORD_TYPE_OFFSET，偏移明码坐标（默认）。

注释：

无

3.4.10 hasDefaultMenu

说明：

是否添加默认的菜单项。

类型：

boolean。

取值：

true，添加默认菜单项（默认），

false，不添加默认菜单项。

注释：

无

3.4.11 OVZoomLevels

说明：

鹰眼地图的缩放级别，范围为 0~14。

类型：

array。

取值：



可以是只包含单个元素的数组，也可以是不连续数组。

注释：

当设置该属性的值为单个元素的数组如[n]（n 为小于等于 14 的整数）时，则鹰眼地图

仅在 0-n 缩放级别内取图；当该属性的值为由连续元素组成的数组，如[n-1,n,n+1]（n

为大于 0 小于 14 的整数）时，鹰眼地图仅在 0-n+1 缩放级别内取图；当该属性的值为

不连续元素组成的数组，如[n-2,n,n+2](n 为大于 1 小于 13 的正整数)时，则鹰眼地图仅

在 0-n-2、n、n+2 缩放级别内取图。

3.4.12 language

说明：

设置中英文地图类型。

类型：

constant。

取值：

MAP_CN，中文地图（默认），

MAP_EN，英文地图。

注释：

无

3.4.13 fullScreenButton

说明：

设置是否显示地图初始化全屏按钮。

类型：

constant。

取值：


HIDE，隐藏。

注释：

无

3.4.14 centerCross

说明：

设置是否在地图上显示中心十字。

类型：

Constant。

取值：


HIDE，隐藏。

注释：

无



3.4.15 minZoomLevel

说明：

设置地图上可显示的最小缩放级别。

类型：

number。

取值：

取值范围：3~maxZoomLevel。

默认为 3

注释：

当 zoom 属性设置的值小于该属性值时，初始化缩放级别为该属性值。

minZoomLevel 应该小于 maxZoomLevel。

3.4.16 maxZoomLevel

说明：

设置地图上可显示的最大缩放级别。

类型：

number。

取值：

取值范围：minZoomLevel~totalLevel。

默认为 17

注释：

当 zoom 属性设置的值大于该属性值时，初始化缩放级别为该属性值。

maxZoomLevel 属性必须小于等于 totalLevel 属性。

3.4.17 totalLevel

说明：

设置地图总缩放级别。

类型：

number。

取值：

取值 3~20

默认 17。

注释：

maxZoomLevel 属性必须小于等于 totalLevel 属性。

设置 totalLevel 时，所有小于等于 totalLevel 的地图底图必须存在，才能有效。



3.4.18 viewBounds

说明：

设定地图可显示的经纬度范围。

类型：

MLngLatBounds。

取值：

取值范围为（-180，-90）-（180，90）。

注释：

minZoomLevel、maxZoomLevel 属性值的设置可能会影响到 viewBounds 属性的设置。

3.4.19 logoUrl

说明：

要加载 logo 的 url。

类型：

string。

取值：

网络可获取的 url。

注释：

不设置此参数时显示内置 logo。

3.4.20 groundLogo

说明：

要加载背景水印图片。

类型：

string。

取值：

（1）网络可获取的 url，用户定义背景水印图片

（2）SHOW，显示 mapabc 水印（默认）

（3）HIDE，隐藏 mapabc 水印，空的灰色背景

注释：

无

3.4.21 mapComButton

说明：

设置地图右上角的“新增商户”组件是否显示。

类型：

constant。

取值：




HIDE，隐藏。

注释：

无

3.4.22 requestNum

说明：

切片请求并发数。

类型：

number。

取值：

默认 100。

注释：

此参数平衡载图速度和拖拽地图性能之间的关系。并发数越大，载图速度越快，拖拽地

图性能越慢。

3.5 方法

无

3.6 示例

var mapOptions=new MMapOptions();

mapOptions.zoom=12;

mapOptions.center= new MLngLat(116.39825820922851 ,39.904600759441024);

mapOptions.toolbar=DEFAULT;

mapOptions.toolbarPos=new MPoint(0,0);

mapOptions.overviewMap=SHOW;

mapOptions.returnCoordType = COORD_TYPE_OFFSET;

mapOptions.OVZoomLevels=[8,9,10];//地图缩放级别为 11,12,13 时，鹰眼地图中显示的内容

是一样的，即都是 zoomLevels=11 时内容。

mapOptions.fullScreenButton=HIDE;

mapOptions.centerCross=HIDE;

mapOptions.minZoomLevel=5;

mapOptions.maxZoomLevel=15;

mapOptions.viewBounds=new MLngLatBounds(new MLngLat(47.34,20.23),new

MLngLat(145.34,69.78));

var mapObj=new MMap("mapObj",mapOptions);



4 MMenuItem()

4.1 说明

构造一个菜单类对象，该对象对应的菜单类型分为两种：一种为类型菜单(classMenu)，

一种为独立菜单(singleMenu)，由 menuType 属性决定添加的是哪种菜单。注意当一个覆盖

物(MOverlay)添加了两种菜单，独立菜单会替换掉类型菜单，即独立菜单优先级最高。

4.2 命名空间

com.mapabc.maps.api.MMenuItem。

4.3 构造方法

4.3.1 MMenuItem()

说明：

在地图上添加的右键菜单对象。

参数：

无

注释：

菜单对象分为两种类型：一种为类型菜单(classMenu)，一种为独立菜单(singleMenu)，

由 menuType 属性决定添加的是哪种菜单。注意当一个覆盖物(MOverlay)添加了两种菜

单，独立菜单会替换掉类型菜单，即独立菜单优先级最高。

如果覆盖物图标为 swf格式，需为 actionscript3.0 编写的 swf，如果用低等级的 actionscript

语言编写的写的 swf 系统无法触发该覆盖物的菜单。

示例：

var menuItem = new MMenuItem();

4.4 属性

4.4.1 menuType

说明：

菜单的类型。

类型：

string。

取值：



"classMenu"，类型菜单（默认），即给一类覆盖物对象添加菜单，

"singleMenu"，独立菜单，即给单独一个覆盖物添加菜单。

注释：

注意只有在覆盖物已经创建的情况下菜单才能添加成功。并且当一个覆盖物(MOverlay)

添加了两种菜单，独立菜单会替换掉类型菜单，即独立菜单优先级最高。

4.4.2 objectType

说明：

拥有菜单的地图或覆盖物类型。

类型：

constant。

取值：

""为空字符串，代表地图菜单。其他参照 MOverlay.TYPE。

注释：

此属性仅当 menuType 为类型菜单时生效。目前只有地图、点、线、面对象有类型菜单。

4.4.3 overlayId

说明：

拥有菜单的覆盖物对象 Id。

类型：

string。

取值：

添加到地图上的覆盖物的 id。

注释：

此属性仅当 menuType 为独立菜单时生效。目前只有点、线、面对象有独立菜单。

4.4.4 order

说明：

菜单顺序号，数字从小到大对应菜单从上到下。

类型：

number。

注释：

两种类型菜单通用。

4.4.5 menuText

说明：

菜单项名称。

类型：

string。



注释：

无

4.4.6 functionName

说明：

单击菜单执行的函数操作。

类型：

function。

注释：

无

4.4.7 isEnabled

说明：

菜单项是否可用，菜单项不可用，会变成灰色。

类型：

boolean。

取值：

true，可用（默认），

false，不可用。

注释：

无

4.4.8 isHaveSeparator

说明：

菜单项上方是否显示分隔条。

类型：

boolean。

取值：

true，有分隔条，

false，无分隔条（默认）。

注释：

无

4.4.9 id

说明：

用户自定义菜单项 id，在菜单单击事件中输出此参数。

类型：

string。

注释：



如果用户没有设置此项，系统会为菜单项设置系统默认 id。如果定义了相同的菜单项

id，则新定义的菜单项会删除并替换旧菜单项，两种类型菜单通用。

示例：

例一：

将菜单绑定到 marker 类对象上。

var menuItem=new MMenuItem();

menuItem.menuType="classMenu";;

menuItem.objectType=MOverlay.TYPE_MARKER;

menuItem.order=1;

menuItem.menuText="123";

menuItem.functionName=test;

menuItem.id="11";

menuItem.isEnabled=true;

例二：

将菜单绑定到指定覆盖物上。

var menuItem=new MMenuItem();

menuItem.menuType="singleMenu";;

menuItem.overlayId="marker";

menuItem.order=1;

menuItem.menuText="123";

menuItem.functionName=test;

menuItem.id="11";

menuItem.isEnabled=true;

命名空间：com.mapabc.maps.api.overlays

5 MOverlay()

5.1 说明

覆盖在地图表面，随地图移动而移动的所有对象都叫覆盖类(overlay)。MOverlay 是

MLabel、MGroundImage、MMarker、MPolyline、MArea 等的父类。

5.2 命名空间

com.mapabc.maps.api.overlays.MOverlay。



5.3 构造方法

5.3.1 MOverlay(id)

说明：

构造一个 MOverlay 对象，一般不直接创建 MOverlay 的实例，而是创建其子类的实例，

在子类的初始化过程中调用 MOverlay 的构造函数。

参数：

（1）id：

说明：覆盖图的 Id。如果用户没有指定，则按 Moverlay 实例的顺序编号。

类型：string。

注释：

无

5.4 属性

5.4.1 id

说明：

对象编号，也是对象的唯一标识。

类型：

string。

注释：

如果用户没有指定，则系统自定义分配。

5.4.2 TYPE

说明：

MOverlay 的类型。

类型：

constant。

取值：

MOverlay.TYPE_MARKER

MOverlay.TYPE_LABEL

MOverlay.TYPE_GROUNDIMAGE

MOverlay.TYPE_POLYLINE

MOverlay.TYPE_POLYGON

MOverlay.TYPE_CIRCLE

MOverlay.TYPE_RECTANGLE

MOverlay.TYPE_AREA

MOverlay.TYPE_RADAR



注释：

无

示例：

marker.id="marker1";

marker.type=MOverlay.TYPE_MARKER;

5.5 常量

5.5.1 TYPE_MARKER

说明：

覆盖物常量，点。

示例：

MOverlay.TYPE_MARKER。

5.5.2 TYPE_RADAR

说明：

覆盖物常量，全景地图雷达标注。

示例：

MOverlay.TYPE_RADAR。

5.5.3 TYPE_LABEL

说明：

覆盖物常量，标签。

示例：

MOverlay.TYPE_LABEL。

5.5.4 TYPE_GROUNDIMAGE

说明：

覆盖物常量，背景图片。

示例：

MOverlay.TYPE_GROUNDIMAGE。

5.5.5 TYPE_POLYLINE

说明：

覆盖物常量，线。

示例：



MOverlay.TYPE_POLYLINE。

5.5.6 TYPE_POLYGON

说明：

覆盖物常量，多边形。

示例：

MOverlay.TYPE_POLYGON。

5.5.7 TYPE_CIRCLE

说明：

覆盖物常量，圆。

示例：

MOverlay.TYPE_CIRCLE。

5.5.8 TYPE_RECTANGLE

说明：

覆盖物常量，矩形。

示例：

MOverlay.TYPE_RECTANGLE。

5.5.9 TYPE_AREA

说明：

覆盖物常量，面。

示例：

MOverlay.TYPE_AREA。

6 MMarker()

6.1 说明

MMarker 标注地图上点的位置，它实现 MOverlay 接口，因此可以用 addOverlay()方法

添加到地图中。标记对象包含 lnglat(这是标记在地图中锚定的地理位置）和 option。如果在

构造函数中未设置 option，则使用默认的选项。将信息窗口添加到地图中后，可在地图中通

过其标记打开它。标记对象会触发鼠标事件、信息窗口事件和拖拽事件等。



6.2 命名空间

com.mapabc.maps.api.overlays.MMarker。

6.3 继承

MOverlay->MMarker

6.4 构造方法

6.4.1 MMarker(lnglat,option)

说明：

通过经纬度坐标及参数选项确定标注信息。

参数：

（1）lnglat:

说明：描述 marker 显示的位置。

类型：MLngLat。

（2）option：

说明：参数选项，参照 MMarkerOptions，未设置时采用默认选项。

类型：MMarkerOptions。

注释：

当用户不设置 option参数时，地图会显示系统默认的marker样式，此样式无 label和 tip，

与使用 setDefaultMarkerOption 方法后再创建默认样式的 marker 对象不同。

示例：

下面的代码片给出创建 MMarker 对象的方法，其中 opion 参数采用默认方式。

var ll = new MLngLat(116.39825820922851 ,39.904600759441024);

var marker = new MMarker(ll);

6.5 属性

6.5.1 id

说明：


类型：

string。

注释：

无。



6.5.2 TYPE

说明:

覆盖物的类型。

类型：

constant。

取值：

MOverlay.TYPE_MARKER

注释：

无

6.5.3 lnglat

说明：

描述 marker 显示的位置

类型：

MLngLat。

注释：

无

6.5.4 option

说明：

Marker 的参数选项，参照 MMarkerOptions。

类型：

MMarkerOptions。

注释：

无

6.5.5 size

说明：

marker 的宽度高度信息。

类型：

MSize。

注释：

只读属性。要想获取此对象首先需要调用 getOverlayById()方法得到 marker 对象。

示例：

var object=mapObj.getOverlayById(Mmarker.id);

alert(object.id+"||"+object.TYPE+"||"+object.lnglat.lngX+"||"+object.lnglat.latY+"||"+

object.o ption.tipOption.content+"||"+object.size.width+"||"+object.size.height);



7 MRadar ()

7.1 说明

MRadar 是实景地图雷达标注，它实现 MOverlay 接口，因此可以用 addOverlay()方法添

加到地图中。

7.2 命名空间

com.mapabc.maps.api.overlays.MRadar。

7.3 继承

MOverlay->MRadar

7.4 构造方法

7.4.1 MRadar(lnglat,option)

说明：

通过经纬度坐标及参数选项确定实景地图雷达标注信息。

参数：

（1）lnglat:

说明：描述实景地图雷达的显示位置。

类型：MLngLat。

（2）option：

说明：参数选项，参照 MRadarOptions，未设置时采用默认选项。

类型：MRadarOptions。

注释：

不支持 setOverlayVisibleById()方法。

示例：

var ll = new MLngLat(116.39825820922851,39.904600759441024);

var radarOptions=MRadarOptions();

var radar = new MRadar(ll, radarOptions);



8 MLabel()

8.1 说明

通过使用MLabel可以创建 label对象，便于在地图上直接显示 label。它有两个参数 lngLat

与 option，lnglat 用来标定 label 显示的位置，option 用来设置 label 的字体样式、内容等。

8.2 命名空间

com.mapabc.maps.api.overlays.MLabel。

8.3 继承

MOverlay->MLabel

8.4 构造方法

8.4.1 MLabel(lnglat,option)

说明：

通过经纬度坐标及参数选项确定 label 信息。

参数：

（1）lnglat:

说明：描述 label 显示的位置。

类型：MLngLat。

（2）option：

说明：参数选项，参照 MLabelOptions，未设置时采用默认选项。

类型：MLabelOptions。

注释：

无

示例 1：











var label=new MLabel(new MLngLat(116.39825820922851 ,39.904600759441024),

labelOptions);

mapObj.addOverlay(label);

示例 2：


labelOptions.fontStyle.name ="Arial";

labelOptions.fontStyle.size = 15;

labelOptions.fontStyle.color = 0xFFFF66;

labelOptions.fontStyle.bold = true;


var label=new MLabel(new MLngLat(116.39825820922851 ,39.904600759441024),

labelOptions);

mapObj.addOverlay(label,true);

8.5 属性

8.5.1 id

说明：


类型：

string。

注释：

无

8.5.2 TYPE

说明：

MLabel 的类型

类型：

constant。

取值：

MOverlay.TYPE_LABEL

注释：

无

8.5.3 lnglat

说明：

label 显示的位置

类型：

MLngLat。



注释：

无

8.5.4 option

说明：

Label 的参数选项，参照 MLabelOptions。

类型：

MLabelOptions。

注释：

无

示例：

var newLabel=mapObj.getOverlayById(label.id);

alert(newLabel.id+"||"+newLabel.TYPE+"||"+newLabel.lnglat.lngX+"||"+

newLabel.lnglat.latY+"||"+newLabel.option.content);

9 MPolyline()

9.1 说明

创建多折线对象，继承自 MOverlay。

9.2 命名空间

com.mapabc.maps.api.overlays.MPolyline。

9.3 继承

MOverlay->MPolygline

9.4 构造方法

9.4.1 MPolyline(lnglatArr,option)

说明：

通过经纬度坐标数组及参数选项构建多折线对象。

参数：

（1）lnglatArr：

说明：经纬度坐标数组。



类型：array。

（2）option：

说明：参数选项，参照 MLineOptions。

类型：MLineOptions。

注释：

无

示例：

本例中 lineOptions 是事先定义好的。lineOptions 的定义请参照 MLineOptions 示例。






var line=new MPolyline(arr,lineOption);

9.5 属性

9.5.1 id

说明：


类型：

string。

注释：

无

9.5.2 TYPE

说明：

覆盖物(overlay)的类型。

类型：

constant。

取值：

MOverlay.TYPE_POLYLINE

注释：

无

9.5.3 lnglatArr

说明：

线的经纬度坐标数组。

类型：



MLngLats。

注释：

无

9.5.4 option

说明：

polyline 的参数选项，参照 MLineOptions。

类型：

MLineOptions。

注释：

无

示例：

var object=mapObj.getOverlayById(PolylineAPI.id);

var lineInfor=object.id+"||"+object.TYPE+"||"+object.option.tipOption.content+";";

for (var i=0;i<object.lnglatArr.length ;i++ )

{lineInfor+= object.lnglatArr[i].lngX+";"+object.lnglatArr[i].latY+"||";}

alert(lineInfor);

10 MArea()

10.1 说明

构建覆盖面对象，以便能在地图上显示。参数设置、构造方法均类似于 MPolyline。MArea

与 MLabel、MMarker、MPolyline 一起继承父类 MOverlay 的属性及方法，同时又将属性、

方法传递到子类上。一般我们并不直接构造 MArea 对象，而是构建其子类的对象。

10.2 命名空间

com.mapabc.maps.api.overlays.MArea。

10.3 继承

MOverlay->MArea



10.4 构造方法

10.4.1 MArea(lnglatArr, option)

说明：

构建覆盖面对象。

参数：

（1）lnglatArr：

说明：经纬度数组。


（2）option：

说明：参数选项，参照 MAreaOptions。


注释：

无

10.5 属性

10.5.1 TYPE

说明：

覆盖物类型。

类型：

constant。

取值：

MOverlay.TYPE_AREA

注释：

无

11 MRectangle()

11.1 说明

描述矩形面对象，继承自 MArea。

11.2 命名空间

com.mapabc.maps.api.overlays.MRectangle。



11.3 继承

MOverlay->MArea->MRectangle

11.4 构造方法

11.4.1 MRectangle(lnglatArr, option)

说明：

通过由左上、右下角组成的经纬度数组和参数选项构建矩形对象。

参数：

（1）lnglatArr：

说明：左上、右下角组成的经纬度数组。


（2）option：

说明：参数选项，参见 MAreaOptions。


注释：

无

示例：




var lineopt = new MAreaStyle();

//多边形的样式

lineopt.borderStyle.alpha = 0.7; //透明度，默认 1，范围 0~1

lineopt.borderStyle.color = 0x00FF33; //线颜色，默认黑色

lineopt.borderStyle.thickness = 3; //线粗细度，默认 3

lineopt.borderStyle.lineType=LINE_SOLID;

//填充色

lineopt.fillStyle.alpha = 0.3;

lineopt.fillStyle.color = 0x99FF33;

//tip 样式




tipOption.hasShadow= false; //是否有阴影

//面的参数选项

var areopt = new MAreaOptions();

areopt.areaStyle=lineopt;





var rect = new MRectangle(arr,areopt); //构建矩形对象

mapObj.addOverlay(rect);

11.5 属性

11.5.1 id

说明：


类型：

string。

注释：

无

11.5.2 TYPE

说明：

覆盖物类的型。

类型：

constant。

取值：

MOverlay.TYPE_RECTANGLE

注释：

无

11.5.3 lnglatArr

说明：

左下、右上角组成的经纬度数组。

类型：

MLngLats。

注释：

无

11.5.4 option

说明：

rectangle 的参数选项，参照 MAreaOptions。

类型：

MAreaOptions。

注释：

无



示例：

var object=mapObj.getOverlayById(Overlay.id);

var rectInfor=object.id+"||"+object.TYPE;


{rectInfor+= object.lnglatArr[i].lngX+";"+object.lnglatArr[i].latY+"||";}

alert(rectInfor);

12 MCircle()

12.1 说明

构建圆对象，继承自 MArea。

12.2 命名空间

com.mapabc.maps.api.overlays.MCircle。

12.3 继承

MOverlay->MArea->MCircle

12.4 构造方法

12.4.1 MCircle(lnglat, radius, option)

说明：

利用圆的中心点、圆半径及 option 选项来创建圆对象。

参数：

（1）lnglat:

说明：圆的中心点经纬度坐标。

类型：MLnglat。

（2）radius:

说明：圆的半径。

类型：number。

（3）option:

说明：参数选项，参见 MAreaOptions。




注释：

无

示例：


arr.push(new MLngLat("JIOMSLKNLMLDPP","LQGWWMIWODLHL"));

arr.push(new MLngLat("JIOMROPWONHLHP","LQGWYKQVLLLL"));



lineopt.borderStyle.alpha = 0.7; //透明度，默认 1，范围 0~1

lineopt.borderStyle.color = 0xFFFF66; //线颜色，默认黑色

lineopt.borderStyle.thickness = 3; //线粗细度，默认 3

lineopt.borderStyle.lineType= LINE_SOLID;//线类型

//填充色

lineopt.fillStyle.alpha = 0.5;

lineopt.fillStyle.color = 0xFFFF99;

//tip 样式



tipOption.anchor = new MPoint(0,0); //图片锚定点，MPoint 类型







var line = new MCircle(arr,areopt);//构建圆对象

mapObj.addOverlay(line);

12.5 属性

12.5.1 id

说明：


类型：

string。

注释：

无

12.5.2 TYPE

说明：



覆盖物类的型。

类型：

constant。

取值：

MOverlay.TYPE_CIRCLE

注释：

无

12.5.3 center

说明：

圆的中心点坐标。

类型：

MLngLat。

注释：

无

12.5.4 radius

说明：

圆的半径，单位为米。

类型：

number。

注释：

无

12.5.5 option

说明：

MCircle 类的参数选项，参照 MAreaOptions。

类型：

MAreaOptions。

注释：

无

12.5.6 bounds

说明：

圆外接矩形的经纬度坐标范围。

类型：

MLngLatBounds。

注释：

无



示例：


var circleInfor=object.id+"||"+object.TYPE+"||"+ object.radius;

alert(circleInfor);

13 MPolygon()

13.1 说明

描述多边形面的覆盖物，继承自 MArea。

13.2 命名空间

com.mapabc.maps.api.overlays.MPolygon。

13.3 继承

MOverlay->MArea->MPolygon

13.4 构造方法

13.4.1 MPolygon(lnglatArr, option)

说明：

通过经纬度数组及参数选项构建多边形对象。

参数：

（1）lnglatArr:

说明：由多边形顶点组成的经纬度数组。


（2）option:

说明：参数选项，参照 MAreaOptions。


注释：

无

示例：






arr.push(new MLngLat("JIOMRLOQPRHDLD","LQGXQQOPMHLLH"));

arr.push(new MLngLat("JIOMSTOORNHLHH","LQGWYOIRJHDDH"));



lineopt.borderStyle.alpha = 1; //透明度，默认 1，范围 0~1 lineopt.borderStyle.color =

0xFF3300; //线颜色，默认黑色

lineopt.borderStyle.thickness = 0.8; //线粗细度，默认 3

//填充色

lineopt.fillStyle.color = 0xFF6600;

//tip 样式



tipOption.anchor = new MPoint(0,0); //图片锚定点，MPoint 类型







var line = new MPolygon(arr,areopt);

mapObj.addOverlay(line,true);

13.5 属性

13.5.1 id

说明：


类型：

string。

注释：

无

13.5.2 TYPE

说明：

覆盖物类型。

类型：

constant。

取值：

MOverlay.TYPE_POLYGON

注释：

无



13.5.3 lnglatArr

说明：

由多边形顶点组成的经纬度数组。

类型：

MLngLats。

注释：

无

13.5.4 option

说明：

Polygon 的参数选项，参照 MAreaOptions。

类型：

MAreaOptions。

注释：

无

示例：


var polygonInfor=object.id+"||"+object.TYPE;


{ polygonInfor += object.lnglatArr[i].lngX+";"+object.lnglatArr[i].latY+"||";}

alert(polygonInfor);

14 MGroundImage()

14.1 说明

此对象用于生成地图的背景图，此类继承自 MOverlay。

14.2 命名空间

com.mapabc.maps.api.overlays.MGroundImage。

14.3 继承

MOverlay->MGroundImage



14.4 构造方法

14.4.1 MGroundImage(lnglat,option)

说明:

通过经纬度坐标及参数选项确定 groundImage 信息。

参数:

（1）lnglat:

说明：左上角经纬度坐标。

类型：MLngLat。

（2）option：

说明：参数选项，参照 MGroundImageOptions。

类型：MGroundImageOptions。

注释：

当使用 addOverlay(overlay,isToFitView)方法往地图上加载背景图时，地图设置为初始加

载 GroudImage 的视野级别，并且图片左上角与地图左上角对齐。注意：MgroundImage

对象始终处于显示层次的最低端，因此无法使用 setOverlayToTopById()方法上移。

示例：

var opt = new MGroundImageOptions();

opt.imageUrl = "http://www.hw-tm.com/zr/07/200706/200761053537574.gif";

opt.picAgent = true

opt.originalLevel =10;

var lngLat = new MLngLat("116.305355","39.9823278",1);

var img = new MGroundImage(lngLat,opt);

mapObj.addOverlay(img,true);

14.5 属性

14.5.1 id

说明：


类型：

string。

注释：

无

14.5.2 TYPE

说明：

MGroundImage 的类型。



类型：

constant。

取值：

MOverlay.TYPE_GROUNDIMAGE

注释：

无

14.5.3 lnglat

说明：

图片左上角经纬度坐标。

类型：

MLngLat。

注释：

无

14.5.4 option

说明：

参数选项，参照 MGroundImageOptions。

类型：

MGroundImageOptions。

注释：

无

14.5.5 size

说明：

背景图层的尺寸大小，对应于 MSize 类，单位为像素。

类型：

MSize。

注释：

获取宽高数值前要先调用 getOverlayById()方法得到 MGroundImage 对象。

14.5.6 bounds

说明：

背景图层所处的经纬度坐标范围，对应于 MLngLatBounds 类。

类型：

MLngLatBounds。

注释：

无



命名空间：com.mapabc.maps.api.overlays.options

15 MMarkerOptions()

15.1 说明

描述 marker 的选项。

15.2 命名空间

com.mapabc.maps.api.overlays.options.MMarkerOptions。

15.3 构造方法

15.3.1 MMarkerOptions()

说明：

构建一个标注选项对象。

参数：

无

注释：

无

示例：

var markerOptions=new MMarkerOptions();

15.4 属性

15.4.1 imageUrl

说明：

标注图片或 SWF 的 url，默认为蓝色气球图片。

类型：

string。

注释：

如果用户想让传入的 swf 能够跟据不同的参数有不同状态，则需要做到以下 4 点：

（1）传入的 swf 为 as3 编译



（2）swf 第一帧有沙箱权限允许访问代码（Security.allowDomain）

（3）在用户自定义 swf 中声明一个公开方法（即回调方法）： public function

setParams(values : Array) : void,此方法的作用是当 flash 地图加载此 swf 完成后，调用该

方法，从而控制 swf 的状态，参数 values 为用户传入的参数，参数来源参见说明 4

（4）用户传入符合要求的 swf url，在 url 中写入要传入说明 3 中方法的参数，例：

http://test1.test.com/api3/test.swf?swfp=param1|param2|param3;其中参数名 swfp 固定不变，

注意均为小写，等号后为参数列表，参数直接用竖线"|"分割，注意参数传递顺序要与

swf 中 setParams 方法中的参数处理顺序一致

示例：

NetArrow.swf 是一个符合说明里面前三条要求的文件，

并将其放到 http://test1.mapabc.com/api3 服务下面，则可以采用如下方法使用该文件：

markerOption.imageUrl="http://test1.mapabc.com/api3/NetArrow.swf?swfp=45|90";

15.4.2 anchor

说明：

图片左上角相对于加点经纬度坐标的锚点。图片左上角与加点经纬度坐标重合时，记为

像素坐标原点(0,0)。

类型：

MPoint。

注释：

同时设置 anchor 与 imageAlign 时，以 anchor 属性值为准；anchor 与 imageAlign 都不设

置时，以 imageAlign 的默认属性值为准。

15.4.3 imageAlign

说明：

设置图片相对于加点经纬度坐标的位置。九宫格位置。

类型：

constant。

取值：

TOP_LEFT ：左上方。

TOP_CENTER：正上方。

TOP_RIGHT：右上方。

MIDDLE_LEFT：正左边。

MIDDLE_CENTER：正中心。

MIDDLE_RIGHT：正右方。

BOTTOM_LEFT：左下方。

BOTTOM_CENTER：正下方（默认）

BOTTOM_RIGHT：右下方。

注释：

同时设置 anchor 与 imageAlign 时，以 anchor 属性值为准；anchor 与 imageAlign 都不设

置时，以 imageAlign 的默认属性值为准。

http://test1.test.com/api3/test.swf?swfp=param1



15.4.4 labelPosition

说明：

Label 左上角相对于图片中下部的锚点。Label 左上角与图片中下部重合时，记为像素

坐标原点(0,0)。

类型：

MPoint。

注释：

同时设置 labelAlign 和 labelPosition 时，以 labelPosition 属性值为准；两个属性都不设

置时，以 labelAlign 的默认值为准。

15.4.5 labelAlign

说明：

Label 对应于图片的位置。九宫格位置。

类型：

constant。

取值：

TOP_LEFT，左上方。

TOP_CENTER，正上方。

TOP_RIGHT，右上方。

MIDDLE_LEFT，正左边。

MIDDLE_CENTER，正中心。

MIDDLE_RIGHT，正右方。

BOTTOM_LEFT，左下方。

BOTTOM_CENTER，正下方

BOTTOM_RIGHT，右下方（默认）

注释：

同时设置 labelAlign 和 labelPosition 时，以 labelPosition 属性值为准；两个属性都不设

置时，以 labelAlign 的默认值为准。

15.4.6 labelOption

说明：

设置点的标注参数选项，默认为 null。

类型：

MLabelOptions。

15.4.7 isBounce

说明：

拖动结束后是否有弹跳效果。

类型：



boolean。

取值：

ture，有弹跳效果

false，没有弹跳效果（默认）

注释：

当有弹跳效果的时候，marker 的 imageAlign 属性必须为 BOTTOM_CENTER，否则弹

跳效果显示不正确。

15.4.8 bounceLocation

说明：

弹跳定位方式。默认为十字方式 BOUNCE_CROSS ，可选参数圆圈方式

BOUNCE_CIRCLE。

类型：

constant。

取值：

BOUNCE_CROSS，弹跳定位方式，十字定位（默认）

BOUNCE_CIRCLE，弹跳定位方式，圆圈定位

注释：

当有弹跳效果的时候，marker 的 imageAlign 属性必须为 BOTTOM_CENTER，否则弹

跳效果显示不正确。

15.4.9 tipOption

说明：

tip 选项，具体见 MTipOptions 类。

类型：

MTipOptions。

注释：

无

15.4.10 canShowTip

说明：

是否在地图中显示 tip。

类型：

boolean。

取值：

true，可以显示（默认）

false，不可显示

注释：

无



15.4.11 rotation

说明：

设置图标旋转的角度。

类型：

number。

注释：

无

15.4.12 isEditable

说明：

是否为可编辑状态。

类型：

boolean。

取值：

true，可以编辑

false，不可编辑（默认）

注释：

无

15.4.13 hasShadow

说明：

是否显示阴影，默认为 true，即有阴影。

类型：

boolean。

取值：

true，有阴影（默认）

false，无阴影

注释：

无

15.4.14 picAgent

说明：

是否使用图片代理形式。

类型：

boolean。

取值：

true，使用代理（默认）

false，不使用代理



注释：

如果 imageUrl 属性的图片资源所在域名下没有 crossdomain.xml，则需要用代理形式添

加该图片资源。

15.4.15 zoomLevels

说明：

设置在地图的哪些缩放级别范围内显示 MMarkerOption。

类型：

array。

取值：

缩放级别数组元素可以是不连续的。

默认为空数组，此时在地图的所有缩放级别内均显示 MMarkerOption

注释：

无

15.4.16 isDimorphic

说明：

此为可选项，设置是否具有二态。

类型：

boolean。

取值：

true，有二态

false，无二态（默认）

注释：

无

15.4.17 dimorphicColor

说明：

设置第二种状态的颜色，默认为 0xFF0000，即红色。

类型：

string。

注释：

无

15.4.18 attributeValue

说明：

点对象的属性值。

类型：

Number



取值：

默认为 0

注释：

仅用于点聚合功能，设置 MClusterOptions.attributeValue=MClusterOptions.VALUE_SUM

情况下，聚合中心点显示所有被聚合点的属性值之和。

示例 1

var markerOption = new MMarkerOptions();





fontstyle.color = 0xffffff;



labelOptions.borderColor =0x00ff00;

labelOptions.alpha =0.5;

labelOptions.content="PointLabel";

labelOptions.hasBorder =true;

labelOptions.hasBackground =true;

labelOptions.backgroundColor =0x0078ff;

markerOption.labelOption=labelOptions;

markerOption.imageUrl= "http://code.mapabc.com/v2/images/10.png";

markerOption.anchor= new MPoint(30,0);

markerOption.rotation=30;

markerOption.imageAlign=TOP_RIGHT;



tipOption.content="welcome to MapABC!";

tipOption.hasShadow=true;

var linestyle = new MLineStyle();

linestyle.thickness = 2;

linestyle.color = 0xFFFF66;

linestyle.alpha = 1;

tipOption.borderStyle = linestyle;

var fontstyle1 = new MFontStyle();

fontstyle1.name ="Arial";

fontstyle1.size = 13;

fontstyle1.color = 0xFF3300;

fontstyle1.bold = true;

tipOption.titleFontStyle= fontstyle1;






fontstyle2.color = 0xFFFF66;

fontstyle2.bold = false;

tipOption.contentFontStyle= fontstyle2;

var mfillstyle1=new MFillStyle();

mfillstyle1.color= 0xFF5500;

mfillstyle1.alpha = 1;

tipOption.fillStyle = mfillstyle1;


mfillstyle2.color= 0X0FF80;


tipOption.titleFillStyle= mfillstyle2;

markerOption.tipOption= tipOption;

markerOption.canShowTip=true;

markerOption.isEditable=true;

markerOption.hasShadow=true;

markerOption.zoomLevels=[6,7,8,9,10];

markerOption. isDimorphic=true;

markerOption. dimorphicColor=oxffff00;

16 MRadarOptions()

16.1 说明

描述实景地图雷达标注的选项。

16.2 命名空间

com.mapabc.maps.api.overlays.options.MRadarOptions。

16.3 构造方法

16.3.1 MRadarOptions()

说明：

构建一个实景地图雷达标注选项对象。

参数：

无

注释：

无

示例：



var radarOptions=new MRadarOptions();

16.4 属性

16.4.1 rotation

说明：

实景地图雷达标注探测区的角度。

类型：

number。

取值：

范围 0~360，默认为 0，单位为度

注释：

无。

16.4.2 color

说明:

实景地图雷达标注探测区颜色。

类型：

16 进制整数。

取值：

0x000000-0xffffff

默认为 0x3682C8

注释：

无

16.4.3 radius

说明：

实景地图雷达标注探测区半径

类型：

Number

取值：

默认为 100，单位为像素

注释：

无

16.4.4 fovea

说明：

实景地图雷达标注视野夹角



类型：

Number

取值：

范围 0~180，默认 75，单位为度

注释：

无

16.4.5 isClosed

说明：

是否关闭雷达。

类型：

Boolean。

取值

true，打开（默认）

false，关闭

注释：

无。

16.4.6 visible

说明：

是否显示雷达。

类型：

Boolean。

取值

true，显示（默认）

false，不显示

注释：

无。

示例：

var radarOptions=new MRadarOptions();

radarOptions.rotation=90;

radarOptions.radius=200;

radarOptions.fovea=80;



17 MLabelOptions()

17.1 说明

MLabel 类的选项参数。

17.2 命名空间

com.mapabc.maps.api.overlays.options.MLabelOptions。

17.3 构造方法

17.3.1 MLabelOptions()

说明：

创建 label 选项对象。

参数：

无

注释：

无

示例:


17.4 属性

17.4.1 fontStyle

说明：

设置 label 的字体样式。

类型：

详见 MFontStyle。

注释：

无

17.4.2 alpha

说明：

设置 label 背景及边框的透明度，默认为 1，即不透明。



类型：

number。

取值：

范围 0 至 1

1 为不透明（默认）

注释：

无

17.4.3 hasBackground

说明：

设置 label 是否有背景，默认为 false，即没有背景。

类型：

boolean。

取值：

true，有背景

false，无背景（默认）

注释：

无

17.4.4 hasBorder

说明：

设置 label 背景是否有边框。

类型：

boolean。

取值：

true，有背景边框

false，无背景边框（默认）

注释：

无

17.4.5 backgroundColor

说明：

设置 label 的背景颜色。

类型：

16 进制整数

取值：

范围为 0x000000-0xffffff。

注释：

无



17.4.6 borderColor

说明：

设置 label 的边框颜色。

类型：

16 进制整数

取值：

范围为 0x000000-0xffffff

注释：

无

17.4.7 content

说明：

label 的显示内容。

类型：

string。

注释：

无

17.4.8 zoomLevels

说明：

设置在地图的哪些缩放级别范围内显示 MLabel。

类型：

array。

取值：


默认为空数组，此时在地图的所有缩放级别内均显示 MLabel。

注释：

无

示例 1：









labelOptions.hasBorder = true;

labelOptions.hasBackground=true;





labelOptions.zoomLevels= [7,8,9,10];//当地图的缩放级别为 7，8，9，10 时显示 label。

示例 2：


labelOptions.fontStyle.name ="Arial";

labelOptions.fontStyle.size = 15;

labelOptions.fontStyle.color = 0xFFFF66;

labelOptions.fontStyle.bold = true;


labelOptions.hasBorder = true;

labelOptions.hasBackground=true;



18 MTipOptions()

18.1 说明

提示窗口选项对象，通过该对象的各个属性来设置提示窗口的标题、内容、边框风格等

内容，此对象服务于 MMarker、MPolyline、MArea 等对象。

18.2 命名空间

com.mapabc.maps.api.overlays.options.MTipOptions。

18.3 构造方法

18.3.1 MTipOptions()

说明：

创建提示窗口对象。

参数：

无

注释：

无

示例:

var tipOptions=new MTipOptions();



18.4 属性

所有信息窗口共有属性

18.4.1 tipType

说明：

信息窗类型。

类型：

constant。

取值：

FLASH_BUBBLE_TIP，flash 气泡信息窗口（默认）

HTML_BUBBLE_TIP，html 气泡信息窗口。

HTML_CUSTOM_TIP，html 用户自定义信息窗口。

IMG_BUBBLE_TIP，image 背景的 html 气泡信息窗口。

注释：

无。

18.4.2 content

说明：

tip 的内容。

类型：

string。

注释：

当 tipoption.tipType=HTML_CUSTOM_TIP 时，content 中的 div 标签中必须包含属性

style=' position :absolute'。

各种类型信息窗私有属性

18.4.3 title

说明：

tip 的标题。

类型：

string。

注释：

适用于 FLASH_BUBBLE_TIP、HTML_BUBBLE_TIP、IMG_BUBBLE_TIP



18.4.4 hasShadow

说明：

tip 是否有阴影。

类型：

boolean。

取值：

true，有阴影（默认）

false，无阴影

注释：

适用于 FLASH_BUBBLE_TIP

18.4.5 roundRectSize

说明：

tip 矩形圆边长度。

类型：

number。

注释：

适用于 FLASH_BUBBLE_TIP

18.4.6 borderStyle

说明：

边框风格。

类型：

MLineStyle。

注释：

适用于 FLASH_BUBBLE_TIP、HTML_BUBBLE_TIP。

HTML_BUBBLE_TIP 中边框宽度属性无效。

18.4.7 titleFontStyle

说明：

标题文字风格。

类型：

MFontStyle。

注释：


HTML_BUBBLE_TIP 中是否粗体属性无效。



18.4.8 contentFontStyle

说明：

内容文字风格。

类型：

MFontStyle。

注释：


HTML_BUBBLE_TIP 中是否粗体属性无效

18.4.9 fillStyle

说明：

内容部分填充风格。

类型：

MFillStyle。

注释：

适用于 FLASH_BUBBLE_TIP、HTML_BUBBLE_TIP

18.4.10 titleFillStyle

说明：

标题部分填充风格。

类型：

MFillStyle。

注释：

适用于 FLASH_BUBBLE_TIP、HTML_BUBBLE_TIP

18.4.11 tipHeight

说明：

HTML 气泡信息窗口高度。

类型：

number。

取值：

默认为 175

最大不得超过地图容器高度

注释：

适用于 HTML_BUBBLE_TIP、IMG_BUBBLE_TIP



18.4.12 tipWidth

说明：

HTML 气泡信息窗口宽度。

类型：

number。

取值：

默认为 300

最大不得超过地图容器宽度

注释：

适用于 HTML_BUBBLE_TIP、IMG_BUBBLE_TIP

18.4.13 tipAlign

说明：

HTML 用户自定义信息窗口的锚点位置。

类型：

constant。

取值：

TOP_LEFT：左上方。







BOTTOM_CENTER：正下方（默认）


注释：

此信息窗口只支持 MMarker 和地图两种对象。

适用于 HTML_CUSTOM_TIP

18.4.14 offset

说明：

HTML 用户自定义信息窗口的相对于锚点位置的偏移量。

类型：

MPoint。

取值：

默认为(0,0)

注释：

仅适用于 HTML_CUSTOM_TIP



示例 1（FLASH 信息窗口）





tipOption. roundRectSize=3;

tipOption.borderStyle.thickness=2;

tipOption.borderStyle. color= 0xFFFF66;

tipOption.borderStyle. alpha=1;

tipOption.titleFontStyle.name="Arial";

tipOption.titleFontStyle.size=13;

tipOption.titleFontStyle.color= 0xFF3300

tipOption.titleFontStyle.bold=true;

tipOption.contentFontStyle.name="Arial";

tipOption.contentFontStyle.size=16;

tipOption.contentFontStyle.color= 0xFFFF66;

tipOption.contentFontStyle.bold=false;

tipOption.fillStyle.color= 0xFF5500;

tipOption.fillStyle.alpha=1;

tipOption.titleFillStyle.color=0X0FF80;

tipOption.titleFillStyle.alpha=1;

tipOption.tipType=FLASH_BUBBLE_TIP;

示例 2（HTML 气泡信息窗口）





tipOption. roundRectSize=3;




























tipOption.tipType=HTML_BUBBLE_TIP;

示例 3（HTML 自定义信息窗口）


tipOption.tipType = HTML_CUSTOM_TIP;

tipOption.content = '<div id ="test"

style="position:absolute ;background-color:#0ff;width:200px;height:200px"><input name="desc"

type="text" id="a" value="测试" /><p><input type="submit" value="确定提交" /> <input

type="button" onclick="closeTip()" value="取消提交" />'

19 MCorrectionTipOptions()

19.1 说明

带纠错功能的特定提示窗口选项。

19.2 命名空间

com.mapabc.maps.api.overlays.options.MCorrectionTipOptions。

19.3 构造方法

19.3.1 MCorrectionTipOptions()

说明：

构建带纠错功能的特定提示窗口参数选项。

参数：

无

注释：

无

示例：



var correctionTipOptions=new MCorrectionTipOptions ();

19.4 属性

19.4.1 titleName

说明：

tip 的标题。

类型：

string。

注释：

无

19.4.2 address

说明：

地址信息。

类型：

string。

注释：

无

19.4.3 telephone

说明：

电话信息。

类型：

string。

注释：

无

19.4.4 details

说明：

企业详细信息。

类型：

string。

注释：

无



19.4.5 imgUrl

说明：

图片的 url。

类型：

string。

注释：

无

20 MLineOptions()

20.1 说明

描述线选项。

20.2 命名空间

com.mapabc.maps.api.overlays.options.MLineOptions。

20.3 构造方法

20.3.1 MLineOptions()

说明：

构造线选项对象。

参数：

无

注释：

无

示例：

var lineopt = new MLineOptions(); //构建一个名为 lineopt 的线选项对象



20.4 属性

20.4.1 lineStyle

说明：

线的边缘风格，参照 MLineStyle。

类型：

MLineStyle。

注释：

无

20.4.2 tipOption

说明：

tip 选项，参见 MTipOptions。

类型：

MTipOptions。

注释：

无

20.4.3 canShowTip

说明：

是否显示 tip。

类型：

boolean。

取值:

true，显示（默认）

false，不显示

注释：

无

20.4.4 isEditable

说明：


类型：

boolean。

取值:

true，可编辑


注释：



无

20.4.5 zoomLevels

说明：

设置在地图的哪些缩放级别范围内显示 MPolyline。

类型：

array。

取值：


默认为空数组，此时在地图的所有缩放级别内均显示 MPolyline。

注释：

无

20.4.6 isDimorphic

说明：

此为可选项，设置是否具有二态，默认为 false，即没有二态。

类型：

boolean。

取值:

true，有二态


注释：

无


说明：

设置第二种状态的颜色。

类型：

string。

取值：

默认为 0xFF0000，即红色

示例 1：


lineopt.lineStyle.thickness = 3;

lineopt.lineStyle.color = 0xFFF988;

lineopt.lineStyle.alpha = 1;

lineopt.lineStyle.lineType= LINE_DASHED;
















tipOption.contentFontStyle.color= 0xFFFF66








lineopt.isEditable =true;

lineopt.zoomLevels=[3,4,5,6,7,8] ;

lineopt. isDimorphic=true;

lineopt. dimorphicColor=oxffff00;

示例 2：


var linestyle5 = new MLineStyle();

linestyle5.thickness = 3;

linestyle5.color = 0xFFF988;

linestyle5.alpha = 1;

linestyle5.lineType= LINE_DASHED;

lineopt.lineStyle = linestyle5;


































lineopt.isEditable =true;

lineopt. isDimorphic=true;

lineopt. dimorphicColor=oxffff00;

21 MAreaOptions()

21.1 说明

描述面选项，该类除了可另外指定填充色和不透明性外，其他方面都非常类似于

MLineOptions。

21.2 命名空间

com.mapabc.maps.api.overlays.options.MAreaOptions。

21.3 构造方法

21.3.1 MAreaOptions()

说明：

创建一个面选项对象，通过对该对象的属性赋值可以生成所需要的面状覆盖物风格。



参数：

无

注释：

无

示例：

var areopt = new MAreaOptions(); //构建一个名为 areopt 的面选项对象

21.4 属性

21.4.1 areaStyle

说明:

面的风格，参照 MAreaStyle。

类型：

MAreaStyle。

注释：

无

21.4.2 tipOption

说明:

tip 选项，参照 MTipOptions。

类型：

MTipOptions。

注释：

无

21.4.3 canShowTip

说明：

是否显示 tip。

类型：

boolean。

取值:

true，可显示（默认）

false，不可显示

注释：

无



21.4.4 isEditable

说明：


类型：

boolean。

取值:

true，可编辑


注释：

具体编辑功能包括：

（1）多边形编辑功能：多边形节点的编辑，多边形位置的编辑（可拖拽多边形）

（2）矩形编辑功能：矩形四个顶点的编辑（改变矩形大小），矩形四个边的编辑（改

变矩形宽高），矩形位置的编辑（可拖拽矩形）。

（3）圆形编辑功能：圆形位置的编辑（可拖拽圆形）。

21.4.5 zoomLevels

说明：

设置在地图的哪些缩放级别范围内显示 MArea。

类型：

array。

取值：


默认为空数组，此时在地图的所有缩放级别内均显示 MArea

注释：

无

示例 1：

var areopt = new MAreaOptions(); //构建一个名为 areopt 的面选项对象。

var mlstyle = new MLineStyle() //定义线、边框风格对象

mlstyle.thickness = 1;

mlstyle.color = 0xFFFF66;

mlstyle.alpha = 1;

areopt.areaStyle.borderStyle= mlstyle;

var mfstyle=new MFillStyle(); //定义填充风格对象

mfstyle.color=0xFFF886;

mfstyle.alpha = 0.7;

areopt.areaStyle.fillStyle = mfstyle;











linestyle.lineType=LINE_DASHED;
























areopt.isEditable = true;

areopt.zoomLevels=[11,12,13,14,15,16,17];

示例 2：

var areopt = new MAreaOptions(); //构建一个名为 areopt 的面选项对象。

areopt.areaStyle.borderStyle.thickness = 0;

areopt.areaStyle.borderStyle.color = 0xFFFF66;

areopt.areaStyle.borderStyle.alpha = 1;

areopt.areaStyle.fillStyle.color=0xFFF886;

areopt.areaStyle.fillStyle.alpha = 0.7;
















tipOption.contentFontStyle.color= 0xFFFF66








areopt.isEditable = true;

21.4.6 labelOption

说明：

MArea 的 label 选项参数。

类型：

MLabelOptions。

注释：

无

21.4.7 labelPosition

说明：

Label 左上角相对于 area 对象中心的锚点。Label 左上角与 area 对象中心重合时，记为

像素坐标原点(0,0)。

类型：

MPoint。

取值：

当不设置该值时，默认为(0,0)，即 Label 位于 area 对象中心。

注释：

无

21.4.8 isDimorphic

说明：

此为可选项，设置是否具有二态。

类型：

boolean。



取值:

true，有二态


注释：

无


说明：

设置第二种状态的颜色。

类型：

string。

取值：

默认为 0xFF0000，即红色。

注释：

无

示例：

以下函数给出了在地图上添加带有标注文字的多边形对象的方法。

function addPolygon(){//在地图上画多边形


arr.push(new MLngLat("JIOMSOMWIMHHDL","LQGWYQQTLLDHL"));

arr.push(new MLngLat("JIOMSSINRNLLHL","LQGWYKNRJLDHD"));

arr.push(new MLngLat("JIOMSTKOITLLHH","LQGWYSNUNPLLH"));

arr.push(new MLngLat("JIOMSSPVJSLLDD","LQGXPRJQMHLDL"));

var areopt = new MAreaOptions(); //构建一个名为 areopt 的面选项对象





fontstyle.color = 0xffffff;




labelOptions.content="circleLabel";

labelOptions.hasBorder =true;

labelOptions.hasBackground =true;


areopt.labelOption=labelOptions;


tipOption.title="多边形";

tipOption.content="这是一个多边形！";





areopt.labelPosition=new MPoint(0,0);

areopt. isDimorphic=true;

areopt. dimorphicColor=oxffff00;

polygonAPI = new MPolygon(arr,areopt);

polygonAPI.id="polygon101";

mapObj.addOverlay(polygonAPI,true);

}

22 MGroundImageOptions()

22.1 说明

MGroundImage 的参数选项。

22.2 命名空间

com.mapabc.maps.api.overlays.options.MGroundImageOptions。

22.3 构造方法

22.3.1 MGroundImageOptions()

说明：

创建 MGroundImage 选项对象。

参数：

无

注释：

无

示例:

var groundImgeOptions=new MGroundImageOptions();

22.4 属性

22.4.1 imageUrl

说明：

标注图片或 SWF 的 url。



类型：

string。

注释：

如果用户想让传入的 swf 能够跟据不同的参数有不同状态，则需要做到以下 4 点：

（1）传入的 swf 为 as3 编译

（2）swf 第一帧有沙箱权限允许访问代码（Security.allowDomain）

（3）在用户自定义 swf 中声明一个公开方法（即回调方法）： public function

setParams(values : Array) : void，此方法的作用是当 flash 地图加载此 swf 完成

后，调用该方法，从而控制 swf 的状态，参数 values 为用户传入的参数，参数来源参见

说明 4

（4）用户传入符合要求的 swf url，在 url 中写入要传入说明 3 中方法的参数，例：

http://test1.test.com/api3/test.swf?swfp=param1|param2|param3;其中参数名 swfp 固定不变，

注意均为小写，等号后为参数列表，参数直接用竖线"|"分割，注意参数传递顺序要与

swf 中 setParams 方法中的参数处理顺序一致。

22.4.2 picAgent

说明：

是否使用图片代理。默认为 true，使用代理。

类型：

boolean。

取值:

true，使用代理（默认）

false，不使用代理

注释：

（1）使用图片代理，imageUrl 所使用的图片不存在跨域问题，imageUrl 属性对应的

图片地址必须是互联网可访问地址。

（2）不使用图片代理，imageUrl 所使用的图片存在跨域问题，用户必须在图片所在域

名下存放 crossdomain.xml 文件。

22.4.3 originalLevel

说明：

图片原始大小所在的 zoom 级别。

类型：

number。

取值：

取值范围 3~17，

默认值 17。

注释：

地图的缩放级别大于此级别过多时，由于图片被过度拉伸会导致图片不显示

http://test1.test.com/api3/test.swf?swfp=param1



22.4.4 zoomLevels

说明：

设置在地图的哪些缩放级别范围内显示 MGroundImage。

类型：

array。

取值：


默认为空数组，此时在地图的所有缩放级别内均显示 MGroundImage

注释：

无

22.4.5 imageAlign

说明：

设置图片相对于标注经纬度坐标点的位置。九宫格位置。

类型：

constant。

取值：

TOP_LEFT ：左上方（默认）







BOTTOM_CENTER：正下方。


注释：

无

示例：

var opt = new MGroundImageOptions();

opt.imageUrl = "http://www.hw-tm.com/zr/07/200706/200761053537574.gif";

opt.picAgent = true;

opt.originalLevel =10;

opt.zoomLevels=[10,11,12];

opt.imageAlign=MIDDLE_CENTER;



23 MClusterOptions()

23.1 说明

设置点聚合的参数选项。

23.2 命名空间

com.mapabc.maps.api.overlays.options.MClusterOptions。

23.3 构造方法

23.3.1 MClusterOptions()

说明：

点聚合的参数选项。

参数：

无

注释：

无

示例:

var clusterOptions =new MClusterOptions ();

23.4 属性

所有类型点聚合通用属性

23.4.1 gridSize

说明：

聚合的范围，以像素为单位

类型：

number。

取值：

默认为 25

注释：

无



23.4.2 maxZoom

说明：

设置聚合的最大级别。

类型：

number。

取值：

默认为 17 级，即小于 17 级别聚合，17 及以上级别不聚合

注释：

无

23.4.3 attributeValue

说明：

聚合中心点显示的属性值类型，可以选择显示所有聚合点的个数，也可以选择显示所

有聚合点的属性值之和，点的属性值取决于 MMarkerOptions.attributeValue。

类型：

constant。

取值：

MClusterOptions.TOTAL_NUMBER，显示所有聚合点的个数（默认）

MClusterOptions.VALUE_SUM，显示所有聚合点的属性值之和

注释：

无

23.4.4 fontStyle

说明：

聚合点显示文字的样式

类型：

MFontStyle。

取值：

size 默认值为 14

color 默认值为 0xFFFFFF，白色

注释：

只用 size 和 color 两个属性可用

绽放类型点聚合专用属性

23.4.5 centerMarkerURL

说明：



设置绽放聚合中心点图标的 URL，用于自定义绽放聚合中心点图标

类型：

string。

取值：

无

注释：

仅用于有绽放效果的点聚合

23.4.6 aroundMarkerURL

说明：

设置绽放聚合绽放点图标的 URL，用于自定义绽放聚合绽放点的图标

类型：

string。

取值：

无

注释：


23.4.7 flareDistance

说明：

绽放点离中心点的距离，以像素为单位

类型：

int。

取值：

默认 30 像素。当设置小于 30，按 30 像素显示

注释：


23.4.8 isUseMarkerIcon

说明：

绽放点聚合中，绽放点是否使用原始图标

类型：

boolean。

取值：

默认 false

注释：


示例：



var clusterOptions =new MClusterOptions();

clusterOptions.gridSize=100;

clusterOptions.maxZoom=12;

clusterOptions.attributeValue=MClusterOptions.VALUE_SUM;

clusterOptions.fontStyle=new MFontStyle();

clusterOptions.fontStyle.color=0xfff000;

clusterOptions.fontStyle.size=20;

clusterOptions.isUseMarkerIcon=true;

clusterOptions.centerMarkerURL="http://图标地址/m1.png";

clusterOptions.aroundMarkerURL="http://图标地址/m1.png";

clusterOptions.flareDistance=50;

23.5 常量

23.5.1 NORMAL_CLUSTER

说明：

点聚合模式常量，普通点聚合模式。

示例：

MClusterOptions.NORMAL_CLUSTER。

23.5.2 FLARE_CLUSTER

说明：

点聚合模式常量，绽放效果的点聚合模式

示例：

MClusterOptions.FLARE_CLUSTER。

23.5.3 NO_CLUSTER

说明：

点聚合模式常量，取消点聚合模式。

示例：

MClusterOptions.NO_CLUSTER。

23.5.4 TOTAL_NUMBER

说明：



聚合中心点显示属性类型常量，显示所有聚合点个数。

示例：

MClusterOptions.TOTAL_NUMBER。

23.5.5 TOTAL_SUM

说明：

聚合中心点显示属性类型常量，显示所有聚合点属性值之和。

示例：

MClusterOptions.TOTAL_SUM。

命名空间：com.mapabc.maps.api.layers

24 MTileLayer ()

24.1 说明

通过地图叠加层的类别及参数选项确定地图叠加层信息。

24.2 命名空间

com.mapabc.maps.api.layers.MTileLayer。

24.3 构造方法

24.3.1 MTileLayer (layerType,option)

说明：地图叠加层。

参数：

（1）layerType：

说明：地图叠加层的类别


取值：（a）TL_TRAFFIC，实时交通图层

（b）TL_USERMAP，用户编辑器图层，对应有效的 MTileLayerOptions 属性

有：userId、tempId、layerId

（c）TL_MASS_TRANSIT，轨道交通层



（d）TL_CUSTOM_MAP，用户提供的图层，对应有效的 MTileLayerOptions

属性有：tileUrl、layerId

（2）option：

说明：参数选项，参照 MTileLayerOptions，此为可选项。

类型：MTileLayerOptions。

注释：

实时交通层当 zoom 大于等于 10 以上显示，目前支持的城市有：北京、上海、广州、

深圳、成都、南京、沈阳、武汉、宁波、重庆、青岛、杭州，具体能显示哪些城市的实

时交通取决于用户的权限。

示例：

var tilelayer=new MTileLayer(TL_TRAFFIC);

25 MDataLayer()

25.1 说明

地图数据切片图层对象。

25.2 命名空间

com.mapabc.maps.api.layers.MDataLayer。

25.3 构造方法

25.3.1 MDataLayer(layerType,option)

说明：地图数据切片层。

参数：

（1）layerType：

说明：地图数据切片图层类型

类型：string

（2）option：

说明：参数选项，参照 MDataLayerOptions，此为可选项。

类型：MDataLayerOptions。

注释：

只支持点数据。

示例：

var datalayer=new MDataLayer(“1”, dataLayerOptions);



命名空间：com.mapabc.maps.api.layers.options

26 MTileLayerOptions()

26.1 说明

描述地图叠加层选项。

26.2 命名空间

com.mapabc.maps.api.layers.options.MTileLayerOptions。

26.3 构造方法

26.3.1 MTileLayerOptions()

说明：

构建一个地图叠加层选项对象。

参数：

无

注释：

无

示例：

var tilelayerOptions=new MTileLayerOptions();

26.4 属性

26.4.1 tileUrl

说明：

地图切片取图地址。

类型：

string。

注释：

只用于用户自己定义切片图层。



26.4.2 userId

说明：

用户的 Id。

类型：

string。

注释:

仅用于编辑器图层。

26.4.3 tempId

说明：

模板 ID

类型：

string。

注释:

仅用于编辑器图层。

26.4.4 layerId

说明：

地图叠加层 ID。用于该叠加层唯一标识。

类型：

string。

注释:

用户不输入则系统自动生成。

实时交通图层，轨道交通图层不需要用户指定。

示例

var tileLayerOptions =new MTileLayerOptions();;


tileLayerOptions.layerId="myMapLayer";

26.4.5 alpha

说明：

地图层透明度。

类型：

number。

取值:

范围 0~1

默认为 1，不透明。

示例



var tileLayerOptions =new MTileLayerOptions();;


tileLayerOptions.layerId="myMapLayer";

27 MDataLayerOptions()

27.1 说明

描述地图数据叠加层选项。

27.2 命名空间

com.mapabc.maps.api.layers.options.MDataLayerOptions。

27.3 构造方法

27.3.1 MDataLayerOptions()

说明：

构建一个地图数据叠加层选项对象。

参数：

无

注释：

无

示例：

var datalayerOptions=new MDataLayerOptions();

27.4 属性

27.4.1 layerId

说明：

地图数据层 ID。用于该数据层唯一标识。

类型：

string。

注释:

用户不输入则系统自动生成。



27.4.2 url

说明：

地图数据地址。

类型：

string。

取值：

http://数据切片地址?x=[X]&y=[Y]&z=[Z]，[X][Y][Z]均为规定的替换符，其中 X 和 Y 分别指

纬度和经度数据块坐标，Z 指缩放级别。

注释：

无。

示例

var dataLayerOptions =new MDataLayerOptions();

dataLayerOptions.url=" http://数据切片地址?x=[X]&y=[Y]&z=[Z]";

28 MGradientMapOptions()

28.1 说明

描述地图渐变图层选项。

28.2 命名空间

com.mapabc.maps.api.layers.options. MGradientMapOptions。

28.3 构造方法

28.3.1 MGradientMapOptions()

说明：

构建一个地图渐变图层选项对象。

参数：

无

注释：

无

示例：

var options :MGradientMapOptions=new MGradientMapOptions();



28.4 属性

28.4.1 pointsXMLString

说明：

点数据源 XML 字符串。

类型：

string。

注释：

内容为 xml 格式,请按以下格式书写：

“<root>

<point><x>116.1</x><y>39.1</y><value>1</value></point>


</root>”

28.4.2 pointsXMLURL

说明：

点数据源 url 地址。

类型：

string。

注释：

上传的文件必须为 xml 格式,请按以下格式书写：

<root>



</root>

28.4.3 radiusRatio

说明：

渐变图半径比率。所有点的渐变半径都会乘以半径比率。

类型：

number。

注释：

无

28.4.4 maxRadius

说明：

每个点的渐变图显示的最大半径，单位：像素。

类型：



number。

注释：

无

28.4.5 minRadius

说明：

每个点的渐变图显示的最小半径，单位：像素。

类型：

number。

注释：

无

28.4.6 maxValue

说明：

渐变图最大值。

类型：

number。

注释：

当数据源中点的 value 值大于等于 maxValue 时，按 maxRadius 显示

当数据源中点的 value 值等于 1 时，按 minRadius 显示

当数据源中点的 value 值介于[1，maxValue]之间，按上述约束的比率显示

28.4.7 colors

说明：

渐变颜色。

类型：

Arr。

取值：

只可输入三种颜色进行渲染

默认值为[0x0000ff,0x00ff00,0xff0000]，即蓝色，绿色，红色

注释：

数据源中点的 value 值越大，越向红色渐变；value 值越小，越向蓝色渐变

28.4.8 alpha

说明：

渐变图透明度。

类型：

number。



取值：

0 至 1，默认为 1，越小越透明

注释：

无

示例：

var options =new MGradientMapOptions();

options.pointsXMLString='<root>' +






'<point><x>118.2</x><y>40.5</y><value>990</value></point></root>';

options.radiusRatio=1; //设置半径比率

options.maxValue=1000; //设置最大值

options.maxRadius=100; //设置最大半径

options.minRadius=10; //设置最小半径

options.colors=[0x00ff00,0x00ff0f,0xfff000]; //设置颜色

29 MWMSLayerOptions()

29.1 说明

设置 WMS 层的参数选项。

29.2 命名空间

com.mapabc.maps.api.layers.options.MWMSLayerOptions。

29.3 构造方法

29.3.1 MWMSLayerOptions()

说明：

WMS 层的参数选项。

参数：

无

注释：



无

示例:

var wmsLayerOptions=new MWMSLayerOptions ();

29.4 属性

29.4.1 WMSUrl

说明：

WMS 的取图地址。

类型：

string。

注释：

无

命名空间：com.mapabc.maps.api.styles

30 MFontStyle()

30.1 说明

描述字体的风格。

30.2 命名空间

com.mapabc.maps.api.styles.MFontStyle。

30.3 构造方法

30.3.1 MFontStyle()

说明：

创建填充样式对象。

参数：

无



注释：

无

示例：

var fontStyle=new MFontStyle();

30.4 属性

30.4.1 name

说明：

字体的名称。

类型：

string。

取值：

默认为宋体

注释：

无

30.4.2 size

说明：

字体的大小。

类型：

number。

取值：

默认为 12

注释：

无

30.4.3 color

说明：

字体的颜色。

类型：

16 进制整数

取值：

范围为 0x000000-0xffffff

默认为 0x000d46（黑色）

注释：

无



30.4.4 bold

说明：

是否为粗体。

类型：

boolean。

取值:

true，是

false，否（默认）

注释：

无

31 MLineStyle()

31.1 说明

描述线的风格，如线的粗细度、颜色及透明度等，此对象既可服务于 MPolyline，又可

以服务于 MArea 的边框线。

31.2 命名空间

com.mapabc.maps.api.styles.MLineStyle。

31.3 构造方法

31.3.1 MLineStyle()

说明：

创建线样式对象。

参数：

无

注释：

无

示例：

var lineStyle=new MLineStyle();



31.4 属性

31.4.1 thickness

说明：

线的粗细度。

类型：

number。

取值：

默认为 2

注释：

无

31.4.2 color

说明：

线的颜色，。

类型：

16 进制整数。

取值：

0x000000-0xffffff

默认为 0x005890（蓝色）

注释：

无

31.4.3 alpha

说明：

线的透明度。

类型：

number。

取值：

范围为 0~1，0 为透明，1 为不透明

默认为 1

注释：

无

31.4.4 lineType

说明：

线的表示样式。

类型：



constant。

取值：

LINE_SOLID ，实线（默认）

LINE_DASHED，虚线

注释：

无

示例：

var linest = new MLineStyle();

linest.alpha = 1;

linest.color = 0xFF3300 ;


linest.lineType= LINE_DASHED;

32 MAreaStyle()

32.1 说明

描述面的风格，除了比 MLineStyle 多填充样式外，其它方面都很类似。

32.2 命名空间

com.mapabc.maps.api.styles.MAreaStyle。

32.3 构造方法

32.3.1 MAreaStyle()

说明：

创建面样式对象。

参数：

无

注释：

无

示例：

var areaStyle=new MAreaStyle();



32.4 属性

32.4.1 borderStyle

说明：

描述边框的风格，参照 MLineStyle。

类型：

MLineStyle。

注释：

无

32.4.2 fillStyle

说明：

描述面的填充风格，参照 MFillStyle。

类型：

MFillStyle。

注释：

无

33 MFillStyle()

33.1 说明

描述面对象的填充风格。

33.2 命名空间

com.mapabc.maps.api.styles.MFillStyle。

33.3 构造方法

33.3.1 MFillStyle()

说明：

创建填充样式对象。

参数：



无

注释：

无

示例：

var fillStyle=new MFillStyle();

33.4 属性

33.4.1 color

说明：

面的填充颜色。

类型：

16 进制整数。

取值：

0x000000-0xffffff

注释：

无

33.4.2 alpha

说明：

填充面的透明度。

类型：

number。

取值：

范围为 0~1，0 为透明，1 为不透明

默认为 1

注释：

无

命名空间：com.mapabc.maps.api.basetypes

34 MLngLat()

34.1 说明

构造一个经纬度坐标对象，用于标注地图上一个点。



34.2 命名空间

com.mapabc.maps.api.basetypes.MLnglat。

34.3 构造方法

34.3.1 MLngLat(longitude,latitude,TYPE)

说明：

构建一个 MLngLat 对象，其中参数的顺序是经度在前，纬度在后，与 lng、lat 顺序对

应。

参数：

（1）longitude：

说明：经度。

类型：string/number。

（2）latitude：

说明：纬度。


（3）TYPE：

说明：坐标类型，可选项。


取值：COORD_TYPE_ENCODE，加密坐标

COORD_TYPE_OFFSET，明码偏移坐标（默认）

注释：

无

示例：

var lngLat=

new MLngLat("JIOMSTPOIQPLLH","LQGXQMOUPLHHL", COORD_TYPE_ENCODE);

var lngLat=new MLngLat(116.3355,39.2255, COORD_TYPE_OFFSET);

34.4 属性

34.4.1 lngX

说明：

经度。

类型：

string/number。

注释：

无



34.4.2 latY

说明：

纬度。

类型：

string/int。

注释：

无

34.4.3 TYPE

说明：

坐标类型。

类型：

constant。

取值：

COORD_TYPE_ENCODE，加密坐标

COORD_TYPE_OFFSET，偏移明码坐标（默认）

注释：

无

示例:

var location=new

MLngLat("JIOMSLKNLMLDPP","LQGWWMIWODLHL",COORD_TYPE_ENCODE);

//通过经纬度坐标标定地图上一个点

alert("经纬度坐标为："+location.lngX+";"+location.latY);

//通过警告框返回该点经纬度坐标

var location=new

MLngLat(116.3322,39.22344, COORD_TYPE_OFFSET);

//通过经纬度坐标标定地图上一个点

alert("经纬度坐标为："+location.lngX+";"+location.latY);

//通过警告框返回该点经纬度坐标

35 MLngLats()

35.1 说明

构造经纬度坐标集合对象。



35.2 命名空间

com.mapabc.maps.api.basetypes.MLnglats。

35.3 构造方法

35.3.1 MLngLats(lnglatArr)

说明：

构建经纬度坐标集合对象。

参数：

（1）lnglatArr：

说明：经纬度对象数组。

类型：array。

注释：

无

示例：

var lnglats=new MLngLats(arr);

35.4 属性

35.4.1 lnglatArr

说明：

经纬度对象数组。

类型：

array。

注释：

无

示例:




var lnglats=new MLngLats(arr);

alert(lnglats.lnglatArr [0].lngX+";"+lnglats.lnglatArr [0].latY);



36 MPoint()

36.1 说明

构建像素坐标对象。

36.2 命名空间

com.mapabc.maps.api.basetypes.MPoint。

36.3 构造方法

36.3.1 MPoint(x,y)

说明：

构建像素坐标对象。

参数：

（1）x：

说明：以屏幕左上角为坐标原点，水平向右为 x 值增长方向。

类型：number。

（2）y：

说明：以屏幕左上角为坐标原点，垂直向下为 y 值增长方向。

类型：number。

注释：

无

示例：

var point=new MPoint(100,100);

36.4 属性

36.4.1 x

说明：

水平向右方向偏离坐标原点的值。

类型：

number。

注释：

无



36.4.2 y

说明：

垂直向下方向偏离坐标原点方向的值。

类型：

number。

注释：

无

示例：

var point=new MPoint(400,500);

alert(point.x+";"+point.y);

37 MSize()

37.1 说明

构建显示尺寸对象。

37.2 命名空间

com.mapabc.maps.api.basetypes.MSize。

37.3 构造方法

37.3.1 MSize(width,height)

说明：

MSize 表示地图矩形区域的大小（以像素表示）。大小对象有两个参数：width 和 height。

宽度是点的 x 坐标的差值，高度是 y 坐标的差值。

参数：

（1）width:

说明：宽度。

类型：number。

（2）height:

说明：高度。

类型：number。

注释：

MSize 的两个参数同 width 和 height 属性一样可访问，但最好不要修改它们，而是在

http://code.google.com/intl/zh-CN/apis/maps/documentation/reference.html#GSize

http://code.google.com/intl/zh-CN/apis/maps/documentation/reference.html#GSize



创建新对象时使用不同的参数。

37.4 属性

37.4.1 width

说明：

点的 x 坐标的差值。

类型：

number。

注释：

无

37.4.2 height

说明：

点的 y 坐标的差值。

类型：

number。

注释：

无

示例：

var size=new MSize(400,500);

alert(size.width+";"+size.height);

38 MLngLatBounds()

38.1 说明

通过西南角、东北角的经纬度坐标，构建经纬度矩形区域对象，类似于 MPixelBounds()

的对象构建。

38.2 命名空间

com.mapabc.maps.api.basetypes.MLnglatBounds。



38.3 构造方法

38.3.1 MLngLatBounds(southWest,northEast)

说明：

通过西南、东北角的经纬度坐标构建经纬度矩形区域对象。

参数：

（1）southWest：

说明：西南角的经纬度坐标。

类型：MLngLat。

（2）northEast：

说明：东北角的经纬度坐标。

类型：MLngLat。

注释：

无

示例：

var lngLatBounds=

New MLngLatBounds(new MLngLat("JIOMSOLTLNLLHH"," LQGWUKPNQLLHL"),

new MLngLat("JIOMTQQWLOHHLD"," LQGXWLHRMLPLH"));

38.4 属性

38.4.1 southWest

说明：

MLngLatBounds 对象西南角的经纬度坐标。

类型：

MLngLat。

注释：

无

38.4.2 northEast

说明：

MLngLatBounds 对象东北角的经纬度坐标。

类型：

MLngLat。

注释：

无

示例：

var lngLatBounds=



new MLngLatBounds(new MLngLat("JIOMSOLTLNLLHH"," LQGWUKPNQLLHL"),

new MLngLat("JIOMTQQWLOHHLD"," LQGXWLHRMLPLH"));

alert(lngLatBounds.getNorthEast().lngX+";"+lngLatBounds.getNorthEast().latY);

39 MPixelBounds()

39.1 说明

构建像素坐标矩形区域对象，可以用来表示矩形区域最大、最小像素坐标，其值因 zoom

级别的不同而不同。

39.2 命名空间

com.mapabc.maps.api.basetypes.MPixelBounds。

39.3 构造方法

39.3.1 MPixelBounds(topLeftPt,rightBottomPt)

说明：

通过左上角和右下角的像素坐标构建矩形区域边界对象。

参数：

（1）topLeftPt：

说明：左上角的像素坐标。

类型：MPoint。

（2）rightBottomPt：

说明：右下角的像素坐标。

类型：MPoint。

注释：

无

示例：

var pixelBounds=new MPixelBounds(new MPoint(0,0),new MPoint(600,800));

39.4 属性

39.4.1 maxX

说明：

最大的 x 值。



类型：

number。

注释：

无

39.4.2 maxY

说明：

最大的 y 值。

类型：

number。

注释：

无

39.4.3 minX

说明：

最小的 x 值。

类型：

number。

注释：

无

39.4.4 minY

说明：

最小的 y 值。

类型：

number。

注释：

无

命名空间：com.mapabc.maps.api.events

40 MEvent

40.1 说明

封装了所有事件。



40.2 命名空间

com.mapabc.maps.api.events。

40.3 事件回调返回属性

40.3.1 mapId

说明：

当前地图的 id。

类型：

String

注释：

无

40.3.2 overlayId

说明：

overlay 对象的 id。

类型：

String

注释：

无

40.3.3 eventType

说明：

事件类型名称。

类型：

String

注释：

无

40.3.4 eventX

说明：

经度坐标。

类型：



String

注释：

无

40.3.5 eventY

说明：

纬度坐标。

类型：

String

注释：

无

40.3.6 zoom

说明：

Zoom 级别。

类型：

String

注释：

无

40.3.7 measureResult

说明：

测量的距离。

类型：

String

注释：

无

40.3.8 menuItemId

说明：

右键菜单项的 Id。

类型：

String

注释：

无



40.3.9 objectType

说明：

右键菜单触发事件的对象类型。

类型：

String

注释：

无

40.3.10 tileLayerId

说明：

切片的 ID。

类型：

String

注释：

无

40.3.11 bounds

说明：

矩形区域经纬度范围。

类型：

MLnglatBounds

注释：

无

40.3.12 dotId

说明：

数据点 ID。

类型：

String

注释：

无

40.3.13 value

说明：

全景地图雷达角度。

或者渐变点的 value 值。

类型：



Number

注释：

无

40.4 事件

40.4.1 MAP_READY 事件

说明：

当地图准备完毕时触发该事件。

语法：

MMap.addEventListener(mapObj,MAP_READY,ready);

返回值：

一个 MEvent 对象，它具有下列属性：

mapId：

说明：地图对象的名称。

类型：string。

eventType：

说明：事件类型名称。

类型：string。

注释：

无

示例：

mapObj.addEventListener(mapObj,MAP_READY,ready);

function ready(param){

alert(param.mapId+";"+param.eventType);

}

40.4.2 TIP_OPEN 事件

说明：

打开 tip 时触发该事件。

语法：

MMap.addEventListener(mapObj,TIP_OPEN,openTip);

返回值：


mapId:


类型：string。

eventType：


类型：string。

overlayId：



说明：overlay 对象的 id，否则返回空。

类型：string。

示例：

mapObj.addEventListener(mapObj,TIP_OPEN, openTip);

function openTip(param){

alert(param.mapId+";"+param.eventType+";"+param.overlayId);}

40.4.3 TIP_CLOSE 事件

说明：

关闭 tip 时触发该事件。

语法：

MMap.addEventListener(mapObj,TIP_CLOSE,closeTip);

返回值：


mapId：


类型：string。

eventType：


类型：string。

overlayId：


类型：string。

示例：

mapObj.addEventListener(mapObj,TIP_CLOSE, closeTip);

function closeTip(param){


40.4.4 TIP_BEFORE_CLOSE 事件

说明：

关闭 tip 之前触发该事件。

语法：

MMap.addEventListener(mapObj,TIP_BEFORE_CLOSE,beforeCloseTip);

返回值：


mapId:


类型：string。

eventType：

说明:事件类型名称。

类型：string。



overlayId：


类型：string。

示例：

mapObj.addEventListener(mapObj,TIP_BEFORE_CLOSE, beforeCloseTip);

function beforeCloseTip(param){


40.4.5 ADD_OVERLAY 事件

说明：

向地图上添加覆盖层时触发该事件。

语法：

MMap.addEventListener(mapObj,ADD_OVERLAY,addOverlay);

返回值：


mapId：


类型：string。

eventType：


类型：string。

overlayId：

说明：添加到地图上 overlay 对象的 id。

类型：string。

示例：

mapObj.addEventListener(mapObj, ADD_OVERLAY, addOverlay);

function addOverlay(param){


40.4.6 REMOVE_OVERLAY 事件

说明：

删除地图上覆盖物时触发该事件。

语法：

MMap.addEventListener(mapObj,REMOVE_OVERLAY,removeOverlay);

返回值：


mapId：


类型：string。

eventType：




类型：string。

overlayId：

说明：overlay 对象的 id。

类型：string。

示例：

mapObj.addEventListener(mapObj,REMOVE_OVERLAY,removeOverlay);

function removeOverlay(param){

alert(param.mapId+”;”+param.eventType+”;”+param.overlayId);}

40.4.7 CLEAR_OVERLAYS 事件

说明：

同时删除地图上所有覆盖层时触发该事件。

语法：

MMap.addEventListener(mapObj,CLEAR_OVERLAYS,clearOverlays);

返回值：


mapId：


类型：string。

eventType：


类型：string。

示例：

mapObj.addEventListener(mapObj,CLEAR_OVERLAYS,clearOverlays);

function clearOverlays(param){

alert(param.mapId+”;”+param.eventType);}

40.4.8 ADD_TILELAYER 事件

说明：

向地图上叠加图层时触发该事件。

语法：

MMap.addEventListener(mapObj,ADD_TILELAYER,addTileLayer);

返回值：


mapId:


类型：string。

eventType：


类型：string。

tileLayerId：



说明：tileLayer 对象的 id。

类型：string。

示例：

mapObj.addEventListener(mapObj, ADD_ TILELAYER, addTileLayer);

function addTileLayer (param){

alert(param.mapId+";"+param.eventType+";"+param.tileLayerId);}

40.4.9 TILE_MOUSE_OVER 事件

说明：

鼠标移入切片时触发该事件。

语法：

MMap.addEventListener(mapObj,TILE_MOUSE_OVER,mouseOverTile);

返回值：


mapId:


类型：string。

eventType：


类型：string。

tileLayerId：

说明：tileLayer 对象的 id。

类型：string。

bounds：

说明：切片对象的经纬度范围。


示例：

mapObj.addEventListener(mapObj, TILE_MOUSE_OVER, mouseOverTile);

function mouseOverTile (param){

alert(param.mapId+";"+param.eventType+";"+param.tileLayerId+

param.bounds.southWest.lngX+";"+ param.bounds.southWest.latY+

";"+ param.bounds.northEast.lngX+";"+ param.bounds.northEast.latY+"\n";);}

40.4.10 MOUSE_CLICK 事件

说明：

单击鼠标左键时触发该事件。

语法：

MMap.addEventListener(mapObj/overlay,MOUSE_CLICK,clickMouse);

返回值：




mapId：


类型：string。

eventType：


类型：string。

overlayId：

说明：所单击覆盖物的 Id。

类型：string。

备注：当单击覆盖物对象时还有此返回值。

eventX：

说明：单击点的经度坐标。


eventY：

说明：单击点纬度坐标。


dotId：

说明：数据点 Id，只有调用 addDataLayer()方法时，才会返回此属性。

类型：string

示例：

mapObj.addEventListener(mapObj,MOUSE_CLICK,clickMouse);

function clickMouse(param){

alert(param.mapId+";"+param.eventType+";"+param.eventX+";"+param.eventY);}

40.4.11 MOUSE_DBCLICK 事件

说明：

双击鼠标左键时触发该事件。

语法：

MMap.addEventListener(mapObj,MOUSE_DBCLICK,dbclickMouse);

返回值：


mapId：


类型：string。

eventType：


类型：string。

eventX：

说明：双击点的经度坐标。


eventY：

说明：双击点的纬度坐标。




示例：

mapObj.addEventListener(mapObj,MOUSE_DBCLICK,dbclickMouse);

function dbclickMouse(param){


40.4.12 MOUSE_DOWN 事件

说明：

鼠标键落下时触发该事件。

语法：

MMap.addEventListener(mapObj/overlay,MOUSE_DOWN,mouseDown);

返回值：


mapId：


类型：string。

eventType：


类型：string。

eventX：

说明：经度坐标。


eventY：

说明：纬度坐标。


overlayId：

说明：overlay 对象的 id。。

类型：string。

备注：当在覆盖物上落下鼠标键时有此返回值。

示例：

mapObj.addEventListener(mapObj,MOUSE_DOWN,mouseDown);

function mouseDown(param){


40.4.13 MOUSE_MOVING 事件

说明：

在地图上移动鼠标时触发该事件。

语法：

MMap.addEventListener(mapObj,MOUSE_MOVING,mouseMoving)

返回值：




mapId：


类型：string。

eventType：


类型：string。

eventX：



eventY:



示例：

mapObj.addEventListener(mapObj, MOUSE_MOVING,mouseMoving);

function mouseMoving(param){


40.4.14 MOUSE_UP 事件

说明：

在地图或者覆盖物上抬起鼠标键时触发该事件。

语法：

MMap.addEventListener(mapObj/overlay,MOUSE_UP,mouseUp);

返回值：


mapId：


类型：string。

eventType：


类型：string。

eventX：



eventY：



overlayId：


类型：string。

备注：当在覆盖物上抬起鼠标键时有此返回值。

示例：

mapObj.addEventListener(mapObj,MOUSE_UP,mouseUp);



function mouseUp(param){


40.4.15 MOUSE_OVER 事件

说明：

鼠标移到地图或覆盖物上时触发该事件。

语法：

MMap.addEventListener(mapObj/overlay,MOUSE_OVER,mouseOver);

返回值：


mapId:


类型：string。

eventType：


类型：string。

overlayId：


类型：string。

备注：当鼠标移动到覆盖物上时有此返回值。

eventX：




eventY：


类型：string/ number。


示例 1：

mapObj.addEventListener(mapObj,MOUSE_OVER,mouseOver);

function mouseOver(param){

alert(param.mapId+";"+param.eventType);}

示例 2：

mapObj.addEventListener(mMarker,MOUSE_OVER,mouseOver);

function mouseOver(param) {

alert(param.mapId+";"+param.eventType+";"+param.overlayId+";"+param.eventX+";"+para

m.eventY);}

40.4.16 MOUSE_OUT 事件

说明：



鼠标移出地图或覆盖物上时触发该事件。

语法：

MMap.addEventListener(mapObj/overlay,MOUSE_OUT,mouseOut);

返回值：


mapId:


类型：string。

eventType：


类型：string。

overlayId：


类型：string。

备注：当鼠标移出覆盖物时有此返回值。

eventX：



备注：当鼠标移出覆盖物时有此返回值。

eventY：



备注：当鼠标出到覆盖物时有此返回值。

示例 1：

mapObj.addEventListener(mapObj,MOUSE_OUT,mouseOut);

function mouseOut(param){


示例 2：

mapObj.addEventListener(mMarker,MOUSE_OUT,mouseOut);

function mouseOut(param) {


m.eventY);}

40.4.17 DRAG_START 事件

说明：

开始拖拽地图或者覆盖物对象时触发该事件。

语法：

MMap.addEventListener(mapObj /overlay,DRAG_START,startDrag);

返回值：


mapId：


类型：string。



eventType：


类型：string。

eventX：



eventY:



overlayId：


类型：string。

备注：当拖拽覆盖物时有此返回值。

示例：

mapObj.addEventListener(mapObj,DRAG_START,startDrag);

function startDrag(param){


40.4.18 DRAGGING 事件

说明：

拖拽地图或者覆盖物对象过程中触发该事件。

语法：

MMap.addEventListener(mapObj/overlay,DRAGGING,dragging);

返回值：


mapId：


类型：string。

eventType：


类型：string。

overlayId：


类型：string。

备注：拖拽覆盖物时有此返回值。

示例：

mapObj.addEventListener(mapObj,DRAGGING,dragging);

function dragging(param){




40.4.19 DRAG_END 事件

说明：

拖拽地图或者覆盖物结束时触发该事件。

语法：

MMap.addEventListener(mapObj/MOverlay,DRAG_END,endDrag);

返回值：


mapId：


类型：string。

eventType：


类型：string。

eventX：



eventY：



overlayId：


类型：string。

备注：拖拽覆盖物时有此返回值。

示例：

mapObj.addEventListener(mapObj,DRAG_END,endDrag);

function endDrag(param){


40.4.20 MAP_MOVE_START 事件

说明：

地图开始移动时触发该事件。

语法：

MMap.addEventListener(mapObj,MAP_MOVE_START,startMoveMap);

返回值：


mapId：


类型：string。

eventType：


类型：string。



eventX：

说明：当前地图中心点的经度坐标。


eventY：

说明：当前地图中心点的纬度坐标。


示例：

mapObj.addEventListener(mapObj,MAP_ MOVE _ START,startMoveMap);

function startMoveMap(param){


40.4.21 MAP_MOVING 事件

说明：

地图移动过程中触发该事件。

语法：

MMap.addEventListener(mapObj, MAP_MOVING, mapMoving)

返回值：


mapId:


类型：string。

eventType：


类型：string。

eventX:



eventY:

说明: 当前地图中心点的纬度坐标。


示例：

mapObj.addEventListener(mapObj, MAP_MOVING, mapMoving);

function mapMoving(param){


40.4.22 MAP_MOVE_END 事件

说明：

地图移动结束时触发该事件。

语法：

MMap.addEventListener(mapObj,MAP_MOVE_END,endMove);

返回值：




mapId：


类型：string。

eventType：


类型：string。

eventX：



eventY：

说明：当前地图中心点的纬度坐标。


示例：

mapObj.addEventListener(mapObj,MAP_MOVE_END,endMove);

function endMove(param){


40.4.23 ZOOM_START 事件

说明：

开始缩放地图时触发该事件。

语法：

MMap.addEventListener(mapObj,ZOOM_START,startZoom);

返回值：


mapId：


类型：string。

eventType：


类型：string。

eventX：



eventY：



zoom：

说明：地图缩放前的 zoom 级别。

类型：int。

示例：

mapObj.addEventListener(mapObj,ZOOM_START,startZoom);

function startZoom(param){



alert(param.mapId+";"+param.eventType+";"+param.eventX+";"+param.eventY+";"+param.

zoom);}

40.4.24 ZOOM_END 事件

说明：

缩放地图结束时触发该事件。

语法：

MMap.addEventListener(mapObj,ZOOM_END,endZoom);

返回值：


mapId：


类型：string。

eventType：


类型：string。

eventX：



eventY：



zoom：

说明：地图缩放后的 zoom 级别。

类型：int。

示例：

mapObj.addEventListener(mapObj,ZOOM_END,endZoom);

function endZoom(param){


zoom);}

40.4.25 ZOOM_CHANGED 事件

说明：

改变地图缩放级别时触发该事件。

语法：

MMap.addEventListener(mapObj,ZOOM_CHANGED,changeZoom);

返回值：


mapId:


类型：string。



eventType：


类型：string。

eventX:



eventY:



zoom：

说明：地图缩放前的级别。

类型：int。

示例：

mapObj.addEventListener(mapObj,ZOOM_CHANGED,changeZoom);

function changeZoom(param){


zoom);}

40.4.26 ROLL_BACK 事件

说明：

地图状态回滚时触发该事件。

语法：

MMap.addEventListener(mapObj,ROLL_BACK,rollBack);

返回值：


mapId：


类型：string。

eventType：


类型：string。

eventX:

说明：所保存地图状态中心点的经度坐标。


eventY:

说明：所保存地图状态中心点的纬度坐标。


示例：

mapObj.addEventListener(mapObj,ROLL_BACK,rollBack);

function rollBack(param){




40.4.27 MEASURE_STEP 事件

说明：

测量一次直线距离后时触发该事件。

语法：

MMap.addEventListener(mapObj,MEASURE_STEP,measureStep);

返回值：


mapId：


类型：string。

eventType：


类型：string。

overlayId：


类型：string。

eventX：



eventY：



measureResult：

说明：测量的距离，单位为米。

类型：number。

示例：

mapObj.addEventListener(mapObj,MEASURE_STEP,measureStep);

function measureStep(param){


measureResult);}

40.4.28 MEASURE_END 事件

说明：

测距结束时触发该事件。

语法：

MMap.addEventListener(mapObj,MEASURE_END,endMeasure);

返回值：


mapId:


类型：string。



eventType：


类型：string。

overlayId：


类型：string。

eventX:



eventY:



measureResult：


类型：number。

示例：

mapObj.addEventListener(mapObj,MEASURE_END,endMeasure);

function endMeasure(param){

alert(param.mapId+";"+param.eventType+";"+overlayId+";"+param.eventX+";"+param.even

tY+";"+param. measureResult);}

40.4.29 COMPUTE_AREA_END 事件

说明：

测面结束时触发该事件。

语法：

MMap.addEventListener(mapObj, COMPUTE_AREA_END,endMeasure);

返回值：


mapId:


类型：string。

eventType：


类型：string。

eventX:



eventY:



measureResult：


类型：double。



overlayId：


类型：string。

示例：

mapObj.addEventListener(mapObj, COMPUTE_AREA_END,endMeasure);

function endMeasure(param){


measureResult+";"+param.overlayId);}

40.4.30 MENUITEM_CLICK 事件

说明：

点击右键菜单时触发该事件。

语法：

MMap.addEventListener(mapObj,MENUITEM_CLICK,clickMenuitem);

返回值：


mapId:


类型：string。

eventType：


类型：string。

overlayId：


类型：string。

menuItemId:

说明：右键菜单项 ID。

类型：string。

objectType:

说明：右键菜单触发事件的对象类型。

类型：string。

eventX:

说明：菜单左上角经度坐标


eventY:

说明：菜单左上角纬度坐标


示例：

mapObj.addEventListener(mapObj,MENUITEM_CLICK,clickmenuitem);

function clickmenuitem (param){

alert(param.mapId+";"+param.eventType+";"+param.overlayId+";"+param.menuItemId+";"+

param.objectType+";"+param.eventX+";"+param.eventY);}



40.4.31 GPS_MOVEALONG_COMPLETE 事件

说明：

调用 markerMoveAlong 方法，移动结束后触发事件。

语法：

MMap.addEventListener(mapObj, GPS_MOVEALONG_COMPLETE,moveStop);

返回值：


mapId：


类型：string。

eventType：


类型：string。

eventX：

说明：经度坐标


eventY：

说明：纬度坐标


overlayId：


类型：string。

示例：

mapObj.addEventListener(mapObj, GPS_MOVEALONG_COMPLETE,moveStop);

function moveStop (param){


m.eventY);}

40.4.32 OVERVIEWMAP_CHANGED 事件

说明：

改变鹰眼状态时触发该事件。

语法：

MMap.addEventListener(mapObj, OVERVIEWMAP_CHANGED,changeOverviewmap);

返回值：


mapId：


类型：string。

eventType：


类型：string。



示例：

mapObj.addEventListener(mapObj, OVERVIEWMAP_CHANGED, changeOverviewmap);

function changeOverviewmap (param){


40.4.33RADAR_INITIALIZED 事件

说明：

全景地图雷达初始化完成事件。

语法：

MMap.addEventListener(mapObj, RADAR_INITIALIZED,radarInitialized);

返回值：


mapId：


类型：string。

eventType：


类型：string。

overlayId：


类型：string。

注释：拖拽覆盖物时有此返回值

示例：

mapObj.addEventListener(mapObj, RADAR_INITIALIZED,radarInitialized);

function radarInitialized (param){


40.4.34 RADAR_POSITION_CHANGED 事件

说明：

全景地图雷达位置改变事件。

语法：

MMap.addEventListener(mapObj, RADAR_POSITION_CHANGED,radarPositionChanged);

返回值：


mapId：


类型：string。

eventType：


类型：string。

overlayId：




类型：string。

注释：拖拽覆盖物时有此返回值。

eventX：

说明：经度坐标


eventY：

说明：纬度坐标


示例：

mapObj.addEventListener(mapObj,

RADAR_POSITION_CHANGED,radarPositionChanged);

function radarPositionChanged (param){


40.4.35 RADAR_ROTATION_CHANGED 事件

说明：

全景地图雷达角度改变事件。

语法：

MMap.addEventListener(mapObj, RADAR_ROTATION_CHANGED,radarRotationChanged);

返回值：


mapId：


类型：string。

eventType：


类型：string。

overlayId：


类型：string。

注释：拖拽覆盖物时有此返回值。

value:

说明：雷达角度

类型：number。

示例：

mapObj.addEventListener(mapObj,

RADAR_ROTATION_CHANGED,radarRotationChanged);

function radarRotationChanged (param){




命名空间：com.mapabc.maps.api.maptools

41 MMapTools()

41.1 说明

地图工具类，它包含所有地图应用功能。

41.2 命名空间

com.mapabc.maps.api.maptools.MMapTools。

41.3 构造方法

41.3.1 MMapTools(mapObj)

说明：

构造一个 MMapTools 对象，参数表示当前地图对象。

参数：

mapObj：

说明：当前地图对象。

类型：object。

注释：

无

示例：

var maptools=new MMapTools(mapObj);

41.4 方法

41.4.1 addMassOverlay(massType,serverLayer,options)

说明：

海量数据展示。

参数：

（1）massType：



说明：海量数据叠加类型。

类型：contant。

取值：MConstants.ADD_MARKER，加真点型

MConstants.NO_MARKER，不加真点型

（2）serverLayer：

说明：渲染服务端数据层名称。

类型：string。

（3）massOverlayOptions：

说明：海量数据参数选项。

类型：MassOverlayOptions。

返回值:

无

注释：

无

示例：

maptools = new MMapTools(mapObj);

var tileOpt = new MTileLayerOptions();

tileOpt.tileUrl ="层地址";

var opt = new MassOverlayOptions();

opt.tileLayerType =TL_CUSTOM_MAP;

opt.tileLayerOptions = tileOpt;

maptools.addMassOverlay(MConstants.ADD_MARKER,"渲染服务端数据层名称",opt);

41.4.2 removeMassOverlay(massType,options)

说明：

删除地图上加载的海量数据。

参数：

（1）massType：

说明：加载海量数据类型。


取值：MConstants.ADD_MARKER，加真点型

MConstants.NO_MARKER，不加真点型

（4） Options：

说明：加载海量数据参数选项

类型：MassOverlayOptions

返回值:

无

注释：

无

示例：

maptools.removeMassOverlay(MConstants.ADD_MARKER,opt);



41.4.3 addSpecialLayer()

说明：

在地图上添加专题地图。

参数：

无

返回值:

无

注释：

无

示例：

maptools = new MMapTools(mapObj);

maptools.addSpecialLayer();

41.4.4 removeSpecialLayer()

说明：

删除地图上添加的专题地图。

参数：

无

返回值:

无

注释：

无

示例：

maptools.removeSpecialLayer();

41.4.5 setCenterByCity(city)

说明：

按照城市名称或城市号设置地图中心点。

参数：

（1）city：

说明：城市名称或者城市号。

类型：string。

返回值:

无

注释：

无

示例：

maptools.setCenterByCity("0633");



42 MassOverlayOptions()

42.1 说明

海量加载数据的参数选项。

42.2 命名空间

com.mapabc.maps.api.maptools.MassOverlayOptions。

42.3 构造方法

42.3.1 MassOverlayOptions()

说明：

创建海量加点的参数选项。

参数：

无

注释：

无

示例:

var massOverlayOptions=MassOverlayOptions ();

42.4 属性

42.4.1 tileLayerType

说明：

切片层类型。MTileLayer()构造函数中的第一个参数。

类型：

constant。

取值：（a）TL_TRAFFIC，实时交通图层

（b）TL_USERMAP，用户编辑器图层

（c）TL_MASS_TRANSIT，轨道交通层

（d）TL_CUSTOM_MAP，用户提供的图层

注释：

无



42.4.2 tileLayerOptions

说明：

切片层参数选项。

类型：

MTileLayerOptions

注释：

无

42.4.3 dataLayerOptions

说明：

数据层参数选项。

类型：

MDataLayerOptions

注释：

无

43 错误代码表

常数描述

-1 执行失败。

0 成功返回。

1 坐标对象结构不正确。

2 数组中坐标对象结构不正确。

3 数组中坐标格式不统一。

4 坐标或坐标数组为空。

9 未给定 ubas 配置形式。

11 ubas 配置的是加密，不允许输入偏移坐标。

12 ubas 配置的是加密，不允许输入真实坐标。

13 ubas 配置的是明码，不允许输入真实坐标。

14 坐标类型是加密，但坐标内容却是数字类型错误。

15 坐标值输入错误。

20 地图缩放级别超出范围，即小于 3 或者大于 17。



搜索 API:

命名空间：com.mapabc.search.api

44 MPoiSearch()

44.1 说明

MPoiSearch 类封装了所有 POI 查询方法。

44.2 命名空间

com.mapabc.search.api.MPoiSearch。

44.3 构造方法

44.3.1 MPoiSearch()

说明：

初始化 MPoiSearch 类的一个新实例。

示例：

var mls = new MPoiSearch();

44.4 方法

关键字查询

44.4.1 poiSearchByKeywords(keywords,city,options)

说明：

根据关键词搜索 POI。

参数：

（1）keywords：

说明：关键词。必填，当仅按数据类型查询时可设置为空字符串。



类型：string。

（2）city：

说明：城市编号或者城市名称。必填。全国为 total。

类型：string。

（3）options：

说明：POI 搜索输入参数选项，非必填，参见 MPoiSearchOptions 类。

类型：MPoiSearchOptions。本方法使用到 MPoiSearchOptions 中属性：

（a）dataType，查询数据类型

（b）recordsPerPage，每页记录数

（c）pageNum，第几页

（d）resType，返回格式

（e）dataSources，数据源

（f）srctype，自定义数据源

（g）extId，编辑器数据源专用，外部 ID

（h）eid，编辑器数据源专用，企业 ID

（i）userId，编辑器数据源专用，用户 ID

（j）tempId，编辑器数据源专用，模板 ID

返回值：

JSON 或 XML。

返回结果说明：

（1）一般返回结果，以 XML 为例：

<?xml version="1.0" encoding="GBK"?>

<searchresult servername="服务器名">



<count>此接口返回的结果集数量（默认最大结果集为400，可通过key权限修改，需要

联系管理员）</count>

<cache>此数据是否从缓存读取</cache>

<total>引擎返回的结果集总数量</total>

<record>此页返回的结果集数量（最大结果集为20）</record>

<searchtime>查询时间</searchtime>

<bounds>bounds值，当前返回的POI点统一个矩形框内，bounds为矩形框的左上右下坐

标对</bounds>

</searchresult>

（2）如果数据源是公交站点，返回的扩展字段信息，以 XML 为例：

<?xml version="1.0" encoding="UTF-8"?>

<CONTENT>

<STATION>

<DATA NAME="NAME"><![CDATA[清城]]></DATA> 站点名称

<DATA NAME="XY_COORDS"><![CDATA[116.327246;39.737597]]></DATA> 站点坐标，

以;分隔

<DATA NAME="SPELL"><![CDATA["qing cheng"]]></DATA>站点名称拼音

<DATA NAME="Code"><![CDATA[110100]]></DATA> 站点所在城市行政区划码

<DATA NAME="STATION_NUM"><![CDATA[1]]></DATA> 站序

</STATION>



<STATION>

<DATA NAME="NAME"><![CDATA[清源西里]]></DATA>

<DATA NAME="XY_COORDS"><![CDATA[116.332433;39.745734]]></DATA>

<DATA NAME="SPELL"><![CDATA["qing yuan xi li"]]></DATA>

<DATA NAME="Code"><![CDATA[110100]]></DATA>

<DATA NAME="STATION_NUM"><![CDATA[2]]></DATA>

</STATION>

<STATION>

<DATA NAME="NAME"><![CDATA[清源西里南站]]></DATA>

<DATA NAME="XY_COORDS"><![CDATA[116.339311;39.74475]]></DATA>

<DATA NAME="SPELL"><![CDATA["qing yuan xi li nan zhan"]]></DATA>

<DATA NAME="Code"><![CDATA[110100]]></DATA><DATA NAME="STATION_NUM">

<![CDATA[3]]></DATA>

</STATION>

</CONTENT>

示例：

var citycode = 010;

var keyword = „银行‟;

var mls =new MPoiSearch();

var mlsp= new MPoiSearchOptions();

mls.setCallbackFunction(myfunc); //设置回调函数

mls.poiSearchByKeywords(keyword,citycode,mlsp);

function myfunc(data){

if(data.error_message != undefined){

alert(data.error_message);

}else{

//解析返回数据

}

}

周边查询

44.4.2 poiSearchByCenPoi(centerPoiXY,keywords,city,options)

说明：

根据中心点坐标查询周边的 POI。

参数：

（1）centerPoiXY：

说明：中心点经纬度坐标。必填。

类型：Mlnglat。

（2）keywords：




类型：string。

（3）city：

说明：城市编号或者城市名称。必填，全国为 total。

类型：string。

（4）options：

说明：POI 查询参数选项。非必填，参见 MPoiSearchOptions 类。








（g）range，周边查询范围

（h）naviflag，导航距离排序标识

（i）sr，编辑器数据源，按距离排序标识

（j）extId，编辑器数据源专用，外部 ID

（k）eid，编辑器数据源专用，企业 ID

（l）userId，编辑器数据源专用，用户 ID

（m）tempId，编辑器数据源专用，模板 ID

返回值：

JSON 或 XML。


以 XML 为例：












标对</bounds>

<cenpoi>

<address>地址</address>

<name>POI名称</name>

<type>POI类型</type>

<timestamp>数据时间戳</timestamp>

<match>匹配度</match>

<url>url连接</url>



<distance>周边查询时，距离中心点距离</distance>

<x>x坐标</x>

<y>y坐标</y>

<citycode>城市号</citycode>

<pguid>索引ID，可以根据此ID查询POI</pguid>

<srctype>数据源</srctype>

<gridcode>5916728612</gridcode>

<tel>电话</tel>

<imageid>图片ID</imageid>

<xml>扩展查询字段，编辑器或者公交数据中，可能存在该字段，扩展字段的含义

和具体行业有关，该部分内容由应用自己去解析</xml>

<drivedistance> 周边查询按照导航距离排序时，距中心点的导航距离

</drivedistance>

</cenpoi> 

</searchresult>

示例：

var centerXY = new MLngLat(116.4190,39.9151);

var citycode =010;

var keyword ='酒店';



mlsp.range = 1000000;

mls.setCallbackFunction(myfunc); //回调函数

mls.poiSearchByCenPoi(centerXY,keyword,citycode,mlsp);

function myfunc(data)

{

if(data.error_message != null){


}else{

//解析返回结果

}

}

44.4.3 poiSearchByCenKeywords(centerKeywords,keywords,city,options)

说明：

根据中心点关键字查询周边的 POI。

参数：

（1）centerKeywords：

说明：中心点关键词。必填。

类型：string。

（2）keywords：

说明：关键字。必填。当仅按数据类型查询时可设置为空字符串。



类型：string。

（3）city：

说明：城市号或城市名称。必填，全国为 total

类型：string。

（4）options：

说明：POI 搜索参数选项。非必填，参见 MPoiSearchOptions 类。















返回值：

JSON 或 XML。


以 XML 为例：












标对</bounds>

<cenpoi>










<x>x坐标</x>

<y>y坐标</y>





<tel>电话</tel>





</drivedistance>


</searchresult>

示例：

var centerKeywords ='中关村';

var citycode =010;






mls.poiSearchByCenKeywords(centerKeywords,keyword,citycode,mlsp);


{



}else{


}

}

44.4.4 poiSearchByCenGridCode(centerGridCode,keywords,city,options)

说明：

根据中心点 GridCode 查询周边的 POI。

参数：

（1）centerGridCode：

说明：中心点 GridCode。必填。

类型：string。

（2）keywords：

说明：关键字。必填。当仅按数据类型查询时可设置为空字符串。



类型：string。

（3）city：

说明：城市编号或者城市名称。必填，全国为 total

类型：string。

（4）options：
















返回值：

JSON 或 XML。


以 XML 为例：












标对</bounds>

<cenpoi>










<x>x坐标</x>

<y>y坐标</y>





<tel>电话</tel>





</drivedistance>


</searchresult>

示例：

var centerGridCode='5916727421';

var citycode =010;


var mls=new MPoiSearch();

var mlsp=new MPoiSearchOptions();



mls.poiSearchByCenGridCode(centerGridCode,keyword,citycode,mlsp);


{



}else{


}

}

44.4.5 poiSearchByCenLineCross(lineXY1,lineXY2,keywords,option)

说明：

将两线交叉点做为中心点，根据中心点坐标查询周边的 POI。

参数：

（1）lineXY1：

说明：第一条线。必填。


（2）lineXY2：

说明：第二条线。必填。




（3）keywords：


类型：string。

（4）options：







（e）range，周边查询范围

（f）buffer，线缓冲区范围

（g）sortRule，排序规则

返回值：

JSON 或 XML。


以 XML 为例：

<?xml version="1.0" encoding="GB2312"?>

<spatial_response type="searchresult" servername="search1-1">

<searchresult>

<searchtime>60</searchtime>

<count>0</count>

<list type="list">

<poi>

<match>11</match>

<type>医疗保健服务;综合医院;三级甲等医院</type>

<id/>

<citycode>010</citycode>

<extid/>

<pguid>B000A82VAR</pguid>

<timestamp>2009-04-19</timestamp>

<name>304医院</name>

<srctype>basepoi</srctype>


<address>海淀区阜成路51号</address>

<tel>010-66867311</tel>

<icon/>

<url/>

<buscode>1</buscode>

<distance>441</distance>

<direction/>



<xml/>

</poi>

</list>

</searchresult>

</spatial_response>

<en_type />

<en_name />

<en_address />

<x>moohhnlqpntKJDH</x>

<y>owgsgrlrloOJHH</y>

</poi>

</list>

<bounds>moohgupwlkKJHL;owgsfslnqgOFLL;moohhoonsjuKFDD;owgsiqkooKJHD</

bounds>

</searchresult>

</spatial_response>

示例：

var keyword = document.form1.keyword.value;

var arr1 = new Array();


arr1.push(new MLngLat(116.368904,39.913423));

arr1.push(new MLngLat(116.382122,39.901176));

arr2.push(new MLngLat("116.305355","39.9823278"));


var line1 = new MLngLats(arr1);

var line2 = new MLngLats(arr2);



mls.setCallbackFunction(myfunc);

mls.poiSearchByCenLineCross(line1,line2,keyword,mlsp);


{



}else{


}

}



PGUID 查询

44.4.6 poiSearchByPguid(pguid,city,options)

说明：

根据 PGUID 查询 POI。

参数：

（1）pguid：

说明：全局索引 ID。必填。

类型：string。

（2）city：

说明：城市编号或者城市名称。必填，全国为 total。

类型：string。

（3）options：



（a）resType，返回格式

（b）dataSources，数据源

（c）srctype，自定义数据源





返回值：

JSON 或 XML。


以 XML 为例：

<?xml version="1.0" encoding="GBK" ?>

<searchresult servername="60.247.103.19">

<count>此接口返回的结果集数量（最大结果集为 400）</count>



<record>此页返回的结果集数量（最大结果集为 20）</record>


<bounds>bounds 值，根据 xy 生成</bounds>

<list type="list">

<poi>

<address />

<name>六顺兴宾馆</name>

<type>住宿服务;宾馆酒店;宾馆酒店</type>




<match>10</match>

<url />


<x>JQMELSMTSMSKIFM</x>

<y>LYEPQVOOTLOINE</y>


<pguid>B000A7YYW9</pguid>



<tel />

<buscode />

<imageid />

<linkid />

<drivedistance>0</drivedistance>

</poi>

</list>

</searchresult>

示例：

var citycode = 010;

var pguid = "B000A7YYW9";




mls.poiSearchByPguid(pguid,citycode,mlsp);


{



}else{


}

}

拉框查询

44.4.7 poiSearchByRegion(regionType,regionXY,keywords,options)

说明：

查询区域范围内的 POI。

参数：

（1）regionType：

说明：区域类型。必填。




取值：MOverlay.TYPE_POLYGON，多边形

MOverlay.TYPE_CIRCLE，圆形

MOverlay.TYPE_RECTANGLE，矩形

（2）regionXY：

说明：区域经纬度坐标。必填。对于圆形和矩形是外切矩形左下右上经纬度坐标数

组，对于多边形是顶点经纬度坐标数组。


（3）keywords：

说明：关键字，必填。

类型：string。

（4）options：









（g）buffer，多边形缓冲区范围

（h）sortRule，排序规则

（i）custom，自定义查询参数

（j）custom_and，自定义查询参数的查询条件





返回值：

JSON 或 XML。

注释：

目前支持的数据源包括基础库+地标库、编辑器库，默认为基础库+地标库


（1）数据源为基础库和地标库，以 XML 为例：


<spatial_response type="searchresult" servername="sis_tj_03">

<searchresult>

<searchtime>0</searchtime> <!—查询时间-->

<count>1557</count> <!—总结果记录数-->

<list type="list"> <!—返回poi的列表-->

<poi>

<match /> 



<type /> 

<citycode /> <!—城市号

<extid /> 

<name>安华学校</name> <!—名称—>

<srctype /> <!—数据来源-->

<gridcode /> <!—网格号-->

<address>外馆斜街</address> <!—地址-->

<tel /> <!—电话-->

<xml /> <!—扩展信息-->

<x>PKSGQTRJMOM</x> <!—x坐标-->

<y>RSKRTONMKI</y> <!—y坐标-->

</list>

<bounds>PKSGQLOKXMNIKE;RSKQSPPMXNNMOI;PKSGRPNJRQTNIKE;RSKRTONIK

I</bounds>

</searchresult>

</spatial_response>

（2）数据源为编辑器，以 XML 为例：

<?xml version="1.0" encoding="utf-8" ?>


<searchresult>


<count>21</count>

<list type="list">

<poi>

<match />

<type />

<id />


<extid>a6510</extid>

<pguid />

<timestamp>1247031589178</timestamp>

<name>北京铂丽商务酒店</name>

<srctype>userpoi</srctype>


<address>北京市朝阳区永安东里 1 号</address>

<tel />

<icon />

<url />

<buscode />




<direction />

<xml />

<en_type />

<en_name />

<en_address />

<x>OQMNRNNSOIMNM</x>

<y>QYEYNNWQKMEJE</y>

</poi>

</list>

<bounds>OQMNQQVOKPEMJI;QYEYNNQUPIIJI;OQMNRNSQNRIMJM;QYEYW

KSTKEIJM</bounds>

</searchresult>

</spatial_response>

示例：

var type = MOverlay.TYPE_CIRCLE;

var region = "116.3084014,39.9640344,116.4599165,39.8583246";

var keyword = "学校";

var arr1 = region.split(",");

var arr =new Array();

for(var i = 0 ;i<=arr1.length-2;){

var mll =new MLngLat(arr1[i],arr1[i+1]);

arr.push(mll);

i=i+2;

}

var mlls = new MLngLats(arr);




mls.poiSearchByRegion(type,mlls,keyword,mlsp);


{



}else{


}

}



缓冲区查询

44.4.8 poiSearchByLine(lineXY,keywords,city,options)

说明：

查询整条路线缓冲区范围的 POI。

参数：

（1）lineXY：

说明：线经纬度坐标。


（2）keywords：


类型：string。

（3）city：


类型：string。

（4）options：




（b）cenXY，道路上的一个查询中心点，当此值不为空时，此方法变为以道

路中心点相对左前、右前、左后、右后位置方向范围内的缓冲区查询。

（c）sign，相对位置方向

（d）buffer，多边形或线的缓冲区范围

（g）resType，返回格式

返回值：

JSON 或 XML。


以 XML 为例：

<?xml version="1.0" encoding="GB2312" ?>


<searchresult>


<count>34</count>

<list type="list">

<poi>

<match>10</match>

<type>科教文化服务;学校;高等院校</type>

<id />


<extid />

<pguid>B000A7BP2D</pguid>




<name>中央广播电视大学</name>



<address>复兴门内大街 160</address>

<tel>010-66490114</tel>

<icon />

<url />



<direction />

<xml />

<en_type />

<en_name />

<en_address />

<x>ILOFJLQHTUHHNM</x>

<y>KTGQGMMOTHHFM</y>

</poi>

</list>

<bounds>ILOFJKONRXRDLNI;KTGPPPNLRDHJI;ILOFKJQNRYSHHNI;KTGQIP

ONXWLHNI</bounds>

</searchresult>

</spatial_response>

示例：

var city = 010;

var region = "116.439888,39.93461583,116.439895,39.93436,116.439941,39.93402833";

var keyword = "修理站";

var arr1 = region.split(",");




arr.push(mll);

i=i+2;

}

var mlls = new MLngLats(arr);



mlsp.buffer = 50000;


mls.poiSearchByLine(mlls,keyword,city,mlsp);


{





}else{


}

}

44.4.9 poiSearchByRoadId(roadId,keywords,city,options)

说明：

根据道路 ID 查询整条路线缓冲区范围的 POI。

参数：

（1）roadId：

说明：道路 ID。

类型：string。

（2）keywords：


类型：string。

（3）city：


类型：string。

（4）options：




（b）range，线的缓冲区范围

（e）resType，返回格式

（f）sortRule，排序规则

返回值：

JSON 或 XML。


以 XML 为例：


<spatial_response type="searchresult" servername="60.247.103.19">

<searchresult>


<count>4</count>

<bounds>JQMEMPLTSMSGENI;LYEPMXHPTOKMNM;JQMEMPPPWL

ROIFI;LYEPOVNWTLGMJE;</bounds>

<list type="list">

<poi>

<address>安德路甲 11</address>

<name>北京安定门中医医院</name>



<id />

<type>医疗保健服务;综合医院;综合医院</type>


<match>10</match>

<icon />


<x>JQMEMPNRXNOEJI</x>

<y>LYEPNQOOXPKMNI</y>


<extid />

<pguid>B000A7OFUC</pguid>



<tel>010-84130283</tel>


<imageid>0a772008042700000476</imageid>

<linkid />

<picpath />

<dn />

<drivedistance>0</drivedistance>

</poi>

</list>

</searchresult>

</spatial_response>

示例：

var city = 010;

var roadId = "001011355";

var keyword = "医院";




mls.poiSearchByRoadId(roadId,keyword,city,mlsp);


{



}else{


}

}



输入提示

44.4.10typeAhead(keywords,city,options)

说明：

关键字输入提示。

参数：

（1）keywords：


类型：string。

（2）city：


类型：string。

（3）options：



（a）resData，返回数据形式

（b）resType，返回格式

返回值：

JSON 或 XML。


北京市西城区西单北大街 :5916629912,北京市西城区西单横 :5916639010,北京市西城区西

单 :5916629902,北京市西城区西单文化广场 :5916638020, 北京市西城区西单民丰胡

同:5916629902,北京市西城区大木仓北一巷 1 号西单饭店:5916629912,北京市西城区西单大

木:5916629912,北京市西城区西单北大街 120 号西单商场:5916629912,北京市西城区西单北

大街 180 号西单文化广场:5916639000,北京市西城区西单手帕胡同:5916628921

示例：

var citycode = 010;

var keyword = "北";


var mlsp = new MPoiSearchOptions();


mls.typeAhead(keyword,citycode,mlsp);


{



}else{


}

}



行政区域查询

44.4.11poiSearchByDistrictName(districtName,keywords,city,options)

说明：

根据行政区域名称查询行政区域内的 POI。

参数：

（1）districtName：

说明：行政区域名称。

类型：string。

（2）keywords：


类型：string。

（3）city：


类型：string。

（4）options：







（e）sortRule，排序规则

返回值：

JSON 或 XML。


以 XML 为例：



<searchresult>


<count>5820</count>

<list type="list">

<poi>

<match>10</match>

<type>餐饮服务;中餐厅;中餐厅</type>

<id />


<extid />



<pguid>B00150D4AE</pguid>


<name>明记</name>



<address>东方路 1486-1 识别</address>

<tel>021-58701107</tel>

<icon />

<url />

<buscode />


<direction />

<xml />

<en_type />

<en_name />

<en_address />

<x>hnfejnunigMLKN</x>

<y>jmcifmprjIHKN</y>

</poi>

</list>

<bounds>hnfeiutnmgMHON;jmchjpvomMHKN;hnfejqwmiEHON;jmciimsqkMDKN<

/bounds>

</searchresult>

</spatial_response>

示例：

var city = 021;

var place ="浦东";

var keyword ="饭店";




mls.poiSearchByDistrictName(place,keyword,city,mlsp);


{



}else{


}

}



45 MPoiSearchOptions()

45.1 说明

POI 查询方法参数选项，用来设置 POI 查询方法的查询参数。

45.2 命名空间

com.mapabc.search.api.MPoiSearchOptions。

45.3 构造方法

45.3.1 MPoiSearchOptions()

说明：

初始化 MPoiSearchOptions 类的一个新实例。

示例:

var poisearchoptions=new MPoiSearchOptions();

45.4 属性

45.4.1 dataSources

说明：

数据源。

取值：

DS_BASE，基础数据库

DS_USERPOI，编辑器数据库

DS_BASE_USERPOI，基础+编辑器数据库

DS_ENPOI，企业地标数据库

DS_BASE_ENPOI，基础+企业地标数据库（默认）

DS_BASE_BUS，基础+公交车站数据库

类型：

constant。

45.4.2 srcType

说明：



数据源高级参数

取值：

默认值为""

类型：

string。

注释：

同时设置 dataSource 及 srcType 参数时，以 srcType 属性值为准。

45.4.3 dataType

说明：

数据类型。

取值：

默认值为""。

类型：

string。

45.4.4 recordsPerPage

说明：

每页返回几条记录。

取值：

默认值为 10。

类型：

number。

45.4.5 pageNum

说明：

返回第几页。

取值：

默认值为 1。

类型：

number。

45.4.6 resType

说明：

返回结果形式。

取值：

JSON（默认）

XML

类型：



string。

45.4.7 range

说明：

查询范围。

取值：

单位为米

默认值为 3000

类型：

number。

45.4.8 naviFlag

说明：

周边查询返回结果是否按导航距离排序。

取值：

0，不按导航距离排序（默认）

1，按导航距离排序。

类型：

Number

注释：

该属性仅适用于针对基础数据库的周边查询方法。

45.4.9 sr

说明：

周边查询返回结果是否按直线距离排序。

取值：

0，不按直线距离排序（默认）

1，按直线距离排序。

类型：

Number

注释：

该属性仅适用于针对编辑器数据库的周边查询方法。

45.4.10 extId

说明：

外部 id。

取值：

默认值为""

类型：



string。

注释：

编辑器数据库专用

45.4.11 eid

说明：

企业 id。

取值：

默认值为""。

类型：

string。

注释：


45.4.12 userId

说明：

用户 id。

取值：

默认值为""。

类型：

string。

注释：


45.4.13 tempId

说明：

模板 id。

取值：

默认值为""。

类型：

string。

注释：


45.4.14 buffer

说明：

线或多边形缓冲区设置。

取值：

单位为米



默认值为 0。

类型：

Number

45.4.15 sortRule

说明：

排序规则。

取值：

默认值为 0。

类型：

Number

45.4.16 resData

说明：

返回数据形式。

取值：

0（默认）

1

2

类型：

Number

45.4.17 cenXY

说明：

道路上的一个查询中心点

类型：

MLngLat

45.4.18 sign

说明：

cenXY 为基准的相对位置

取值：

1，左前（默认）

2，右前

3，左后

4，右后

类型：

Number



45.4.19 custom

说明：

自定义查询参数。

取值：

格式举例：address:学院路;tel:66882222

类型：

String

45.4.20 custom_and

说明：

custom 自定义查询参数中，以分号分隔的多组查询条件之间的与或关系

取值：

ture，与关系

false，或关系

类型：

String

45.4.21 requestMethod

说明：

请求方式

取值：

get，get 请求方式（默认）

post，post 请求方式

类型：

String

45.5 方法

无

45.6 示例

var mlsp= new MpoiSearchOptions();

mlsp.dataSources= DS_BASE;

mlsp.dataType="酒店";

mlsp.range=2000;

mlsp.recordsPerPage=3;

mlsp.pageNum=2;



mlsp.returnType="JSON";

mlsp.srcType="BUS:1%2BPOI";

46 MRouteSearch()

46.1 说明

MRouteSearch 封装了所有路径导航查询方法。

46.2 命名空间

com.mapabc.search.api.MRouteSearch。

46.3 构造方法

46.3.1 MRouteSearch()

说明：

初始化 MRouteSearch 类的一个新实例。

示例：

var mls = new MRouteSearch();

46.4 方法

导航路径查询

46.4.1 routeSearchByTwoPoi(startPoiXY,endPoiXY,options)

说明：

根据起点和终点查询驾车导航路径。

参数：

（1）startPoiXY：

说明：起点坐标。必填。

类型：MLngLat。

（2）endPoiXY：

说明：终点坐标。必填。



类型：MLngLat。

（3）options：

说明：路径导航搜索输入参数对象，非必填，参见 MRouteSearchOptions 类。

类型：MRouteSearchOptions。本方法使用到 MRouteSearchOptions 中属性：


（b）per，抽吸函数

（c）routeType，路径计算规则

（d）region，避让区域坐标

（e）name，避让区域名称

（f）avoidanceType，避让规则

（g）passByXY，途经点。

（h）ext，自定义格式类型

返回值：

JSON 或 XML。

注释：

本方法设置 passByXY 参数后，与 routSearchByMultiPoi 方法的区别为本方法按照

routeType 参数设置的导航方式进行导航；routSearchByMultiPoi 按照多点参数的输入顺序进

行导航。


以 XML 为例：


<RoutingJ ver="2.0" servername="60.247.103.19">

<count>15</count> <!—换乘方案的段数-->

<cache>false</cache> <!—是否被缓存-->

<searchtime>7</searchtime><!—查询时间-->

<bounds>KIUNJQMKPLHHM;MQMRJYHOHHHE;KIVNOTOLNLHDE;MQMYMY

LOSHHHM</bounds><!—bounds 值-->

<segmengList type="list"><!—导航路径规划的段数列表-->

<segment><!—第 1 段-->

<action>偏左转</action> <!—辅助动作-->

<roadname>北三环西路辅路</roadname> <!—道路名称-->

<direction>东</direction> <!—行使方向-->

<roadlength>825</roadlength><!—行驶距离-->

<coor>KIUNJQMKPHHDE,MQMYMTPLLHLM</coor><!—行使路段坐标-->

<grade>主要道路</grade><!—道路等级-->

<drivetime>2 分钟</drivetime><!—估算行驶时间-->

<accessorialinfo>进入主路</accessorialinfo><!—动作-->

<textinfo>沿北三环西路辅路向东行驶 825米偏左转进入主路</textinfo> <!—本段道路行

使文字描述-->

<form>辅路</form><!—道路描述性质描述，见下文 form 接点列表-->

</segment>

<segment/>

<segment/>



<coors>KIVNHRMPLHDM,MQMTKYPNLHLI,KIVNHRNOHLLI,MQMTKRMN

DHHE,KIVNHUIMDLLE</coors> <所有 sgement 接点坐标集合，如果设置了抽希参

数，则为抽希后结果>

</RoutingJ>

示例：

var startXY= new MLngLat(116.5,38.2);

var endXY = new MLngLat(117,38.9);

var mrs =new MRouteSearch();

var options=new MRouteSearchOptions();

mrs.setCallbackFunction(myfunc);

mrs.routeSearchByTwoPoi(startXY,endXY,options);




}else{


}

}

46.4.2 routeSearchByMultiPoi(multiPoiXY,options)

说明：

多点驾车导航路径查询。按照多点参数的输入顺序进行导航。

参数：

（1）multePoiXY：

说明：多点坐标。必填。


（2）options：






返回值：

JSON 或 XML。


以 XML 为例：


- <RoutingJ ver="2.0" servername="mSIS03" versionname="1.0.7.2">

<count>23</count>

<cache>false</cache>


http://search1.mapabc.com/sisserver?highLight=false&config=R&ver=2.0&xs=JIOMSRNWPNHLHH,JIOMTKMOKQLLHL,JIOMSRNRNSLHHH,JIOMSQKNOTHLHH&ys=LQGXROKSHDLH,LQGXRKQPQHHHL,LQGXQNLPLHLHD,LQGXQROTQPDPH&enc=utf-8&resType=xml&routeType=0&per=150&a_k=947518d877fb275850a375d795be6a44c27ab526ef632290ee4f46327a7d0faac6c032378101477f&ctx=1359931&a_nocache=115309971104



<bounds>116.36285;39.91319;116.4063;39.924305</bounds>

<coors>116.3769,39.9242,116.3759,39.92415,116.3759,39.9241,116.3772,

39.92415,116.3773,39.9226,116.3773,39.92251,116.3788,39.92256,116

.3808,39.92259,116.3812,39.92259,116.3828,39.92262,116.3834,39.92

262,116.3837,39.92259,116.3838,39.92256,116.3839,39.92252,116.384

2,39.92246,</coors>

- <segmengList type="list">

- <segment>

<roadName>西四东大街</roadName>

<roadLength>87</roadLength>

<action>左转调头</action>

<direction>西</direction>

<coor>116.376976,39.9242,116.37595,39.924152</coor>

<grade>主要道路</grade>

<driveTime>1分钟</driveTime>

<accessorialInfo />

<soundID />

<videoID />

<textInfo>沿西四东大街向西行驶 87米左转调头</textInfo>

<form>主路</form>

</segment>

</segmengList>

</RoutingJ>

示例：

var coor =

"JIOMSRNWPNHLHH,LQGXROKSHDLH,JIOMTKMOKQLLHL,LQGXRKQPQHHHL,J

IOMSRNRNSLHHH,LQGXQNLPLHLHD,JIOMSQKNOTHLHH,LQGXQROTQPDPH";


var options = new MRouteSearchOptions();

var arr1 = coor.split(",");




arr.push(mll);

i=i+2;

}

var multiXY = new MLngLats(arr);


mrs.routeSearchByMultiPoi(multiXY,options);




}else{






}

}

46.4.3 calculaNaviDistance(multiPoiXY,option)

说明：

多点导航距离计算。

参数：

（1）multePoiXY：



（2）options：




（b）routeType，路径计算规则

返回值：

JSON 或 XML。


以 XML 为例：


<RoutingL ver="2.0" servername="search1-1">

<segmentList type="list">

<segment>

<roadLength>25695</roadLength> 

</segment>

<segment>

<roadLength>21744</roadLength> 

</segment>

</segmentList>

</RoutingL>

示例：

var coor

="JIOMSRNWPNHLHH,LQGXROKSHDLH,JIOMTKMOKQLLHL,LQGXRKQPQHHHL

,JIOMSRNRNSLHHH,LQGXQNLPLHLHD,JIOMSQKNOTHLHH,LQGXQROTQPDPH";


var options = new MRouteSearchOptions();







arr.push(mll);

i=i+2;

}

var multiXY = new MLngLats(arr);


mrs.calculaNaviDistance(multiXY,options);




}else{


}

}

47 MRouteSearchOptions()

47.1 说明

路径导航可选参数对象，用来设置路径导航查询方法的各种参数选项。

47.2 命名空间

com.mapabc.search.api.MRouteSearchOptions。

47.3 构造方法

47.3.1 MRouteSearchOptions()

说明:

初始化 MRouteSearchOptions 类的一个新实例。

示例：

var option =new MRouteSearchOptions();

47.4 属性

47.4.1 routeType

说明：



路径计算规则。

取值：

当路径导航查询时：

0，速度优先（默认）

1，费用优先（不走收费路段最快道路）

2，距离优先

3，不走快速路（不走快速路，不包含高速路）

9，多策略（同时使用速度优先、费用优先、距离优先三个策略计算路径）

10，国道优先

11，省道优先

当导航距离计算查询时：

0，表示时间最短路径（默认）

1，表示距离最短路径

类型：

number。

47.4.2 per

说明：

抽吸函数，表示在地图上画导航路径的关键点的个数。

取值：

值越大路径越准确，默认为 150。

类型：

number。

47.4.3 resType

说明：

返回结果形式，

取值：

JSON（默认）

XML

类型：

string。

47.4.4 passByXY

说明：

驾车路径查询中，必经地点的坐标。

类型：

MLngLats。



47.4.5 region

说明：

避让区域坐标。

取值：

避让的区域最多有 32 个，每个区域中最多有 16 个顶点。

类型：

MLngLats。

47.4.6 name

说明：

避让区域名称。

类型：

String。

47.4.7 avoidanceType

说明：

避让类型。

取值：

1，区域避让

2，名称避让

3，为区域避让加名称避让。

类型：

number。

注释：

当 region 和 name 有一个不为空时候，avoidanceType 就不能为空，否则查询无结果。

47.4.8 ext

说明：

自定义格式类型。

取值：

0，（默认）

1，代表返回途经城市列表做排重处理

2，代表返回途经城市列表不排重。

类型：

number。




说明：

请求方式

取值：



类型：

String

47.5 方法

无

47.6 示例

var option=new MRouteSearchOptions();

option.routeType=1;

option.returnType="XML";

48 MBusSearch()

48.1 说明

MBusSearch 封装了所有公交查询方法。

48.2 命名空间

com.mapabc.search.api.MBusSearch。

48.3 构造方法

48.3.1 MBusSearch()

说明：

初始化 MBusSearch 类的一个新实例。



示例：

var mls = new MBusSearch();

48.4 方法

公交路径查询

48.4.1 busSearchByTwoPoi(startPoiXY,endPoiXY,city,options)

说明：

根据起点和终点查询公交导航路径。

参数：

（1）startPoiXY：

说明：起点坐标。必填。

类型：MLngLat。

（2）endPoiXY：

说明：终点坐标。必填。

类型：MLngLat。

（3）city：

说明：城市编号或者城市名称。必填。

类型：string。

（4）options：

说明：公交搜索输入参数对象，非必填，参见 MBusSearchOptions 类。

类型：MBusSearchOptions。本方法使用到 MBusSearchOptions 中属性：




返回值：

JSON 或 XML。


以 XML 为例：


<RoutingJ ver="2.0" servername="60.247.103.19">

<count>此查询返回的结果集</count>

<cache>数据是否从缓存读取</cache>


<busList type="list"><！--换乘方案列表-->

<bus><！--换乘方案 1-->

<expense>0</expense> <！--换乘方案价格-->

<segmentList type="list"><！--换乘段列表，每段代表一次换乘-->

<segment>



<startName>呼家楼</startName> <!—起点名称-->

<endName>国贸</endName> <!—终点名称-->

<busName>地铁 10 号线(巴沟--劲松)</busName> <!—公

交名称-->

<passDepotName>金台夕照</passDepotName> <!—路径

站点-->

<driverLength>1571</driverLength> <!—行驶距离-->

<footLength>100</footLength> <!—步行距离-->

<passDepotCount>1</passDepotCount> <!—途径站点数-->

<coordinateList>JQMEMVIVSOOIJI,LYEPKSLPTQRKI

NM,JQMEMVIVROMNM,LYEPJYPSTOEFM,JQMEM

VIVUJKMNI,LYEPJWHXOQROIJM,JQMEMVIVUJKI

JM,LYEPJVPXUOUOENI,JQMEMVIWRPOMJM,LYE

PIYOURLRGINE,JQMEMVIWRPGINI,LYEPIYJTPOU

GEJI,

</coordinateList> <！--路线坐标-->

<passDepotCoordinate>JQMEMVIVUJKMJM,LYEPJWH

XOQRGIFE,

</passDepotCoordinate> < ！ -- 途径站点坐标，和

passDepotCount 对应，passDepotCount=1，此段为 1 对坐标-->

</segment>

</segmentList>

<footEndLength>10</footEndLength> <！--换乘方案结束后，步行到

终点距离-->

<bounds>JQMEKWJRTMKINI;LYEOKWOTSJUOMNE;JQMEM

VIWRPOMNI;LYEPKSLPTQRKEJI;

</bounds>

</bus>

</busList>

</RoutingJ>

示例：

var citycode = 010;


var endXY = new MLngLat(116.3,39.8);

var mrs =new MBusSearch();

var options=new MBusSearchOptions();


mrs.busSearchByTwoPoi(startXY,endXY,citycode,options);




}else{




}

}

公交线路信息查询

48.4.2 busSearchByBusId(busId,city,option)

说明：

根据公交线路 ID 查询公交信息。

参数：

（1）busId：

说明：公交线路 ID。必填。

类型：string。

（2）city：


类型：string。

（3）options：




（b）resData，是否返回扩展信息

（c）recordsPerPage，每页记录数

（d）pageNum，第几页

返回值：

JSON 或 XML。


（1）通用返回结果，以 XML 为例：



<count>此接口返回的结果集数量</count>



<list type="list">

<bus>

<name>300 路内环(草桥--草桥)</name>

<type>1</type>

<length>50.02910</length>

<description>以下为实际运行站点，照片 0012 为价格表</description>

<status>1</status>

<line_id>110100011436</line_id>

<key_name>300 路内环</key_name>



<front_name>草桥</front_name>

<front_spell>"cao qiao"</front_spell>

<terminal_name>草桥</terminal_name>

<terminal_spell>"cao qiao"</terminal_spell>

<start_time>0530</start_time>

<end_time>2200</end_time>

<service_period />

<time_interval1>05302200</time_interval1>

<interval1 />

<time_interval2 />

<interval2 />

<time_interval3 />

<interval3 />

<time_interval4 />

<interval4 />

<time_interval5 />

<interval5 />

<time_interval6 />

<interval6 />

<time_interval7 />

<interval7 />

<time_interval8 />

<interval8 />

<time_desc />

<company>北京公交集团有限公司第二客运分公司</company>

<basic_price>1</basic_price>

<total_price>5</total_price>

<commutation_ticket>0</commutation_ticket>

<auto>0</auto>

<ic_card>1</ic_card>

<express_way>0</express_way>

<loop>1</loop>

<double_deck>0</double_deck>

<gpsfile_id />

<photo_id />

<photo_folder />

<paper_table_id />

<speed />

<xys />

<data_source>1</data_source>

<stationdes />

<air>0</air>

</bus>

</list>



</searchresult>

（2）公交扩展信息返回说明，以 XML 为例：


<CONTENT>

<DATA NAME="BUSINFO_ALIAS"><![CDATA[]]></DATA> 站台别名

<DATA NAME="BUSINFO_LINE_KEYS"><![CDATA[376 路;491 路内环;919 路支 3 空调|376

路;492路外环;919路支 3空调]]></DATA> 经过此站台的公交线路名称关键字,由一个或多

个一次聚类站台经过的线路关键字组合而成，一次聚类站台有多条线路经过时以;分隔，二

次聚类有多个一次聚类站台构成时以|分隔。如：376 路;491 路内环;919 路支 3 空调|376 路;492

路外环;919 路支 3 空调

<DATA

NAME="BUSINFO_LINEIDS"><![CDATA[110100011632;110100013001;110100012302|1101

00011633;110100013000;110100012303]]></DATA> 经过此站台的公交线路 id ，同

BUSINFO_LINE_KEYS

<DATA NAME="XS"><![CDATA[116.250760|116.250836]]></DATA> 此站台包含的一次聚

类站台 X 坐标，以|分隔

<DATA NAME="YS"><![CDATA[40.211440|40.211040]]></DATA> 此站台包含的一次聚类

站台 Y 坐标,以|分隔

<DATA NAME="BUSINFO_LINE_NAMES"><![CDATA[376 路 (昌平东关 --昌平南口北

站);491 路内环(朝凤庵村--朝凤庵村);919 路支 3 空调(昌平东关--德胜门)|376 路(昌平南口北

站 --昌平东关 );492 路外环 (朝凤庵村 --朝凤庵村 );919 路支 3 空调 (德胜门 --昌平东

关)]]></DATA> 经过此站台的公交线路名称，同 BUSINFO_LINE_KEYS

<DATA NAME="BUSINFO_ANGLES"><![CDATA[271.012505|90.471537]]></DATA> 此站

台包含的一次聚类站台的角度,以|分隔

</CONTENT>

示例：

var citycode = 010;

var busLineId = "110100011436";

var options= new MBusSearchOptions();

var mrs = new MBusSearch();


mrs.busSearchByBusId(busLineId,citycode,options);




}else{


}

}

48.4.3 busSearchByBusName(busName,city,option)

说明：



根据公交线路名称查询公交线路信息。

参数：

（1）busName：

说明：公交线路名称。必填。

类型：string。

（2）city：


类型：string。

（3）options：







返回值：

JSON 或 XML。








<list type="list">

<bus>


<type>1</type>



<status>1</status>

<line_id>110100011436</line_id>








<service_period />


<interval1 />

<time_interval2 />



<interval2 />

<time_interval3 />

<interval3 />

<time_interval4 />

<interval4 />

<time_interval5 />

<interval5 />

<time_interval6 />

<interval6 />

<time_interval7 />

<interval7 />

<time_interval8 />

<interval8 />

<time_desc />





<auto>0</auto>



<loop>1</loop>


<gpsfile_id />

<photo_id />

<photo_folder />

<paper_table_id />

<speed />

<xys />


<stationdes />

<air>0</air>

</bus>

</list>

</searchresult>



<CONTENT>









<DATA



BUSINFO_LINE_KEYS











</CONTENT>

示例：

var citycode = 010;

var busLineName = "300";

var options =new MBusSearchOptions();



mrs.busSearchByBusName(busLineName,citycode,options);




}else{


}

}

48.4.4 busSearchByBusStation(stationName,city,option)

说明：

根据公交站点查询经过此公交站点的公交线路信息。

参数：

（1）stationName：

说明：公交站点名称。必填。

类型：string。

（2）city：


类型：string。

（3）options：









返回值：

JSON 或 XML。








<list type="list">

<bus>


<type>1</type>



<status>1</status>

<line_id>110100011436</line_id>








<service_period />


<interval1 />

<time_interval2 />

<interval2 />

<time_interval3 />

<interval3 />

<time_interval4 />

<interval4 />

<time_interval5 />

<interval5 />

<time_interval6 />

<interval6 />



<time_interval7 />

<interval7 />

<time_interval8 />

<interval8 />

<time_desc />





<auto>0</auto>



<loop>1</loop>


<gpsfile_id />

<photo_id />

<photo_folder />

<paper_table_id />

<speed />

<xys />


<stationdes />

<air>0</air>

</bus>

</list>

</searchresult>



<CONTENT>







<DATA



BUSINFO_LINE_KEYS













</CONTENT>

示例：

var citycode = 010;

var stationName = "北京站";

var options =new MBusSearchOptions();



mrs.busSearchByBusStation(stationName,citycode,options);




}else{


}

}

49 MBusSearchOptions()

49.1 说明

公交查询可选参数对象，用来设置公交查询方法的各种参数选项。

49.2 命名空间

com.mapabc.search.api.MBusSearchOptions。

49.3 构造方法

49.3.1 MBusSearchOptions()

说明:

初始化 MBusSearchOptions 类的一个新实例。

示例：



var option =new MBusSearchOptions();

49.4 属性

49.4.1 routeType

说明：

路径计算规则。

取值：

0，最快捷模式，尽可能乘坐轨道交通和快速公交线路

1，最经济模式，尽可能乘坐月票车线路。

2，最少换乘模式，尽可能减少换乘次数。

3，最少步行模式，尽可能减少步行距离。

4，最舒适模式，尽可能乘坐有空调车线。

类型：

number。

49.4.2 per

说明：

抽吸函数，表示在地图上画公交路径的关键点的个数。

取值：

值越大路径越准确，默认为 150。

类型：

number。

49.4.3 resType

说明：


取值：

JSON（默认）

XML

类型：

string。

49.4.4 resData

说明：

是否返回公交线路信息的 XML 扩展信息。

取值：

0，不返回（默认）



1，返回

类型：

number。

49.4.5 recordsPerPage

说明：

每页返回几条记录。

取值：

默认值为 10。

类型：

number。

49.4.6 pageNum

说明：

返回第几页。

取值：

默认值为 1。

类型：

number。


说明：

请求方式

取值：



类型：

String

49.5 方法

无

49.6 示例

var option=new MBusSearchOptions();

option.routeType=1;

option.returnType="XML";



50 MGeoCodeSearch()

50.1 说明

地理编码（地址匹配类）。封装了地址匹配功能。

50.2 命名空间

com.mapabc.search.api.MGeoCodeSearch。

50.3 构造方法

50.3.1 MGeoCodeSearch()

说明：

初始化 MGeoCodeSearch 类的一个新实例。

示例:

var mgc=new MGeoCodeSearch();

50.4 方法

50.4.1 addressToGeocode(address,options)

说明：

地址解析，由地址得到经纬度坐标相关信息。

参数：

（1）address：

说明：地址。必填。

类型：string。

（2）options：

说明：地址解析输入参数选项。非必填，参考 MGeoCodeSearchOptions 类。

类型：MGeoCodeSearchOptions。本方法使用到 MGeoCodeSearchOptions 中属性：


返回值：

JSON 或 XML。



http://172.17.17.100:8080/browse/ASEARCHII-19




<searchresult>

<count>1</count> <!—返回结果数量->

<list>

<poi>

<name>中国北京市海淀区苏州街</name> <!—名称->

<level>gl_street</level> <!—结果等级，详见1.5节->

<x>116.306806</x> <!—经度->

<y>39.975306</y> <!—纬度->

<num>2003</num> <!—现有POI数据中地址包含本结果，且粒度小于

等于本结果的数量->

<range>0.004457</range> <!—现有POI数据中地址包含本结果，且粒度小于等于

本结果的所有POI与本结果经纬度距离的平均->

<score>25136.212891</score> <!—权重公式计算结果->

<inum>1</inum> <!—现有POI数据中地址粒度与本结果一致且能够对

应本结果的数量->

<prox>1.000000</prox> <!—查询query与本结果名称的相似度->

</poi>

</list>

</searchresult>

（2）其他说明：

结果级别共分为 10 级，有几级是预留的，已用的按级别从大粒度到小粒度分别是：

gl_country（国家）

gl_province（省级）

gl_city（市级）

gl_district（区县级）

gl_subdistrict（乡村级、热点商圈）

gl_housenumber（门牌号级）

gl_courtyard（小区级）

gl_poi（POI 级）

gl_interplate（根据差值计算的门牌号，即已知门牌号中不存在，但在已知门牌号的基

础上可以通过模糊计算得到的结果）

gl_nearby（超出已知门牌号范围，提供最近的门牌号地址）

示例：

var address = "北京市海淀区苏州街";

var mls = new MGeoCodeSearch();

var mlsp= new MGeoCodeSearchOptions();


mls.addressToGeocode(address,mlsp);




}else{




}

}

51 MGeoCodeSearchOptions()

51.1 说明

地址解析输入参数选项类。

51.2 命名空间

com.mapabc.search.api.MGeoCodeSearchOptions。

51.3 构造方法

51.3.1 MGeoCodeSearchOptions()

说明：

初始化 MGeoCodeSearchOptions 类的一个新实例。

示例:

var option=new MGeoCodeSearchOptions();

51.4 属性

51.4.1 resType

说明：


取值：

JSON（默认）

XML

类型：

string。





说明：

请求方式

取值：



类型：

String

51.5 方法

无

51.6 示例

var mgco = new MGeoCodeSearchOptions();

mgco.resType="xml";

52 MReGeoCodeSearch()

52.1 说明

逆地理编码（位置描述类）。封装了位置描述功能。

52.2 命名空间

com.mapabc.search.api.MReGeoCodeSearch。

52.3 构造方法

52.3.1 MReGeoCodeSearch()

说明：

初始化 MReGeoCodeSearch 类的一个新实例。

示例:

var mgc=new MReGeoCodeSearch();



52.4 方法

52.4.1 poiToAddress(poiXY,options)

说明：

位置描述，由经纬度坐标得到详细地址信息，包括该点所在省市区，周边的 POI 和道路。

参数：

（1）poiXY：

说明：位置点经纬度坐标。必填。

类型：MLngLat。

（2）options：

说明：位置描述输入参数选项。非必填，参考 MReGeoCodeSearchOptions 类。

类型：MReGeoCodeSearchOptions。本方法使用到 MReGeoCodeSearchOptions 中属性：


（b）poiNumber，返回周边的 POI 数量

（c）range，限定周边热点 POI 和道路的距离范围

（d）pattern，返回数据的模式

（e）roadLevel，道路等级

（f）exkey，排除的关键字

返回值：

JSON 或 XML。


以 XML 为例：


<spatial_response type="SpatialBean" servername="sis_tj_04">

<SpatialBean ver="1.0">

<Province ver="1.0"> <!—省-->

<name>北京市</name> <!—省名-->

<code>11</code> <!—省编号-->

</Province>

<City ver="1.0"> <!—市-->

<name>北京城区</name> <!—名称->

<code>1101</code> <!—区域名称-->

<telnum>010</telnum> 

<name>海淀区</name> <!—区域名-->

<code>110108</code> <!—区域编号-->

</District>

<roadList type="list"> 

<Road ver="1.0">



<id>916</id> <!—道路id-->

<name>北四环中路辅路</name> 

<direction>东北</direction> <!—相对xy方向-->

<distance>76.0</distance> <!—相对距离-->

<width>12</width> <!—路宽-->

<spatial_geo type="Line">

<coor/> <!—线路坐标-->

</spatial_geo>

</Road>

</roadList>

<poiList type="list"> <!—周边poi-->

<poi>

<match /> 

<extid /> <!—编辑器的外部id号-->

<pguid /> 

<address>北京市北四环西路9</address> <!—地址-->

<tel /> 

<url /> 

<xml /> <!—扩展信息-->

<x>HKVNJPRKKMK</x> <!—x坐标-->

<y>JSNYOTPKKEG</y> 

<name>安德里北街</name>

<direction/> 


<width>8</width>

<ename>Andeli North Street</ename>

<level>45000</level>

<spatial_geo type="Line">

<coor>lknepkprhfJOJL,nsfpqrlslNGJL,lknepkqvgfNKJD,nsfpqrlsnNGJL;lknepk

nvnkJGNL,nsfpqrltmNKNH,lknepknqfnNGNL,nsfpqrlufJONL;lkneotswmhJONL,nsf

pqrlskNOFH,lknepknqfnJOFD,nsfpqrlufFOFD </coor>

<buffer>0</buffer>

<spatial_geo type="Polygons">

<coors>igpjnesrikoLIHF,kohupfsopmmHELN,igpjnetpqinLILN,kohupfrqkkmLI

HJ,igpjneuokmsHEHF,kohupfpkplsLILJ,igpjnevmilnDIDF,kohupevjkpjLMLN,igpjne

vsqokLILN,kohupepnmjjLIDJ </coors>

</spatial_geo>

</spatial_geo>

</Road>



</roadList>

</spatial_response>

示例：

var citycode = 010;

var roadName = "北三环";


var mlsp= new MRoadSearchOptions();


mls.roadSearchByRoadName(roadName,citycode,mlsp);




}else{


}

}

54.4.2 roadCrossSearchByRoadId(roadId1,roadId2,city,options）

说明：

通过道路 ID 查询两条道路的交叉路口。

参数：

（1）roadId1：

说明：第一条道路 ID。必填。

类型：string。

（2）roadId2：

说明：第二条道路 ID。必填。

类型：string。

（2）city：


类型：string。

（3）options：




（b）sortRule，排序规则

返回值：

JSON 或 XML。


以 XML 为例：


<spatial_response type="searchresult">



<searchresult>


<count>1</count>

<list type="list">

<poi>

<match />

<type />

<id />

<citycode />

<extid />

<pguid />

<timestamp />

<name />

<srctype />

<gridcode />

<address />

<tel />

<icon />

<url />

<buscode />


<direction />

<xml />

<en_type />

<en_name />

<en_address />

<x>igpjnfvmmLMHJ</x>

<y>kohurmtmlLILF</y>

</poi>

</list>

</searchresult>

</spatial_response>

示例：

var citycode = 010;

var id1 ="00103710";

var id2 = "00103711";




mls.roadCrossSearchByRoadId(id1,id2,citycode,mlsp);






}else{


}

}

54.4.3 roadCrossSearchByRoadName(roadName1,roadName2,city,options）

说明：

通过道路名称查询两条道路的交叉路口。

参数：

（1）roadName1：

说明：第一条道路名称。必填。

类型：string。

（2）roadName2：

说明：第二条道路名称。必填。

类型：string。

（2）city：


类型：string。

（3）options：




（b）roadLevel，道路等级

返回值：

JSON 或 XML。


以 XML 为例：


<spatial_response type="searchresult">

<searchresult>


<count>2</count>

<list type="list">

<poi>

<match />

<type />

<id />

<citycode />

<extid />

<pguid />

<timestamp />

<name />



<srctype />

<gridcode />

<address />

<tel />

<icon />

<url />

<buscode />


<direction />

<xml />

<en_type />

<en_name />

<en_address />

<x>igpjmnrlhlLMLJ</x>

<y>kohuolnmoLILF</y>

</poi>

</list>

<bounds>igpjmnpnnnHMLJ;kohuolmskHMHJ;igpjmnrlhlLEHJ;kohuolnmoLILJ</bou

nds>

</searchresult>

</spatial_response>

示例：

var citycode =010;

var name1 ="中关村大街";

var name2 ="海淀南路";




mls.roadCrossSearchByRoadName(name1,name2,citycode,mlsp);




}else{


}

}

54.4.4 allRoadCrossSearchByRoadName(roadName,city,options)

说明：

查询一条道路上所有交叉路口的位置信息。

参数：

（1）roadName：



说明：道路名称。必填。

类型：string。

（2）city：


类型：string。

（3）options：




（b）keyType，预留字段

返回值：

JSON 或 XML。


以 XML 为例：



<searchresult>


<count>70</count>

<list type="list">

<poi>

<id>00104906</id>

<name>北土城西路</name>

<x>iikemmjppnNMEN</x>

<y>kqcpqnjvlJMMN</y>

</poi>

<poi/>

</list>

<bounds>iikemimspiJIMJ;kqcpqmopnNIEF;iikemmjppnFEEF;kqcpqnloNEMF</bounds>

</searchresult>

</spatial_response>

示例：

var citycode = 010;

var roadName = "北三环";




mls.allRoadCrossSearchByRoadName(roadName,citycode,mlsp);




}else{




}

}

55 MRoadSearchOptions()

55.1 说明

道路查询输入参数选项类。

55.2 命名空间

com.mapabc.search.api.MRoadSearchOptions。

55.3 构造方法

55.3.1 MRoadSearchOptions()

说明：

初始化 MRoadSearchOptions 类的一个新实例。

示例:

var option=new MRoadSearchOptions();

55.4 属性

55.4.1 resType

说明：


取值：

JSON（默认）

XML

类型：

string。




55.4.2 keyType

说明：

预留字段

类型：

string。

55.4.3 rexy

说明：

是否返回坐标

取值：

true，返回（默认）

false，不返回

类型：

boolean。

55.4.4 sortRule

说明：

排序规则

类型：

number。

55.4.5 buffer

说明：

缓冲区范围。

类型：

number。

55.4.6 roadlevel

说明：

道路等级

取值：

与国家标准的道路等级划分的对应关系如下：





国家标准的道路等级划分共 12 级,参考如下：



0，图廓线未命名道路

1，非导航道路

2，普通道路

3，次要道路

4，县乡村内部道路

5，乡公路

6，县道

7，主要道路

8，主要大街、城市快速道

9，省道

10，国道

11，高速公路

类型：

number。


说明：

请求方式

取值：



类型：

String

55.5 方法

无

55.6 示例

var mgco = new MReGeocodeSearchOptions();

mgco.resType="xml";

mgco.roadLevel=3;

56 MSpatialSearch()

56.1 说明

封装了所有空间查询计算方法。



56.2 命名空间

com.mapabc.search.api.MSpatialSearch。

56.3 构造方法

56.3.1 MSpatialSearch()

说明：

初始化 MSpatialSearch 类的一个新实例。

示例：

var mls = new MSpatialSearch();

56.4 方法

56.4.1 isPoiInRegion(regionType,poiXY,regionXY,options)

说明：

判断一个点与几何区域的相对位置。目前支持的几何区域包括多边形、圆形、矩形。

参数：







（2）poiXY：

说明：点坐标。必填。

类型：MLngLat。

（3）regionXY：

说明：区域坐标。必填。


注释：矩形和圆形为外切矩形的左下右上坐标，多边形为顶点坐标

（4）options：

说明：空间查询计算输入参数对象，非必填，参见 MSpatialSearchOptions 类。

类型：MSpatialSearchOptions。本方法使用到 MSpatialSearchOptions 中属性：


（b）buffer，缓冲区范围

返回值：

JSON 或 XML。




以 XML 为例：


<spatial_response type="Result" servername="search1-1">

<Result> INTERIOR;</Result> INTERIOR | EXTERIOR |BOUNDARY（区域内|区域外|

区域边界上）

</spatial_response>

示例：

var searchType=MOverlay.TYPE_POLYGON;

var poiXY1 = new MLngLat("116.42898559570312","39.9434364619742");

var regionXY=new Array();

regionXY.push(new MLngLat("JIOMTKJVROLLHL","LQGWWSIPPHLDH"));

regionXY.push(new MLngLat("JIOMTSIOPMHPHL","LQGXSSIUKLHDH"));

regionXY.push(new MLngLat("JIOMTMJOJUPHLP","LQGXYMQNMHLDH"));

regionXY.push(new MLngLat("JIOMSRIQISHDLL","MHGOTNKVODPLL"));

var regionXY2=new MLngLats(regionXY);

var mss = new MSpatialSearch();

var option = new MSpatialSearchOptions();

mss.setCallbackFunction(myfunc);

mss.isPoiInRegion(searchType,poiXY1,regionXY2,option);




}else{


}

}

56.4.2 isMultiPoiInRegion(regionType,multiPoiXY,regionXY,options)

说明：

判断多个点与几何区域的相对位置。目前支持的几何区域包括多边形、圆形、矩形。

参数：







（2）multiPoiXY：





（3）regionXY：

说明：区域坐标。必填。


注释：矩形和圆形为外切矩形的左下右上坐标，多边形为顶点坐标

（4）options：




（b）buffer，缓冲区范围

（c）coorType，坐标类型

返回值：

JSON 或 XML。


以 XML 为例：


<spatial_response type="Result" servername="search1-2">

<Result>INTERIOR;INTERIOR;</Result> INTERIOR | EXTERIOR |BOUNDARY（区域内|

区域外|区域边界上）

</spatial_response>

示例：

var mss = new MSpatialSearch();

var option = new MSpatialSearchOptions();

var arr= new Array();

arr.push(new MLngLat("116.313","39.9927"));

arr.push(new MLngLat("116.4773527","39.8843867"));

var lls = new MLngLats(arr);




var lls1 = new MLngLats(arr1);

mss.setCallbackFunction(myfunc);

mss.isMultiPoiInRegion(MOverlay.TYPE_CIRCLE,lls1,lls,option);




}else{


}

}



56.4.3 calculaDistance(PoiXY1,PoiXY2,lineXY,options)

说明：

计算两点之间、点到线的最短距离、线的长度。

参数：

（1）PoiXY1：

说明：点 1 坐标。

类型：MLngLat。

注释：计算两点距离或者点到线最短距离时不得为 null；计算线长度时为 null

（2）PoiXY2：

说明：点 2 坐标。

类型：MLngLat。

注释：计算两点距离时不得为空，计算点到线最短距离或者线长度时为 null

（3）lineXY：

说明：线坐标。


注释：计算点到线最短距离或者线长度时不得为空，计算两点距离时为 null

（4）options：




返回值：

JSON 或 XML。


（1）两点距离，以 XML 为例：

<?xml version="1.0" encoding="gbk" ?>

<Distance>8411</Distance>

（2）点到线的最短距离，以 XML 为例：


<distance>

<length>23850</length>

<list type="list">

<seg>

<x>116.281</x>

<y>39.8881</y>

</seg>

</list>

</distance>

（3）线的长度，以 XML 为例：


<distance>




<list type="list">

<seg>


</seg>

</list>

</distance>

示例：

var mrs = new MSpatialSearch();

var sp = new MSpatialSearchOptions();

mrs.setCallbackFunction(myfunc_calculationDistance);

var startXY =new MLngLat(116.381,39.6881);

var endXY = new MLngLat(116.3744111,39.9120711);

mrs.calculaDistance(startXY,endXY,null,sp);




}else{


}

}

56.4.4 calculaBufferZone(lineArr,options)

说明：

计算缓冲区范围边界坐标。

参数：

（1）lineArr：

说明：线坐标数组，可以是多条线。

类型：MLngLats 数组。

注释：计算两点距离或者点到线最短距离时不得为 null；计算线长度时为 null

（2）options：




（b）buffer，缓冲区

（c）range，缓冲范围

返回值：

JSON 或 XML。


以 XML 为例：




<spatial_response type="searchresult" servername="172.17.33.89">

<searchresult>


<count>2</count>

<spatial_geos type="list">

<spatial_geo type="Polygon">

<coor>HIVJKNTTWOKOGIH,JQNUPLUTQPQKKID,HIVJMLWSWMKKKIL,JQNTQ

KQORQHKKIH,HIVJMLXQQSOKOIL,JQNTQJVRRQPKKMH,HIVJMLYMUTJO

GIL,JQNTQJPQVLOOGML,HIVJMLYRVTIGOEL,JQNTPSSOVNMKGIL,HIVJM

LYVRSOGGML,JQNTPRUOPTIOKMD……</coor>

<buffer>0</buffer>

</spatial_geo>

<spatial_geo type="Polygon">

<coor>HIVJKNTTWOKGOED,JQNUPLUTQPQKKIL,HIVJMLWSWMKKOMD,JQNT

QKQORQHOGID,HIVJMLXQQSOKKIH,JQNTQJVRRQPKGEL,HIVJMLYMUTJ

OKML,JQNTQJPQVLOOKIL,HIVJMLYRVTIOKIL,JQNTPSSOVNMGOMH,HIVJ

MLYVRSOOGIL,JQNTPRUOPTIKOEL…… </coor>

<buffer>0</buffer>

</spatial_geo>

</spatial_geos>

</searchresult>

</spatial_response>

示例：

var coor1 = "116.32569,39.96682,116.12568,39.9671,116.32568,39.8671";

var coor2 = "116.42569,39.86682,116.22568,39.7671,116.52568,39.6671";

var options= new MSpatialSearchOptions();

var mrs = new MSpatialSearch();

var arr1 = coor1.split(",");




arr.push(mll);

i=i+2;

}

var lineXY1 = new MLngLats(arr);

var arr2 = coor2.split(",");

var arr3 =new Array();

for(var j = 0 ;j<=arr2.length-2;){

var mll1 =new MLngLat(arr2[j],arr2[j+1]);

arr3.push(mll1);

j=j+2;

}

var lineXY2 = new MLngLats(arr3);

var a = new Array();



a.push(lineXY2);

a.push(lineXY1);


mrs.calculaBufferZone(a,options);




}else{


}

}

57 MSpatialSearchOptions()

57.1 说明

空间查询计算输入参数选项类。

57.2 命名空间

com.mapabc.search.api.MSpatialSearchOptions。

57.3 构造方法

57.3.1 MSpatialSearchOptions()

说明：

初始化 MSpatialSearchOptions 类的一个新实例。

示例:

var option=new MSpatialSearchOptions();

57.4 属性

57.4.1 resType

说明：


取值：

JSON（默认）



XML

类型：

string。

57.4.2 buffer

说明：

缓冲区。

类型：

number。

57.4.3 range

说明：

缓冲区范围。

类型：

number。

57.4.4 coorType

说明：

坐标类型。

类型：

number。


说明：

请求方式

取值：



类型：

String

57.5 方法

无



57.6 示例

var mgco = new MSpatialSearchOptions();

mgco.resType="xml";

mgco.range=3000;

58 MCoordinateSearch()

58.1 说明

封装了坐标处理方法。

58.2 命名空间

com.mapabc.search.api.MCoordinateSearch。

58.3 构造方法

58.3.1 MCoordinateSearch()

说明：

初始化 MCoordinateSearch 类的一个新实例。

示例：

var mls = new MCoordinateSearch();

58.4 方法

58.4.1 GPSToOffsetGet(poiXY1,poiXY2,options)

说明：

将真实的 GPS 坐标转换为偏移坐标。

参数：

（1）poiXY1：

说明：第一个经纬度真实坐标。必填。

类型：MLngLat。

（2）poiXY1：



说明：第二个经纬度真实坐标。可以为 null。

类型：MLngLat。

（3）options：

说明：坐标处理输入参数对象，非必填，参见 MCoordinateSearchOptions 类。

类型：MCoordinateSearchOptions。本方法使用到 MCoordinateSearchOptions 中属性：


（b）cr，是否返回 gridCode

（c）ver，版本号

返回值：

JSON 或 XML。

注释：

此方法仅支持 get 请求方式，并且最多只可偏转两个坐标。


以 XML 为例：


<rgc_result type="list" servername="60.247.103.19">

<Item>

<x>KIUNOPMKQOHHHI</x>

<y>MQMXGQHSULLHI</y>


</Item>

<Item>

<x>KIUNPPLSLSLLLI</x>

<y>MPMXNPMPMHHHI</y>


</Item>

</rgc_result>

示例：

var mrs = new MCoordinateSearch();

var opt = new MCoordinateSearchOptions();



mrs.GPSToOffsetGet(startXY,null,opt);




}else{


}

}



58.4.2 GPSToOffsetPost(multiPoiXY,options)

说明：

将一组真实的 GPS 坐标转换为偏移坐标。

参数：

（1）multiXY：

说明：一组经纬度真实坐标。必填。


（2）options：




（b）cr，是否返回 gridCode

返回值：

JSON 或 XML。

注释：

此方法仅支持 post 请求方式，并且可以支持一组经纬度坐标。


以 XML 为例：


<rgc_result type="list">

<Item>

<x>KIUNJRILNQJHLDI</x>

<y>MQMYMVIRLOKHHHM</y>


</Item>

<Item>

<x>KIVNHVMSQSJHHDM</x>

<y>MQMRKTMRQLILHHI</y>


</Item>

<Item>

<x>KIVNHVMSQQHLDDI</x>

<y>MQMRKTMRRONHHLI</y>


</Item>

<Item>

<x>KIVNHVMSQRIDLDE</x>

<y>MQMRKTMRRUIDHDM</y>


</Item>

</rgc_result>



示例：



var poi1= new MLngLat(115.797,39.9957);




arr.push(poi1);

arr.push(poi2);

arr.push(poi3);


mrs.GPSToOffsetPost(arr,opt);




}else{


}

}

58.4.3 pathCorrection(poiXY,radian,city,options)

说明：

道路纠偏。

参数：

（1）poiXY：

说明：点经纬度坐标。必填。

类型：MLngLat。

（2）radian：

说明：GPS 设备角度。必填。

类型：number。

（3）city：


类型：string。

（4）options：




（b）angle，角度误差

（c）range，纠偏最大范围

（d）flag，是否返回明码坐标

返回值：

JSON 或 XML。

注释：



此方法仅支持单点，不支持多点。


以 XML 为例：


<rgc_result type="list" servername="60.247.103.19">

<Item>

<x>116.341445</x>

<y>39.887485</y>

</Item>

</rgc_result>

示例：

var radian = 0.0;

var city =0531;





mrs.pathCorrection(startXY,radian,city,opt);




}else{


}

}

58.4.4 fromLngLatToPixel(LngLats,centerPoiXY,zoom,mapSize,options)

说明：

从经纬度坐标转化为屏幕像素坐标。

参数：

（1）lnglats：

说明：单个或者多个经纬度坐标。必填。



说明：地图中心点坐标。必填。

类型：MLngLat。

（3）zoom：

说明：地图 zoom 级别。必填。

类型：number。

（4）mapSize：

说明：地图尺寸。必填。



类型：MSize。

（5）options：




返回值：

JSON 或 XML。


以 XML 为例：


<searchresult servername="localhost.localdomain">

<list>

<screenPoint>

<screenX>501104.0</screenX>

<screenY>266685.0</screenY>

</screenPoint>

<screenPoint>

<screenX>503435.0</screenX>

<screenY>263670.0</screenY>

</screenPoint>

</list>

</searchresult>

示例：

var coor = "116.3604213,39.3204703,116.4604213,39.4204703";

var zoom = 15;

var size = new MSize(1000000,500000);

var cenxy= new MLngLat(116.313031,39.872196);





arr.push(mll);

i=i+2;

}

var lls = new MLngLats(arr);




mrs.fromLngLatToPixel(lls,cenxy,zoom,size,opt)






}else{


}

}

58.4.5 fromPixelToLngLat(Pixels, centerPoiXY,zoom, mapSize ,options)

说明：

从经纬度坐标转化为屏幕像素坐标。

参数：

（1）pixels：

说明：屏幕像素坐标，可以是多个。必填。

类型：MPoint 数组。


说明：地图中心点坐标。必填。

类型：MLngLat。

（3）zoom：

说明：地图 zoom 级别。必填。

类型：number。

（4）mapSize：

说明：地图尺寸。必填。

类型：MSize。

（5）options：




返回值：

JSON 或 XML。


以 XML 为例：


<searchresult servername="localhost.localdomain">

<list>

<lnglatPoint>

<lng>116.36040687561035</lng>

<lat>39.32045443611561</lat>

</lnglatPoint>

<lnglatPoint>

<lng>116.46044254302979</lng>

<lat>39.4204805386993</lat>

</lnglatPoint>



</list>

</searchresult>

示例：

var coor = "501104.0,266685.0,503435.0,263670.0";

var h = 50000;

var w = 1000000;

var zoom = 15;

var cenxy= new MLngLat(116.313031,39.872);

var size = new MSize(w,h);




var mll =new MPoint(arr1[i],arr1[i+1]);

arr.push(mll);

i=i+2;

}




mrs.fromPixelToLngLat(arr,cenxy,zoom,size,opt)




}else{


}

}

59 MCoordinateSearchOptions()

59.1 说明

坐标处理参数选项类。

59.2 命名空间

com.mapabc.search.api.MCoordinateSearchOptions。



59.3 构造方法

59.3.1 MCoordinateSearchOptions()

说明：

初始化 MCoordinateSearchOptions 类的一个新实例。

示例:

var option=new MCoordinateSearchOptions();

59.4 属性

59.4.1 resType

说明：


取值：

JSON（默认）

XML

类型：

string。

59.4.2 angle

说明：

角度误差。应用调整参数，根据实际情况调整调优。

取值：

默认为 70

类型：

number。

59.4.3 range

说明：

纠偏最大范围。应用调整参数，根据实际情况调整调优。

取值：

默认为 300 米

类型：

number。



59.4.4 cr

说明：

返回坐标类型。

取值：

0，表示返回坐标和 gridCode（默认）

1，只返回 gridCode

类型：

number。

59.4.5 ver

说明：

版本号。

取值：

1.0，1.0 版本（默认）

2.0，2.0 版本

类型：

string。

59.4.6 flag

说明：

是否返回明码坐标。

取值：

true，返回明码坐标

false，返回加密坐标（默认）

类型：

boolean。


说明：

请求方式

取值：



类型：

String



59.5 方法

无

59.6 示例

var mgco = new MCoordinateSearchOptions();

mgco.resType="xml";

mgco.range=3000;

60 MSearchTools()

60.1 说明

封装了辅助查询工具等相关方法。

60.2 命名空间

com.mapabc.search.api.MSearchTools。

60.3 构造方法

60.3.1 MSearchTools()

说明：

初始化 MSearchTools 类的一个新实例。

示例：

var mls = new MSearchTools();

60.4 方法

60.4.1 weatherSearchByCity(city,options)

说明：

根据城市查询天气预报。

参数：



（1）city：


类型：string。

（2）options：

说明：查询工具参数对象，非必填，参见 MSearchToolOptions 类。

类型：MSearchToolOptions。本方法使用到 MSearchToolOptions 中属性：


（b）ver，版本号

返回值：

JSON 或 XML。


以 XML 为例：


<weather ver="1.0">

<cityweather>

<type>city</type>

<index>

<air>3 级部分时间开启天气热， </air>

<beer>4 级适宜炎热的天气可能增加啤酒对您的诱惑， </beer>

<boating>1 级适宜白天天气晴朗，阳光明媚， </boating>

<cold>1 级少发各项气象条件适宜，发生感冒机率较低。</cold>

<comfort>2 级较不舒适白天天气晴好， </comfort>

<dressing>2 级热天气较热，</dressing>

<drying>2 级适宜多云，适宜晾晒。</drying>

<fishing>2 级较适宜较适合垂钓， </fishing>

<heat>1 级少发气温偏高，有可能中暑， </heat>

<kite>2 级较适宜天气晴朗，万里无云， </kite>

<make_up>4 级防脱水天热，易出汗， </make_up>

<morning>1 级适宜天气晴朗，空气清新， </morning>

<pollution>3 级中气象条件对空气污染物稀释、</pollution>

<shopping>1 级较适宜天气晴朗，风和日丽， </shopping>

<spf>3 级中等属中等强度紫外辐射天气， </spf>

<tourism>2 级适宜多云，有时云会遮挡阳光， </tourism>

<transport>1 级良好天气晴朗，路面干燥， </transport>

<umbrellas>1 级不带伞为多云天气， </umbrellas>

<washing>1 级适宜适宜洗车， </washing>

<wind>8 级无温度未达到风寒所需的低温， </wind>

</index>


<adcode>110000</adcode>

<cityname>北京市</cityname>

<pcityname>北京市</pcityname>



<aliasname>北京</aliasname>

<x>116.405285</x>

<y>39.904989</y>

<weatherlist type="list">

<weatherbean>

<time>2010-05-19 08:00:00</time>

<des>多云</des>

<temperature>32</temperature>

<wind_direction>微风</wind_direction>

<wind_power>小于 3</wind_power>

</weatherbean>

<weatherbean>

<time>2010-05-19 20:00:00</time>

<des>晴</des>




</weatherbean>

</weatherlist>

</cityweather>

</weather>

示例：

var citycode = 010;

var mws =new MSearchTools();

mws.setCallbackFunction(myfunc);

mws.weatherSearchByCity(citycode);




}else{


}

}

60.4.2 weatherSearchByAdCode(adCode,options)

说明：

根据地区代码查询天气预报。

参数：

（1）adCode：

说明：地区代码。必填。

类型：string。

（2）options：







返回值：

JSON 或 XML。


以 XML 为例：


<weather ver="1.0">

<cityweather>

<type>city</type>

<index>





















</index>






<x>116.405285</x>

<y>39.904989</y>




<weatherbean>

<time>2010-05-19 08:00:00</time>

<des>多云</des>




</weatherbean>

<weatherbean>

<time>2010-05-19 20:00:00</time>

<des>晴</des>




</weatherbean>

</weatherlist>

</cityweather>

</weather>

示例：

var adCode = "130627";



mws.weatherSearchByAdCode(adCode);




}else{


}

}

60.4.3 weatherSearchByPoi(poiXY,options)

说明：

根据经纬度坐标查询天气预报。

参数：

（1）poiXY：

说明：经纬度坐标。必填。

类型：Mlnglat。

（2）options：







返回值：

JSON 或 XML。


以 XML 为例：


<weather ver="1.0">

<cityweather>

<type>city</type>

<index>





















</index>






<x>116.405285</x>

<y>39.904989</y>


<weatherbean>

<time>2010-05-19 08:00:00</time>

<des>多云</des>






</weatherbean>

<weatherbean>

<time>2010-05-19 20:00:00</time>

<des>晴</des>




</weatherbean>

</weatherlist>

</cityweather>

</weather>

示例：

var poiXY = new MLngLat("OMPIWOWOJJPNLNG","QLMKPSOKLPLJHNG");



mws.weatherSearchByPoi(poiXY);




}else{


}

}

60.4.4 addressSearchByIP(ip,options)

说明：

根据 IP 地址查询具体详细地址。

参数：

（1）ip：

说明：ip 地址。必填。

类型：string。

（2）options：




返回值：

JSON 或 XML。


以 XML 为例：




<ip>

<address>北京市互联通</address>

<x>JPOHKTPOIIQJNJN</x>

<y>MOGLLNQNHQLJJJF</y>



<name>北京市</name>

<code>11</code>

</Province>

<City ver="1.0">


<code>1101</code>


</City>


<name>昌平区</name>

<code>110114</code>

<x />

<y />

<bounds />

</District>


<Road ver="1.0">

<id>001090935</id>

<name>（未命名道路）</name>

<direction>EastNorth</direction>


<width>0</width>

<ename>(unnamed road)</ename>

<spatial_geo type="Line">

<coor />

<buffer>0</buffer>

</spatial_geo>

</Road>

</roadList>


<crossPoiList type="list">

<cross>

<name>（未命名道路）-（未命名道路）</name>

</cross>

</crossPoiList>

</SpatialBean>

</ip>



示例：

var ip ="211.157.3.182";



mws.addressSearchByIP(ip);




}else{


}

}

60.4.5 cityInfoSearchByCity(city,option)

说明：

根据城市代码，包括城市编号、城市名称和城市区号查询城市的信息。

参数：

（1）city：


类型：string。

（2）options：




返回值：

JSON 或 XML。


以 XML 为例：


<City ver="1.0">

<list type="list">

<City>

<name>北京</name>


<x>fjtekqrposNKGE</x>

<y>hrlphplnJOOE</y>

<districttable>{}</districttable>

<province_name>北京市</province_name>

</City>

<City>

<name>上海</name>




<x>fkoelopplrJOGE</x>

<y>hjlijlnlnNOOI</y>


<province_name>上海市</province_name>

</City>

<City>

<name>长沙</name>


<x>fjqehhtjouNOOM</x>

<y>gqlihpomsNKGM</y>


<province_name>湖南省</province_name>

</City>

</list>

</City>

示例：

var citycode = 010;



mws.cityInfoSearchByCity(citycode);




}else{


}

}

60.4.6 districtSearchByNameAndCode(searchType,name,code,options)

说明：

根据省市区名称及编码，查询省市区详细信息。

参数：

（1）searchType：

说明：查询类型。必填。

取值：province，省查询

city，市查询

district，区查询

类型：string。

（2）name：

说明：地区名称

取值：XX 省，XX 市，XX 自治州，XX 区，XX 县等。必填。



类型：string。

（3）code：

说明：省市编码。如果是省和市查询需要填入省编号；如果是区县查询，需要填入

市编号。必填。

类型：string。

（4）options：




返回值：

JSON 或 XML。


以 XML 为例：


<china>

<province_list type="list">

<province>


<x>116.408198000000000</x>

<y>39.904667000000000</y>

<code>110000</code>

<bounds>115.420372009277;39.4432525634766;117.505569458008;41.0608711242676</bounds>

<ename>BJ</ename>

<englishname>BEIJINGSHI</englishname>

</province>

</province_list>

</china>

示例：

var name ="安新";

var code = "130600";

var type = "district";

var mrs =new MSearchTools();


mrs.districtSearchByNameAndCode(type,name,code);




}else{


}

}



60.4.7 districtSearchByPoiAndZoom(poiXY,zoom,options)

说明：

根据经纬度坐标和 zoom 级别，查询经纬度坐标所在区域的详细信息。

参数：

（1）poiXY：

说明：经纬度坐标。必填。

类型：MLngLat。

（2）zoom：

说明：地图缩放级别

取值：

范围 3 到 17 级

3-6 级，省级行政区域

7-9 级，市级行政区域

10-17 级，区级行政区域

类型：number。

（3）options：




返回值：

JSON 或 XML。


以 XML 为例：


<china servername="mSIS02" versionname="1.0.7.2">

<province_list type="list">

<province>


<x>116.408198</x>

<y>39.904667</y>

<code>110000</code>

<bounds>115.420372;39.443252;117.505569;41.060871</bounds>

<ename>BJ</ename>


<city_list type="list">

<city>

<name>北京</name>

<x>116.397945</x>

<y>39.90817</y>

<code>110000</code>

<bounds>115.420372;39.443252;117.505569;41.060871</bounds>

<ename>BJ</ename>




<district_list type="list">

<district>

<name>西城区</name>

<x>116.364</x>

<y>39.9352</y>

<code>110102</code>

<bounds>116.327339;39.897415;116.399963;39.972980</bounds>

<ename>XCQ</ename>


</district>

<district>

……

</district_list>

</city>

</city_list>

</province>

</province_list>

</china>

示例：

var zoom = 17;


var options= new MSearchToolsOptions();

var mrs = new MSearchTools();


mrs.districtSearchByPoiAndZoom(startXY,zoom,options);




}else{


}

}

61 MSearchToolsOptions()

61.1 说明

辅助查询工具类参数选项类。



61.2 命名空间

com.mapabc.search.api. MSearchToolsOptions。

61.3 构造方法

61.3.1 MSearchToolsOptions()

说明：

初始化 MSearchToolsOptions 类的一个新实例。

示例:

var option=new MSearchToolsOptions();

61.4 属性

61.4.1 resType

说明：


取值：

JSON（默认）

XML

类型：

string。

61.4.2 ver

说明：

版本号

取值：

1.0，1.0 版本（默认）

2.0，2.0 版本

类型：

string。


说明：

请求方式

取值：





类型：

String

61.5 方法

无

61.6 示例

var mgco = new MSearchToolsOptions();

mgco.resType="xml";

mgco.ver="2.0";

62 MDynamicRendering()

62.1 说明

封装了动态渲染查询相关方法。

62.2 命名空间

com.mapabc.search.api.MDynamicRendering。

62.3 构造方法

62.3.1 MDynamicRendering()

说明：

初始化 MDynamicRendering 类的一个新实例。

示例：

var mls = new MDynamicRendering();



62.4 方法

62.4.1 poiSearchByPoiId(poiId,serverLayer,options)

说明：

根据 POI 的 ID 号查询动态渲染服务数据层中的 POI 信息。

参数：

（1）poiId：

说明：POI 的 ID 号。必填。

类型：string。


说明：动态渲染服务数据层 ID 号。必填。

类型：string。

（3）options：

说明：动态渲染查询参数对象，非必填，参见 MDynamicRenderingOptions 类。

类型：MDynamicRenderingOptions。

本方法使用到 MDynamicRenderingOptions 中属性：


返回值：

JSON 或 XML。


以 XML 为例：



<count>1</count>

<list type="list">

<poi>

<address />

<name>上海南站</name>

<id>19</id>

<type>S</type>

<x>KKJNPQRNRSNMLHH</x>

<y>MJGQQUPMQMNELLD</y>

<extid />

<tel />


<z>3</z>

<xys />

<extendMap>

<price>8.880000114440918</price>

</extendMap>



<featuretype>1</featuretype>

<information />

<puiid>A3000G8I4W415</puiid>

<stylecolor />

<stylewidth />

<thematicvalue>19</thematicvalue>

</poi>

</list>

</searchresult>

示例：

var id = "19";

var layer = "nga_c";


var mlsp= new MDynamicRenderingOptions();


mls.poiSearchByPoiId(id,layer,mlsp);




}else{


}

}

62.4.2 poiSearchByCenPoi(centerPoiXY,serverLayer,options)

说明：

根据中心点经纬度坐标查询动态渲染服务数据层中的 POI 信息。

参数：


说明：中心点经纬度坐标。必填。

类型：MLngLat。



类型：string。

（3）options：





（b）range，查询范围

返回值：



JSON 或 XML。


以 XML 为例：



<count>2</count>

<list type="list">

<poi>

<address />

<name>地铁 2 号线(浦东国际机场--徐泾东)</name>

<id>276</id>

<type>L</type>

<x>KKJNQTKRXNSILHL</x>

<y>MJGRLVKUTOMEHDH</y>

<extid />

<tel />


<z>0</z>

<xys>KKJNTOMPWMILHH,MJGQQUJMQILHD,KKJNTOKTVMIHHL </xys>

<extendMap>

<price>8.880000114440918</price>

</extendMap>


<information />

<puiid>A3000G8ID39B8</puiid>

<stylecolor>#36B854</stylecolor>

<stylewidth />


</poi>

</list>

</searchresult>

示例：

var centerPoiXY = new MLngLat(116.3,39.8);





mls.poiSearchByCenPoi(centerPoiXY,layer,mlsp);




}else{




}

}

62.4.3 spatialSearchByRegion(regionXY, serverLayer,options)

说明：

根据多边形顶点经纬度坐标组查询动态渲染服务数据层中的空间数据信息。

参数：

（1）regionXY：

说明：多边形顶点经纬度坐标组。必填。




类型：string。

（3）options：





返回值：

JSON 或 XML。


以 XML 为例：



<count>2</count>

<list type="list">

<poi>

<address />

<name>地铁 2 号线(浦东国际机场--徐泾东)</name>

<id>276</id>

<type>L</type>

<x>KKJNQTKRXNSMHHH</x>

<y>MJGRLVKUTOMILHH</y>

<extid />

<tel />


<z>0</z>

<xys>KKJNTOMPWMMHLL,MJGQQUJMQMHHH,KKJNTOKTVMMLLH </xys>

<extendMap>

<price>8.880000114440918</price>



</extendMap>


<information />

<puiid>A3000G8ID39B8</puiid>

<stylecolor>#36B854</stylecolor>

<stylewidth />


</poi>

</list>

</searchresult>

示例：





arr.push(poi1);

arr.push(poi2);

arr.push(poi3);





mls.spatialSearchByRegion(arr,layer,mlsp);




}else{


}

}

63 MDynamicRenderingOptions()

63.1 说明

动态渲染查询参数选项类。

63.2 命名空间

com.mapabc.search.api.MDynamicRenderingOptions。



63.3 构造方法

63.3.1 MDynamicRenderingOptions()

说明：

初始化 MDynamicRenderingOptions 类的一个新实例。

示例:

var option=new MDynamicRenderingOptions();

63.4 属性

63.4.1 resType

说明：


取值：

JSON（默认）

XML

类型：

string。

63.4.2 range

说明：

查询范围

取值：

默认为 5000 米

类型：

number。


说明：

请求方式

取值：



类型：

String



63.5 方法

无

63.6 示例

var mgco = new MDynamicRenderingOptions();

mgco.resType="xml";

64 错误代码附录：

在查询结果中返回。

64.1 400 错误请求

输入参数不符合规范：

参数为空：data.error_id =400 ； data.error_message=XXX 参数为空.

参数过长：data.error_id =400； data.error_message=XXX 参数长度超过范围.

参数错误：data.error_id =400；data.error_message=XXX 参数错误.

64.2 403 无权访问

强制锁定：data.error_id =403；data.error_message=被强制锁定.

余额不足：data.error_id =403；data.error_message=余额不足.

过期：data.error_id =403；data.error_message=过期.

KEY 存在,但是 URL 错误：data.error_id =403； data.error_message=KEY 存在,但是 URL 错

误.

KEY 不存在：data.error_id =403； data.error_message=KEY 不存在（没申请或被注销）.

Documents

Ajax api（flash地图展现）用户手册—企业版—v2.3.4