Upload
aethersg
View
292
Download
8
Embed Size (px)
Citation preview
MapABC 地图应用程序编程接口-用户手册
北京图盟科技有限公司
MapABC 地图应用程序编程接口
用户手册
文件状态:
[ ] 草稿
[√] 正式发布
[ ] 正在修改
文件标识: MapABC-Map API-UM
当前版本: Ajax API(Flash 地图展现)2.3.4 企业版
作 者:
创建日期:
最后更新:
密 级: 秘密
版权说明: 版权© 2010 归北京图盟科技有限公司所有
MapABC 地图应用程序编程接口-用户手册
北京图盟科技有限公司
版版 本本 管管 理理
【修改记录】
版本/状态 作者 起止日期 备注
【审 阅】
版本/状态 审阅时间 审阅人 职务 备注
MapABC 地图应用程序编程接口-用户手册
北京图盟科技有限公司
说明 本文档是 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 地图应用程序编程接口-用户手册
北京图盟科技有限公司
目录
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
MapABC 地图应用程序编程接口-用户手册
北京图盟科技有限公司
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
MapABC 地图应用程序编程接口-用户手册
北京图盟科技有限公司
坐标类型 ..............................................................................................................................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
MapABC 地图应用程序编程接口-用户手册
北京图盟科技有限公司
修改地图状态 ......................................................................................................................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
MapABC 地图应用程序编程接口-用户手册
北京图盟科技有限公司
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
MapABC 地图应用程序编程接口-用户手册
北京图盟科技有限公司
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
MapABC 地图应用程序编程接口-用户手册
北京图盟科技有限公司
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
MapABC 地图应用程序编程接口-用户手册
北京图盟科技有限公司
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
MapABC 地图应用程序编程接口-用户手册
北京图盟科技有限公司
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
MapABC 地图应用程序编程接口-用户手册
北京图盟科技有限公司
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
MapABC 地图应用程序编程接口-用户手册
北京图盟科技有限公司
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
MapABC 地图应用程序编程接口-用户手册
北京图盟科技有限公司
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
MapABC 地图应用程序编程接口-用户手册
北京图盟科技有限公司
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
MapABC 地图应用程序编程接口-用户手册
北京图盟科技有限公司
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
MapABC 地图应用程序编程接口-用户手册
北京图盟科技有限公司
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
MapABC 地图应用程序编程接口-用户手册
北京图盟科技有限公司
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
MapABC 地图应用程序编程接口-用户手册
北京图盟科技有限公司
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
MapABC 地图应用程序编程接口-用户手册
北京图盟科技有限公司
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
MapABC 地图应用程序编程接口-用户手册
北京图盟科技有限公司
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
MapABC 地图应用程序编程接口-用户手册
北京图盟科技有限公司
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
MapABC 地图应用程序编程接口-用户手册
北京图盟科技有限公司
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
MapABC 地图应用程序编程接口-用户手册
北京图盟科技有限公司
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
MapABC 地图应用程序编程接口-用户手册
北京图盟科技有限公司
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
MapABC 地图应用程序编程接口-用户手册
北京图盟科技有限公司
地图 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
MapABC 地图应用程序编程接口-用户手册
北京图盟科技有限公司
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
说明:
工具条样式常量,小型工具条
MapABC 地图应用程序编程接口-用户手册
北京图盟科技有限公司
示例:
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
说明:
鼠标工具常量,设置鼠标焦点滚轮缩放
示例:
MapABC 地图应用程序编程接口-用户手册
北京图盟科技有限公司
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
说明:
鼠标工具常量,鼠标测距
示例:
MapABC 地图应用程序编程接口-用户手册
北京图盟科技有限公司
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
MapABC 地图应用程序编程接口-用户手册
北京图盟科技有限公司
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
MapABC 地图应用程序编程接口-用户手册
北京图盟科技有限公司
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
MapABC 地图应用程序编程接口-用户手册
北京图盟科技有限公司
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
MapABC 地图应用程序编程接口-用户手册
北京图盟科技有限公司
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
MapABC 地图应用程序编程接口-用户手册
北京图盟科技有限公司
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
MapABC 地图应用程序编程接口-用户手册
北京图盟科技有限公司
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
说明:
MapABC 地图应用程序编程接口-用户手册
北京图盟科技有限公司
切片图层常量,卫星图层
示例:
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
MapABC 地图应用程序编程接口-用户手册
北京图盟科技有限公司
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
MapABC 地图应用程序编程接口-用户手册
北京图盟科技有限公司
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
MapABC 地图应用程序编程接口-用户手册
北京图盟科技有限公司
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
说明:
MapABC 地图应用程序编程接口-用户手册
北京图盟科技有限公司
位置名称常量,上右
示例:
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
说明:
MapABC 地图应用程序编程接口-用户手册
北京图盟科技有限公司
位置名称常量,下右
示例:
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 类的一个新实例。
参数:
MapABC 地图应用程序编程接口-用户手册
北京图盟科技有限公司
(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); //通过对象的属性返回经纬度坐标。
MapABC 地图应用程序编程接口-用户手册
北京图盟科技有限公司
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。
事件:
MapABC 地图应用程序编程接口-用户手册
北京图盟科技有限公司
无
注释:
无
示例:
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);
MapABC 地图应用程序编程接口-用户手册
北京图盟科技有限公司
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。
事件:
无
注释:
无
MapABC 地图应用程序编程接口-用户手册
北京图盟科技有限公司
示例:
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()
说明:
MapABC 地图应用程序编程接口-用户手册
北京图盟科技有限公司
返回地图是否允许缩放的状态。
参数:
无
返回值:
说明:如果允许地图缩放返回 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,则表示操作有误,对照附录的错误
代码表可以查看错误代码类型。
MapABC 地图应用程序编程接口-用户手册
北京图盟科技有限公司
类型: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。
返回值:
说明:如果返回值为 0,表示操作正确,如果非 0,则表示操作有误,对照附录的错误
代码表可以查看错误代码类型。
类型: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。
返回值:
说明:如果返回值为 0,表示操作正确,如果非 0,则表示操作有误,对照附录的错误
代码表可以查看错误代码类型。
MapABC 地图应用程序编程接口-用户手册
北京图盟科技有限公司
类型: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。
返回值:
说明:如果返回值为 0,表示操作正确,如果非 0,则表示操作有误,对照附录的错误
代码表可以查看错误代码类型。
类型:number。
事件:
无
注释:
无
示例:
mapObj.setContinuousZoom(true);
2.4.17 setMapColor(color)
说明:
设置地图颜色。
参数:
(1) color:
说明:地图的颜色,该属性值为 16 进制,例如"#ff0000",默认为"#000000"。
类型:String。
返回值:
说明:如果返回值为 0,表示操作正确,如果非 0,则表示操作有误,对照附录的错误
代码表可以查看错误代码类型。
类型:number。
事件:
MapABC 地图应用程序编程接口-用户手册
北京图盟科技有限公司
无
注释:
无
示例:
mapObj.setMapColor('#ff0000');
2.4.18 setDragEnabled(dragEnabled)
说明:
设置地图是否允许拖拽。
参数:
(1)dragEnabled
说明:是否允许地图拖拽。
类型:boolean。
返回值:
说明:如果返回值为 0,表示操作正确,如果非 0,则表示操作有误,对照附录的错误
代码表可以查看错误代码类型。
类型:number。
事件:
无
注释:
该方法只限于控制地图是否可以被鼠标拖拽,不能控制鹰眼拖图,不限制其他移图接口。
示例:
mapObj.setDragEnabled(false);
2.4.19 setZoomEnabled(zoomEnabled)
说明:
设置是否允许地图缩放。
参数:
(1)zoomEnabled:
说明:是否允许地图缩放。
类型:boolean。
返回值:
说明:如果返回值为 0,表示操作正确,如果非 0,则表示操作有误,对照附录的错误
代码表可以查看错误代码类型。
类型:number。
事件:
无
注释:
地图缩放方法包括通过鱼骨条缩放地图、鼠标双击放大、键盘缩放地图以及 zoomIn()、
zoomOut()方法。
示例:
MapABC 地图应用程序编程接口-用户手册
北京图盟科技有限公司
mapObj.setZoomEnabled(false);
2.4.20 setLngLatBounds(bounds)
说明:
根据经纬度 bounds 设置最合适的地图位置和 zoom 级别。其中 bounds 表示
MLngLatBounds 对象。
参数:
(1)bounds:
说明:通过西南、东北角的经纬度坐标构建的经纬度矩形区域。
类型:MLngLatBounds。
返回值:
说明:如果返回值为 0,表示操作正确,如果非 0,则表示操作有误,对照附录的错误
代码表可以查看错误代码类型。
类型:number。
事件:
MAP_MOVE_END 事件。
注释:
该方法不支持真实坐标。
示例:
mapObj.setLngLatBounds(new MLngLatBounds(new MLngLat('58','23',1),new
MLngLat('116','24',1)));
2.4.21 zoomIn(lnglat)
说明:
放大地图的一个级别。除了使用该方法进行放大地图以外,还可以使用鱼骨条、鼠标双
击、键盘“+”方法来放大地图。
参数:
(1)lngLat:
说明:地图缩放时的焦点坐标。默认为空,即中心点放大。
类型:MLngLat。
返回值:
说明:如果返回值为 0,表示操作正确,如果非 0,则表示操作有误,对照附录的错误
代码表可以查看错误代码类型。
类型:number。
事件:
ZOOM_START 事件、ZOOM_END 事件、ZOOM_CHANGED 事件。
注释:
无
示例:
mapObj.zoomIn(new MLngLat("116.39746427536011","39.9086663756386"));
MapABC 地图应用程序编程接口-用户手册
北京图盟科技有限公司
2.4.22 zoomOut(lnglat)
说明:
缩小地图的一个级别。除了使用该方法,还可以使用鱼骨条、键盘“减号”来缩小地图。
参数:
lngLat:
说明:地图缩放时的焦点坐标。默认为空,即中心点缩小。
类型:MLngLat。
返回值:
说明:如果返回值为 0,表示操作正确,如果非 0,则表示操作有误,对照附录的错误
代码表可以查看错误代码类型。
类型:number。
事件:
ZOOM_START 事件、ZOOM_END 事件、ZOOM_CHANGED 事件。
注释:
无
示例:
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 表示向下
方滑动。
类型:constant。
返回值:
说明:如果返回值为 0,表示操作正确,如果非 0,则表示操作有误,对照附录的错误
代码表可以查看错误代码类型。
类型:number。
事件:
MAP_MOVE_START 事件、MAP_MOVE_END 事件、MAP_MOVING 事件。
注释:
无
示例:
mapObj.panDirection(EAST,SOUTH);//地图朝右下滑动地图宽度一半的距离。
MapABC 地图应用程序编程接口-用户手册
北京图盟科技有限公司
2.4.24 panTo(center)
说明:
移动地图的中心点到指定的坐标。
参数:
(1)center:
说明:目标位置中心点经纬度。
类型:MLngLat。
返回值:
说明:如果返回值为 0,表示操作正确,如果非 0,则表示操作有误,对照附录的错误
代码表可以查看错误代码类型。
类型:number。
事件:
MAP_MOVE_END 事件。
注释:
如果该点已经在当前的视口之中,则地图中心会滑动到该位置;如果该点不在当前的视
口之中,地图中心点跳转到指定坐标。
示例:
mapObj.panTo(new MLngLat("116.49746427536011","39.9086663756386"));
2.4.25 panBy(position,speed)
说明:
地图按指定速度滑动指定的像素距离。
参数:
(1)position:
说明:地图移动的像素距离。
类型:MSize。
(2)speed:
说明:地图移动速度。
取值:单位为像素每秒
类型:number。
返回值:
说明:如果返回值为 0,表示操作正确,如果非 0,则表示操作有误,对照附录的错误
代码表可以查看错误代码类型。
类型:number。
事件:
MAP_MOVE_START 事件、MAP_MOVE_END 事件、MAP_MOVING 事件。
注释:
无
示例:
mapObj.panBy(new MSize(50,40),300);
MapABC 地图应用程序编程接口-用户手册
北京图盟科技有限公司
2.4.26 setCtrlPanelState (ctrlName,state)
说明:
设置地图上的控制面板是否显示。
参数:
(1)ctrlName :
说明:控件名称。
取值:OVERVIEW_CTRL:鹰眼
TOOLBAR_CTRL:工具条
SCALE_CTRL:比例尺
类型:constant。
(2)state :
说明:显示状态。
取值:SHOW:显示
HIDE:隐藏
MINIMIZE:最小化(只适用鹰眼)
类型:constant。
返回值:
说明:如果返回值为 0,表示操作正确,如果非 0,则表示操作有误,对照附录的错误
代码表可以查看错误代码类型。
类型: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:
说明:鹰眼状态
MapABC 地图应用程序编程接口-用户手册
北京图盟科技有限公司
取值:MINIMIZE:最小化鹰眼
SHOW:打开鹰眼(默认)
HIDE:隐藏鹰眼
类型:constant。
返回值:
说明:如果返回值为 0,表示操作正确,如果非 0,则表示操作有误,对照附录的错误
代码表可以查看错误代码类型。
类型:number。
事件:
OVERVIEWMAP_CHANGED 事件
注释:
无
示例:
mapObj.setOverviewState(SHOW); //打开鹰眼
mapObj.setOverviewState(MINIMIZE); //最小化鹰眼
mapObj.setOverviewState(HIDE); //隐藏鹰眼
2.4.28 loadCtrlPanel(ctrlName,opt)
说明:
加载地图控制面板。
参数:
(1)ctrlName:
说明:地图控件名称
取值:TOOLBAR_CTRL(工具条)
类型:constant。
(2)opt:
说明:加载地图控制面板参数选项
取值:opt 结构为:{toolbarPos:MPoint, toolbar:constant,toolbarUrl:String},其中第
一个属性表示工具条的位置,第二个参数表示工具条的类型(必填),第三个参数
表示工具条的 url。
类型:object。
返回值:
说明:如果返回值为 0,表示操作正确,如果非 0,则表示操作有误,对照附录的错误
代码表可以查看错误代码类型。
类型:number。
事件:
无
注释:
无
示例:
var toolbarOpt={};
toolbarOpt.toolbarPos=new MPoint(2,5);
toolbarOpt.toolbar=SMALL;
MapABC 地图应用程序编程接口-用户手册
北京图盟科技有限公司
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 级别,只是存储下来,并不能被调用返回存储值。
参数:
无
返回值:
说明:如果返回值为 0,表示操作正确,如果非 0,则表示操作有误,对照附录的错误
代码表可以查看错误代码类型。
类型:number。
事件:
无
注释:
无
示例:
mapObj.savePosition();
2.4.31 returnToSavedPosition()
说明:
返回到由上次保存的地图中心点位置和 zoom 级别所确定的视野范围状态。
参数:
MapABC 地图应用程序编程接口-用户手册
北京图盟科技有限公司
无
返回值:
说明:如果返回值为 0,表示操作正确,如果非 0,则表示操作有误,对照附录的错误
代码表可以查看错误代码类型。
类型:number。
事件:
ROLL_BACK 事件。
注释:
该方法需与 savePosition 方法成对使用。
示例:
mapObj.returnToSavedPosition();
2.4.32 clearMap(clearType)
说明:
清除地图上的覆盖物和层。
参数:
(1)clearType
说明:清除类型
类型:constant
取值:CLEAR_ALL,删除所有覆盖物和层
CLEAR_MEASURES,删除测距测面结果
返回值:
说明:如果返回值为 0,表示操作正确,如果非 0,则表示操作有误,对照附录的错误
代码表可以查看错误代码类型。
类型:number。
事件:
CLEAR_OVERLAYS 事件
注释:
无
示例:
mapObj.clearMap(CLEAR_ALL);
添加覆盖物
2.4.33 addOverlay(overlay,isToFitView)
说明:
向地图添加覆盖物(如标记,线,面等)。
参数:
(1)overlay:
说明:地图覆盖对象,继承自 MOverlay 对象。
类型:MOverlay。
MapABC 地图应用程序编程接口-用户手册
北京图盟科技有限公司
(2)isToFitView:
说明:设置是否为自动适应视野,默认为 false。当设置为 ture 时,所添加的点线
面覆盖物能自动适应地图视野级别。
类型:boolean。
返回值:
说明:如果返回值为 0,表示操作正确,如果非 0,则表示操作有误,对照附录的错误
代码表可以查看错误代码类型。
类型: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));
arr.push(new MLngLat(116.38727188110351,39.91250133090293));
arr.push(new MLngLat(116.39825820922851 ,39.904600759441024));
//设置线样式
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);
MapABC 地图应用程序编程接口-用户手册
北京图盟科技有限公司
2.4.34 addOverlays(overlays,azc)
说明:
向地图添加一组覆盖物(如标记,线,面等)。
参数:
(1)overlays:
说明:地图覆盖对象数组,继承自 MOverlay 对象。
类型:Array。
(2)azc:
说明:是否自动调整视野到能在地图范围内显示这些 Overlays,默认为 false。
类型:boolean。
返回值:
说明:如果返回值为 0,表示操作正确,如果非 0,则表示操作有误,对照附录的错误
代码表可以查看错误代码类型。
类型:number。
事件:
ADD_OVERLAY 事件。
注释:
无
示例:
在本例中,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。
MapABC 地图应用程序编程接口-用户手册
北京图盟科技有限公司
类型:string。
(4)imageUrl:
说明:点图标的 Url 地址,如果为空则使用默认圆点形状的点图标。
类型:string。
(5)picAgent:
说明:点图标是否使用代理方式添加。
类型:Boolean。
(6)alpha:
说明:如果使用默认的点图标,点图标的透明度。
类型:number。
(7)isDimorohic:
说明:是否有二态效果。
类型:Boolean。
(8)dimorphicColor:
说明:二态效果的颜色。
类型:十六进制整数。
返回值:
说明:如果返回值为 0,表示操作正确,如果非 0,则表示操作有误,对照附录的错误
代码表可以查看错误代码类型。
类型:number。
事件:
ADD_OVERLAY 事件。
注释:
本方法只适用于添加点覆盖物,所谓轻量级是指不用对象的形式创建点覆盖物,并且创
建的点覆盖物只包含几个属性。
使用代理方式加载点图标,可以方便用户不担心跨域问题,如果用户不选择使用代理方
式,则需要保证有权限控制文件。
示例:
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 对象。
类型:MOverlay。
返回值:
说明:如果返回值为 0,表示操作正确,如果非 0,则表示操作有误,对照附录的错误
代码表可以查看错误代码类型。
类型:number。
MapABC 地图应用程序编程接口-用户手册
北京图盟科技有限公司
事件:
无
注释:
使用该方法更新 marker 时不能更新其经纬度坐标。
示例:
以下代码片使用 updateOverlay()方法更新原始对象的部分属性特征。
function addLine() {
var arr = new Array();
arr.push(new MLngLat(116.36890411376953 ,39.913423004886866));
arr.push(new MLngLat(116.38212203979492,39.9011768955094));
arr.push(new MLngLat(116.38727188110351,39.91250133090293));
arr.push(new MLngLat(116.39825820922851 ,39.904600759441024));
var tipOption = new MTipOptions();
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。
返回值:
说明:如果返回值为 0,表示操作正确,如果非 0,则表示操作有误,对照附录的错误
代码表可以查看错误代码类型。
MapABC 地图应用程序编程接口-用户手册
北京图盟科技有限公司
类型:number。
事件:
无
注释:
背景图片目前无法编辑。
示例:
mapObj.setOverlayEditableById("polylineapi",true);
2.4.38 setOverlayToTopById(overlayId)
说明:
设置指定的覆盖物位于同类覆盖物的最顶层。
参数:
(1)overlayId:
说明:要置顶的 overlay 对象的 id。
类型:string。
返回值:
说明:如果返回值为 0,表示操作正确,如果非 0,则表示操作有误,对照附录的错误
代码表可以查看错误代码类型。
类型:number。
事件:
无
注释:
一般来讲,在地图引擎中点对象位于顶层,线对象位于中间层,面对像位于最底层,该
方法只能调整同类覆盖物之间的位置关系,并不能调整不同类覆盖物之间相对位置。
示例:
mapObj.setOverlayToTopById("marker"); //将 id 为"marker"的点覆盖物置于所有点的最
顶层
2.4.39 setOverlayVisibleById(overlayId,isVisible)
说明:
设置 overlay 是否显示。
参数:
(1)overlayId:
说明:覆盖物对象的 id。
类型:string。
(2)isVisible:
说明: 指定 id 的覆盖物是否可见。
类型:boolean。
返回值:
说明:如果返回值为 0,表示操作正确,如果非 0,则表示操作有误,对照附录的错误
代码表可以查看错误代码类型。
MapABC 地图应用程序编程接口-用户手册
北京图盟科技有限公司
类型: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。
返回值:
说明:如果返回值为 0,表示操作正确,如果非 0,则表示操作有误,对照附录的错误
代码表可以查看错误代码类型。
类型:number。
事件:
无
注释:
本方法支持点线面覆盖物。本方法不受鼠标事件控制。
示例:
mapObj.setOverlayDimorphicById ("marker",true); //“marker”是加载到地图上的点对
象的 id。
2.4.41 setFitview(overlays)
说明:
设置覆盖物到合适的地图视野级别。
参数:
(1)overlays:
说明:覆盖物对象列表或覆盖物对象 id 列表。
类型:array。
返回值:
说明:如果返回值为 0,表示操作正确,如果非 0,则表示操作有误,对照附录的错误
MapABC 地图应用程序编程接口-用户手册
北京图盟科技有限公司
代码表可以查看错误代码类型。
类型: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,绽放效果点聚合
类型:constant。
(2)clusterOption:
说明:点聚合参数选项。
类型:MClusterOptions。
返回值:
说明:如果返回值为 0,表示操作正确,如果非 0,则表示操作有误,对照附录的错误
代码表可以查看错误代码类型。
类型:number。
事件:
无
注释:
只对点对象起作用。
示例:
var clusterOptions=new MClusterOptions();
clusterOptions.gridSize=40;
clusterOptions.maxZoom=12;
map.setClusterState(MClusterOptions.NORMAL_CLUSTER, clusterOptions)
2.4.43 getOverlayById(overlayId)
说明:
通过 Id 获得指定的覆盖物对象,并可以通过该对象获得对象属性值。
参数:
MapABC 地图应用程序编程接口-用户手册
北京图盟科技有限公司
(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
类型:constant。
返回值:
说明:指定类型的覆盖物对象数组。
类型: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);
}
}
MapABC 地图应用程序编程接口-用户手册
北京图盟科技有限公司
2.4.45 expOverlay(overlayId)
说明:
根据 overlayID 导出 json 形式的 overlay 对象。
参数:
(1)overlayId:
说明:覆盖物的 Id。
类型: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);
MapABC 地图应用程序编程接口-用户手册
北京图盟科技有限公司
2.4.46 removeOverlaysByType(type)
说明:
根据 overlay 类型删除 overlay 对象。
参数:
(1)type:
说明:覆盖物的对象
取值: MOverlay.TYPE。
类型:constant。
返回值:
说明:如果返回值为 0,表示操作正确,如果非 0,则表示操作有误,对照附录的错误
代码表可以查看错误代码类型。
类型:number。
事件:
REMOVE_OVERLAY 事件。
注释:
无
示例:
mapObj.removeOverlaysByType(MOverlay.TYPE_MARKER); //删除所有的标识点
2.4.47 removeOverlay(overlay)
说明:
删除地图上指定的地图覆盖物。
参数:
(1)overlay:
说明:待删除的对象。
类型:MOverlay。
返回值:
说明:如果返回值为 0,表示操作正确,如果非 0,则表示操作有误,对照附录的错误
代码表可以查看错误代码类型。
类型:number。
事件:
REMOVE_OVERLAY 事件
注释:
无
示例:
mapObj.removeOverlay(line) ; //删除 line 覆盖物对象。
2.4.48 removeOverlays(overlays)
说明:
一次删除地图上多个覆盖物对象。
MapABC 地图应用程序编程接口-用户手册
北京图盟科技有限公司
参数:
(1)overlays:
说明:待删除的覆盖物对象数组。
类型:array。
返回值:
说明:如果返回值为 0,表示操作正确,如果非 0,则表示操作有误,对照附录的错误
代码表可以查看错误代码类型。
类型:number。
事件:
REMOVE_OVERLAY 事件
注释:
无
示例:
mapObj.removeOverlays(arr) ;
2.4.49 removeOverlayById(overlayId)
说明:
删除地图上指定 id 的地图覆盖物。
参数:
(1)overlayId:
说明:待删除对象的 Id。
类型:string。
返回值:
说明:如果返回值为 0,表示操作正确,如果非 0,则表示操作有误,对照附录的错误
代码表可以查看错误代码类型。
类型:number。
事件:
REMOVE_OVERLAY 事件
注释:
无
示例:
mapObj.removeOverlayById("marker"); //删除 Id 为"marker"的对象
2.4.50 removeAllOverlays()
说明:
删除地图上所有的覆盖物(overlays)对象。
参数:
无
返回值:
说明:如果返回值为 0,表示操作正确,如果非 0,则表示操作有误,对照附录的错误
代码表可以查看错误代码类型。
MapABC 地图应用程序编程接口-用户手册
北京图盟科技有限公司
类型:number。
事件:
CLEAR_OVERLAYS 事件
注释:
无
示例:
mapObj.removeAllOverlays(); //删除 mapObj 地图对象上所有覆盖物。
2.4.51 setDefaultMarkerOption(option)
说明:
设置默认 Marker 样式。
参数:
(1)option:
说明:marker 样式,遵从 MMarkerOptions 结构。
类型:MMarkerOptions。
返回值:
无
事件:
无
注释:
无
示例:
如下代码片介绍了设置默认点样式的方法。
function setDefaultMarkerOption() {//设置默认点样式
var tipOption = new MTipOptions();
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;
MapABC 地图应用程序编程接口-用户手册
北京图盟科技有限公司
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 ;
linest.thickness = 3;
var tipOption = new MTipOptions(); //创建一个 MTipOptions 对象
tipOption.title="title";
tipOption.content="content"; //tip 内容
lineopt= new MLineOptions(); //创建一个 lineOptions 对象
lineopt.lineStyle = linest;
lineopt.tipOption = tipOption;
lineopt.canShowTip = true;
mapObj.setDefaultLineOption(lineopt);
var arr = new Array();
arr.push(new MLngLat(116.36890411376953 ,39.913423004886866));
arr.push(new MLngLat(116.38212203979492,39.9011768955094));
arr.push(new MLngLat(116.38727188110351,39.91250133090293));
arr.push(new MLngLat(116.39825820922851 ,39.904600759441024));
var line1=new MPolyline(arr);//此处创建一 line1对象,第二个缺省参数即为默认的 lineopt
mapObj.addOverlay(line1);
MapABC 地图应用程序编程接口-用户手册
北京图盟科技有限公司
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.title="title";
tipOption.content="content";
tipOption.hasShadow= false;
var areopt = new MAreaOptions(); //areOptions 选项
areopt.areaStyle=lineopt1;
areopt.tipOption=tipOption;
areopt.canShowTip = true;
mapObj.setDefaultAreaOption(areopt);
var arr = new Array();
arr.push(new MLngLat(116.36890411376953 ,39.913423004886866));
arr.push(new MLngLat(116.38212203979492,39.9011768955094));
arr.push(new MLngLat(116.38727188110351,39.91250133090293));
arr.push(new MLngLat(116.39825820922851 ,39.904600759441024));
var polygon=new MPolygon(arr); //创建多边形对象,使用默认的样式
mapObj.addOverlay(polygon); //添加到地图上
MapABC 地图应用程序编程接口-用户手册
北京图盟科技有限公司
叠加层
2.4.54 addWMSLayer(options)
说明:
向地图上叠加 WMS 图层。
参数:
(1)options:
说明:WMS 层的参数选项。
类型:MWMSLayerOptions。
返回值:
说明:如果返回值为 0,表示操作正确,如果非 0,则表示操作有误,对照附录的错误
代码表可以查看错误代码类型。
类型:number。
事件:
无
注释:
无
示例:
mapObj.addWMSLayer(WMSLayerOptions);
2.4.55 addTileLayer(tileLayer)
说明:
向地图叠加切片图层,叠加的切片图层可以是用户编辑图层,也可以是实时交通图层或
轨道交通图层等。
参数:
(1)tileLayer:
说明:地图叠加切片图层对象。
类型:MTileLayer
返回值:
说明:如果返回值为 0,表示操作正确,如果非 0,则表示操作有误,对照附录的错误
代码表可以查看错误代码类型。
类型:number。
事件:
ADD_TILELAYER 事件。
注释:
无
示例 1:
var tileLayerOptions =new MTileLayerOptions(); //添加用户编辑器图层
tileLayerOptions.userId="20001";
tileLayerOptions.layerId="usermapTile";
var tl = new MTileLayer(TL_USERMAP,tileLayerOptions);
MapABC 地图应用程序编程接口-用户手册
北京图盟科技有限公司
mapObj.addTileLayer(tl);
示例 2:
var tl = new MTileLayer(TL_TRAFFIC); //添加实时交通层
mapObj.addTileLayer(tl);
示例 3:
var tl = new MTileLayer(TL_MASS_TRANSIT); //添加轨道交通层
mapObj.addTileLayer(tl);
示例 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);
mapObj.addTileLayer(tl);
2.4.56 addDataLayer(dataLayer)
说明:
向地图添加数据切片图层。
参数:
(1)dataLayer:
说明:地图数据切片图层对象。
类型:MDataLayer。
返回值:
说明:如果返回值为 0,表示操作正确,如果非 0,则表示操作有误,对照附录的错误
代码表可以查看错误代码类型。
类型: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 值的上限,根据这些条件渲染出每
MapABC 地图应用程序编程接口-用户手册
北京图盟科技有限公司
个点的显示范围和渐变颜色,并以图层的形式叠加在地图上。
参数:
(1)options:
说明:地图渐变图层对象。
类型:MGradientMapOptions。
返回值:
说明:如果返回值为 0,表示操作正确,如果非 0,则表示操作有误,对照附录的错误
代码表可以查看错误代码类型。
类型:number。
事件:
无。
注释:
无。
示例:
var options =new MGradientMapOptions();
options.pointsXMLString='<root>' +
'<point><x>116.1</x><y>39.1</y><value>170</value></point>' +
'<point><x>116.7</x><y>39.7</y><value>250</value></point>' +
'<point><x>116.8</x><y>39.8</y><value>280</value></point>' +
'<point><x>116.9</x><y>39.9</y><value>300</value></point>' +
'<point><x>116.1</x><y>40.9</y><value>340</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。
返回值:
说明:如果返回值为 0,表示操作正确,如果非 0,则表示操作有误,对照附录的错误
代码表可以查看错误代码类型。
类型:number。
事件:
无。
注释:
MapABC 地图应用程序编程接口-用户手册
北京图盟科技有限公司
目前更新方法仅对 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 图层。
参数:
无
返回值:
说明:如果返回值为 0,表示操作正确,如果非 0,则表示操作有误,对照附录的错误
代码表可以查看错误代码类型。
类型: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,房地产图层
类型:constant。
(2)tileLayerId:
说明:地图叠加层 Id。删除 TL_TRAFFIC、TL_MASS_TRANSIT、TL_SATELLITE、
TL_REAL_ESTATE 图层时,不用指定此参数。
MapABC 地图应用程序编程接口-用户手册
北京图盟科技有限公司
类型:string。
返回值:
说明:如果返回值为 0,表示操作正确,如果非 0,则表示操作有误,对照附录的错误
代码表可以查看错误代码类型。
类型: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。
返回值:
说明:如果返回值为 0,表示操作正确,如果非 0,则表示操作有误,对照附录的错误
代码表可以查看错误代码类型。
类型:number。
事件:
无
注释:
无。
示例:
mapObj.removeDataLayer("","layer1");
2.4.62 removeGradientMapLayer()
说明:
删除地图上的叠加渐变图层。
参数:
无
返回值:
MapABC 地图应用程序编程接口-用户手册
北京图盟科技有限公司
说明:如果返回值为 0,表示操作正确,如果非 0,则表示操作有误,对照附录的错误
代码表可以查看错误代码类型。
类型: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。
返回值:
MapABC 地图应用程序编程接口-用户手册
北京图盟科技有限公司
说明:如果返回值为 0,表示操作正确,如果非 0,则表示操作有误,对照附录的错误
代码表可以查看错误代码类型。
类型:number。
事件:
无
注释:
无
示例:
mapObj.removeMenuItem('22') ;
信息窗口
2.4.65 openTip(position, tipOptions)
说明:
显示地图的信息窗口。
参数:
(1)position:
说明:信息窗口的显示位置。
类型:MLngLat。
(2)tipOptions:
说明:tip 窗口显示内容,显示风格选项。
类型:MTipOptions。
返回值:
说明:如果返回值为 0,表示操作正确,如果非 0,则表示操作有误,对照附录的错误
代码表可以查看错误代码类型。
类型:number。
事件:
TIP_OPEN 事件
注释:
无
示例:
本例中,tipOption 是事先定义好的 tip 选项对象。
mapObj.openTip(new MLngLat(116.39825820922851 ,39.904600759441024)
,tipOption);
2.4.66 openOverlayTip(overlayId)
说明:
显示 Overlay 对象的信息窗口。
参数:
(1)overlayId:
说明:要打开 tip 的覆盖物的 Id。
MapABC 地图应用程序编程接口-用户手册
北京图盟科技有限公司
类型:string。
返回值:
说明:如果返回值为 0,表示操作正确,如果非 0,则表示操作有误,对照附录的错误
代码表可以查看错误代码类型。
类型: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 参数,该参数可设置的属
MapABC 地图应用程序编程接口-用户手册
北京图盟科技有限公司
性值为: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:拉框缩小
类型:constant。
(2)option:
说明:当前鼠标功能的参数设置,参数作为 option 的属性值传递,为可选项,目
前只应用到 RULER 和 DRAW_CIRCLE 功能上。
类型:object。
返回值:
说明:如果返回值为 0,表示操作正确,如果非 0,则表示操作有误,对照附录的错误
代码表可以查看错误代码类型。
类型: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); //通过鼠标画矩形
MapABC 地图应用程序编程接口-用户手册
北京图盟科技有限公司
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。
返回值:
说明:如果返回值为 0,表示操作正确,如果非 0,则表示操作有误,对照附录的错误
代码表可以查看错误代码类型。
类型:number。 事件:
GPS_MOVEALONG_COMPLETE 事件
注释:
要想调用此方法,必须先使用MMap.addOverlay()方法将MMarker添加到地图上。同时,
MapABC 地图应用程序编程接口-用户手册
北京图盟科技有限公司
此方法必须与 MMap.startMoveAlong()方法一起使用。
示例:
var arr = new Array();
arr.push(new MLngLat(116.36890411376953 ,39.913423004886866));
arr.push(new MLngLat(116.38212203979492,39.9011768955094));
arr.push(new MLngLat(116.38727188110351,39.91250133090293));
arr.push(new MLngLat(116.39825820922851 ,39.904600759441024));
mapObj.markerMoveAlong("mark",arr,3);
2.4.70 startMoveAlong(markerId,isLoop)
说明:
开始移动指定的 marker 对象。
参数:
(1)markerId:
说明:要开始移动的 marker 的 id。
类型:string。
(2)isLoop:
说明:MMarker 对象是否沿着移动路线循环移动,默认为否。
类型:boolean。
返回值:
说明:如果返回值为 0,表示操作正确,如果非 0,则表示操作有误,对照附录的错误
代码表可以查看错误代码类型。
类型:number。
事件:
无
注释:
在调用此方法之前必须先使用 moveAlong()方法来设置移动路线。
示例:
var arr = new Array();
arr.push(new MLngLat(116.36890411376953 ,39.913423004886866));
arr.push(new MLngLat(116.38212203979492,39.9011768955094));
arr.push(new MLngLat(116.38727188110351,39.91250133090293));
arr.push(new MLngLat(116.39825820922851 ,39.904600759441024));
mapObj.markerMoveAlong("mark",arr);
mapObj.startMoveAlong("mark",true);//“ marker”为 MMarker 对象的 id
2.4.71 pauseMoveAlong(markerId)
说明:
暂停正在运动中的 marker。
参数:
(1)markerId:
MapABC 地图应用程序编程接口-用户手册
北京图盟科技有限公司
说明:要暂停的 marker 的 id。
类型:string。
返回值:
说明:如果返回值为 0,表示操作正确,如果非 0,则表示操作有误,对照附录的错误
代码表可以查看错误代码类型。
类型:number。
事件:
无
注释:
该方法只对 startMoveAlong 的移动起作用,对 MoveTo 功能不起作用。
示例:
var arr = new Array();
arr.push(new MLngLat(116.36890411376953 ,39.913423004886866));
arr.push(new MLngLat(116.38212203979492,39.9011768955094));
arr.push(new MLngLat(116.38727188110351,39.91250133090293));
arr.push(new MLngLat(116.39825820922851 ,39.904600759441024));
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。
返回值:
说明:如果返回值为 0,表示操作正确,如果非 0,则表示操作有误,对照附录的错误
代码表可以查看错误代码类型。
类型:number。
事件:
无
注释:
在执行该方法前必须先执行 startMoveAlong()方法。
示例:
mapObj.stopMoveAlong("marker");
2.4.73 setGPSFocus(focusType,markerIds)
说明:
MapABC 地图应用程序编程接口-用户手册
北京图盟科技有限公司
设置 marker 为 GPS 焦点模式。
参数:
(1)focusType:
说明:GPS 定位类型。
类型:constant。
取值:NOFOCUS:非焦点模式(默认值);
FOCUS :GPS 对象移出地图时,地图自动移动到以 GPS 位置为中心;
CENTER_FOCUS:GPS 总是在地图中心(仅对单点开放)。
(2)markerIds:
说明:设置焦点的 Marker Id 列表,为空表示解除所有点的 GPS 焦点模式,默认空
数组。
类型:array。
返回值:
说明:如果返回值为 0,表示操作正确,如果非 0,则表示操作有误,对照附录的错误代
码表可以查看错误代码类型。
类型:number。
事件:
无
注释:
无
示例:
var arr=new Array();
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 为直接跳转到目标位置,无移动效果;值越大,移动速度越慢;默
MapABC 地图应用程序编程接口-用户手册
北京图盟科技有限公司
认值为 0。
类型:number。
返回值:
说明:如果返回值为 0,表示操作正确,如果非 0,则表示操作有误,对照附录的错误
代码表可以查看错误代码类型。
类型: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:拖拽过程中
MapABC 地图应用程序编程接口-用户手册
北京图盟科技有限公司
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:全景地图雷达角度改变
类型:constant。
(4)functionName:
说明:事件函数的引用。
类型:function。
返回值:
说明:如果返回值为 0,表示操作正确,如果非 0,则表示操作有误,对照附录的错误
代码表可以查看错误代码类型。
类型:number。
事件:
无
注释:
可以向一个事件注册多个事件处理函数,在事件发生时,事件处理函数按注册时的顺序
执行。
示例:
下面的代码片段定义了一个函数,执行的操作为隐藏鹰眼。然后把这个函数注册到开始
缩放地图事件上,当开始缩放地图时时,执行该方法,结果为缩放地图之前,隐藏鹰眼。
function startZoom(event)
{
mapObj.setOverviewState(HIDE);
}
mapObj.addEventListener(mapObj,ZOOM_START,startZoom);
2.4.76 removeEventListener(object,eventType,functionName)
说明:
MapABC 地图应用程序编程接口-用户手册
北京图盟科技有限公司
注销事件。
参数:
(1)object:
说明:事件发生的对象。
类型:object。
(2)eventType:
说明:事件类型,具体见 addEventListener()方法中列出的所有事件类型。
类型:constant。
(3)functionName:
说明:事件函数的引用。
类型:function。
返回值:
说明:如果返回值为 0,表示操作正确,如果非 0,则表示操作有误,对照附录的错误
代码表可以查看错误代码类型。
类型:number。
事件:
无
注释:
无
示例:
下面的代码片段卸载了一个地图完成事件函数。
mapObj.removeEventListener(mapObj,MAP_READY, mapReady);
2.4.77 removeClosuresListeners()
说明:
注销所有闭包形式注册的事件(匿名函数)。
参数:
无
返回值:
说明:如果返回值为 0,表示操作正确,如果非 0,则表示操作有误,对照附录的错误
代码表可以查看错误代码类型。
类型:number。
事件:
无
注释:
无
示例:
mapObj. removeClosuresListeners ();
MapABC 地图应用程序编程接口-用户手册
北京图盟科技有限公司
地图工具
2.4.78 calculateDistance(IIs)
说明:
计算多点的距离。
参数:
(1)IIs:
说明:表示由多点的经纬度坐标组成的数组。
类型:array。
返回值:
说明:返回一个距离数组,其中数组第一个值为各段距离总和,之后的值为各段分距离。
类型:array。
事件:
无
注释:
无
示例:
var arr = new Array();
arr.push(new MLngLat(116.36890411376953 ,39.913423004886866));
arr.push(new MLngLat(116.38212203979492,39.9011768955094));
arr.push(new MLngLat(116.38727188110351,39.91250133090293));
arr.push(new MLngLat(116.39825820922851 ,39.904600759441024));
alert(mapObj.calculateDistance(arr));
2.4.79 fromLngLatToContainerPixel(lnglat)
说明:
将点的经纬度坐标转换成容器的屏幕坐标。
参数:
(1)lnglat:
说明:点的经纬度坐标。
类型:MLngLat。
返回值:
说明:返回点的屏幕坐标。
类型:MPoint。
事件:
无
注释:
无
示例:
var lng=mapObj.getCenter().lngX;
var lat=mapObj.getCenter().latY;
MapABC 地图应用程序编程接口-用户手册
北京图盟科技有限公司
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()
说明:
打印当前地图。
参数:
MapABC 地图应用程序编程接口-用户手册
北京图盟科技有限公司
无
返回值:
无
事件:
无
注释:
不能打印工具条、鹰眼,同时也不能保存叠加到地图上的 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
说明:
MapABC 地图应用程序编程接口-用户手册
北京图盟科技有限公司
要加载的地图的缩放级别。
类型:
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,黑色工具条,
MapABC 地图应用程序编程接口-用户手册
北京图盟科技有限公司
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,隐藏。
注释:
无
MapABC 地图应用程序编程接口-用户手册
北京图盟科技有限公司
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。
取值:
MapABC 地图应用程序编程接口-用户手册
北京图盟科技有限公司
可以是只包含单个元素的数组,也可以是不连续数组。
注释:
当设置该属性的值为单个元素的数组如[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。
取值:
SHOW,显示(默认),
HIDE,隐藏。
注释:
无
3.4.14 centerCross
说明:
设置是否在地图上显示中心十字。
类型:
Constant。
取值:
SHOW,显示(默认),
HIDE,隐藏。
注释:
无
MapABC 地图应用程序编程接口-用户手册
北京图盟科技有限公司
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 的地图底图必须存在,才能有效。
MapABC 地图应用程序编程接口-用户手册
北京图盟科技有限公司
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。
取值:
SHOW,显示(默认),
MapABC 地图应用程序编程接口-用户手册
北京图盟科技有限公司
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);
MapABC 地图应用程序编程接口-用户手册
北京图盟科技有限公司
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。
取值:
MapABC 地图应用程序编程接口-用户手册
北京图盟科技有限公司
"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。
MapABC 地图应用程序编程接口-用户手册
北京图盟科技有限公司
注释:
无
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。
注释:
MapABC 地图应用程序编程接口-用户手册
北京图盟科技有限公司
如果用户没有设置此项,系统会为菜单项设置系统默认 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。
MapABC 地图应用程序编程接口-用户手册
北京图盟科技有限公司
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
MapABC 地图应用程序编程接口-用户手册
北京图盟科技有限公司
注释:
无
示例:
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
说明:
覆盖物常量,线。
示例:
MapABC 地图应用程序编程接口-用户手册
北京图盟科技有限公司
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,则使用默认的选项。将信息窗口添加到地图中后,可在地图中通
过其标记打开它。标记对象会触发鼠标事件、信息窗口事件和拖拽事件等。
MapABC 地图应用程序编程接口-用户手册
北京图盟科技有限公司
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。
注释:
无。
MapABC 地图应用程序编程接口-用户手册
北京图盟科技有限公司
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);
MapABC 地图应用程序编程接口-用户手册
北京图盟科技有限公司
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);
MapABC 地图应用程序编程接口-用户手册
北京图盟科技有限公司
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 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!";
MapABC 地图应用程序编程接口-用户手册
北京图盟科技有限公司
var label=new MLabel(new MLngLat(116.39825820922851 ,39.904600759441024),
labelOptions);
mapObj.addOverlay(label);
示例 2:
var labelOptions=new MLabelOptions();
labelOptions.fontStyle.name ="Arial";
labelOptions.fontStyle.size = 15;
labelOptions.fontStyle.color = 0xFFFF66;
labelOptions.fontStyle.bold = true;
labelOptions.content= "MapABC!";
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。
MapABC 地图应用程序编程接口-用户手册
北京图盟科技有限公司
注释:
无
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:
说明:经纬度坐标数组。
MapABC 地图应用程序编程接口-用户手册
北京图盟科技有限公司
类型:array。
(2)option:
说明:参数选项,参照 MLineOptions。
类型:MLineOptions。
注释:
无
示例:
本例中 lineOptions 是事先定义好的。lineOptions 的定义请参照 MLineOptions 示例。
var arr = new Array();
arr.push(new MLngLat(116.36890411376953 ,39.913423004886866));
arr.push(new MLngLat(116.38212203979492,39.9011768955094));
arr.push(new MLngLat(116.38727188110351,39.91250133090293));
arr.push(new MLngLat(116.39825820922851 ,39.904600759441024));
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
说明:
线的经纬度坐标数组。
类型:
MapABC 地图应用程序编程接口-用户手册
北京图盟科技有限公司
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
MapABC 地图应用程序编程接口-用户手册
北京图盟科技有限公司
10.4 构造方法
10.4.1 MArea(lnglatArr, option)
说明:
构建覆盖面对象。
参数:
(1)lnglatArr:
说明:经纬度数组。
类型:MLngLats。
(2)option:
说明:参数选项,参照 MAreaOptions。
类型:MAreaOptions。
注释:
无
10.5 属性
10.5.1 TYPE
说明:
覆盖物类型。
类型:
constant。
取值:
MOverlay.TYPE_AREA
注释:
无
11 MRectangle()
11.1 说明
描述矩形面对象,继承自 MArea。
11.2 命名空间
com.mapabc.maps.api.overlays.MRectangle。
MapABC 地图应用程序编程接口-用户手册
北京图盟科技有限公司
11.3 继承
MOverlay->MArea->MRectangle
11.4 构造方法
11.4.1 MRectangle(lnglatArr, option)
说明:
通过由左上、右下角组成的经纬度数组和参数选项构建矩形对象。
参数:
(1)lnglatArr:
说明:左上、右下角组成的经纬度数组。
类型:MLngLats。
(2)option:
说明:参数选项,参见 MAreaOptions。
类型:MAreaOptions。
注释:
无
示例:
var arr = new Array();
arr.push(new MLngLat(116.36890411376953 ,39.913423004886866));
arr.push(new MLngLat(116.38212203979492,39.9011768955094));
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 样式
var tipOption = new MTipOptions();
tipOption.title="title";
tipOption.content="content"; //tip 内容
tipOption.hasShadow= false; //是否有阴影
//面的参数选项
var areopt = new MAreaOptions();
areopt.areaStyle=lineopt;
areopt.tipOption=tipOption;
areopt.canShowTip = true;
MapABC 地图应用程序编程接口-用户手册
北京图盟科技有限公司
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。
注释:
无
MapABC 地图应用程序编程接口-用户手册
北京图盟科技有限公司
示例:
var object=mapObj.getOverlayById(Overlay.id);
var rectInfor=object.id+"||"+object.TYPE;
for (var i=0;i<object.lnglatArr.length ;i++ )
{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。
类型:MAreaOptions。
MapABC 地图应用程序编程接口-用户手册
北京图盟科技有限公司
注释:
无
示例:
var arr = new Array();
arr.push(new MLngLat("JIOMSLKNLMLDPP","LQGWWMIWODLHL"));
arr.push(new MLngLat("JIOMROPWONHLHP","LQGWYKQVLLLL"));
var lineopt = new MAreaStyle();
//多边形的样式
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 样式
var tipOption = new MTipOptions();
tipOption.title="title";
tipOption.anchor = new MPoint(0,0); //图片锚定点,MPoint 类型
tipOption.content="content"; //tip 内容
tipOption.hasShadow= false; //是否有阴影
var areopt = new MAreaOptions();
areopt.areaStyle=lineopt;
areopt.tipOption=tipOption;
areopt.canShowTip = true;
var line = new MCircle(arr,areopt);//构建圆对象
mapObj.addOverlay(line);
12.5 属性
12.5.1 id
说明:
对象编号,也是对象的唯一标识。
类型:
string。
注释:
无
12.5.2 TYPE
说明:
MapABC 地图应用程序编程接口-用户手册
北京图盟科技有限公司
覆盖物类的型。
类型:
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。
注释:
无
MapABC 地图应用程序编程接口-用户手册
北京图盟科技有限公司
示例:
var object=mapObj.getOverlayById(Overlay.id);
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:
说明: 由多边形顶点组成的经纬度数组。
类型:MLngLats。
(2)option:
说明:参数选项,参照 MAreaOptions。
类型:MAreaOptions。
注释:
无
示例:
var arr = new Array();
arr.push(new MLngLat("JIOMSLKNLMLDPP","LQGWWMIWODLHL"));
arr.push(new MLngLat("JIOMROPWONHLHP","LQGWYKQVLLLL"));
MapABC 地图应用程序编程接口-用户手册
北京图盟科技有限公司
arr.push(new MLngLat("JIOMRLOQPRHDLD","LQGXQQOPMHLLH"));
arr.push(new MLngLat("JIOMSTOORNHLHH","LQGWYOIRJHDDH"));
var lineopt = new MAreaStyle();
//多边形的样式
lineopt.borderStyle.alpha = 1; //透明度,默认 1,范围 0~1 lineopt.borderStyle.color =
0xFF3300; //线颜色,默认黑色
lineopt.borderStyle.thickness = 0.8; //线粗细度,默认 3
//填充色
lineopt.fillStyle.color = 0xFF6600;
//tip 样式
var tipOption = new MTipOptions();
tipOption.title="title";
tipOption.anchor = new MPoint(0,0); //图片锚定点,MPoint 类型
tipOption.content="content"; //tip 内容
tipOption.hasShadow= false; //是否有阴影
var areopt = new MAreaOptions();
areopt.areaStyle=lineopt;
areopt.tipOption=tipOption;
areopt.canShowTip = true;
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
注释:
无
MapABC 地图应用程序编程接口-用户手册
北京图盟科技有限公司
13.5.3 lnglatArr
说明:
由多边形顶点组成的经纬度数组。
类型:
MLngLats。
注释:
无
13.5.4 option
说明:
Polygon 的参数选项,参照 MAreaOptions。
类型:
MAreaOptions。
注释:
无
示例:
var object=mapObj.getOverlayById(Overlay.id);
var polygonInfor=object.id+"||"+object.TYPE;
for (var i=0;i<object.lnglatArr.length ;i++ )
{ 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
MapABC 地图应用程序编程接口-用户手册
北京图盟科技有限公司
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 的类型。
MapABC 地图应用程序编程接口-用户手册
北京图盟科技有限公司
类型:
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。
注释:
无
MapABC 地图应用程序编程接口-用户手册
北京图盟科技有限公司
命名空间: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 编译
MapABC 地图应用程序编程接口-用户手册
北京图盟科技有限公司
(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 的默认属性值为准。
MapABC 地图应用程序编程接口-用户手册
北京图盟科技有限公司
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
说明:
拖动结束后是否有弹跳效果。
类型:
MapABC 地图应用程序编程接口-用户手册
北京图盟科技有限公司
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,不可显示
注释:
无
MapABC 地图应用程序编程接口-用户手册
北京图盟科技有限公司
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,不使用代理
MapABC 地图应用程序编程接口-用户手册
北京图盟科技有限公司
注释:
如果 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
MapABC 地图应用程序编程接口-用户手册
北京图盟科技有限公司
取值:
默认为 0
注释:
仅用于点聚合功能,设置 MClusterOptions.attributeValue=MClusterOptions.VALUE_SUM
情况下,聚合中心点显示所有被聚合点的属性值之和。
示例 1
var markerOption = new MMarkerOptions();
var labelOptions=new MLabelOptions();
var fontstyle = new MFontStyle(); //定义字体风格对象
fontstyle.name ="Arial";
fontstyle.size = 15;
fontstyle.color = 0xffffff;
fontstyle.bold = true;
labelOptions.fontStyle=fontstyle;
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;
var tipOption = new MTipOptions();
tipOption.title="title";
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;
var fontstyle2 = new MFontStyle();
fontstyle2.name ="Arial";
fontstyle2.size = 16;
MapABC 地图应用程序编程接口-用户手册
北京图盟科技有限公司
fontstyle2.color = 0xFFFF66;
fontstyle2.bold = false;
tipOption.contentFontStyle= fontstyle2;
var mfillstyle1=new MFillStyle();
mfillstyle1.color= 0xFF5500;
mfillstyle1.alpha = 1;
tipOption.fillStyle = mfillstyle1;
var mfillstyle2=new MFillStyle();
mfillstyle2.color= 0X0FF80;
mfillstyle2.alpha = 1;
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()
说明:
构建一个实景地图雷达标注选项对象。
参数:
无
注释:
无
示例:
MapABC 地图应用程序编程接口-用户手册
北京图盟科技有限公司
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
说明:
实景地图雷达标注视野夹角
MapABC 地图应用程序编程接口-用户手册
北京图盟科技有限公司
类型:
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;
MapABC 地图应用程序编程接口-用户手册
北京图盟科技有限公司
17 MLabelOptions()
17.1 说明
MLabel 类的选项参数。
17.2 命名空间
com.mapabc.maps.api.overlays.options.MLabelOptions。
17.3 构造方法
17.3.1 MLabelOptions()
说明:
创建 label 选项对象。
参数:
无
注释:
无
示例:
var labelOptions=new MLabelOptions();
17.4 属性
17.4.1 fontStyle
说明:
设置 label 的字体样式。
类型:
详见 MFontStyle。
注释:
无
17.4.2 alpha
说明:
设置 label 背景及边框的透明度,默认为 1,即不透明。
MapABC 地图应用程序编程接口-用户手册
北京图盟科技有限公司
类型:
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。
注释:
无
MapABC 地图应用程序编程接口-用户手册
北京图盟科技有限公司
17.4.6 borderColor
说明:
设置 label 的边框颜色。
类型:
16 进制整数
取值:
范围为 0x000000-0xffffff
注释:
无
17.4.7 content
说明:
label 的显示内容。
类型:
string。
注释:
无
17.4.8 zoomLevels
说明:
设置在地图的哪些缩放级别范围内显示 MLabel。
类型:
array。
取值:
缩放级别数组元素可以是不连续的。
默认为空数组,此时在地图的所有缩放级别内均显示 MLabel。
注释:
无
示例 1:
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!";
labelOptions.hasBorder = true;
labelOptions.hasBackground=true;
MapABC 地图应用程序编程接口-用户手册
北京图盟科技有限公司
labelOptions.backgroundColor =0x0078ff;
labelOptions.borderColor =0x00ff00;
labelOptions.zoomLevels= [7,8,9,10];//当地图的缩放级别为 7,8,9,10 时显示 label。
示例 2:
var labelOptions=new MLabelOptions();
labelOptions.fontStyle.name ="Arial";
labelOptions.fontStyle.size = 15;
labelOptions.fontStyle.color = 0xFFFF66;
labelOptions.fontStyle.bold = true;
labelOptions.content= "MapABC!";
labelOptions.hasBorder = true;
labelOptions.hasBackground=true;
labelOptions.backgroundColor =0x0078ff;
labelOptions.borderColor =0x00ff00;
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();
MapABC 地图应用程序编程接口-用户手册
北京图盟科技有限公司
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
MapABC 地图应用程序编程接口-用户手册
北京图盟科技有限公司
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。
注释:
适用于 FLASH_BUBBLE_TIP、HTML_BUBBLE_TIP、IMG_BUBBLE_TIP
HTML_BUBBLE_TIP 中是否粗体属性无效。
MapABC 地图应用程序编程接口-用户手册
北京图盟科技有限公司
18.4.8 contentFontStyle
说明:
内容文字风格。
类型:
MFontStyle。
注释:
适用于 FLASH_BUBBLE_TIP、HTML_BUBBLE_TIP、IMG_BUBBLE_TIP
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
MapABC 地图应用程序编程接口-用户手册
北京图盟科技有限公司
18.4.12 tipWidth
说明:
HTML 气泡信息窗口宽度。
类型:
number。
取值:
默认为 300
最大不得超过地图容器宽度
注释:
适用于 HTML_BUBBLE_TIP、IMG_BUBBLE_TIP
18.4.13 tipAlign
说明:
HTML 用户自定义信息窗口的锚点位置。
类型:
constant。
取值:
TOP_LEFT:左上方。
TOP_CENTER:正上方。
TOP_RIGHT:右上方。
MIDDLE_LEFT:正左边。
MIDDLE_CENTER:正中心。
MIDDLE_RIGHT:正右方。
BOTTOM_LEFT:左下方。
BOTTOM_CENTER:正下方(默认)
BOTTOM_RIGHT:右下方。
注释:
此信息窗口只支持 MMarker 和地图两种对象。
适用于 HTML_CUSTOM_TIP
18.4.14 offset
说明:
HTML 用户自定义信息窗口的相对于锚点位置的偏移量。
类型:
MPoint。
取值:
默认为(0,0)
注释:
仅适用于 HTML_CUSTOM_TIP
MapABC 地图应用程序编程接口-用户手册
北京图盟科技有限公司
示例 1(FLASH 信息窗口)
var tipOption = new MTipOptions();
tipOption.title="title";
tipOption.content="welcome to MapABC!";
tipOption.hasShadow=true;
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 气泡信息窗口)
var tipOption = new MTipOptions();
tipOption.title="title";
tipOption.content="welcome to MapABC!";
tipOption.hasShadow=true;
tipOption. roundRectSize=3;
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;
var fontstyle2 = new MFontStyle();
fontstyle2.name ="Arial";
fontstyle2.size = 16;
fontstyle2.color = 0xFFFF66;
fontstyle2.bold = false;
MapABC 地图应用程序编程接口-用户手册
北京图盟科技有限公司
tipOption.contentFontStyle= fontstyle2;
var mfillstyle1=new MFillStyle();
mfillstyle1.color= 0xFF5500;
mfillstyle1.alpha = 1;
tipOption.fillStyle = mfillstyle1;
var mfillstyle2=new MFillStyle();
mfillstyle2.color= 0X0FF80;
mfillstyle2.alpha = 1;
tipOption.titleFillStyle= mfillstyle2;
tipOption.tipType=HTML_BUBBLE_TIP;
示例 3(HTML 自定义信息窗口)
var tipOption = new MTipOptions();
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()
说明:
构建带纠错功能的特定提示窗口参数选项。
参数:
无
注释:
无
示例:
MapABC 地图应用程序编程接口-用户手册
北京图盟科技有限公司
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。
注释:
无
MapABC 地图应用程序编程接口-用户手册
北京图盟科技有限公司
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 的线选项对象
MapABC 地图应用程序编程接口-用户手册
北京图盟科技有限公司
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,可编辑
false,不可编辑(默认)
注释:
MapABC 地图应用程序编程接口-用户手册
北京图盟科技有限公司
无
20.4.5 zoomLevels
说明:
设置在地图的哪些缩放级别范围内显示 MPolyline。
类型:
array。
取值:
缩放级别数组元素可以是不连续的。
默认为空数组,此时在地图的所有缩放级别内均显示 MPolyline。
注释:
无
20.4.6 isDimorphic
说明:
此为可选项,设置是否具有二态,默认为 false,即没有二态。
类型:
boolean。
取值:
true,有二态
false,无二态(默认)
注释:
无
20.4.7 dimorphicColor
说明:
设置第二种状态的颜色。
类型:
string。
取值:
默认为 0xFF0000,即红色
示例 1:
var lineopt = new MLineOptions(); //构建一个名为 lineopt 的线选项对象
lineopt.lineStyle.thickness = 3;
lineopt.lineStyle.color = 0xFFF988;
lineopt.lineStyle.alpha = 1;
lineopt.lineStyle.lineType= LINE_DASHED;
var tipOption = new MTipOptions();
tipOption.title="title";
MapABC 地图应用程序编程接口-用户手册
北京图盟科技有限公司
tipOption.content="welcome to MapABC!";
tipOption.hasShadow=true;
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;
lineopt.tipOption = tipOption;
lineopt.canShowTip = true;
lineopt.isEditable =true;
lineopt.zoomLevels=[3,4,5,6,7,8] ;
lineopt. isDimorphic=true;
lineopt. dimorphicColor=oxffff00;
示例 2:
var lineopt = new MLineOptions(); //构建一个名为 lineopt 的线选项对象
var linestyle5 = new MLineStyle();
linestyle5.thickness = 3;
linestyle5.color = 0xFFF988;
linestyle5.alpha = 1;
linestyle5.lineType= LINE_DASHED;
lineopt.lineStyle = linestyle5;
var tipOption = new MTipOptions();
tipOption.title="title";
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;
MapABC 地图应用程序编程接口-用户手册
北京图盟科技有限公司
fontstyle1.color = 0xFF3300;
fontstyle1.bold = true;
tipOption.titleFontStyle= fontstyle1;
var fontstyle2 = new MFontStyle();
fontstyle2.name ="Arial";
fontstyle2.size = 16;
fontstyle2.color = 0xFFFF66;
fontstyle2.bold = false;
tipOption.contentFontStyle= fontstyle2;
var mfillstyle1=new MFillStyle();
mfillstyle1.color= 0xFF5500;
mfillstyle1.alpha = 1;
tipOption.fillStyle = mfillstyle1;
var mfillstyle2=new MFillStyle();
mfillstyle2.color= 0X0FF80;
mfillstyle2.alpha = 1;
tipOption.titleFillStyle= mfillstyle2;
lineopt.tipOption = tipOption;
lineopt.canShowTip = true;
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()
说明:
创建一个面选项对象,通过对该对象的属性赋值可以生成所需要的面状覆盖物风格。
MapABC 地图应用程序编程接口-用户手册
北京图盟科技有限公司
参数:
无
注释:
无
示例:
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,不可显示
注释:
无
MapABC 地图应用程序编程接口-用户手册
北京图盟科技有限公司
21.4.4 isEditable
说明:
是否为可编辑状态。
类型:
boolean。
取值:
true,可编辑
false,不可编辑(默认)
注释:
具体编辑功能包括:
(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;
var tipOption = new MTipOptions();
tipOption.title="title";
tipOption.content="welcome to MapABC!";
tipOption.hasShadow=true;
MapABC 地图应用程序编程接口-用户手册
北京图盟科技有限公司
var linestyle = new MLineStyle();
linestyle.thickness = 2;
linestyle.color = 0xFFFF66;
linestyle.alpha = 1;
linestyle.lineType=LINE_DASHED;
tipOption.borderStyle = linestyle;
var fontstyle1 = new MFontStyle();
fontstyle1.name ="Arial";
fontstyle1.size = 13;
fontstyle1.color = 0xFF3300;
fontstyle1.bold = true;
tipOption.titleFontStyle= fontstyle1;
var fontstyle2 = new MFontStyle();
fontstyle2.name ="Arial";
fontstyle2.size = 16;
fontstyle2.color = 0xFFFF66;
fontstyle2.bold = false;
tipOption.contentFontStyle= fontstyle2;
var mfillstyle1=new MFillStyle();
mfillstyle1.color= 0xFF5500;
mfillstyle1.alpha = 1;
tipOption.fillStyle = mfillstyle1;
var mfillstyle2=new MFillStyle();
mfillstyle2.color= 0X0FF80;
mfillstyle2.alpha = 1;
tipOption.titleFillStyle= mfillstyle2;
areopt.tipOption=tipOption;
areopt.canShowTip = true;
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;
var tipOption = new MTipOptions();
tipOption.title="title";
tipOption.content="welcome to MapABC!";
tipOption.hasShadow=true;
tipOption.borderStyle.thickness=2;
tipOption.borderStyle. color= 0xFFFF66;
tipOption.borderStyle. alpha=1;
MapABC 地图应用程序编程接口-用户手册
北京图盟科技有限公司
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;
areopt.tipOption=tipOption;
areopt.canShowTip = true;
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。
MapABC 地图应用程序编程接口-用户手册
北京图盟科技有限公司
取值:
true,有二态
false,无二态(默认)
注释:
无
21.4.9 dimorphicColor
说明:
设置第二种状态的颜色。
类型:
string。
取值:
默认为 0xFF0000,即红色。
注释:
无
示例:
以下函数给出了在地图上添加带有标注文字的多边形对象的方法。
function addPolygon(){//在地图上画多边形
var arr = new Array();
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 的面选项对象
var labelOptions=new MLabelOptions();
var fontstyle = new MFontStyle(); //定义字体风格对象
fontstyle.name ="Arial";
fontstyle.size = 15;
fontstyle.color = 0xffffff;
fontstyle.bold = true;
labelOptions.fontStyle=fontstyle;
labelOptions.borderColor =0x00ff00;
labelOptions.content="circleLabel";
labelOptions.hasBorder =true;
labelOptions.hasBackground =true;
labelOptions.backgroundColor =0x0078ff;
areopt.labelOption=labelOptions;
var tipOption = new MTipOptions();
tipOption.title="多边形";
tipOption.content="这是一个多边形!";
tipOption.hasShadow=true;
MapABC 地图应用程序编程接口-用户手册
北京图盟科技有限公司
areopt.tipOption=tipOption;
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。
MapABC 地图应用程序编程接口-用户手册
北京图盟科技有限公司
类型:
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。
注释:
地图的缩放级别大于此级别过多时,由于图片被过度拉伸会导致图片不显示
MapABC 地图应用程序编程接口-用户手册
北京图盟科技有限公司
22.4.4 zoomLevels
说明:
设置在地图的哪些缩放级别范围内显示 MGroundImage。
类型:
array。
取值:
缩放级别数组元素可以是不连续的。
默认为空数组,此时在地图的所有缩放级别内均显示 MGroundImage
注释:
无
22.4.5 imageAlign
说明:
设置图片相对于标注经纬度坐标点的位置。九宫格位置。
类型:
constant。
取值:
TOP_LEFT :左上方(默认)
TOP_CENTER:正上方。
TOP_RIGHT:右上方。
MIDDLE_LEFT:正左边。
MIDDLE_CENTER:正中心。
MIDDLE_RIGHT:正右方。
BOTTOM_LEFT:左下方。
BOTTOM_CENTER:正下方。
BOTTOM_RIGHT:右下方。
注释:
无
示例:
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;
MapABC 地图应用程序编程接口-用户手册
北京图盟科技有限公司
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
注释:
无
MapABC 地图应用程序编程接口-用户手册
北京图盟科技有限公司
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
说明:
MapABC 地图应用程序编程接口-用户手册
北京图盟科技有限公司
设置绽放聚合中心点图标的 URL,用于自定义绽放聚合中心点图标
类型:
string。
取值:
无
注释:
仅用于有绽放效果的点聚合
23.4.6 aroundMarkerURL
说明:
设置绽放聚合绽放点图标的 URL,用于自定义绽放聚合绽放点的图标
类型:
string。
取值:
无
注释:
仅用于有绽放效果的点聚合
23.4.7 flareDistance
说明:
绽放点离中心点的距离,以像素为单位
类型:
int。
取值:
默认 30 像素。当设置小于 30,按 30 像素显示
注释:
仅用于有绽放效果的点聚合
23.4.8 isUseMarkerIcon
说明:
绽放点聚合中,绽放点是否使用原始图标
类型:
boolean。
取值:
默认 false
注释:
仅用于有绽放效果的点聚合
示例:
MapABC 地图应用程序编程接口-用户手册
北京图盟科技有限公司
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
说明:
MapABC 地图应用程序编程接口-用户手册
北京图盟科技有限公司
聚合中心点显示属性类型常量,显示所有聚合点个数。
示例:
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:
说明:地图叠加层的类别
类型:constant。
取值:(a)TL_TRAFFIC,实时交通图层
(b)TL_USERMAP,用户编辑器图层,对应有效的 MTileLayerOptions 属性
有:userId、tempId、layerId
(c)TL_MASS_TRANSIT,轨道交通层
MapABC 地图应用程序编程接口-用户手册
北京图盟科技有限公司
(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);
MapABC 地图应用程序编程接口-用户手册
北京图盟科技有限公司
命名空间: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。
注释:
只用于用户自己定义切片图层。
MapABC 地图应用程序编程接口-用户手册
北京图盟科技有限公司
26.4.2 userId
说明:
用户的 Id。
类型:
string。
注释:
仅用于编辑器图层。
26.4.3 tempId
说明:
模板 ID
类型:
string。
注释:
仅用于编辑器图层。
26.4.4 layerId
说明:
地图叠加层 ID。用于该叠加层唯一标识。
类型:
string。
注释:
用户不输入则系统自动生成。
实时交通图层,轨道交通图层不需要用户指定。
示例
var tileLayerOptions =new MTileLayerOptions();;
tileLayerOptions.userId="20001";
tileLayerOptions.layerId="myMapLayer";
26.4.5 alpha
说明:
地图层透明度。
类型:
number。
取值:
范围 0~1
默认为 1,不透明。
示例
MapABC 地图应用程序编程接口-用户手册
北京图盟科技有限公司
var tileLayerOptions =new MTileLayerOptions();;
tileLayerOptions.userId="20001";
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。
注释:
用户不输入则系统自动生成。
MapABC 地图应用程序编程接口-用户手册
北京图盟科技有限公司
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();
MapABC 地图应用程序编程接口-用户手册
北京图盟科技有限公司
28.4 属性
28.4.1 pointsXMLString
说明:
点数据源 XML 字符串。
类型:
string。
注释:
内容为 xml 格式,请按以下格式书写:
“<root>
<point><x>116.1</x><y>39.1</y><value>1</value></point>
<point><x>116.2</x><y>39.2</y><value>2</value></point>
</root>”
28.4.2 pointsXMLURL
说明:
点数据源 url 地址。
类型:
string。
注释:
上传的文件必须为 xml 格式,请按以下格式书写:
<root>
<point><x>116.1</x><y>39.1</y><value>1</value></point>
<point><x>116.2</x><y>39.2</y><value>2</value></point>
</root>
28.4.3 radiusRatio
说明:
渐变图半径比率。所有点的渐变半径都会乘以半径比率。
类型:
number。
注释:
无
28.4.4 maxRadius
说明:
每个点的渐变图显示的最大半径,单位:像素。
类型:
MapABC 地图应用程序编程接口-用户手册
北京图盟科技有限公司
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。
MapABC 地图应用程序编程接口-用户手册
北京图盟科技有限公司
取值:
0 至 1,默认为 1,越小越透明
注释:
无
示例:
var options =new MGradientMapOptions();
options.pointsXMLString='<root>' +
'<point><x>116.1</x><y>39.1</y><value>170</value></point>' +
'<point><x>116.7</x><y>39.7</y><value>250</value></point>' +
'<point><x>116.8</x><y>39.8</y><value>280</value></point>' +
'<point><x>116.9</x><y>39.9</y><value>300</value></point>' +
'<point><x>116.1</x><y>40.9</y><value>340</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]; //设置颜色
29 MWMSLayerOptions()
29.1 说明
设置 WMS 层的参数选项。
29.2 命名空间
com.mapabc.maps.api.layers.options.MWMSLayerOptions。
29.3 构造方法
29.3.1 MWMSLayerOptions()
说明:
WMS 层的参数选项。
参数:
无
注释:
MapABC 地图应用程序编程接口-用户手册
北京图盟科技有限公司
无
示例:
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()
说明:
创建填充样式对象。
参数:
无
MapABC 地图应用程序编程接口-用户手册
北京图盟科技有限公司
注释:
无
示例:
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(黑色)
注释:
无
MapABC 地图应用程序编程接口-用户手册
北京图盟科技有限公司
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();
MapABC 地图应用程序编程接口-用户手册
北京图盟科技有限公司
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
说明:
线的表示样式。
类型:
MapABC 地图应用程序编程接口-用户手册
北京图盟科技有限公司
constant。
取值:
LINE_SOLID ,实线(默认)
LINE_DASHED,虚线
注释:
无
示例:
var linest = new MLineStyle();
linest.alpha = 1;
linest.color = 0xFF3300 ;
linest.thickness = 3;
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();
MapABC 地图应用程序编程接口-用户手册
北京图盟科技有限公司
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()
说明:
创建填充样式对象。
参数:
MapABC 地图应用程序编程接口-用户手册
北京图盟科技有限公司
无
注释:
无
示例:
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 说明
构造一个经纬度坐标对象,用于标注地图上一个点。
MapABC 地图应用程序编程接口-用户手册
北京图盟科技有限公司
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:
说明:纬度。
类型:string/number。
(3)TYPE:
说明:坐标类型,可选项。
类型:constant。
取值: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。
注释:
无
MapABC 地图应用程序编程接口-用户手册
北京图盟科技有限公司
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 说明
构造经纬度坐标集合对象。
MapABC 地图应用程序编程接口-用户手册
北京图盟科技有限公司
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 arr = new Array();
arr.push(new MLngLat("JIOMSLKNLMLDPP","LQGWWMIWODLHL"));
arr.push(new MLngLat("JIOMROPWONHLHP","LQGWYKQVLLLL"));
var lnglats=new MLngLats(arr);
alert(lnglats.lnglatArr [0].lngX+";"+lnglats.lnglatArr [0].latY);
MapABC 地图应用程序编程接口-用户手册
北京图盟科技有限公司
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。
注释:
无
MapABC 地图应用程序编程接口-用户手册
北京图盟科技有限公司
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 属性一样可访问,但最好不要修改它们,而是在
MapABC 地图应用程序编程接口-用户手册
北京图盟科技有限公司
创建新对象时使用不同的参数。
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。
MapABC 地图应用程序编程接口-用户手册
北京图盟科技有限公司
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=
MapABC 地图应用程序编程接口-用户手册
北京图盟科技有限公司
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 值。
MapABC 地图应用程序编程接口-用户手册
北京图盟科技有限公司
类型:
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 说明
封装了所有事件。
MapABC 地图应用程序编程接口-用户手册
北京图盟科技有限公司
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
说明:
经度坐标。
类型:
MapABC 地图应用程序编程接口-用户手册
北京图盟科技有限公司
String
注释:
无
40.3.5 eventY
说明:
纬度坐标。
类型:
String
注释:
无
40.3.6 zoom
说明:
Zoom 级别。
类型:
String
注释:
无
40.3.7 measureResult
说明:
测量的距离。
类型:
String
注释:
无
40.3.8 menuItemId
说明:
右键菜单项的 Id。
类型:
String
注释:
无
MapABC 地图应用程序编程接口-用户手册
北京图盟科技有限公司
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 值。
类型:
MapABC 地图应用程序编程接口-用户手册
北京图盟科技有限公司
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);
返回值:
一个 MEvent 对象,它具有下列属性:
mapId:
说明:地图对象的名称。
类型:string。
eventType:
说明:事件类型名称。
类型:string。
overlayId:
MapABC 地图应用程序编程接口-用户手册
北京图盟科技有限公司
说明: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);
返回值:
一个 MEvent 对象,它具有下列属性:
mapId:
说明:地图对象的名称。
类型:string。
eventType:
说明:事件类型名称。
类型:string。
overlayId:
说明:overlay 对象的 id,否则返回空。
类型:string。
示例:
mapObj.addEventListener(mapObj,TIP_CLOSE, closeTip);
function closeTip(param){
alert(param.mapId+";"+param.eventType+";"+param.overlayId);}
40.4.4 TIP_BEFORE_CLOSE 事件
说明:
关闭 tip 之前触发该事件。
语法:
MMap.addEventListener(mapObj,TIP_BEFORE_CLOSE,beforeCloseTip);
返回值:
一个 MEvent 对象,它具有下列属性:
mapId:
说明:地图对象的名称。
类型:string。
eventType:
说明:事件类型名称。
类型:string。
MapABC 地图应用程序编程接口-用户手册
北京图盟科技有限公司
overlayId:
说明:overlay 对象的 id,否则返回空。
类型:string。
示例:
mapObj.addEventListener(mapObj,TIP_BEFORE_CLOSE, beforeCloseTip);
function beforeCloseTip(param){
alert(param.mapId+";"+param.eventType+";"+param.overlayId);}
40.4.5 ADD_OVERLAY 事件
说明:
向地图上添加覆盖层时触发该事件。
语法:
MMap.addEventListener(mapObj,ADD_OVERLAY,addOverlay);
返回值:
一个 MEvent 对象,它具有下列属性:
mapId:
说明:地图对象的名称。
类型:string。
eventType:
说明:事件类型名称。
类型:string。
overlayId:
说明:添加到地图上 overlay 对象的 id。
类型:string。
示例:
mapObj.addEventListener(mapObj, ADD_OVERLAY, addOverlay);
function addOverlay(param){
alert(param.mapId+";"+param.eventType+";"+param.overlayId);}
40.4.6 REMOVE_OVERLAY 事件
说明:
删除地图上覆盖物时触发该事件。
语法:
MMap.addEventListener(mapObj,REMOVE_OVERLAY,removeOverlay);
返回值:
一个 MEvent 对象,它具有下列属性:
mapId:
说明:地图对象的名称。
类型:string。
eventType:
说明:事件类型名称。
MapABC 地图应用程序编程接口-用户手册
北京图盟科技有限公司
类型: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);
返回值:
一个 MEvent 对象,它具有下列属性:
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);
返回值:
一个 MEvent 对象,它具有下列属性:
mapId:
说明:地图对象的名称。
类型:string。
eventType:
说明:事件类型名称。
类型:string。
tileLayerId:
MapABC 地图应用程序编程接口-用户手册
北京图盟科技有限公司
说明: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);
返回值:
一个 MEvent 对象,它具有下列属性:
mapId:
说明:地图对象的名称。
类型:string。
eventType:
说明:事件类型名称。
类型:string。
tileLayerId:
说明:tileLayer 对象的 id。
类型:string。
bounds:
说明:切片对象的经纬度范围。
类型:MLngLatBounds。
示例:
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);
返回值:
一个 MEvent 对象,它具有下列属性:
MapABC 地图应用程序编程接口-用户手册
北京图盟科技有限公司
mapId:
说明:地图对象的名称。
类型:string。
eventType:
说明:事件类型名称。
类型:string。
overlayId:
说明:所单击覆盖物的 Id。
类型:string。
备注:当单击覆盖物对象时还有此返回值。
eventX:
说明:单击点的经度坐标。
类型:string/number。
eventY:
说明:单击点纬度坐标。
类型:string/number。
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);
返回值:
一个 MEvent 对象,它具有下列属性:
mapId:
说明:地图对象的名称。
类型:string。
eventType:
说明:事件类型名称。
类型:string。
eventX:
说明:双击点的经度坐标。
类型:string/number。
eventY:
说明:双击点的纬度坐标。
MapABC 地图应用程序编程接口-用户手册
北京图盟科技有限公司
类型:string/number。
示例:
mapObj.addEventListener(mapObj,MOUSE_DBCLICK,dbclickMouse);
function dbclickMouse(param){
alert(param.mapId+";"+param.eventType+";"+param.eventX+";"+param.eventY);}
40.4.12 MOUSE_DOWN 事件
说明:
鼠标键落下时触发该事件。
语法:
MMap.addEventListener(mapObj/overlay,MOUSE_DOWN,mouseDown);
返回值:
一个 MEvent 对象,它具有下列属性:
mapId:
说明:地图对象的名称。
类型:string。
eventType:
说明:事件类型名称。
类型:string。
eventX:
说明:经度坐标。
类型:string/number。
eventY:
说明:纬度坐标。
类型:string/number。
overlayId:
说明:overlay 对象的 id。。
类型:string。
备注:当在覆盖物上落下鼠标键时有此返回值。
示例:
mapObj.addEventListener(mapObj,MOUSE_DOWN,mouseDown);
function mouseDown(param){
alert(param.mapId+";"+param.eventType+";"+param.eventX+";"+param.eventY);}
40.4.13 MOUSE_MOVING 事件
说明:
在地图上移动鼠标时触发该事件。
语法:
MMap.addEventListener(mapObj,MOUSE_MOVING,mouseMoving)
返回值:
MapABC 地图应用程序编程接口-用户手册
北京图盟科技有限公司
一个 MEvent 对象,它具有下列属性:
mapId:
说明:地图对象的名称。
类型:string。
eventType:
说明:事件类型名称。
类型:string。
eventX:
说明:经度坐标。
类型:string/number。
eventY:
说明:纬度坐标。
类型:string/number。
示例:
mapObj.addEventListener(mapObj, MOUSE_MOVING,mouseMoving);
function mouseMoving(param){
alert(param.mapId+";"+param.eventType+";"+param.eventX+";"+param.eventY);}
40.4.14 MOUSE_UP 事件
说明:
在地图或者覆盖物上抬起鼠标键时触发该事件。
语法:
MMap.addEventListener(mapObj/overlay,MOUSE_UP,mouseUp);
返回值:
一个 MEvent 对象,它具有下列属性:
mapId:
说明:地图对象的名称。
类型:string。
eventType:
说明:事件类型名称。
类型:string。
eventX:
说明:经度坐标。
类型:string/number。
eventY:
说明:纬度坐标。
类型:string/number。
overlayId:
说明:overlay 对象的 id。
类型:string。
备注:当在覆盖物上抬起鼠标键时有此返回值。
示例:
mapObj.addEventListener(mapObj,MOUSE_UP,mouseUp);
MapABC 地图应用程序编程接口-用户手册
北京图盟科技有限公司
function mouseUp(param){
alert(param.mapId+";"+param.eventType+";"+param.eventX+";"+param.eventY);}
40.4.15 MOUSE_OVER 事件
说明:
鼠标移到地图或覆盖物上时触发该事件。
语法:
MMap.addEventListener(mapObj/overlay,MOUSE_OVER,mouseOver);
返回值:
一个 MEvent 对象,它具有下列属性:
mapId:
说明:地图对象的名称。
类型:string。
eventType:
说明:事件类型名称。
类型:string。
overlayId:
说明:覆盖物的 Id。
类型:string。
备注:当鼠标移动到覆盖物上时有此返回值。
eventX:
说明:经度坐标。
类型:string/number。
备注:当鼠标移动到覆盖物上时有此返回值。
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 事件
说明:
MapABC 地图应用程序编程接口-用户手册
北京图盟科技有限公司
鼠标移出地图或覆盖物上时触发该事件。
语法:
MMap.addEventListener(mapObj/overlay,MOUSE_OUT,mouseOut);
返回值:
一个 MEvent 对象,它具有下列属性:
mapId:
说明:地图对象的名称。
类型:string。
eventType:
说明:事件类型名称。
类型:string。
overlayId:
说明:覆盖物的 Id。
类型:string。
备注:当鼠标移出覆盖物时有此返回值。
eventX:
说明:经度坐标。
类型:string/ number。
备注:当鼠标移出覆盖物时有此返回值。
eventY:
说明:纬度坐标。
类型:string/ number。
备注:当鼠标出到覆盖物时有此返回值。
示例 1:
mapObj.addEventListener(mapObj,MOUSE_OUT,mouseOut);
function mouseOut(param){
alert(param.mapId+";"+param.eventType);}
示例 2:
mapObj.addEventListener(mMarker,MOUSE_OUT,mouseOut);
function mouseOut(param) {
alert(param.mapId+";"+param.eventType+";"+param.overlayId+";"+param.eventX+";"+para
m.eventY);}
40.4.17 DRAG_START 事件
说明:
开始拖拽地图或者覆盖物对象时触发该事件。
语法:
MMap.addEventListener(mapObj /overlay,DRAG_START,startDrag);
返回值:
一个 MEvent 对象,它具有下列属性:
mapId:
说明:地图对象的名称。
类型:string。
MapABC 地图应用程序编程接口-用户手册
北京图盟科技有限公司
eventType:
说明:事件类型名称。
类型:string。
eventX:
说明: 经度坐标。
类型:string/ number。
eventY:
说明:纬度坐标。
类型:string/number。
overlayId:
说明:overlay 对象的 id。
类型:string。
备注:当拖拽覆盖物时有此返回值。
示例:
mapObj.addEventListener(mapObj,DRAG_START,startDrag);
function startDrag(param){
alert(param.mapId+";"+param.eventType+";"+param.eventX+";"+param.eventY);}
40.4.18 DRAGGING 事件
说明:
拖拽地图或者覆盖物对象过程中触发该事件。
语法:
MMap.addEventListener(mapObj/overlay,DRAGGING,dragging);
返回值:
一个 MEvent 对象,它具有下列属性:
mapId:
说明:地图对象的名称。
类型:string。
eventType:
说明:事件类型名称。
类型:string。
overlayId:
说明:overlay 对象的 id。
类型:string。
备注:拖拽覆盖物时有此返回值。
示例:
mapObj.addEventListener(mapObj,DRAGGING,dragging);
function dragging(param){
alert(param.mapId+";"+param.eventType);}
MapABC 地图应用程序编程接口-用户手册
北京图盟科技有限公司
40.4.19 DRAG_END 事件
说明:
拖拽地图或者覆盖物结束时触发该事件。
语法:
MMap.addEventListener(mapObj/MOverlay,DRAG_END,endDrag);
返回值:
一个 MEvent 对象,它具有下列属性:
mapId:
说明:地图对象的名称。
类型:string。
eventType:
说明:事件类型名称。
类型:string。
eventX:
说明:经度坐标。
类型:string/number。
eventY:
说明:纬度坐标。
类型:string/number。
overlayId:
说明:overlay 对象的 id。
类型:string。
备注:拖拽覆盖物时有此返回值。
示例:
mapObj.addEventListener(mapObj,DRAG_END,endDrag);
function endDrag(param){
alert(param.mapId+";"+param.eventType+";"+param.eventX+";"+param.eventY);}
40.4.20 MAP_MOVE_START 事件
说明:
地图开始移动时触发该事件。
语法:
MMap.addEventListener(mapObj,MAP_MOVE_START,startMoveMap);
返回值:
一个 MEvent 对象,它具有下列属性:
mapId:
说明:地图对象的名称。
类型:string。
eventType:
说明:事件类型名称。
类型:string。
MapABC 地图应用程序编程接口-用户手册
北京图盟科技有限公司
eventX:
说明:当前地图中心点的经度坐标。
类型:string/number。
eventY:
说明:当前地图中心点的纬度坐标。
类型:string/number。
示例:
mapObj.addEventListener(mapObj,MAP_ MOVE _ START,startMoveMap);
function startMoveMap(param){
alert(param.mapId+";"+param.eventType+";"+param.eventX+";"+param.eventY);}
40.4.21 MAP_MOVING 事件
说明:
地图移动过程中触发该事件。
语法:
MMap.addEventListener(mapObj, MAP_MOVING, mapMoving)
返回值:
一个 MEvent 对象,它具有下列属性:
mapId:
说明:地图对象的名称。
类型:string。
eventType:
说明:事件类型名称。
类型:string。
eventX:
说明:当前地图中心点的经度坐标。
类型:string/number。
eventY:
说明: 当前地图中心点的纬度坐标。
类型:string/number。
示例:
mapObj.addEventListener(mapObj, MAP_MOVING, mapMoving);
function mapMoving(param){
alert(param.mapId+";"+param.eventType+";"+param.eventX+";"+param.eventY);}
40.4.22 MAP_MOVE_END 事件
说明:
地图移动结束时触发该事件。
语法:
MMap.addEventListener(mapObj,MAP_MOVE_END,endMove);
返回值:
MapABC 地图应用程序编程接口-用户手册
北京图盟科技有限公司
一个 MEvent 对象,它具有下列属性:
mapId:
说明:地图对象的名称。
类型:string。
eventType:
说明:事件类型名称。
类型:string。
eventX:
说明:当前地图中心点的经度坐标。
类型:string/number。
eventY:
说明:当前地图中心点的纬度坐标。
类型:string/number。
示例:
mapObj.addEventListener(mapObj,MAP_MOVE_END,endMove);
function endMove(param){
alert(param.mapId+";"+param.eventType+";"+param.eventX+";"+param.eventY);}
40.4.23 ZOOM_START 事件
说明:
开始缩放地图时触发该事件。
语法:
MMap.addEventListener(mapObj,ZOOM_START,startZoom);
返回值:
一个 MEvent 对象,它具有下列属性:
mapId:
说明:地图对象的名称。
类型:string。
eventType:
说明:事件类型名称。
类型:string。
eventX:
说明:经度坐标。
类型:string/number。
eventY:
说明:纬度坐标。
类型:string/number。
zoom:
说明:地图缩放前的 zoom 级别。
类型:int。
示例:
mapObj.addEventListener(mapObj,ZOOM_START,startZoom);
function startZoom(param){
MapABC 地图应用程序编程接口-用户手册
北京图盟科技有限公司
alert(param.mapId+";"+param.eventType+";"+param.eventX+";"+param.eventY+";"+param.
zoom);}
40.4.24 ZOOM_END 事件
说明:
缩放地图结束时触发该事件。
语法:
MMap.addEventListener(mapObj,ZOOM_END,endZoom);
返回值:
一个 MEvent 对象,它具有下列属性:
mapId:
说明:地图对象的名称。
类型:string。
eventType:
说明:事件类型名称。
类型:string。
eventX:
说明:经度坐标。
类型:string/number。
eventY:
说明:经度坐标。
类型:string/number。
zoom:
说明:地图缩放后的 zoom 级别。
类型:int。
示例:
mapObj.addEventListener(mapObj,ZOOM_END,endZoom);
function endZoom(param){
alert(param.mapId+";"+param.eventType+";"+param.eventX+";"+param.eventY+";"+param.
zoom);}
40.4.25 ZOOM_CHANGED 事件
说明:
改变地图缩放级别时触发该事件。
语法:
MMap.addEventListener(mapObj,ZOOM_CHANGED,changeZoom);
返回值:
一个 MEvent 对象,它具有下列属性:
mapId:
说明:地图对象的名称。
类型:string。
MapABC 地图应用程序编程接口-用户手册
北京图盟科技有限公司
eventType:
说明:事件类型名称。
类型:string。
eventX:
说明:经度坐标。
类型:string/number。
eventY:
说明:纬度坐标。
类型:string/number。
zoom:
说明:地图缩放前的级别。
类型:int。
示例:
mapObj.addEventListener(mapObj,ZOOM_CHANGED,changeZoom);
function changeZoom(param){
alert(param.mapId+";"+param.eventType+";"+param.eventX+";"+param.eventY+";"+param.
zoom);}
40.4.26 ROLL_BACK 事件
说明:
地图状态回滚时触发该事件。
语法:
MMap.addEventListener(mapObj,ROLL_BACK,rollBack);
返回值:
一个 MEvent 对象,它具有下列属性:
mapId:
说明:地图对象的名称。
类型:string。
eventType:
说明:事件类型名称。
类型:string。
eventX:
说明:所保存地图状态中心点的经度坐标。
类型:string/number。
eventY:
说明:所保存地图状态中心点的纬度坐标。
类型:string/number。
示例:
mapObj.addEventListener(mapObj,ROLL_BACK,rollBack);
function rollBack(param){
alert(param.mapId+";"+param.eventType+";"+param.eventX+";"+param.eventY);}
MapABC 地图应用程序编程接口-用户手册
北京图盟科技有限公司
40.4.27 MEASURE_STEP 事件
说明:
测量一次直线距离后时触发该事件。
语法:
MMap.addEventListener(mapObj,MEASURE_STEP,measureStep);
返回值:
一个 MEvent 对象,它具有下列属性:
mapId:
说明:地图对象的名称。
类型:string。
eventType:
说明:事件类型名称。
类型:string。
overlayId:
说明:overlay 对象的 id。
类型:string。
eventX:
说明:经度坐标。
类型:string/number。
eventY:
说明:纬度坐标。
类型:string/number。
measureResult:
说明:测量的距离,单位为米。
类型:number。
示例:
mapObj.addEventListener(mapObj,MEASURE_STEP,measureStep);
function measureStep(param){
alert(param.mapId+";"+param.eventType+";"+param.eventX+";"+param.eventY+";"+param.
measureResult);}
40.4.28 MEASURE_END 事件
说明:
测距结束时触发该事件。
语法:
MMap.addEventListener(mapObj,MEASURE_END,endMeasure);
返回值:
一个 MEvent 对象,它具有下列属性:
mapId:
说明:地图对象的名称。
类型:string。
MapABC 地图应用程序编程接口-用户手册
北京图盟科技有限公司
eventType:
说明:事件类型名称。
类型:string。
overlayId:
说明:overlay 对象的 id。
类型:string。
eventX:
说明:经度坐标。
类型:string/number。
eventY:
说明:纬度坐标。
类型:string/number。
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);
返回值:
一个 MEvent 对象,它具有下列属性:
mapId:
说明:地图对象的名称。
类型:string。
eventType:
说明:事件类型名称。
类型:string。
eventX:
说明:经度坐标。
类型:string/number。
eventY:
说明:纬度坐标。
类型:string/number。
measureResult:
说明:测量的距离,单位为米。
类型:double。
MapABC 地图应用程序编程接口-用户手册
北京图盟科技有限公司
overlayId:
说明:overlay 对象的 id。
类型:string。
示例:
mapObj.addEventListener(mapObj, COMPUTE_AREA_END,endMeasure);
function endMeasure(param){
alert(param.mapId+";"+param.eventType+";"+param.eventX+";"+param.eventY+";"+param.
measureResult+";"+param.overlayId);}
40.4.30 MENUITEM_CLICK 事件
说明:
点击右键菜单时触发该事件。
语法:
MMap.addEventListener(mapObj,MENUITEM_CLICK,clickMenuitem);
返回值:
一个 MEvent 对象,它具有下列属性:
mapId:
说明:地图对象的名称。
类型:string。
eventType:
说明:事件类型名称。
类型:string。
overlayId:
说明:overlay 对象的 id。
类型:string。
menuItemId:
说明:右键菜单项 ID。
类型:string。
objectType:
说明:右键菜单触发事件的对象类型。
类型:string。
eventX:
说明:菜单左上角经度坐标
类型:string/number。
eventY:
说明:菜单左上角纬度坐标
类型:string/number。
示例:
mapObj.addEventListener(mapObj,MENUITEM_CLICK,clickmenuitem);
function clickmenuitem (param){
alert(param.mapId+";"+param.eventType+";"+param.overlayId+";"+param.menuItemId+";"+
param.objectType+";"+param.eventX+";"+param.eventY);}
MapABC 地图应用程序编程接口-用户手册
北京图盟科技有限公司
40.4.31 GPS_MOVEALONG_COMPLETE 事件
说明:
调用 markerMoveAlong 方法,移动结束后触发事件。
语法:
MMap.addEventListener(mapObj, GPS_MOVEALONG_COMPLETE,moveStop);
返回值:
一个 MEvent 对象,它具有下列属性:
mapId:
说明:地图对象的名称。
类型:string。
eventType:
说明:事件类型名称。
类型:string。
eventX:
说明:经度坐标
类型:string/number。
eventY:
说明:纬度坐标
类型:string/number。
overlayId:
说明:overlay 对象的 id。
类型:string。
示例:
mapObj.addEventListener(mapObj, GPS_MOVEALONG_COMPLETE,moveStop);
function moveStop (param){
alert(param.mapId+";"+param.eventType+";"+param.overlayId+";"+param.eventX+";"+para
m.eventY);}
40.4.32 OVERVIEWMAP_CHANGED 事件
说明:
改变鹰眼状态时触发该事件。
语法:
MMap.addEventListener(mapObj, OVERVIEWMAP_CHANGED,changeOverviewmap);
返回值:
一个 MEvent 对象,它具有下列属性:
mapId:
说明:地图对象的名称。
类型:string。
eventType:
说明:事件类型名称。
类型:string。
MapABC 地图应用程序编程接口-用户手册
北京图盟科技有限公司
示例:
mapObj.addEventListener(mapObj, OVERVIEWMAP_CHANGED, changeOverviewmap);
function changeOverviewmap (param){
alert(param.mapId+";"+param.eventType);}
40.4.33RADAR_INITIALIZED 事件
说明:
全景地图雷达初始化完成事件。
语法:
MMap.addEventListener(mapObj, RADAR_INITIALIZED,radarInitialized);
返回值:
一个 MEvent 对象,它具有下列属性:
mapId:
说明:地图对象的名称。
类型:string。
eventType:
说明:事件类型名称。
类型:string。
overlayId:
说明:overlay 对象的 id。
类型:string。
注释:拖拽覆盖物时有此返回值
示例:
mapObj.addEventListener(mapObj, RADAR_INITIALIZED,radarInitialized);
function radarInitialized (param){
alert(param.mapId+";"+param.eventType);}
40.4.34 RADAR_POSITION_CHANGED 事件
说明:
全景地图雷达位置改变事件。
语法:
MMap.addEventListener(mapObj, RADAR_POSITION_CHANGED,radarPositionChanged);
返回值:
一个 MEvent 对象,它具有下列属性:
mapId:
说明:地图对象的名称。
类型:string。
eventType:
说明:事件类型名称。
类型:string。
overlayId:
MapABC 地图应用程序编程接口-用户手册
北京图盟科技有限公司
说明:overlay 对象的 id。
类型:string。
注释:拖拽覆盖物时有此返回值。
eventX:
说明:经度坐标
类型:string/number。
eventY:
说明:纬度坐标
类型:string/number。
示例:
mapObj.addEventListener(mapObj,
RADAR_POSITION_CHANGED,radarPositionChanged);
function radarPositionChanged (param){
alert(param.mapId+";"+param.eventType);}
40.4.35 RADAR_ROTATION_CHANGED 事件
说明:
全景地图雷达角度改变事件。
语法:
MMap.addEventListener(mapObj, RADAR_ROTATION_CHANGED,radarRotationChanged);
返回值:
一个 MEvent 对象,它具有下列属性:
mapId:
说明:地图对象的名称。
类型:string。
eventType:
说明:事件类型名称。
类型:string。
overlayId:
说明:overlay 对象的 id。
类型:string。
注释:拖拽覆盖物时有此返回值。
value:
说明:雷达角度
类型:number。
示例:
mapObj.addEventListener(mapObj,
RADAR_ROTATION_CHANGED,radarRotationChanged);
function radarRotationChanged (param){
alert(param.mapId+";"+param.eventType);}
MapABC 地图应用程序编程接口-用户手册
北京图盟科技有限公司
命名空间: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:
MapABC 地图应用程序编程接口-用户手册
北京图盟科技有限公司
说明:海量数据叠加类型。
类型: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:
说明:加载海量数据类型。
类型:constant。
取值:MConstants.ADD_MARKER,加真点型
MConstants.NO_MARKER,不加真点型
(4) Options:
说明:加载海量数据参数选项
类型:MassOverlayOptions
返回值:
无
注释:
无
示例:
maptools.removeMassOverlay(MConstants.ADD_MARKER,opt);
MapABC 地图应用程序编程接口-用户手册
北京图盟科技有限公司
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");
MapABC 地图应用程序编程接口-用户手册
北京图盟科技有限公司
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,用户提供的图层
注释:
无
MapABC 地图应用程序编程接口-用户手册
北京图盟科技有限公司
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。
MapABC 地图应用程序编程接口-用户手册
北京图盟科技有限公司
搜索 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:
说明:关键词。必填,当仅按数据类型查询时可设置为空字符串。
MapABC 地图应用程序编程接口-用户手册
北京图盟科技有限公司
类型: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>
MapABC 地图应用程序编程接口-用户手册
北京图盟科技有限公司
<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:
说明:关键词。必填,当仅按数据类型查询时可设置为空字符串。
MapABC 地图应用程序编程接口-用户手册
北京图盟科技有限公司
类型:string。
(3)city:
说明:城市编号或者城市名称。必填,全国为 total。
类型:string。
(4)options:
说明:POI 查询参数选项。非必填,参见 MPoiSearchOptions 类。
类型:MPoiSearchOptions。本方法使用到 MPoiSearchOptions 中属性:
(a)dataType,查询数据类型
(b)recordsPerPage,每页记录数
(c)pageNum,第几页
(d)resType,返回格式
(e)dataSources,数据源
(f)srctype,自定义数据源
(g)range,周边查询范围
(h)naviflag,导航距离排序标识
(i)sr,编辑器数据源,按距离排序标识
(j)extId,编辑器数据源专用,外部 ID
(k)eid,编辑器数据源专用,企业 ID
(l)userId,编辑器数据源专用,用户 ID
(m)tempId,编辑器数据源专用,模板 ID
返回值:
JSON 或 XML。
返回结果说明:
以 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>
<cenpoi>
<address>地址</address>
<name>POI名称</name>
<type>POI类型</type>
<timestamp>数据时间戳</timestamp>
<match>匹配度</match>
<url>url连接</url>
MapABC 地图应用程序编程接口-用户手册
北京图盟科技有限公司
<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> <!--周边查询时中心点POI-->
</searchresult>
示例:
var centerXY = new MLngLat(116.4190,39.9151);
var citycode =010;
var keyword ='酒店';
var mls =new MPoiSearch();
var mlsp= new MPoiSearchOptions();
mlsp.range = 1000000;
mls.setCallbackFunction(myfunc); //回调函数
mls.poiSearchByCenPoi(centerXY,keyword,citycode,mlsp);
function myfunc(data)
{
if(data.error_message != null){
alert(data.error_message);
}else{
//解析返回结果
}
}
44.4.3 poiSearchByCenKeywords(centerKeywords,keywords,city,options)
说明:
根据中心点关键字查询周边的 POI。
参数:
(1)centerKeywords:
说明:中心点关键词。必填。
类型:string。
(2)keywords:
说明:关键字。必填。当仅按数据类型查询时可设置为空字符串。
MapABC 地图应用程序编程接口-用户手册
北京图盟科技有限公司
类型:string。
(3)city:
说明:城市号或城市名称。必填,全国为 total
类型:string。
(4)options:
说明:POI 搜索参数选项。非必填,参见 MPoiSearchOptions 类。
类型:MPoiSearchOptions。本方法使用到 MPoiSearchOptions 中属性:
(a)dataType,查询数据类型
(b)recordsPerPage,每页记录数
(c)pageNum,第几页
(d)resType,返回格式
(e)dataSources,数据源
(f)srctype,自定义数据源
(g)range,周边查询范围
(h)naviflag,导航距离排序标识
(i)sr,编辑器数据源,按距离排序标识
(j)extId,编辑器数据源专用,外部 ID
(k)eid,编辑器数据源专用,企业 ID
(l)userId,编辑器数据源专用,用户 ID
(m)tempId,编辑器数据源专用,模板 ID
返回值:
JSON 或 XML。
返回结果说明:
以 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>
<cenpoi>
<address>地址</address>
<name>POI名称</name>
<type>POI类型</type>
<timestamp>数据时间戳</timestamp>
<match>匹配度</match>
<url>url连接</url>
MapABC 地图应用程序编程接口-用户手册
北京图盟科技有限公司
<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> <!--周边查询时中心点POI-->
</searchresult>
示例:
var centerKeywords ='中关村';
var citycode =010;
var keyword ='酒店';
var mls =new MPoiSearch();
var mlsp= new MPoiSearchOptions();
mlsp.range = 1000000;
mls.setCallbackFunction(myfunc); //回调函数
mls.poiSearchByCenKeywords(centerKeywords,keyword,citycode,mlsp);
function myfunc(data)
{
if(data.error_message != null){
alert(data.error_message);
}else{
//解析返回结果
}
}
44.4.4 poiSearchByCenGridCode(centerGridCode,keywords,city,options)
说明:
根据中心点 GridCode 查询周边的 POI。
参数:
(1)centerGridCode:
说明:中心点 GridCode。必填。
类型:string。
(2)keywords:
说明:关键字。必填。当仅按数据类型查询时可设置为空字符串。
MapABC 地图应用程序编程接口-用户手册
北京图盟科技有限公司
类型:string。
(3)city:
说明:城市编号或者城市名称。必填,全国为 total
类型:string。
(4)options:
说明:POI 搜索参数选项。非必填,参见 MPoiSearchOptions 类。
类型:MPoiSearchOptions。本方法使用到 MPoiSearchOptions 中属性:
(a)dataType,查询数据类型
(b)recordsPerPage,每页记录数
(c)pageNum,第几页
(d)resType,返回格式
(e)dataSources,数据源
(f)srctype,自定义数据源
(g)range,周边查询范围
(h)naviflag,导航距离排序标识
(i)sr,编辑器数据源,按距离排序标识
(j)extId,编辑器数据源专用,外部 ID
(k)eid,编辑器数据源专用,企业 ID
(l)userId,编辑器数据源专用,用户 ID
(m)tempId,编辑器数据源专用,模板 ID
返回值:
JSON 或 XML。
返回结果说明:
以 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>
<cenpoi>
<address>地址</address>
<name>POI名称</name>
<type>POI类型</type>
<timestamp>数据时间戳</timestamp>
<match>匹配度</match>
<url>url连接</url>
MapABC 地图应用程序编程接口-用户手册
北京图盟科技有限公司
<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> <!--周边查询时中心点POI-->
</searchresult>
示例:
var centerGridCode='5916727421';
var citycode =010;
var keyword ='酒店';
var mls=new MPoiSearch();
var mlsp=new MPoiSearchOptions();
mlsp.range = 1000000;
mls.setCallbackFunction(myfunc); //回调函数
mls.poiSearchByCenGridCode(centerGridCode,keyword,citycode,mlsp);
function myfunc(data)
{
if(data.error_message != null){
alert(data.error_message);
}else{
//解析返回结果
}
}
44.4.5 poiSearchByCenLineCross(lineXY1,lineXY2,keywords,option)
说明:
将两线交叉点做为中心点,根据中心点坐标查询周边的 POI。
参数:
(1)lineXY1:
说明:第一条线。必填。
类型:MLngLats。
(2)lineXY2:
说明:第二条线。必填。
MapABC 地图应用程序编程接口-用户手册
北京图盟科技有限公司
类型:MLngLats。
(3)keywords:
说明:关键词。必填,当仅按数据类型查询时可设置为空字符串。
类型:string。
(4)options:
说明:POI 搜索参数选项。非必填,参见 MPoiSearchOptions 类。
类型:MPoiSearchOptions。本方法使用到 MPoiSearchOptions 中属性:
(a)dataType,查询数据类型
(b)recordsPerPage,每页记录数
(c)pageNum,第几页
(d)resType,返回格式
(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>
<gridcode>5916720420</gridcode>
<address>海淀区阜成路51号</address>
<tel>010-66867311</tel>
<icon/>
<url/>
<buscode>1</buscode>
<distance>441</distance>
<direction/>
MapABC 地图应用程序编程接口-用户手册
北京图盟科技有限公司
<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();
var arr2 = 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"));
arr2.push(new MLngLat("116.325356","39.9123278"));
var line1 = new MLngLats(arr1);
var line2 = new MLngLats(arr2);
var mls = new MPoiSearch();
var mlsp= new MPoiSearchOptions();
mls.setCallbackFunction(myfunc);
mls.poiSearchByCenLineCross(line1,line2,keyword,mlsp);
function myfunc(data)
{
if(data.error_message != null){
alert(data.error_message);
}else{
//解析返回结果
}
}
MapABC 地图应用程序编程接口-用户手册
北京图盟科技有限公司
PGUID 查询
44.4.6 poiSearchByPguid(pguid,city,options)
说明:
根据 PGUID 查询 POI。
参数:
(1)pguid:
说明:全局索引 ID。必填。
类型:string。
(2)city:
说明:城市编号或者城市名称。必填,全国为 total。
类型:string。
(3)options:
说明:POI 查询参数选项。非必填,参见 MPoiSearchOptions 类。
类型:MPoiSearchOptions。本方法使用到 MPoiSearchOptions 中属性:
(a)resType,返回格式
(b)dataSources,数据源
(c)srctype,自定义数据源
(j)extId,编辑器数据源专用,外部 ID
(k)eid,编辑器数据源专用,企业 ID
(l)userId,编辑器数据源专用,用户 ID
(m)tempId,编辑器数据源专用,模板 ID
返回值:
JSON 或 XML。
返回结果说明:
以 XML 为例:
<?xml version="1.0" encoding="GBK" ?>
<searchresult servername="60.247.103.19">
<count>此接口返回的结果集数量(最大结果集为 400)</count>
<cache>此数据是否从缓存读取</cache>
<total>引擎返回的结果集总数量</total>
<record>此页返回的结果集数量(最大结果集为 20)</record>
<searchtime>查询时间</searchtime>
<bounds>bounds 值,根据 xy 生成</bounds>
<list type="list">
<poi>
<address />
<name>六顺兴宾馆</name>
<type>住宿服务;宾馆酒店;宾馆酒店</type>
<timestamp>2009-01-15</timestamp>
MapABC 地图应用程序编程接口-用户手册
北京图盟科技有限公司
<match>10</match>
<url />
<distance>0</distance>
<x>JQMELSMTSMSKIFM</x>
<y>LYEPQVOOTLOINE</y>
<citycode>010</citycode>
<pguid>B000A7YYW9</pguid>
<srctype>basepoi</srctype>
<gridcode>5916728612</gridcode>
<tel />
<buscode />
<imageid />
<linkid />
<drivedistance>0</drivedistance>
</poi>
</list>
</searchresult>
示例:
var citycode = 010;
var pguid = "B000A7YYW9";
var mls = new MPoiSearch();
var mlsp= new MPoiSearchOptions();
mls.setCallbackFunction(myfunc);
mls.poiSearchByPguid(pguid,citycode,mlsp);
function myfunc(data)
{
if(data.error_message != null){
alert(data.error_message);
}else{
//解析返回结果
}
}
拉框查询
44.4.7 poiSearchByRegion(regionType,regionXY,keywords,options)
说明:
查询区域范围内的 POI。
参数:
(1)regionType:
说明:区域类型。必填。
MapABC 地图应用程序编程接口-用户手册
北京图盟科技有限公司
类型:constant。
取值:MOverlay.TYPE_POLYGON,多边形
MOverlay.TYPE_CIRCLE,圆形
MOverlay.TYPE_RECTANGLE,矩形
(2)regionXY:
说明:区域经纬度坐标。必填。对于圆形和矩形是外切矩形左下右上经纬度坐标数
组,对于多边形是顶点经纬度坐标数组。
类型:MLngLats。
(3)keywords:
说明:关键字,必填。
类型:string。
(4)options:
说明:POI 查询参数选项。非必填,参见 MPoiSearchOptions 类。
类型:MPoiSearchOptions。本方法使用到 MPoiSearchOptions 中属性:
(a)dataType,查询数据类型
(b)recordsPerPage,每页记录数
(c)pageNum,第几页
(d)resType,返回格式
(e)dataSources,数据源
(f)srctype,自定义数据源
(g)buffer,多边形缓冲区范围
(h)sortRule,排序规则
(i)custom,自定义查询参数
(j)custom_and,自定义查询参数的查询条件
(j)extId,编辑器数据源专用,外部 ID
(k)eid,编辑器数据源专用,企业 ID
(l)userId,编辑器数据源专用,用户 ID
(m)tempId,编辑器数据源专用,模板 ID
返回值:
JSON 或 XML。
注释:
目前支持的数据源包括基础库+地标库、编辑器库,默认为基础库+地标库
返回结果说明:
(1)数据源为基础库和地标库,以 XML 为例:
<?xml version="1.0" encoding="GB2312"?>
<spatial_response type="searchresult" servername="sis_tj_03">
<searchresult>
<searchtime>0</searchtime> <!—查询时间-->
<count>1557</count> <!—总结果记录数-->
<list type="list"> <!—返回poi的列表-->
<poi>
<match /> <!--匹配度-->
MapABC 地图应用程序编程接口-用户手册
北京图盟科技有限公司
<type /> <!--类型->
<id /> <!—id 号-->
<citycode /> <!—城市号
<extid /> <!---外部id->
<pguid /> <!---全局索引id->
<timestamp /> <!—时间戳-->
<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" ?>
<spatial_response type="searchresult" servername="search1-2">
<searchresult>
<searchtime>47</searchtime>
<count>21</count>
<list type="list">
<poi>
<match />
<type />
<id />
<citycode>010</citycode>
<extid>a6510</extid>
<pguid />
<timestamp>1247031589178</timestamp>
<name>北京铂丽商务酒店</name>
<srctype>userpoi</srctype>
<gridcode>5916638620</gridcode>
<address>北京市朝阳区永安东里 1 号</address>
<tel />
<icon />
<url />
<buscode />
MapABC 地图应用程序编程接口-用户手册
北京图盟科技有限公司
<distance>0</distance>
<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);
var mls = new MPoiSearch();
var mlsp= new MPoiSearchOptions();
mls.setCallbackFunction(myfunc);
mls.poiSearchByRegion(type,mlls,keyword,mlsp);
function myfunc(data)
{
if(data.error_message != null){
alert(data.error_message);
}else{
//解析返回结果
}
}
MapABC 地图应用程序编程接口-用户手册
北京图盟科技有限公司
缓冲区查询
44.4.8 poiSearchByLine(lineXY,keywords,city,options)
说明:
查询整条路线缓冲区范围的 POI。
参数:
(1)lineXY:
说明:线经纬度坐标。
类型:MLngLats。
(2)keywords:
说明:关键字,必填。
类型:string。
(3)city:
说明:城市编号或者城市名称。必填,全国为 total
类型:string。
(4)options:
说明:POI 查询参数选项。非必填,参见 MPoiSearchOptions 类。
类型:MPoiSearchOptions。本方法使用到 MPoiSearchOptions 中属性:
(a)dataType,查询数据类型
(b)cenXY,道路上的一个查询中心点,当此值不为空时,此方法变为以道
路中心点相对左前、右前、左后、右后位置方向范围内的缓冲区查询。
(c)sign,相对位置方向
(d)buffer,多边形或线的缓冲区范围
(g)resType,返回格式
返回值:
JSON 或 XML。
返回结果说明:
以 XML 为例:
<?xml version="1.0" encoding="GB2312" ?>
<spatial_response type="searchresult" servername="search1-2">
<searchresult>
<searchtime>156</searchtime>
<count>34</count>
<list type="list">
<poi>
<match>10</match>
<type>科教文化服务;学校;高等院校</type>
<id />
<citycode>010</citycode>
<extid />
<pguid>B000A7BP2D</pguid>
MapABC 地图应用程序编程接口-用户手册
北京图盟科技有限公司
<timestamp>2009-10-26</timestamp>
<name>中央广播电视大学</name>
<srctype>basepoi</srctype>
<gridcode>5916628821</gridcode>
<address>复兴门内大街 160</address>
<tel>010-66490114</tel>
<icon />
<url />
<buscode>1</buscode>
<distance>0</distance>
<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(",");
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);
var mls = new MPoiSearch();
var mlsp= new MPoiSearchOptions();
mlsp.buffer = 50000;
mls.setCallbackFunction(myfunc);
mls.poiSearchByLine(mlls,keyword,city,mlsp);
function myfunc(data)
{
if(data.error_message != null){
MapABC 地图应用程序编程接口-用户手册
北京图盟科技有限公司
alert(data.error_message);
}else{
//解析返回结果
}
}
44.4.9 poiSearchByRoadId(roadId,keywords,city,options)
说明:
根据道路 ID 查询整条路线缓冲区范围的 POI。
参数:
(1)roadId:
说明:道路 ID。
类型:string。
(2)keywords:
说明:关键字,必填。
类型:string。
(3)city:
说明:城市编号或者城市名称。必填,全国为 total
类型:string。
(4)options:
说明:POI 查询参数选项。非必填,参见 MPoiSearchOptions 类。
类型:MPoiSearchOptions。本方法使用到 MPoiSearchOptions 中属性:
(a)dataType,查询数据类型
(b)range,线的缓冲区范围
(e)resType,返回格式
(f)sortRule,排序规则
返回值:
JSON 或 XML。
返回结果说明:
以 XML 为例:
<?xml version="1.0" encoding="GBK" ?>
<spatial_response type="searchresult" servername="60.247.103.19">
<searchresult>
<searchtime>17022</searchtime>
<count>4</count>
<bounds>JQMEMPLTSMSGENI;LYEPMXHPTOKMNM;JQMEMPPPWL
ROIFI;LYEPOVNWTLGMJE;</bounds>
<list type="list">
<poi>
<address>安德路甲 11</address>
<name>北京安定门中医医院</name>
MapABC 地图应用程序编程接口-用户手册
北京图盟科技有限公司
<id />
<type>医疗保健服务;综合医院;综合医院</type>
<timestamp>2009-02-10</timestamp>
<match>10</match>
<icon />
<distance>0</distance>
<x>JQMEMPNRXNOEJI</x>
<y>LYEPNQOOXPKMNI</y>
<citycode>010</citycode>
<extid />
<pguid>B000A7OFUC</pguid>
<srctype>basepoi</srctype>
<gridcode>5916734201</gridcode>
<tel>010-84130283</tel>
<buscode>1</buscode>
<imageid>0a772008042700000476</imageid>
<linkid />
<picpath />
<dn />
<drivedistance>0</drivedistance>
</poi>
</list>
</searchresult>
</spatial_response>
示例:
var city = 010;
var roadId = "001011355";
var keyword = "医院";
var mls = new MPoiSearch();
var mlsp= new MPoiSearchOptions();
mls.setCallbackFunction(myfunc);
mls.poiSearchByRoadId(roadId,keyword,city,mlsp);
function myfunc(data)
{
if(data.error_message != null){
alert(data.error_message);
}else{
//解析返回结果
}
}
MapABC 地图应用程序编程接口-用户手册
北京图盟科技有限公司
输入提示
44.4.10typeAhead(keywords,city,options)
说明:
关键字输入提示。
参数:
(1)keywords:
说明:关键字,必填。
类型:string。
(2)city:
说明:城市编号或者城市名称。必填,全国为 total
类型:string。
(3)options:
说明:POI 查询参数选项。非必填,参见 MPoiSearchOptions 类。
类型:MPoiSearchOptions。本方法使用到 MPoiSearchOptions 中属性:
(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 mls = new MPoiSearch();
var mlsp = new MPoiSearchOptions();
mls.setCallbackFunction(myfunc);
mls.typeAhead(keyword,citycode,mlsp);
function myfunc(data)
{
if(data.error_message != null){
alert(data.error_message);
}else{
//解析返回结果
}
}
MapABC 地图应用程序编程接口-用户手册
北京图盟科技有限公司
行政区域查询
44.4.11poiSearchByDistrictName(districtName,keywords,city,options)
说明:
根据行政区域名称查询行政区域内的 POI。
参数:
(1)districtName:
说明:行政区域名称。
类型:string。
(2)keywords:
说明:关键字,必填。
类型:string。
(3)city:
说明:城市编号或者城市名称。必填,全国为 total
类型:string。
(4)options:
说明:POI 查询参数选项。非必填,参见 MPoiSearchOptions 类。
类型:MPoiSearchOptions。本方法使用到 MPoiSearchOptions 中属性:
(a)dataType,查询数据类型
(b)recordsPerPage,每页记录数
(c)pageNum,第几页
(d)resType,返回格式
(e)sortRule,排序规则
返回值:
JSON 或 XML。
返回结果说明:
以 XML 为例:
<?xml version="1.0" encoding="utf-8" ?>
<spatial_response type="searchresult" servername="search1-2">
<searchresult>
<searchtime>139</searchtime>
<count>5820</count>
<list type="list">
<poi>
<match>10</match>
<type>餐饮服务;中餐厅;中餐厅</type>
<id />
<citycode>021</citycode>
<extid />
MapABC 地图应用程序编程接口-用户手册
北京图盟科技有限公司
<pguid>B00150D4AE</pguid>
<timestamp>2009-01-15</timestamp>
<name>明记</name>
<srctype>basepoi</srctype>
<gridcode>4621645210</gridcode>
<address>东方路 1486-1 识别</address>
<tel>021-58701107</tel>
<icon />
<url />
<buscode />
<distance>0</distance>
<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 ="饭店";
var mls = new MPoiSearch();
var mlsp= new MPoiSearchOptions();
mls.setCallbackFunction(myfunc);
mls.poiSearchByDistrictName(place,keyword,city,mlsp);
function myfunc(data)
{
if(data.error_message != null){
alert(data.error_message);
}else{
//解析返回结果
}
}
MapABC 地图应用程序编程接口-用户手册
北京图盟科技有限公司
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
说明:
MapABC 地图应用程序编程接口-用户手册
北京图盟科技有限公司
数据源高级参数
取值:
默认值为""
类型:
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
类型:
MapABC 地图应用程序编程接口-用户手册
北京图盟科技有限公司
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。
取值:
默认值为""
类型:
MapABC 地图应用程序编程接口-用户手册
北京图盟科技有限公司
string。
注释:
编辑器数据库专用
45.4.11 eid
说明:
企业 id。
取值:
默认值为""。
类型:
string。
注释:
编辑器数据库专用
45.4.12 userId
说明:
用户 id。
取值:
默认值为""。
类型:
string。
注释:
编辑器数据库专用
45.4.13 tempId
说明:
模板 id。
取值:
默认值为""。
类型:
string。
注释:
编辑器数据库专用
45.4.14 buffer
说明:
线或多边形缓冲区设置。
取值:
单位为米
MapABC 地图应用程序编程接口-用户手册
北京图盟科技有限公司
默认值为 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
MapABC 地图应用程序编程接口-用户手册
北京图盟科技有限公司
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;
MapABC 地图应用程序编程接口-用户手册
北京图盟科技有限公司
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:
说明:终点坐标。必填。
MapABC 地图应用程序编程接口-用户手册
北京图盟科技有限公司
类型:MLngLat。
(3)options:
说明:路径导航搜索输入参数对象,非必填,参见 MRouteSearchOptions 类。
类型:MRouteSearchOptions。本方法使用到 MRouteSearchOptions 中属性:
(a)resType,返回格式
(b)per,抽吸函数
(c)routeType,路径计算规则
(d)region,避让区域坐标
(e)name,避让区域名称
(f)avoidanceType,避让规则
(g)passByXY,途经点。
(h)ext,自定义格式类型
返回值:
JSON 或 XML。
注释:
本方法设置 passByXY 参数后,与 routSearchByMultiPoi 方法的区别为本方法按照
routeType 参数设置的导航方式进行导航;routSearchByMultiPoi 按照多点参数的输入顺序进
行导航。
返回结果说明:
以 XML 为例:
<?xml version="1.0" encoding="GBK" ?>
<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/>
MapABC 地图应用程序编程接口-用户手册
北京图盟科技有限公司
<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);
function myfunc(data){
if(data.error_message != undefined){
alert(data.error_message);
}else{
//解析返回数据
}
}
46.4.2 routeSearchByMultiPoi(multiPoiXY,options)
说明:
多点驾车导航路径查询。按照多点参数的输入顺序进行导航。
参数:
(1)multePoiXY:
说明:多点坐标。必填。
类型:MLngLats。
(2)options:
说明:路径导航搜索输入参数对象,非必填,参见 MRouteSearchOptions 类。
类型:MRouteSearchOptions。本方法使用到 MRouteSearchOptions 中属性:
(a)resType,返回格式
(b)per,抽吸函数
(c)routeType,路径计算规则
返回值:
JSON 或 XML。
返回结果说明:
以 XML 为例:
<?xml version="1.0" encoding="utf-8" ?>
- <RoutingJ ver="2.0" servername="mSIS03" versionname="1.0.7.2">
<count>23</count>
<cache>false</cache>
<searchtime>2</searchtime>
MapABC 地图应用程序编程接口-用户手册
北京图盟科技有限公司
<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 mrs =new MRouteSearch();
var options = new MRouteSearchOptions();
var arr1 = coor.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 multiXY = new MLngLats(arr);
mrs.setCallbackFunction(myfunc);
mrs.routeSearchByMultiPoi(multiXY,options);
function myfunc(data){
if(data.error_message != undefined){
alert(data.error_message);
}else{
MapABC 地图应用程序编程接口-用户手册
北京图盟科技有限公司
//解析返回数据
}
}
46.4.3 calculaNaviDistance(multiPoiXY,option)
说明:
多点导航距离计算。
参数:
(1)multePoiXY:
说明:多点坐标。必填。
类型:MLngLats。
(2)options:
说明:路径导航搜索输入参数对象,非必填,参见 MRouteSearchOptions 类。
类型:MRouteSearchOptions。本方法使用到 MRouteSearchOptions 中属性:
(a)resType,返回格式
(b)routeType,路径计算规则
返回值:
JSON 或 XML。
返回结果说明:
以 XML 为例:
<?xml version="1.0" encoding="GB2312" ?>
<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 mrs =new MRouteSearch();
var options = new MRouteSearchOptions();
var arr1 = coor.split(",");
var arr =new Array();
for(var i = 0 ;i<=arr1.length-2;){
var mll =new MLngLat(arr1[i],arr1[i+1]);
MapABC 地图应用程序编程接口-用户手册
北京图盟科技有限公司
arr.push(mll);
i=i+2;
}
var multiXY = new MLngLats(arr);
mrs.setCallbackFunction(myfunc);
mrs.calculaNaviDistance(multiXY,options);
function myfunc(data){
if(data.error_message != undefined){
alert(data.error_message);
}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
说明:
MapABC 地图应用程序编程接口-用户手册
北京图盟科技有限公司
路径计算规则。
取值:
当路径导航查询时:
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。
MapABC 地图应用程序编程接口-用户手册
北京图盟科技有限公司
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。
MapABC 地图应用程序编程接口-用户手册
北京图盟科技有限公司
47.4.9 requestMethod
说明:
请求方式
取值:
get,get 请求方式(默认)
post,post 请求方式
类型:
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 类的一个新实例。
MapABC 地图应用程序编程接口-用户手册
北京图盟科技有限公司
示例:
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 中属性:
(a)resType,返回格式
(b)per,抽吸函数
(c)routeType,路径计算规则
返回值:
JSON 或 XML。
返回结果说明:
以 XML 为例:
<?xml version="1.0" encoding="GBK" ?>
<RoutingJ ver="2.0" servername="60.247.103.19">
<count>此查询返回的结果集</count>
<cache>数据是否从缓存读取</cache>
<searchtime>查询时间</searchtime>
<busList type="list"><!--换乘方案列表-->
<bus><!--换乘方案 1-->
<expense>0</expense> <!--换乘方案价格-->
<segmentList type="list"><!--换乘段列表,每段代表一次换乘-->
<segment>
MapABC 地图应用程序编程接口-用户手册
北京图盟科技有限公司
<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 startXY= new MLngLat(116.4,39.9);
var endXY = new MLngLat(116.3,39.8);
var mrs =new MBusSearch();
var options=new MBusSearchOptions();
mrs.setCallbackFunction(myfunc);
mrs.busSearchByTwoPoi(startXY,endXY,citycode,options);
function myfunc(data){
if(data.error_message != undefined){
alert(data.error_message);
}else{
MapABC 地图应用程序编程接口-用户手册
北京图盟科技有限公司
//解析返回数据
}
}
公交线路信息查询
48.4.2 busSearchByBusId(busId,city,option)
说明:
根据公交线路 ID 查询公交信息。
参数:
(1)busId:
说明:公交线路 ID。必填。
类型:string。
(2)city:
说明:城市编号或者城市名称。必填。
类型:string。
(3)options:
说明:公交搜索输入参数对象,非必填,参见 MBusSearchOptions 类。
类型:MBusSearchOptions。本方法使用到 MBusSearchOptions 中属性:
(a)resType,返回格式
(b)resData,是否返回扩展信息
(c)recordsPerPage,每页记录数
(d)pageNum,第几页
返回值:
JSON 或 XML。
返回结果说明:
(1)通用返回结果,以 XML 为例:
<?xml version="1.0" encoding="GBK" ?>
<searchresult servername="60.247.103.19">
<count>此接口返回的结果集数量</count>
<cache>此数据是否从缓存读取</cache>
<searchtime>查询时间</searchtime>
<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>
MapABC 地图应用程序编程接口-用户手册
北京图盟科技有限公司
<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>
MapABC 地图应用程序编程接口-用户手册
北京图盟科技有限公司
</searchresult>
(2)公交扩展信息返回说明,以 XML 为例:
<?xml version="1.0" encoding="UTF-8"?>
<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.setCallbackFunction(myfunc);
mrs.busSearchByBusId(busLineId,citycode,options);
function myfunc(data){
if(data.error_message != undefined){
alert(data.error_message);
}else{
//解析返回数据
}
}
48.4.3 busSearchByBusName(busName,city,option)
说明:
MapABC 地图应用程序编程接口-用户手册
北京图盟科技有限公司
根据公交线路名称查询公交线路信息。
参数:
(1)busName:
说明:公交线路名称。必填。
类型:string。
(2)city:
说明:城市编号或者城市名称。必填。
类型:string。
(3)options:
说明:公交搜索输入参数对象,非必填,参见 MBusSearchOptions 类。
类型:MBusSearchOptions。本方法使用到 MBusSearchOptions 中属性:
(a)resType,返回格式
(b)resData,是否返回扩展信息
(c)recordsPerPage,每页记录数
(d)pageNum,第几页
返回值:
JSON 或 XML。
返回结果说明:
(1)通用返回结果,以 XML 为例:
<?xml version="1.0" encoding="GBK" ?>
<searchresult servername="60.247.103.19">
<count>此接口返回的结果集数量</count>
<cache>此数据是否从缓存读取</cache>
<searchtime>查询时间</searchtime>
<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 />
MapABC 地图应用程序编程接口-用户手册
北京图盟科技有限公司
<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 为例:
<?xml version="1.0" encoding="UTF-8"?>
<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 空调
MapABC 地图应用程序编程接口-用户手册
北京图盟科技有限公司
<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 busLineName = "300";
var options =new MBusSearchOptions();
var mrs = new MBusSearch();
mrs.setCallbackFunction(myfunc);
mrs.busSearchByBusName(busLineName,citycode,options);
function myfunc(data){
if(data.error_message != undefined){
alert(data.error_message);
}else{
//解析返回数据
}
}
48.4.4 busSearchByBusStation(stationName,city,option)
说明:
根据公交站点查询经过此公交站点的公交线路信息。
参数:
(1)stationName:
说明:公交站点名称。必填。
类型:string。
(2)city:
说明:城市编号或者城市名称。必填。
类型:string。
(3)options:
MapABC 地图应用程序编程接口-用户手册
北京图盟科技有限公司
说明:公交搜索输入参数对象,非必填,参见 MBusSearchOptions 类。
类型:MBusSearchOptions。本方法使用到 MBusSearchOptions 中属性:
(a)resType,返回格式
(b)resData,是否返回扩展信息
(c)recordsPerPage,每页记录数
(d)pageNum,第几页
返回值:
JSON 或 XML。
返回结果说明:
(1)通用返回结果,以 XML 为例:
<?xml version="1.0" encoding="GBK" ?>
<searchresult servername="60.247.103.19">
<count>此接口返回的结果集数量</count>
<cache>此数据是否从缓存读取</cache>
<searchtime>查询时间</searchtime>
<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 />
MapABC 地图应用程序编程接口-用户手册
北京图盟科技有限公司
<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 为例:
<?xml version="1.0" encoding="UTF-8"?>
<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 路 (昌平东关 --昌平南口北
MapABC 地图应用程序编程接口-用户手册
北京图盟科技有限公司
站);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 stationName = "北京站";
var options =new MBusSearchOptions();
var mrs = new MBusSearch();
mrs.setCallbackFunction(myfunc);
mrs.busSearchByBusStation(stationName,citycode,options);
function myfunc(data){
if(data.error_message != undefined){
alert(data.error_message);
}else{
//解析返回数据
}
}
49 MBusSearchOptions()
49.1 说明
公交查询可选参数对象,用来设置公交查询方法的各种参数选项。
49.2 命名空间
com.mapabc.search.api.MBusSearchOptions。
49.3 构造方法
49.3.1 MBusSearchOptions()
说明:
初始化 MBusSearchOptions 类的一个新实例。
示例:
MapABC 地图应用程序编程接口-用户手册
北京图盟科技有限公司
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,不返回(默认)
MapABC 地图应用程序编程接口-用户手册
北京图盟科技有限公司
1,返回
类型:
number。
49.4.5 recordsPerPage
说明:
每页返回几条记录。
取值:
默认值为 10。
类型:
number。
49.4.6 pageNum
说明:
返回第几页。
取值:
默认值为 1。
类型:
number。
49.4.7 requestMethod
说明:
请求方式
取值:
get,get 请求方式(默认)
post,post 请求方式
类型:
String
49.5 方法
无
49.6 示例
var option=new MBusSearchOptions();
option.routeType=1;
option.returnType="XML";
MapABC 地图应用程序编程接口-用户手册
北京图盟科技有限公司
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 中属性:
(a)resType,返回格式
返回值:
JSON 或 XML。
返回结果说明:
(1)通用返回结果,以 XML 为例:
MapABC 地图应用程序编程接口-用户手册
北京图盟科技有限公司
<?xml version="1.0" encoding="GBK" ?>
<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.setCallbackFunction(myfunc);
mls.addressToGeocode(address,mlsp);
function myfunc(data){
if(data.error_message != undefined){
alert(data.error_message);
}else{
MapABC 地图应用程序编程接口-用户手册
北京图盟科技有限公司
//解析返回数据
}
}
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。
MapABC 地图应用程序编程接口-用户手册
北京图盟科技有限公司
51.4.2 requestMethod
说明:
请求方式
取值:
get,get 请求方式(默认)
post,post 请求方式
类型:
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();
MapABC 地图应用程序编程接口-用户手册
北京图盟科技有限公司
52.4 方法
52.4.1 poiToAddress(poiXY,options)
说明:
位置描述,由经纬度坐标得到详细地址信息,包括该点所在省市区,周边的 POI 和道路。
参数:
(1)poiXY:
说明:位置点经纬度坐标。必填。
类型:MLngLat。
(2)options:
说明:位置描述输入参数选项。非必填,参考 MReGeoCodeSearchOptions 类。
类型:MReGeoCodeSearchOptions。本方法使用到 MReGeoCodeSearchOptions 中属性:
(a)resType,返回格式
(b)poiNumber,返回周边的 POI 数量
(c)range,限定周边热点 POI 和道路的距离范围
(d)pattern,返回数据的模式
(e)roadLevel,道路等级
(f)exkey,排除的关键字
返回值:
JSON 或 XML。
返回结果说明:
以 XML 为例:
<?xml version="1.0" encoding="GB2312"?>
<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> <!---电话区号->
</City>
<District ver="1.0"> <!—区域-->
<name>海淀区</name> <!—区域名-->
<code>110108</code> <!—区域编号-->
</District>
<roadList type="list"> <!--周边道路列表-->
<Road ver="1.0">
MapABC 地图应用程序编程接口-用户手册
北京图盟科技有限公司
<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 /> <!---匹配度->
<id>0</id> <!---poi id->
<citycode /> <!--城市号-->
<extid /> <!—编辑器的外部id号-->
<pguid /> <!---索引id->
<timestamp /> <!---时间戳->
<name>银谷大厦</name> <!---名称->
<srctype /> <!---数据来源->
<gridcode>5916728612</gridcode> <!—网格编号-->
<address>北京市北四环西路9</address> <!—地址-->
<tel /> <!---电话->
<icon /> <!—图标-->
<url /> <!---关联url->
<distance>0.0</distance> <!---相对距离->
<direction>北</direction> <!—相对方向-->
<xml /> <!—扩展信息-->
<x>HKVNJPRKKMK</x> <!—x坐标-->
<y>JSNYOTPKKEG</y> <!---y坐标->
</poi>
</poiList>
</SpatialBean>
</spatial_response>
示例:
var mls =new MReGeoCodeSearch();
var mlsp= new MReGeoCodeSearchOptions();
mls.setCallbackFunction(myfunc);
mls.poiToAddress(new MLngLat(116.334,39.9872),mlsp);
function myfunc(data){
if(data.error_message != undefined){
alert(data.error_message);
}else{
MapABC 地图应用程序编程接口-用户手册
北京图盟科技有限公司
//解析返回数据
}
}
52.4.2 poiToAddressSimple(poiXY,options)
说明:
简化版位置描述,由经纬度坐标得到详细地址信息。
参数:
(1)poiXY:
说明:位置点经纬度坐标。必填。
类型:MLngLat。
(2)options:
说明:位置描述输入参数选项。非必填,参考 MReGeoCodeSearchOptions 类。
类型:MReGeoCodeSearchOptions。本方法使用到 MReGeoCodeSearchOptions 中属性:
(a)resType,返回格式
返回值:
JSON 或 XML。
返回结果说明:
河北省沧州市黄骅市;沧黄高速出口-205 国道交叉路口;杨常庄村,于常庄村附近
示例:
var mls =new MReGeoCodeSearch();
var mlsp= new MReGeoCodeSearchOptions();
mls.setCallbackFunction(myfunc);
mls.poiToAddressSimple(new MLngLat(116.334,39.9872),mlsp);
function myfunc(data){
if(data.error_message != undefined){
alert(data.error_message);
}else{
//解析返回数据
}
}
52.4.3 multiPoiToAddress(multiPoiXY,Options)
说明:
多点位置描述,由经纬度坐标得到详细地址信息。
参数:
(1)multiPoiXY:
说明:多个位置点经纬度坐标。必填。
MapABC 地图应用程序编程接口-用户手册
北京图盟科技有限公司
类型:MLngLats。
(2)options:
说明:位置描述输入参数选项。非必填,参考 MReGeoCodeSearchOptions 类。
类型:MReGeoCodeSearchOptions。本方法使用到 MReGeoCodeSearchOptions 中属性:
(a)resType,返回格式
(b)level,道路等级
返回值:
JSON 或 XML。
返回结果说明:
<?xml version="1.0" encoding="GB2312" ?>
<spatial_response type="list" servername="search1-2">
<list type="list">
<SpatialBean ver="1.0">
<Province ver="1.0">
<name>河北省</name>
<code>130000</code>
</Province>
<City ver="1.0">
<name>保定市</name>
<code>130600</code>
<telnum>0312</telnum>
</City>
<District ver="1.0">
<name>雄县</name>
<code>130638</code>
<x />
<y />
<bounds />
</District>
<roadList type="list">
<Road ver="1.0">
<id>03163993</id>
<name>保津高速</name>
<direction>SouthEast</direction>
<distance>1838.367955</distance>
<width>41000</width>
<ename>Baojin Expressway</ename>
</Road>
</roadList>
<poiList type="list" />
</SpatialBean>
<SpatialBean ver="1.0">
MapABC 地图应用程序编程接口-用户手册
北京图盟科技有限公司
<Province ver="1.0">
<name>河北省</name>
<code>130000</code>
</Province>
<City ver="1.0">
<name>保定市</name>
<code>130600</code>
<telnum>0312</telnum>
</City>
<District ver="1.0">
<name>高碑店市</name>
<code>130684</code>
<x />
<y />
<bounds />
</District>
<roadList type="list" />
<poiList type="list" />
</SpatialBean>
<SpatialBean ver="1.0">
<Province ver="1.0">
<name>河北省</name>
<code>130000</code>
</Province>
<City ver="1.0">
<name>廊坊市</name>
<code>131000</code>
<telnum>0316</telnum>
</City>
<District ver="1.0">
<name>永清县</name>
<code>131023</code>
<x />
<y />
<bounds />
</District>
<roadList type="list" />
<poiList type="list" />
</SpatialBean>
</list>
</spatial_response>
示例:
var coor = "110.319358,39.91741109,116.219358,39.81741199";
MapABC 地图应用程序编程接口-用户手册
北京图盟科技有限公司
var arr = coor.split(",");
var l1 = new MLngLat(arr[0],arr[1]);
var l2 = new MLngLat(arr[2],arr[3]);
var a = new Array();
a.push(l1);
a.push(l2);
var lls = new MLngLats(a);
var mls =new MReGeoCodeSearch();
var mlsp= new MReGeoCodeSearchOptions();
mls.setCallbackFunction(myfunc);
mls.multiPoiToAddress(lls,mlsp);
function myfunc(data){
if(data.error_message != undefined){
alert(data.error_message);
}else{
//解析返回数据
}
}
53 MReGeoCodeSearchOptions()
53.1 说明
位置描述输入参数选项类。
53.2 命名空间
com.mapabc.search.api.MReGeoCodeSearchOptions。
53.3 构造方法
53.3.1 MReGeoCodeSearchOptions()
说明:
初始化 MReGeoCodeSearchOptions 类的一个新实例。
示例:
var option=new MReGeoCodeSearchOptions();
MapABC 地图应用程序编程接口-用户手册
北京图盟科技有限公司
53.4 属性
53.4.1 resType
说明:
返回结果形式,
取值:
JSON(默认)
XML
类型:
string。
53.4.2 poiNumber
说明:
返回周边的 POI 数量,
取值:
默认值为 10
类型:
number。
53.4.3 range
说明:
限定周边热点 POI 和道路的距离范围
类型:
number。
53.4.4 pattern
说明:
返回数据的模式。
取值:
0, 返回地标性 POI
1, 返回全部 POI,
注释:
(1)如果 xy 在繁华地区设置 0 效果较好,如果 xy 在偏远地区设置 1 效果较好。
(2)地标性 POI 包括以下类型点:大厦、写字楼、电视台、公园、风景点、博物馆、
展览馆、体育场馆、图书馆、宾馆、酒店、医院、大学、影剧院、中学、小学、银行、
政府机关、科研院所、公安机关、邮政局 、电信营业厅、幼儿园。
类型:
number。
MapABC 地图应用程序编程接口-用户手册
北京图盟科技有限公司
53.4.5 roadlevel
说明:
道路等级
取值:
与国家标准的道路等级划分的对应关系如下:
0,代表的标准道路等级 0-11 范围的道路
1,代表的标准道路等级 2-11 范围的道路
2,代表的标准道路等级 7-11 范围的道路
3,代表的标准道路等级 9-11 范围的道路
国家标准的道路等级划分共 12 级,参考如下:
0,图廓线 未命名道路
1,非导航道路
2,普通道路
3,次要道路
4,县乡村内部道路
5,乡公路
6, 县道
7, 主要道路
8, 主要大街、城市快速道
9, 省道
10, 国道
11, 高速公路
类型:
number。
53.4.6 exkey
说明:
排除的关键字
类型:
String
53.4.7 requestMethod
说明:
请求方式
取值:
get,get 请求方式(默认)
post,post 请求方式
类型:
String
MapABC 地图应用程序编程接口-用户手册
北京图盟科技有限公司
53.5 方法
无
53.6 示例
var mgco = new MReGeoCodeSearchOptions();
mgco.resType="xml";
mgco.poiNumber=20;
54 MRoadSearch()
54.1 说明
封装了所有道路信息查询方法。
54.2 命名空间
com.mapabc.search.api.MRoadSearch。
54.3 构造方法
54.3.1 MRoadSearch()
说明:
初始化 MRoadSearch 类的一个新实例。
示例:
var mls = new MRoadSearch();
54.4 方法
54.4.1 roadSearchByRoadName(roadName,city,options)
说明:
根据道路名称查询道路的详细信息。
MapABC 地图应用程序编程接口-用户手册
北京图盟科技有限公司
参数:
(1)roadName:
说明:道路名称。必填。
类型:string。
(2)city:
说明:城市编号或者城市名称。必填。
类型:string。
(3)options:
说明:道路搜索输入参数对象,非必填,参见 MRoadSearchOptions 类。
类型:MRoadSearchOptions。本方法使用到 MRoadSearchOptions 中属性:
(a)resType,返回格式
(b)roadLevel,道路级别
(c)buffer,缓冲区范围
(d)rexy,是否返回坐标
返回值:
JSON 或 XML。
返回结果说明:
以 XML 为例:
<?xml version="1.0" encoding="gbk"?>
<spatial_response type="roadList" servername="60.247.103.19">
<roadList type="list">
<Road ver="1.0">
<id>001011355</id> <!--道路ID-->
<name>安德里北街</name><!--道路名称-->
<direction/> <!--道路方向-->
<distance>0.000000</distance>
<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>
MapABC 地图应用程序编程接口-用户手册
北京图盟科技有限公司
</roadList>
</spatial_response>
示例:
var citycode = 010;
var roadName = "北三环";
var mls = new MRoadSearch();
var mlsp= new MRoadSearchOptions();
mls.setCallbackFunction(myfunc);
mls.roadSearchByRoadName(roadName,citycode,mlsp);
function myfunc(data){
if(data.error_message != undefined){
alert(data.error_message);
}else{
//解析返回数据
}
}
54.4.2 roadCrossSearchByRoadId(roadId1,roadId2,city,options)
说明:
通过道路 ID 查询两条道路的交叉路口。
参数:
(1)roadId1:
说明:第一条道路 ID。必填。
类型:string。
(2)roadId2:
说明:第二条道路 ID。必填。
类型:string。
(2)city:
说明:城市编号或者城市名称。必填。
类型:string。
(3)options:
说明:道路搜索输入参数对象,非必填,参见 MRoadSearchOptions 类。
类型:MRoadSearchOptions。本方法使用到 MRoadSearchOptions 中属性:
(a)resType,返回格式
(b)sortRule,排序规则
返回值:
JSON 或 XML。
返回结果说明:
以 XML 为例:
<?xml version="1.0" encoding="GB2312" ?>
<spatial_response type="searchresult">
MapABC 地图应用程序编程接口-用户手册
北京图盟科技有限公司
<searchresult>
<searchtime>19</searchtime>
<count>1</count>
<list type="list">
<poi>
<match />
<type />
<id />
<citycode />
<extid />
<pguid />
<timestamp />
<name />
<srctype />
<gridcode />
<address />
<tel />
<icon />
<url />
<buscode />
<distance>0</distance>
<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";
var mls = new MRoadSearch();
var mlsp= new MRoadSearchOptions();
mls.setCallbackFunction(myfunc);
mls.roadCrossSearchByRoadId(id1,id2,citycode,mlsp);
function myfunc(data){
if(data.error_message != undefined){
alert(data.error_message);
MapABC 地图应用程序编程接口-用户手册
北京图盟科技有限公司
}else{
//解析返回数据
}
}
54.4.3 roadCrossSearchByRoadName(roadName1,roadName2,city,options)
说明:
通过道路名称查询两条道路的交叉路口。
参数:
(1)roadName1:
说明:第一条道路名称。必填。
类型:string。
(2)roadName2:
说明:第二条道路名称。必填。
类型:string。
(2)city:
说明:城市编号或者城市名称。必填。
类型:string。
(3)options:
说明:道路搜索输入参数对象,非必填,参见 MRoadSearchOptions 类。
类型:MRoadSearchOptions。本方法使用到 MRoadSearchOptions 中属性:
(a)resType,返回格式
(b)roadLevel,道路等级
返回值:
JSON 或 XML。
返回结果说明:
以 XML 为例:
<?xml version="1.0" encoding="GB2312" ?>
<spatial_response type="searchresult">
<searchresult>
<searchtime>68</searchtime>
<count>2</count>
<list type="list">
<poi>
<match />
<type />
<id />
<citycode />
<extid />
<pguid />
<timestamp />
<name />
MapABC 地图应用程序编程接口-用户手册
北京图盟科技有限公司
<srctype />
<gridcode />
<address />
<tel />
<icon />
<url />
<buscode />
<distance>0</distance>
<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 ="海淀南路";
var mls = new MRoadSearch();
var mlsp= new MRoadSearchOptions();
mls.setCallbackFunction(myfunc);
mls.roadCrossSearchByRoadName(name1,name2,citycode,mlsp);
function myfunc(data){
if(data.error_message != undefined){
alert(data.error_message);
}else{
//解析返回数据
}
}
54.4.4 allRoadCrossSearchByRoadName(roadName,city,options)
说明:
查询一条道路上所有交叉路口的位置信息。
参数:
(1)roadName:
MapABC 地图应用程序编程接口-用户手册
北京图盟科技有限公司
说明:道路名称。必填。
类型:string。
(2)city:
说明:城市编号或者城市名称。必填。
类型:string。
(3)options:
说明:道路搜索输入参数对象,非必填,参见 MRoadSearchOptions 类。
类型:MRoadSearchOptions。本方法使用到 MRoadSearchOptions 中属性:
(a)resType,返回格式
(b)keyType,预留字段
返回值:
JSON 或 XML。
返回结果说明:
以 XML 为例:
<?xml version="1.0" encoding="GB2312"?>
<spatial_response type="searchresult" servername="search1-1">
<searchresult>
<searchtime>27</searchtime>
<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 = "北三环";
var mls = new MRoadSearch();
var mlsp= new MRoadSearchOptions();
mls.setCallbackFunction(myfunc);
mls.allRoadCrossSearchByRoadName(roadName,citycode,mlsp);
function myfunc(data){
if(data.error_message != undefined){
alert(data.error_message);
}else{
MapABC 地图应用程序编程接口-用户手册
北京图盟科技有限公司
//解析返回数据
}
}
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。
MapABC 地图应用程序编程接口-用户手册
北京图盟科技有限公司
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
说明:
道路等级
取值:
与国家标准的道路等级划分的对应关系如下:
0,代表的标准道路等级 0-11 范围的道路
1,代表的标准道路等级 2-11 范围的道路
2,代表的标准道路等级 7-11 范围的道路
3,代表的标准道路等级 9-11 范围的道路
国家标准的道路等级划分共 12 级,参考如下:
MapABC 地图应用程序编程接口-用户手册
北京图盟科技有限公司
0,图廓线 未命名道路
1,非导航道路
2,普通道路
3,次要道路
4,县乡村内部道路
5,乡公路
6, 县道
7, 主要道路
8, 主要大街、城市快速道
9, 省道
10, 国道
11, 高速公路
类型:
number。
55.4.7 requestMethod
说明:
请求方式
取值:
get,get 请求方式(默认)
post,post 请求方式
类型:
String
55.5 方法
无
55.6 示例
var mgco = new MReGeocodeSearchOptions();
mgco.resType="xml";
mgco.roadLevel=3;
56 MSpatialSearch()
56.1 说明
封装了所有空间查询计算方法。
MapABC 地图应用程序编程接口-用户手册
北京图盟科技有限公司
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)
说明:
判断一个点与几何区域的相对位置。目前支持的几何区域包括多边形、圆形、矩形。
参数:
(1)regionType:
说明:区域类型。必填。
取值:MOverlay.TYPE_POLYGON,多边形
MOverlay.TYPE_CIRCLE,圆形
MOverlay.TYPE_RECTANGLE,矩形
类型:constant。
(2)poiXY:
说明:点坐标。必填。
类型:MLngLat。
(3)regionXY:
说明:区域坐标。必填。
类型:MLngLats。
注释:矩形和圆形为外切矩形的左下右上坐标,多边形为顶点坐标
(4)options:
说明:空间查询计算输入参数对象,非必填,参见 MSpatialSearchOptions 类。
类型:MSpatialSearchOptions。本方法使用到 MSpatialSearchOptions 中属性:
(a)resType,返回格式
(b)buffer,缓冲区范围
返回值:
JSON 或 XML。
MapABC 地图应用程序编程接口-用户手册
北京图盟科技有限公司
返回结果说明:
以 XML 为例:
<?xml version="1.0" encoding="GB2312" ?>
<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);
function myfunc(data){
if(data.error_message != undefined){
alert(data.error_message);
}else{
//解析返回数据
}
}
56.4.2 isMultiPoiInRegion(regionType,multiPoiXY,regionXY,options)
说明:
判断多个点与几何区域的相对位置。目前支持的几何区域包括多边形、圆形、矩形。
参数:
(1)regionType:
说明:区域类型。必填。
取值:MOverlay.TYPE_POLYGON,多边形
MOverlay.TYPE_CIRCLE,圆形
MOverlay.TYPE_RECTANGLE,矩形
类型:constant。
(2)multiPoiXY:
说明:多点坐标。必填。
类型:MLngLats。
MapABC 地图应用程序编程接口-用户手册
北京图盟科技有限公司
(3)regionXY:
说明:区域坐标。必填。
类型:MLngLats。
注释:矩形和圆形为外切矩形的左下右上坐标,多边形为顶点坐标
(4)options:
说明:空间查询计算输入参数对象,非必填,参见 MSpatialSearchOptions 类。
类型:MSpatialSearchOptions。本方法使用到 MSpatialSearchOptions 中属性:
(a)resType,返回格式
(b)buffer,缓冲区范围
(c)coorType,坐标类型
返回值:
JSON 或 XML。
返回结果说明:
以 XML 为例:
<?xml version="1.0" encoding="GB2312" ?>
<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 arr1 = new Array();
arr1.push(new MLngLat("116.3544845","39.98882653"));
arr1.push(new MLngLat("116.344845","39.8882653"));
var lls1 = new MLngLats(arr1);
mss.setCallbackFunction(myfunc);
mss.isMultiPoiInRegion(MOverlay.TYPE_CIRCLE,lls1,lls,option);
function myfunc(data){
if(data.error_message != undefined){
alert(data.error_message);
}else{
//解析返回数据
}
}
MapABC 地图应用程序编程接口-用户手册
北京图盟科技有限公司
56.4.3 calculaDistance(PoiXY1,PoiXY2,lineXY,options)
说明:
计算两点之间、点到线的最短距离、线的长度。
参数:
(1)PoiXY1:
说明:点 1 坐标。
类型:MLngLat。
注释:计算两点距离或者点到线最短距离时不得为 null;计算线长度时为 null
(2)PoiXY2:
说明:点 2 坐标。
类型:MLngLat。
注释:计算两点距离时不得为空,计算点到线最短距离或者线长度时为 null
(3)lineXY:
说明:线坐标。
类型:MLngLats。
注释:计算点到线最短距离或者线长度时不得为空,计算两点距离时为 null
(4)options:
说明:空间查询计算输入参数对象,非必填,参见 MSpatialSearchOptions 类。
类型:MSpatialSearchOptions。本方法使用到 MSpatialSearchOptions 中属性:
(a)resType,返回格式
返回值:
JSON 或 XML。
返回结果说明:
(1)两点距离,以 XML 为例:
<?xml version="1.0" encoding="gbk" ?>
<Distance>8411</Distance>
(2)点到线的最短距离,以 XML 为例:
<?xml version="1.0" encoding="gbk" ?>
<distance>
<length>23850</length>
<list type="list">
<seg>
<x>116.281</x>
<y>39.8881</y>
</seg>
</list>
</distance>
(3)线的长度,以 XML 为例:
<?xml version="1.0" encoding="gbk" ?>
<distance>
<length>8411</length>
MapABC 地图应用程序编程接口-用户手册
北京图盟科技有限公司
<list type="list">
<seg>
<length>8411</length>
</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);
function myfunc(data){
if(data.error_message != undefined){
alert(data.error_message);
}else{
//解析返回数据
}
}
56.4.4 calculaBufferZone(lineArr,options)
说明:
计算缓冲区范围边界坐标。
参数:
(1)lineArr:
说明:线坐标数组,可以是多条线。
类型:MLngLats 数组。
注释:计算两点距离或者点到线最短距离时不得为 null;计算线长度时为 null
(2)options:
说明:空间查询计算输入参数对象,非必填,参见 MSpatialSearchOptions 类。
类型:MSpatialSearchOptions。本方法使用到 MSpatialSearchOptions 中属性:
(a)resType,返回格式
(b)buffer,缓冲区
(c)range,缓冲范围
返回值:
JSON 或 XML。
返回结果说明:
以 XML 为例:
<?xml version="1.0" encoding="GB2312" ?>
MapABC 地图应用程序编程接口-用户手册
北京图盟科技有限公司
<spatial_response type="searchresult" servername="172.17.33.89">
<searchresult>
<searchtime>0</searchtime>
<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(",");
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 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();
MapABC 地图应用程序编程接口-用户手册
北京图盟科技有限公司
a.push(lineXY2);
a.push(lineXY1);
mrs.setCallbackFunction(myfunc);
mrs.calculaBufferZone(a,options);
function myfunc(data){
if(data.error_message != undefined){
alert(data.error_message);
}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(默认)
MapABC 地图应用程序编程接口-用户手册
北京图盟科技有限公司
XML
类型:
string。
57.4.2 buffer
说明:
缓冲区。
类型:
number。
57.4.3 range
说明:
缓冲区范围。
类型:
number。
57.4.4 coorType
说明:
坐标类型。
类型:
number。
57.4.5 requestMethod
说明:
请求方式
取值:
get,get 请求方式(默认)
post,post 请求方式
类型:
String
57.5 方法
无
MapABC 地图应用程序编程接口-用户手册
北京图盟科技有限公司
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:
MapABC 地图应用程序编程接口-用户手册
北京图盟科技有限公司
说明:第二个经纬度真实坐标。可以为 null。
类型:MLngLat。
(3)options:
说明:坐标处理输入参数对象,非必填,参见 MCoordinateSearchOptions 类。
类型:MCoordinateSearchOptions。本方法使用到 MCoordinateSearchOptions 中属性:
(a)resType,返回格式
(b)cr,是否返回 gridCode
(c)ver,版本号
返回值:
JSON 或 XML。
注释:
此方法仅支持 get 请求方式,并且最多只可偏转两个坐标。
返回结果说明:
以 XML 为例:
<?xml version="1.0" encoding="GBK" ?>
<rgc_result type="list" servername="60.247.103.19">
<Item>
<x>KIUNOPMKQOHHHI</x>
<y>MQMXGQHSULLHI</y>
<gridcode>5916566401</gridcode>
</Item>
<Item>
<x>KIUNPPLSLSLLLI</x>
<y>MPMXNPMPMHHHI</y>
<gridcode>5816274211</gridcode>
</Item>
</rgc_result>
示例:
var mrs = new MCoordinateSearch();
var opt = new MCoordinateSearchOptions();
var startXY= new MLngLat(115.797,39.9957);
mrs.setCallbackFunction(myfunc);
mrs.GPSToOffsetGet(startXY,null,opt);
function myfunc(data){
if(data.error_message != undefined){
alert(data.error_message);
}else{
//解析返回数据
}
}
MapABC 地图应用程序编程接口-用户手册
北京图盟科技有限公司
58.4.2 GPSToOffsetPost(multiPoiXY,options)
说明:
将一组真实的 GPS 坐标转换为偏移坐标。
参数:
(1)multiXY:
说明:一组经纬度真实坐标。必填。
类型:MLngLats。
(2)options:
说明:坐标处理输入参数对象,非必填,参见 MCoordinateSearchOptions 类。
类型:MCoordinateSearchOptions。本方法使用到 MCoordinateSearchOptions 中属性:
(a)resType,返回格式
(b)cr,是否返回 gridCode
返回值:
JSON 或 XML。
注释:
此方法仅支持 post 请求方式,并且可以支持一组经纬度坐标。
返回结果说明:
以 XML 为例:
<?xml version="1.0" encoding="GBK" ?>
<rgc_result type="list">
<Item>
<x>KIUNJRILNQJHLDI</x>
<y>MQMYMVIRLOKHHHM</y>
<gridcode>5916725522</gridcode>
</Item>
<Item>
<x>KIVNHVMSQSJHHDM</x>
<y>MQMRKTMRQLILHHI</y>
<gridcode>5817619311</gridcode>
</Item>
<Item>
<x>KIVNHVMSQQHLDDI</x>
<y>MQMRKTMRRONHHLI</y>
<gridcode>5817619311</gridcode>
</Item>
<Item>
<x>KIVNHVMSQRIDLDE</x>
<y>MQMRKTMRRUIDHDM</y>
<gridcode>5817619311</gridcode>
</Item>
</rgc_result>
MapABC 地图应用程序编程接口-用户手册
北京图盟科技有限公司
示例:
var mrs = new MCoordinateSearch();
var opt = new MCoordinateSearchOptions();
var poi1= new MLngLat(115.797,39.9957);
var poi2= new MLngLat(115.797,39.9957);
var poi3= new MLngLat(115.797,39.9957);
var arr=new Array();
arr.push(poi1);
arr.push(poi2);
arr.push(poi3);
mrs.setCallbackFunction(myfunc);
mrs.GPSToOffsetPost(arr,opt);
function myfunc(data){
if(data.error_message != undefined){
alert(data.error_message);
}else{
//解析返回数据
}
}
58.4.3 pathCorrection(poiXY,radian,city,options)
说明:
道路纠偏。
参数:
(1)poiXY:
说明:点经纬度坐标。必填。
类型:MLngLat。
(2)radian:
说明:GPS 设备角度。必填。
类型:number。
(3)city:
说明:城市编号或者城市名称。必填。
类型:string。
(4)options:
说明:坐标处理输入参数对象,非必填,参见 MCoordinateSearchOptions 类。
类型:MCoordinateSearchOptions。本方法使用到 MCoordinateSearchOptions 中属性:
(a)resType,返回格式
(b)angle,角度误差
(c)range,纠偏最大范围
(d)flag,是否返回明码坐标
返回值:
JSON 或 XML。
注释:
MapABC 地图应用程序编程接口-用户手册
北京图盟科技有限公司
此方法仅支持单点,不支持多点。
返回结果说明:
以 XML 为例:
<?xml version="1.0" encoding="utf-8" ?>
<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;
var mrs = new MCoordinateSearch();
var opt = new MCoordinateSearchOptions();
var startXY= new MLngLat(116.33528,39.88615);
mrs.setCallbackFunction(myfunc);
mrs.pathCorrection(startXY,radian,city,opt);
function myfunc(data){
if(data.error_message != undefined){
alert(data.error_message);
}else{
//解析返回数据
}
}
58.4.4 fromLngLatToPixel(LngLats,centerPoiXY,zoom,mapSize,options)
说明:
从经纬度坐标转化为屏幕像素坐标。
参数:
(1)lnglats:
说明:单个或者多个经纬度坐标。必填。
类型:MLngLats。
(2)centerPoiXY:
说明:地图中心点坐标。必填。
类型:MLngLat。
(3)zoom:
说明:地图 zoom 级别。必填。
类型:number。
(4)mapSize:
说明:地图尺寸。必填。
MapABC 地图应用程序编程接口-用户手册
北京图盟科技有限公司
类型:MSize。
(5)options:
说明:坐标处理输入参数对象,非必填,参见 MCoordinateSearchOptions 类。
类型:MCoordinateSearchOptions。本方法使用到 MCoordinateSearchOptions 中属性:
(a)resType,返回格式
返回值:
JSON 或 XML。
返回结果说明:
以 XML 为例:
<?xml version="1.0" encoding="GBK" ?>
<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);
var arr1 = coor.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 lls = new MLngLats(arr);
var mrs = new MCoordinateSearch();
var opt = new MCoordinateSearchOptions();
mrs.setCallbackFunction(myfunc);
mrs.fromLngLatToPixel(lls,cenxy,zoom,size,opt)
function myfunc(data){
if(data.error_message != undefined){
MapABC 地图应用程序编程接口-用户手册
北京图盟科技有限公司
alert(data.error_message);
}else{
//解析返回数据
}
}
58.4.5 fromPixelToLngLat(Pixels, centerPoiXY,zoom, mapSize ,options)
说明:
从经纬度坐标转化为屏幕像素坐标。
参数:
(1)pixels:
说明:屏幕像素坐标,可以是多个。必填。
类型:MPoint 数组。
(2)centerPoiXY:
说明:地图中心点坐标。必填。
类型:MLngLat。
(3)zoom:
说明:地图 zoom 级别。必填。
类型:number。
(4)mapSize:
说明:地图尺寸。必填。
类型:MSize。
(5)options:
说明:坐标处理输入参数对象,非必填,参见 MCoordinateSearchOptions 类。
类型:MCoordinateSearchOptions。本方法使用到 MCoordinateSearchOptions 中属性:
(a)resType,返回格式
返回值:
JSON 或 XML。
返回结果说明:
以 XML 为例:
<?xml version="1.0" encoding="GBK" ?>
<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>
MapABC 地图应用程序编程接口-用户手册
北京图盟科技有限公司
</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 arr1 = coor.split(",");
var arr =new Array();
for(var i = 0 ;i<=arr1.length-2;){
var mll =new MPoint(arr1[i],arr1[i+1]);
arr.push(mll);
i=i+2;
}
var mrs = new MCoordinateSearch();
var opt = new MCoordinateSearchOptions();
mrs.setCallbackFunction(myfunc);
mrs.fromPixelToLngLat(arr,cenxy,zoom,size,opt)
function myfunc(data){
if(data.error_message != undefined){
alert(data.error_message);
}else{
//解析返回数据
}
}
59 MCoordinateSearchOptions()
59.1 说明
坐标处理参数选项类。
59.2 命名空间
com.mapabc.search.api.MCoordinateSearchOptions。
MapABC 地图应用程序编程接口-用户手册
北京图盟科技有限公司
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。
MapABC 地图应用程序编程接口-用户手册
北京图盟科技有限公司
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。
59.4.7 requestMethod
说明:
请求方式
取值:
get,get 请求方式(默认)
post,post 请求方式
类型:
String
MapABC 地图应用程序编程接口-用户手册
北京图盟科技有限公司
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)
说明:
根据城市查询天气预报。
参数:
MapABC 地图应用程序编程接口-用户手册
北京图盟科技有限公司
(1)city:
说明:城市编号或者城市名称。必填。
类型:string。
(2)options:
说明:查询工具参数对象,非必填,参见 MSearchToolOptions 类。
类型:MSearchToolOptions。本方法使用到 MSearchToolOptions 中属性:
(a)resType,返回格式
(b)ver,版本号
返回值:
JSON 或 XML。
返回结果说明:
以 XML 为例:
<?xml version="1.0" encoding="GBK" ?>
<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>
<citycode>010</citycode>
<adcode>110000</adcode>
<cityname>北京市</cityname>
<pcityname>北京市</pcityname>
MapABC 地图应用程序编程接口-用户手册
北京图盟科技有限公司
<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>
<temperature>17</temperature>
<wind_direction>微风</wind_direction>
<wind_power>小于 3</wind_power>
</weatherbean>
</weatherlist>
</cityweather>
</weather>
示例:
var citycode = 010;
var mws =new MSearchTools();
mws.setCallbackFunction(myfunc);
mws.weatherSearchByCity(citycode);
function myfunc(data){
if(data.error_message != undefined){
alert(data.error_message);
}else{
//解析返回数据
}
}
60.4.2 weatherSearchByAdCode(adCode,options)
说明:
根据地区代码查询天气预报。
参数:
(1)adCode:
说明:地区代码。必填。
类型:string。
(2)options:
MapABC 地图应用程序编程接口-用户手册
北京图盟科技有限公司
说明:查询工具参数对象,非必填,参见 MSearchToolOptions 类。
类型:MSearchToolOptions。本方法使用到 MSearchToolOptions 中属性:
(a)resType,返回格式
(b)ver,版本号
返回值:
JSON 或 XML。
返回结果说明:
以 XML 为例:
<?xml version="1.0" encoding="GBK" ?>
<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>
<citycode>010</citycode>
<adcode>110000</adcode>
<cityname>北京市</cityname>
<pcityname>北京市</pcityname>
<aliasname>北京</aliasname>
<x>116.405285</x>
<y>39.904989</y>
<weatherlist type="list">
MapABC 地图应用程序编程接口-用户手册
北京图盟科技有限公司
<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>
<temperature>17</temperature>
<wind_direction>微风</wind_direction>
<wind_power>小于 3</wind_power>
</weatherbean>
</weatherlist>
</cityweather>
</weather>
示例:
var adCode = "130627";
var mws =new MSearchTools();
mws.setCallbackFunction(myfunc);
mws.weatherSearchByAdCode(adCode);
function myfunc(data){
if(data.error_message != undefined){
alert(data.error_message);
}else{
//解析返回数据
}
}
60.4.3 weatherSearchByPoi(poiXY,options)
说明:
根据经纬度坐标查询天气预报。
参数:
(1)poiXY:
说明:经纬度坐标。必填。
类型:Mlnglat。
(2)options:
说明:查询工具参数对象,非必填,参见 MSearchToolOptions 类。
类型:MSearchToolOptions。本方法使用到 MSearchToolOptions 中属性:
(a)resType,返回格式
(b)ver,版本号
MapABC 地图应用程序编程接口-用户手册
北京图盟科技有限公司
返回值:
JSON 或 XML。
返回结果说明:
以 XML 为例:
<?xml version="1.0" encoding="GBK" ?>
<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>
<citycode>010</citycode>
<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>
MapABC 地图应用程序编程接口-用户手册
北京图盟科技有限公司
<wind_direction>微风</wind_direction>
<wind_power>小于 3</wind_power>
</weatherbean>
<weatherbean>
<time>2010-05-19 20:00:00</time>
<des>晴</des>
<temperature>17</temperature>
<wind_direction>微风</wind_direction>
<wind_power>小于 3</wind_power>
</weatherbean>
</weatherlist>
</cityweather>
</weather>
示例:
var poiXY = new MLngLat("OMPIWOWOJJPNLNG","QLMKPSOKLPLJHNG");
var mws =new MSearchTools();
mws.setCallbackFunction(myfunc);
mws.weatherSearchByPoi(poiXY);
function myfunc(data){
if(data.error_message != undefined){
alert(data.error_message);
}else{
//解析返回数据
}
}
60.4.4 addressSearchByIP(ip,options)
说明:
根据 IP 地址查询具体详细地址。
参数:
(1)ip:
说明:ip 地址。必填。
类型:string。
(2)options:
说明:查询工具参数对象,非必填,参见 MSearchToolOptions 类。
类型:MSearchToolOptions。本方法使用到 MSearchToolOptions 中属性:
(a)resType,返回格式
返回值:
JSON 或 XML。
返回结果说明:
以 XML 为例:
MapABC 地图应用程序编程接口-用户手册
北京图盟科技有限公司
<?xml version="1.0" encoding="GBK" ?>
<ip>
<address>北京市互联通</address>
<x>JPOHKTPOIIQJNJN</x>
<y>MOGLLNQNHQLJJJF</y>
<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>
</City>
<District ver="1.0">
<name>昌平区</name>
<code>110114</code>
<x />
<y />
<bounds />
</District>
<roadList type="list">
<Road ver="1.0">
<id>001090935</id>
<name>(未命名道路)</name>
<direction>EastNorth</direction>
<distance>85.593567</distance>
<width>0</width>
<ename>(unnamed road)</ename>
<spatial_geo type="Line">
<coor />
<buffer>0</buffer>
</spatial_geo>
</Road>
</roadList>
<poiList type="list" />
<crossPoiList type="list">
<cross>
<name>(未命名道路)-(未命名道路)</name>
</cross>
</crossPoiList>
</SpatialBean>
</ip>
MapABC 地图应用程序编程接口-用户手册
北京图盟科技有限公司
示例:
var ip ="211.157.3.182";
var mws =new MSearchTools();
mws.setCallbackFunction(myfunc);
mws.addressSearchByIP(ip);
function myfunc(data){
if(data.error_message != undefined){
alert(data.error_message);
}else{
//解析返回数据
}
}
60.4.5 cityInfoSearchByCity(city,option)
说明:
根据城市代码,包括城市编号、城市名称和城市区号查询城市的信息。
参数:
(1)city:
说明:城市编号或者城市名称。必填。
类型:string。
(2)options:
说明:查询工具参数对象,非必填,参见 MSearchToolOptions 类。
类型:MSearchToolOptions。本方法使用到 MSearchToolOptions 中属性:
(a)resType,返回格式
返回值:
JSON 或 XML。
返回结果说明:
以 XML 为例:
<?xml version="1.0" encoding="GBK" ?>
<City ver="1.0">
<list type="list">
<City>
<name>北京</name>
<telnum>010</telnum>
<x>fjtekqrposNKGE</x>
<y>hrlphplnJOOE</y>
<districttable>{}</districttable>
<province_name>北京市</province_name>
</City>
<City>
<name>上海</name>
MapABC 地图应用程序编程接口-用户手册
北京图盟科技有限公司
<telnum>021</telnum>
<x>fkoelopplrJOGE</x>
<y>hjlijlnlnNOOI</y>
<districttable>{}</districttable>
<province_name>上海市</province_name>
</City>
<City>
<name>长沙</name>
<telnum>0731</telnum>
<x>fjqehhtjouNOOM</x>
<y>gqlihpomsNKGM</y>
<districttable>{}</districttable>
<province_name>湖南省</province_name>
</City>
</list>
</City>
示例:
var citycode = 010;
var mws =new MSearchTools();
mws.setCallbackFunction(myfunc);
mws.cityInfoSearchByCity(citycode);
function myfunc(data){
if(data.error_message != undefined){
alert(data.error_message);
}else{
//解析返回数据
}
}
60.4.6 districtSearchByNameAndCode(searchType,name,code,options)
说明:
根据省市区名称及编码,查询省市区详细信息。
参数:
(1)searchType:
说明:查询类型。必填。
取值:province,省查询
city,市查询
district,区查询
类型:string。
(2)name:
说明:地区名称
取值:XX 省,XX 市,XX 自治州,XX 区,XX 县等。必填。
MapABC 地图应用程序编程接口-用户手册
北京图盟科技有限公司
类型:string。
(3)code:
说明:省市编码。如果是省和市查询需要填入省编号;如果是区县查询,需要填入
市编号。必填。
类型:string。
(4)options:
说明:查询工具参数对象,非必填,参见 MSearchToolOptions 类。
类型:MSearchToolOptions。本方法使用到 MSearchToolOptions 中属性:
(a)resType,返回格式
返回值:
JSON 或 XML。
返回结果说明:
以 XML 为例:
<?xml version="1.0" encoding="GB2312" ?>
<china>
<province_list type="list">
<province>
<name>北京市</name>
<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.setCallbackFunction(myfunc);
mrs.districtSearchByNameAndCode(type,name,code);
function myfunc(data){
if(data.error_message != undefined){
alert(data.error_message);
}else{
//解析返回数据
}
}
MapABC 地图应用程序编程接口-用户手册
北京图盟科技有限公司
60.4.7 districtSearchByPoiAndZoom(poiXY,zoom,options)
说明:
根据经纬度坐标和 zoom 级别,查询经纬度坐标所在区域的详细信息。
参数:
(1)poiXY:
说明:经纬度坐标。必填。
类型:MLngLat。
(2)zoom:
说明:地图缩放级别
取值:
范围 3 到 17 级
3-6 级,省级行政区域
7-9 级,市级行政区域
10-17 级,区级行政区域
类型:number。
(3)options:
说明:查询工具参数对象,非必填,参见 MSearchToolOptions 类。
类型:MSearchToolOptions。本方法使用到 MSearchToolOptions 中属性:
(a)resType,返回格式
返回值:
JSON 或 XML。
返回结果说明:
以 XML 为例:
<?xml version="1.0" encoding="utf-8" ?>
<china servername="mSIS02" versionname="1.0.7.2">
<province_list type="list">
<province>
<name>北京市</name>
<x>116.408198</x>
<y>39.904667</y>
<code>110000</code>
<bounds>115.420372;39.443252;117.505569;41.060871</bounds>
<ename>BJ</ename>
<englishname>BEIJINGSHI</englishname>
<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>
MapABC 地图应用程序编程接口-用户手册
北京图盟科技有限公司
<englishname>BEIJINGSHI</englishname>
<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>
<englishname>BEIJINGSHI</englishname>
</district>
<district>
……
</district_list>
</city>
</city_list>
</province>
</province_list>
</china>
示例:
var zoom = 17;
var startXY= new MLngLat(115.797,39.9957);
var options= new MSearchToolsOptions();
var mrs = new MSearchTools();
mrs.setCallbackFunction(myfunc);
mrs.districtSearchByPoiAndZoom(startXY,zoom,options);
function myfunc(data){
if(data.error_message != undefined){
alert(data.error_message);
}else{
//解析返回数据
}
}
61 MSearchToolsOptions()
61.1 说明
辅助查询工具类参数选项类。
MapABC 地图应用程序编程接口-用户手册
北京图盟科技有限公司
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。
61.4.3 requestMethod
说明:
请求方式
取值:
MapABC 地图应用程序编程接口-用户手册
北京图盟科技有限公司
get,get 请求方式(默认)
post,post 请求方式
类型:
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();
MapABC 地图应用程序编程接口-用户手册
北京图盟科技有限公司
62.4 方法
62.4.1 poiSearchByPoiId(poiId,serverLayer,options)
说明:
根据 POI 的 ID 号查询动态渲染服务数据层中的 POI 信息。
参数:
(1)poiId:
说明:POI 的 ID 号。必填。
类型:string。
(2)serverLayer:
说明:动态渲染服务数据层 ID 号。必填。
类型:string。
(3)options:
说明:动态渲染查询参数对象,非必填,参见 MDynamicRenderingOptions 类。
类型:MDynamicRenderingOptions。
本方法使用到 MDynamicRenderingOptions 中属性:
(a)resType,返回格式
返回值:
JSON 或 XML。
返回结果说明:
以 XML 为例:
<?xml version="1.0" encoding="GBK" ?>
<searchresult servername="60.247.103.19">
<count>1</count>
<list type="list">
<poi>
<address />
<name>上海南站</name>
<id>19</id>
<type>S</type>
<x>KKJNPQRNRSNMLHH</x>
<y>MJGQQUPMQMNELLD</y>
<extid />
<tel />
<citycode>021</citycode>
<z>3</z>
<xys />
<extendMap>
<price>8.880000114440918</price>
</extendMap>
MapABC 地图应用程序编程接口-用户手册
北京图盟科技有限公司
<featuretype>1</featuretype>
<information />
<puiid>A3000G8I4W415</puiid>
<stylecolor />
<stylewidth />
<thematicvalue>19</thematicvalue>
</poi>
</list>
</searchresult>
示例:
var id = "19";
var layer = "nga_c";
var mls = new MDynamicRendering();
var mlsp= new MDynamicRenderingOptions();
mls.setCallbackFunction(myfunc);
mls.poiSearchByPoiId(id,layer,mlsp);
function myfunc(data){
if(data.error_message != undefined){
alert(data.error_message);
}else{
//解析返回数据
}
}
62.4.2 poiSearchByCenPoi(centerPoiXY,serverLayer,options)
说明:
根据中心点经纬度坐标查询动态渲染服务数据层中的 POI 信息。
参数:
(1)centerPoiXY:
说明:中心点经纬度坐标。必填。
类型:MLngLat。
(2)serverLayer:
说明:动态渲染服务数据层 ID 号。必填。
类型:string。
(3)options:
说明:动态渲染查询参数对象,非必填,参见 MDynamicRenderingOptions 类。
类型:MDynamicRenderingOptions。
本方法使用到 MDynamicRenderingOptions 中属性:
(a)resType,返回格式
(b)range,查询范围
返回值:
MapABC 地图应用程序编程接口-用户手册
北京图盟科技有限公司
JSON 或 XML。
返回结果说明:
以 XML 为例:
<?xml version="1.0" encoding="GBK" ?>
<searchresult servername="60.247.103.19">
<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 />
<citycode>021</citycode>
<z>0</z>
<xys>KKJNTOMPWMILHH,MJGQQUJMQILHD,KKJNTOKTVMIHHL </xys>
<extendMap>
<price>8.880000114440918</price>
</extendMap>
<featuretype>2</featuretype>
<information />
<puiid>A3000G8ID39B8</puiid>
<stylecolor>#36B854</stylecolor>
<stylewidth />
<thematicvalue>276</thematicvalue>
</poi>
</list>
</searchresult>
示例:
var centerPoiXY = new MLngLat(116.3,39.8);
var layer = "nga_c";
var mls = new MDynamicRendering();
var mlsp= new MDynamicRenderingOptions();
mls.setCallbackFunction(myfunc);
mls.poiSearchByCenPoi(centerPoiXY,layer,mlsp);
function myfunc(data){
if(data.error_message != undefined){
alert(data.error_message);
}else{
MapABC 地图应用程序编程接口-用户手册
北京图盟科技有限公司
//解析返回数据
}
}
62.4.3 spatialSearchByRegion(regionXY, serverLayer,options)
说明:
根据多边形顶点经纬度坐标组查询动态渲染服务数据层中的空间数据信息。
参数:
(1)regionXY:
说明:多边形顶点经纬度坐标组。必填。
类型:MLngLats。
(2)serverLayer:
说明:动态渲染服务数据层 ID 号。必填。
类型:string。
(3)options:
说明:动态渲染查询参数对象,非必填,参见 MDynamicRenderingOptions 类。
类型:MDynamicRenderingOptions。
本方法使用到 MDynamicRenderingOptions 中属性:
(a)resType,返回格式
返回值:
JSON 或 XML。
返回结果说明:
以 XML 为例:
<?xml version="1.0" encoding="GBK" ?>
<searchresult servername="60.247.103.19">
<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 />
<citycode>021</citycode>
<z>0</z>
<xys>KKJNTOMPWMMHLL,MJGQQUJMQMHHH,KKJNTOKTVMMLLH </xys>
<extendMap>
<price>8.880000114440918</price>
MapABC 地图应用程序编程接口-用户手册
北京图盟科技有限公司
</extendMap>
<featuretype>2</featuretype>
<information />
<puiid>A3000G8ID39B8</puiid>
<stylecolor>#36B854</stylecolor>
<stylewidth />
<thematicvalue>276</thematicvalue>
</poi>
</list>
</searchresult>
示例:
var poi1= new MLngLat(115.797,39.9957);
var poi2= new MLngLat(115.797,39.9957);
var poi3= new MLngLat(115.797,39.9957);
var arr=new Array();
arr.push(poi1);
arr.push(poi2);
arr.push(poi3);
var layer = "nga_c";
var mls = new MDynamicRendering();
var mlsp= new MDynamicRenderingOptions();
mls.setCallbackFunction(myfunc);
mls.spatialSearchByRegion(arr,layer,mlsp);
function myfunc(data){
if(data.error_message != undefined){
alert(data.error_message);
}else{
//解析返回数据
}
}
63 MDynamicRenderingOptions()
63.1 说明
动态渲染查询参数选项类。
63.2 命名空间
com.mapabc.search.api.MDynamicRenderingOptions。
MapABC 地图应用程序编程接口-用户手册
北京图盟科技有限公司
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。
63.4.3 requestMethod
说明:
请求方式
取值:
get,get 请求方式(默认)
post,post 请求方式
类型:
String
MapABC 地图应用程序编程接口-用户手册
北京图盟科技有限公司
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 不存在(没申请或被注销).