MapABC首页 > 地图 API > API类参考
左侧导航
MapABC地图API类参考
下面是类的定义说明,构造方法、属性、方法等:
MMap MEventControl MMapViews
MMapMode MGeometry MLatLng
MMapOptions MStyle MOverlay
MPointOverlay MPolylineOverlay MPolygonOverlay
MCircleOverlay MRectOverlay MRegularPolygonOverlay
MCustomPointOverlay    

MMap类

  地图类封装了Flash地图组件,对地图的操作都是通过它完成。仅仅创建一个MMap对象就可以在页面中显示地图,实现基本的地图功能。
构造方法返回顶部
构造方法 参数 说明
MMap(containerId, options) containerId:说明:装载地图组件的容器ID,例如<div>标签的ID。类型:String
options:说明:地图初始化时的参数。类型:MMapOptions

创建一个MMap对象,显示Flash地图。

MEventControl 继承 MMap


方法 类型 说明
EVENT_MAP_INITIALIZED String 静态属性,表示onMapInited事件
EVENT_MAP_ZOOMED String 静态属性,表示onMapZoomed事件
EVENT_MAP_MOVED String 静态属性,表示onMapMoved事件
EVENT_MAP_DBCLICK String 静态属性,表示onMapDoubleClick事件
EVENT_POINT_DRAWN String 静态属性,表示onPointdrawn事件
EVENT_POLYLINE_DRAWN String 静态属性,表示onPolylineDrawn事件
EVENT_RECT_DRAWN String 静态属性,表示onRectdrawn事件
EVENT_POLYGON_DRAWN String 静态属性,表示onPolygonDrawn事件
EVENT_CIRCLE_DRAWN String 静态属性,表示onCircleDrawn事件
EVENT_REGULARPOLYGON_DRAWN String 静态属性,表示onRegularpolygonDrawn事件
EVENT_GET_MAP_BOUNDS String 静态属性,表示onGetMapBoundCallback事件
EVENT_GET_COORD_MAP_TO_SCREEN String 静态属性,表示onGetXYByLonLatCallBack事件
EVENT_RADAR_INITIALIZED String 静态属性,表示onRadarInited事件
EVENT_RADAR_ANGLECHANGED String 静态属性,表示onRadarAngleChanged事件
EVENT_RADAR_POSCHANGED String 静态属性,表示onRadarPosChanged事件
EVENT_GEOMEtrY_CREATED String 静态属性,表示onGeometryCreated事件
EVENT_GEOMEtrY_CHANGED String 静态属性,表示onGeometryChanged事件
EVENT_GEOMEtrY_REMOVED String 静态属性,表示onGeometryRemoved事件
EVENT_EXPORT_MAP_DATA String 静态属性,表示onExportMapData事件
EVENT_POINT_CLICKED String 静态属性,表示onPressPoint事件
EVENT_POLYLINE_CLICKED String 静态属性,表示onPressLine事件
EVENT_POLYGON_CLICKED String 静态属性,表示onPressPolygon事件
EVENT_MAP_CLICK String 静态属性,表示onMapClick事件
EVENT_POPUP_MENU_CLICK String 静态属性,表示onPopupMenuClick事件

方法
地图操作API返回顶部
方法 返回类型 参数 说明
isInitialized() boolean 检查地图是否已经初始化完成.初始化完成true,未完成返回false
setZoomLevel(zoomLevel) boolean zoomLevel:类型为整数,范围为从3到17 设置地图zoom级别. 初始化完成true,未完成返回false
getZoomLevel() int 返回地图的zoom级别.返回值为地图当前的zoom值,范围为从3到17
setCenterByLatLng(lat, lng)

lat: 说明:中心的纬度,加密坐标

lat 类型:字符串

lng: 说明:中心的经度,加密坐标

lng 类型:字符串

设置地图的中心点。注意经度、纬度的顺序。
getCenterByLatLng() 地图的中心点
类型:MLatLng
返回地图的中心点
setZoomAndCenter(zoomLevel, center)

zoomLevel 说明:缩放级别

zoomLevel 类型:字符串

center 说明:中心点的坐标

center 类型:MLatLng

设置地图的缩放级别和中心点。
getMapBounds() 取地图的边界,本方法并不直接返回地图边界的结果,而是通过MMap.EVENT_GET_MAP_BOUNDS事件返回。
frameZoomIn() 进入拉框放大状态。点击右键菜单或者执行quitMouseDraw()方法后停止。
frameZoomOut() 进入拉框缩小状态。点击右键菜单或者执行quitMouseDraw()方法后停止
pan(dir,step,speed)

dir : 平移方向 "up"、"down"、"left"、"right"、表示上、下、左、右四个方向。

step : 移动的步长,每次移动的像素。

speed: 移动的速度。

移动地图。
measure() 进入测距状态。双击鼠标或点击右键菜单或者执行quitMouseDraw()方法后停止。
showNavigator(isShow)

isShow:说明:true为显示鹰眼,false为隐藏鹰眼

类型:Boolean

设置鹰眼的可见性,显示或隐藏鹰眼。鹰眼缺省是关闭的。
setCompassScale(scale)

scale:说明:工具栏的大小比例,是一个表示百分比的数字。

类型:Number范围:50-100

设置工具栏的大小比例。
setCompassScale(scale)

scale 说明:工具栏的大小比例,是一个表示百分比的数字。

类型:Number范围:50-100

设置工具栏的大小比例。
addPopupMenuItem(itemName, itemId)

itemName:菜单项名称

itemId:菜单项ID,

itemId 说明:对FMP的右键菜单中增加自定义的菜单项

FMP右键菜单设置功能,增加一个右键菜单项
removePopupMenuItem(itemId)

itemId:菜单项ID

说明:对FMP的右键菜单中删除自定义的菜单项

FMP右键菜单设置功能,删除一个右键菜单项
setMapColor(flashColor)

flashColor:地图的底色值。

说明:值以JSON串的形式进行设定

ra 是红色成分的百分比(-100 到 100);

rb 是红色成分的偏移量(-255 到 255);

ga 是绿色成分的百分比(-100 到 100);

gb 是绿色成分的偏移量(-255 到 255);

ba 是蓝色成分的百分比(-100 到 100);

bb 是蓝色成分的偏移量(-255 到 255);

aa 是 Alpha 的百分比(-100 到 100);

ab 是 Alpha 的偏移量(-255 到 255)

更改地图的底色

辅助API返回顶部
方法 返回类型 参数 说明
getCoordMapToScreen(lng, lat)

lng 说明:经度。

lng 类型:浮点数。
lat 说明:经度。

lat 类型:浮点数 。

地理坐标到屏幕坐标转换,本方法并不直接返回转换的结果,由MMap.EVENT_GET_COORD_MAP_TO_SCREEN事件返回。屏幕坐标的中心点为(128,128),X坐标向左递减,向右递增;Y坐标向上递减,向下递增。

事件API返回顶部
方法 返回类型 参数 说明
switchEvent
(eventName, status)

eventName 说明:事件名称。

eventName 类型:String
status 说明:true为允许触发该事件,false为禁止触发该事件。

status 类型:Boolean 。

设置是否允许触发某个事件
switchDefaultdB ClickProcessor(status)

status 说明:true为允许缺省双击处理,false为禁止双击处理。

类型:Boolean 。

设置是否允许缺省鼠标双击处理,缺省的鼠标双击处理操作是放大地图。

绘图API返回顶部
方法 返回类型 参数 说明
addOverlay(overlay, sb)

overlay 说明:MOverlay对象的子类,例如MPointOverlay,表示一个点对象。

overlay 类型:MOverlay

sb 说明:是否调整视野。为true则画完Overlay时调整视野,使该Overlay位于地图的中心。缺省为false,不调整视野。目前只对MPointOverlay有效。

sb 类型:Boolean 。

在地图上添加一个MOverlay对象
removeOverlay(overlay)

overlay 说明:MOverlay对象的子类,例如MPointOverlay,表示一个点对象。

类型:MOverlay

删除地图上的一个MOverlay对象
drawPoints(points, sb)

points 说明:要添加的点数组。每个数组元素是一个MPointOverlay对象。

points 类型:数组 。

sb 说明:是否调整视野,true为调整视野;false为不调整视野。

sb 类型:Boolean 。

在地图上批量添加点,添加多个点时使用该方法能提高效率
drawCustomPoints(customPoints, sb)

points 说明:要添加的点数组。每个数组元素是一个MCustomPointOverlay对象。

points 类型:数组。

sb 说明:是否调整视野,true为调整视野;false为不调整视野。

sb 类型:Boolean 。

在地图上批量添加自定义图标点,添加多个点时使用该方法能提高效率
drawBusLine(lineLngs,lineLats
,changeStationLngs, changeStationLats,
startPos, endPos, lineStyle, showDemo)

ineLngs 说明:线路节点经度字符串,每个经度值之间以“,”逗号相隔。

ineLngs 类型:String。

lineLats 说明:线路节点纬度字符串,每个纬度值之间以“,”逗号相隔。

lineLats 类型:String。

changeStationLngs 说明:换乘点的经度坐标字符串,每个经度值之间以“,”逗号相隔。

changeStationLngs 类型:Sting 。 changeStationLats 说明:换乘点的纬度坐标字符串,每个纬度值之间以“,”逗号相隔。

changeStationLats 类型:Sting 。

startPos 说明:起始点。

startPos 类型:MPointOverlay

endPos 说明:终止点。

endPos 类型:MPointOverlay

lineStyle 说明:可选,线路的样式。

lineStyle 类型:MStyle

showDemo 说明:可选,是否显示公交演示如果使用此参数,则lineStyle不可省略。

showDemo 类型:Boolean

showDemo 缺省时:false

在地图上画公交路线,并标注出起始点、终止点和中间的换乘站点
drawDriveLine(lineLngs,lineLats,
startPos,endPos, lineStyle)

ineLngs 说明:线路节点经度字符串,每个经度值之间以“,”逗号相隔。

ineLngs 类型:String。

lineLats 说明:线路节点纬度字符串,每个纬度值之间以“,”逗号相隔。

lineLats 类型:String。

startPos 说明:起始点。

startPos 类型:MPointOverlay

endPos 说明:终止点。

endPos 类型:MPointOverlay

lineStyle 说明:可选,线路的样式。

lineStyle类型:MStyle

在地图上画驾车路线
removePointById(id)

id 说明:点的id

类型:String

根据Id删除在地图上绘制的点Overlay
removePolylineById(id)

id 说明:多折线的id

类型:String

根据Id删除在地图上绘制的多折线Overlay
removeRectById(id)

id 说明:矩形的id

类型:String

根据Id删除在地图上绘制的矩形Overlay
removePolygonById(id)

id 说明:多边形的id

类型:String

根据Id删除在地图上绘制的多边形Overlay
removeCircleById(id)

id 说明:圆的id

类型:String

根据Id删除在地图上绘制的圆Overlay
removeRegularPolygonById(id)

id 说明:正多边形的id

类型:String

根据Id删除在地图上绘制的正多边形Overlay
removeAllPointOverlays() 删除在地图上绘制的全部点Overlay
removeAllPolylineOverlays() 删除在地图上绘制的全部多折线Overlay
removeAllPolygonOverlays() 删除在地图上绘制的全部多边形Overlay
removeAllRectOverlays() 删除在地图上绘制的全部矩形Overlay
removeAllCircleOverlays()  删除在地图上绘制的全部圆形Overlay
removeAllRegularPolygonOverlays() 删除在地图上绘制的全部正多边形Overlay
removeAllOverlays() 删除在地图上绘制的全部Overlay

鼠标绘图API返回顶部
方法 返回类型 参数 说明
beginDrawPointOnMap(style)

style 说明:点的样式。

类型:MStyle

进入鼠标绘图状态,允许用户用鼠标在地图上画点。点击右键菜单或者执行quitMouseDraw()方法后停止
beginDrawPolylineOnMap(style)

style 说明:多折线的样式。

类型:MStyle

进入鼠标绘图状态,允许用户用鼠标在地图上画多折线,每单击一次画多折线的一个节点。双击鼠标或点击右键菜单或者执行quitMouseDraw()方法后停止。
beginDrawRectOnMap(style)

style 说明:矩形的样式。

类型:MStyle

进入鼠标绘图状态,允许用户用鼠标在地图上画矩形,拖动绘制矩形。点击右键菜单或者执行quitMouseDraw()方法后停止。
beginDrawPolygonOnMap(style) style 说明:多边形的样式。类型:MStyle 进入鼠标绘图状态,允许用户用鼠标在地图上画多边形,每单击一次画多边形的一个节点。点击右键菜单或者执行quitMouseDraw()方法后停止。
beginDrawCircleOnMap(style)

style 说明:圆的样式。

类型:MStyle

进入鼠标绘图状态,允许用户用鼠标在地图上画圆,单击一次定位圆心,拖动半径画一个圆。双击鼠标或点击右键菜单或者执行quitMouseDraw()方法后停止。
beginDrawRegularPolygonOnMap
(style)

style 说明:正多边形的样式。

类型:MStyle

进入鼠标绘图状态,允许用户用鼠标在地图上画正多边形,单击一次定位圆心,拖动半径画一个正多边形。点击右键菜单或者执行quitMouseDraw()方法后停止
quitMouseDraw() 停止绘图事件,退出鼠标绘图状态

TIP控制API返回顶部
方法 返回类型 参数 说明
spreadTipById(overlayId)

overlayId 说明:overlay的Id。

类型:String

根据Id,向右展开Overlay的tip
openTipById(overlayId)

overlayId 说明:overlay的Id。

类型:String

根据Id,向下打开Overlay的tip

扩展应用API返回顶部
方法 返回类型 参数 说明
addRadar(angle, color, radius, fovea, closed, coordX, coordY, show)

angle 说明:雷达视野角度。

angle 类型:数字。

angle 范围:0到360度。

color 说明:雷达的视野颜色,RGB颜色格式。

color 类型:16进制整数。

color 范围:0x000000-0xffffff。

radius 说明:雷达的视野半径。

radius 类型:数字。

fovea 说明:雷达的视野夹角。

fovea 类型:数字。

fovea 范围:0到360度

closed 说明:是否关闭雷达。

closed 类型:Boolean。

coordX 说明:雷达的经度,加密坐标

coordX 类型:字符串

coordY 说明:雷达的纬度,加密坐标。

coordY 类型:字符串

show 说明:创建雷达后,是否显示(true显示,false为隐藏)。如果雷达用false隐藏了,可以调用showRadar(show)方法显示。

show 类型:Boolean

在地图上添加的雷达
openRadar(open)

open 说明:控制参数(true为打开雷达,false为关闭雷达)。

类型:Boolean

打开或关闭的雷达
showRadar(show)

show 说明:控制参数(true为显示;false为不显示)。

类型:Boolean

设置是否显示雷达对象
setRadarPos(pos)

pos 说明:雷达的位置。

类型:MLatLng

设置雷达对象的位置
setRadarAngle(angle)

angle 说明:雷达对象的角度。

类型:数字

设置雷达对象的角度
setRadarFov(angle)

angle 说明:张开角度。

类型:数字

设置雷达对象视野的张开角度
setRadarRadius(radius)

radius 说明:视角的半径。

类型:数字

设置雷达对象视野的半径

地图编辑API返回顶部
方法 返回类型 参数 说明
setMapMode(mode)

mode 说明:地图状态。

类型:String。

范围:[MMapMode.EDIT,MMapMode.BROWSE]

设置地图状态。在“浏览”和“编辑”状态之间切换
addGeometry(geometryType, style)

geometryType 说明:几何对象类型。

geometryType 类型:String。

geometryType 范围:

[MGeometry.TYPE_POINT, MGeometry.TYPE_POLYLINE, MGeometry.TYPE_POLYGON] 。

style 说明:几何对象的样式。

style 类型:MStyle

在编辑地图状态下,添加几何对象。执行addGeometry后,用鼠标在地图上标点,或画多折线、多边形
removeGeometryById(id, geometryType)

id 说明:几何对象的id。

id 类型:String

geometryType:说明:几何对象类型

geometryType 类型:String。

geometryType 范围:

[MGeometry.TYPE_POINT, MGeometry.TYPE_POLYLINE, MGeometry.TYPE_POLYGON]

根据id和类型删除几何对象的tip
openGeometryTipById(id, geometryType)

id 说明:几何对象的id。

id 类型:String。

geometryType 说明:几何对象类型。

geometryType 类型:String

geometryType 范围:

[MGeometry.TYPE_POINT, MGeometry.TYPE_POLYLINE, MGeometry.TYPE_POLYGON]

根据id和类型展开几何对象的tip
importMapData(data)

data 说明:导入的数据,是一个JSON字符串。

类型:String

把使用exportMapData方法导出的点、线、面数据导入到当前地图。导入的数据是JSON格式字符串,因此使用此功能时需要在页面里添加一些JSON工具,如prototype.js(1.5.1以后的版本)。注意:不要使用json.js,这个脚本与FMP有冲突
exportMapData() 把当前地图上所有的点、线、面几何对象数据导出。导出的数据是一个JSON字符串,由onExportMapData事件返回
submitPictureURL(gtype,serialId,urls,descs)

gtype 说明:几何对象类型。

gtype 类型:String。

gtype 范围:

[MGeometry.TYPE_POINT, MGeometry.TYPE_POLYLINE, MGeometry.TYPE_POLYGON]

gtype 说明:对象唯一ID。

gtype 类型:String。

urls 说明:图片的URL地址

urls 类型:String

descs 说明:图片的描述

descs 类型:String

将图片的URL提供给MyMaps的编辑点,此方法只针MyMays的地图标注点有效

方法 参数 说明
onMapInited

event.type=”onMapInited” event.args=mapId,zoomLevel,centerLng,centerLat,upperLeftLng,
upperLeftLat,bottomRightLng,bottmRightLat

args的值是一个以“,”分隔的字符串,其中:

mapId:地图的Id

zoomLevel:地图当前的zoom值

centerLng:地图中心点的经度坐标

centerLat:地图中心点的纬度坐标

upperLeftLng:地图左上角经度

upperLeftLat:地图左上角纬度

bottomRightLng:地图右下角经度

bottmRightLat:地图右下角纬度

当地图初始化完成时触发。此时地图可以进行正常操作
onMapZoomed

event.type=”onMapZoomed” event.args=mapId,zoomLevel,centerLng,centerLat,upperLeftLng,
upperLeftLat,bottomRightLng,bottmRightLat

args的值是一个以“,”分隔的字符串,其中:

mapId:地图的Id

zoomLevel:地图当前的zoom值

centerLng:地图中心点的经度坐标

centerLat:地图中心点的纬度坐标

upperLeftLng:地图左上角经度

upperLeftLat:地图左上角纬度

bottomRightLng:地图右下角经度

bottmRightLat:地图右下角纬度

当地图放大或缩小时触发
onMapMoved

event.type=”onMapMoved” event.args=mapId,zoomLevel,centerLng,centerLat,upperLeftLng,
upperLeftLat,bottomRightLng,bottmRightLat

args的值是一个以“,”分隔的字符串,其中:

mapId:地图的Id

zoomLevel:地图当前的zoom值

centerLng:地图中心点的经度坐标

centerLat:地图中心点的纬度坐标

upperLeftLng:地图左上角经度

upperLeftLat:地图左上角纬度

bottomRightLng:地图右下角经度

bottmRightLat:地图右下角纬度

当地图移动时触发
onMapDoubleClick

event.type=”onMapDoubleClick” event.args=mapId,zoomLevel,centerLng,centerLat,blockNo

args的值是一个以“,”分隔的字符串,其中:

mapId:地图的Id

zoomLevel:地图当前的zoom值

centerLng:地图中心点的经度坐标

centerLat:地图中心点的纬度坐标

blockNo:图块编号

当鼠标在地图上双击时发生。FMP缺省的双击事件的处理是放大操作。如果需要,可以在程序中调用switchDefaultdBClickProcessor方法允许或禁止缺省的双击事件处理
onPointdrawn

event.type=”onPointdrawn” event.args=mapId,zoomLevel,pointLng,pointLat,id args的值是一个以“,”分隔的字符串,其中:

mapId:地图的Id

zoomLevel:地图当前的zoom值

pointLng:点的经度坐标

pointLat:点的纬度坐标。

id:点的Id,引擎随机生成的一个guid

当用鼠标在地图上画点时触发
onPolylineDrawn

event.type=”onPolylineDrawn” event.args=mapId,zoomLevel,point1Lng,point1Lat,point2Lng,point2Lat,…… args的值是一个以“,”分隔的字符串,其中:

mapId:地图的Id

zoomLevel:地图当前的zoom值 point1Lng,point1Lat,point2Lng,point2Lat,……:一个坐标序列,表示多折线的每一个节点。节点坐标按照经度在前,纬度在后顺序排列。

id:多折线的Id,引擎随机生成的一个guid

当用鼠标在地图上画完一条多折线时触发
onRectdrawn

event.type=”onRectdrawn” event.args=mapId,zoomLevel,point1Lng,point1Lat,point2Lng,point2Lat,id args的值是一个以“,”分隔的字符串,其中:

mapId:地图的Id

zoomLevel:地图当前的zoom值

point1Lng,point1Lat,point2Lng,point2Lat:表示矩形对角线上的两个顶点。每对坐标都是经度在前,纬度在后。 根据鼠标画矩形时的顺序,这两个点有可能为左上和右下或者右上和左下。

id:矩形的Id,引擎随机生成的一个guid

当用鼠标在地图上画完一个矩形时触发
onPolygonDrawn

event.type=”onPolygonDrawn” event.args=mapId,zoomLevel,point1Lng,point1Lat,point2Lng,point2Lat,……,id args的值是一个以“,”分隔的字符串,其中:

mapId:地图的Id

zoomLevel:地图当前的zoom值 point1Lng,point1Lat,point2Lng,point2Lat,……:一个坐标序列,表示多边形的每一个顶点。节点坐标按照经度在前,纬度在后顺序排列。

id:多边形的Id,引擎随机生成的一个guid

当用鼠标在地图上画完一个多边形时触发
onCircleDrawn

event.type=”onCircleDrawn” event.args=mapId,zoomLevel,point1Lng,point1Lat,point2Lng,point2Lat,dx,dy,id args的值是一个以“,”分隔的字符串,其中:

mapId:地图的Id

zoomLevel:地图当前的zoom值

point1Lng,point1Lat,point2Lng,point2Lat:两对坐标,第一对是圆心坐标,第二对是圆的外接矩形的一个顶点。 每对坐标都是经度在前,纬度在后。根据鼠标画圆形时的顺序,第二对坐标可能为外接矩形的任一个顶点。

dx,dy:圆的水平方向半径和垂直方向半径,如果是正圆,这两个值是相等的。半径的单位是“米”。

id:圆形的Id,引擎随机生成的一个guid

当用鼠标在地图上画完一个圆形时触发
onRegularPolygonDrawn

event.type=”onRegularPolygonDrawn” event.args=mapId,zoomLevel,point1Lng,point1Lat,point2Lng,point2Lat,dx,dy,id args的值是一个以“,”分隔的字符串,其中:

mapId:地图的Id

zoomLevel:地图当前的zoom值

point1Lng,point1Lat,point2Lng,point2Lat:两对坐标,第一对是正多边形的圆心坐标, 第二对是画正多边形时鼠标拖动结束的位置,即正多边形的一个顶点。每对坐标都是经度在前,纬度在后。

dx,dy:正多边形的半径(即外接圆的半径),这两个值是相等的。半径的单位是“米”。

id:正多边形的Id,引擎随机生成的一个guid

当用鼠标在地图上画完一个正多边形时触发
onGetMapBoundCallback

event.type=”onGetMapBoundCallback”
event.args=mapId,zoomLevel,upperLeftLng,
upperLeftLat,bottomRightLng,bottmRightLat

args的值是一个以“,”分隔的字符串,其中:

mapId:地图的Id

zoomLevel:地图当前的zoom值

upperLeftLng:地图左上角经度

upperLeftLat:地图左上角纬度

bottomRightLng:地图右下角经度

bottmRightLat:地图右下角纬度

调用getMapBounds后触发的事件。在此事件中返回getMapBounds的结果
onGetCoordNumCallback

event.type=”onGetCoordNumCallback” event.args=mapId,plainLng,plainLat args的值是一个以“,”分隔的字符串,其中:

mapId:地图的Id

lainLng:返回的明码经度

plainLat:返回的明码纬度

调用getMapBounds()后触发的事件。在此事件中返回getCoordEncToPlain的结果
onGetCoordStrCallback

event.type=”onGetCoordStrCallback”

event.args= mapId,encLng,encLat

args的值是一个以“,”分隔的字符串,其中:

mapId:地图的Id

encLng:返回的加密经度

encLat:返回的加密纬度

调用getCoordPlainToEnc后触发的事件。在此事件中返回getCoordPlainToEnc的结果
onGetXYByLonLatCallBack

event.type=”onGetXYByLonLatCallBack”

event.args=mapId,scrX,scrY

args的值是一个以“,”分隔的字符串,其中:

mapId:地图的Id

scrX:返回的屏幕X坐标

scrY:是返回的屏幕Y坐标 注意,屏幕中心的坐标为(128,128)

调用getCoordMapToScreen后触发的事件。在此事件中返回getCoordMapToScreen的结果
onRadarInited

event.type=”onRadarInited”

event.args=mapId,object0,object1

args的值是一个以“,”分隔的字符串,其中:

mapId:地图的Id

object0,object1:用户定义的两个参数

调用MMap.addRadar添加雷达,雷达初始化完成后触发此事件
onRadarAngleChanged

event.type=”onRadarAngleChanged”

event.args=mapId,angle,object

args的值是一个以“,”分隔的字符串,其中:

mapId:地图的Id

angle:雷达视野旋转后的角度

object:用户定义的参数

当雷达视野旋转时触发此事件
onRadarPosChanged

event.type=”onRadarPosChanged”

event.args=mapId,lng,lat args的值是一个以“,”分隔的字符串,其中:

mapId:地图的Id

lng:移动后的经度

lat:移动后的纬度

当雷达位置移动时触发此事件
onGeometryCreated

event.type=”onGeometryCreated”

event.args=mapId,jsonString

args的值是一个以“,”分隔的字符串,其中:

mapId:地图的Id

jsonString:创建的几何对象的JSON字符串

在地图编辑状态下,当创建了一个几何对象时触发。绘制点时鼠标在地图上一点击就触发此事件,而多折线和多边形是绘制完毕,双击鼠标左键结束时触发
onGeometryChanged

event.type=”onGeometryChanged”

event.args=mapId,jsonString

args的值是一个以“,”分隔的字符串,其中:

mapId:地图的Id

jsonString:几何对象修改后的JSON字符串

在地图编辑状态下,当修改了一个几何对象时触发。修改包括移动点的位置、移动多折线或多边形节点的位置,以及修改它们的属性等
onGeometryRemoved

event.type=”onGeometryRemoved”

event.args=mapId,jsonString

args的值是一个以“,”分隔的字符串,其中:

mapId:地图的Id

jsonString:删除的几何对象的JSON字符串

在地图编辑状态下,当删除了一个几何对象时触发
onExportMapData

event.type=”onExportMapData”

event.args=mapId,jsonString

args的值是一个以“,”分隔的字符串,其中:

mapId:地图的Id

jsonString:整个地图的几何对象的JSON字符串

执行exportMapData方法时,通过此事件返回整个地图上几何对象数据的JSON字符串
onPressPoint

event.type=”onPressPoint”

event.args=mapId,clickLng,clickLat,id

args的值是一个以“,”分隔的字符串,其中:

mapId:地图的Id

pclickLng,clickLat:鼠标点击位置的经度、纬度坐标

id:点对象的Id

点击一个点时触发
onPressLine

event.type=”onPressLine”

event.args=mapId,mapLevel,clickLng,clickLat,id

args的值是一个以“,”分隔的字符串,其中:

mapId:地图的Id

pclickLng,clickLat:鼠标点击位置的经度、纬度坐标

id:多折线对象的Id

点击一条多折线时触发
onMapClick

event.type=”onMapClick ” event.args=mapId,zoomLevel,centerLng,centerLat,blockNo

args的值是一个以“,”分隔的字符串,其中:

mapId:地图的Id

zoomLevel:地图当前的zoom值

centerLng:地图中心点的经度坐标

centerLat:地图中心点的纬度坐标

blockNo:图块编号

左键单击地图触发事件
onPressPolygon

event.type=”onPressPolygon”

event.args=mapId,clickLng,clickLat,id

args的值是一个以“,”分隔的字符串,其中:

mapId:地图的Id

pclickLng,clickLat:鼠标点击位置的经度、纬度坐标

id:多边形对象的Id

点击一个多边形时触发
onPopupMenuClick

event.type=”onPopupMenuClick” event.args=mapId,zoomLevel,centerLng,centerLat,upperLeftLng,upperLeftLat, bottomRightLng,bottmRightLat,clickLng,clickLat,menuid

args的值是一个以“,”分隔的字符串,其中:

mapId:地图的Id

zoomLevel:地图当前的zoom值

centerLng:地图中心点的经度坐标

centerLat:地图中心点的纬度坐标

upperLeftLng:地图左上角经度

upperLeftLat:地图左上角纬度

bottomRightLng:地图右下角经度

bottmRightLat:地图右下角纬度

clickLng:右击单击的经度坐标

clickLat:右击单击的纬度坐标

menuid:菜单项ID

右键菜单被单击时触发事件

事件处理类MEventControl

  事件处理类是所有可以接收事件的类的父类。它封装了对事件的处理操作,由它接收从flash发出的事件,然后再派发到事件处理函数中。
构造方法返回顶部
构造方法 参数 说明
MEventControl() 一般不会直接调用MEventControl的构造函数,而是在其子类的构造方法中调用。调用MEventControl的构造方法后,其子类就具有了事件处理的能力

方法
地图操作API返回顶部
方法 返回类型 参数 说明
addEventListener(eventType, functionName, object)

注册成功返回true,失败返回false。

注册失败的原因可能有:已经存在同名同对象方法

eventType 说明:事件类型。

eventType 类型:String。

functionName 说明:事件函数的引用

functionName 类型:Object。

object 说明:方法所属的对象,如果缺省,则使用方法自身的引用。

object 类型:Object

添加(注册)事件处理函数,当eventType事件发生时,执行object对象的functionName方法。可以向一个事件注册多个事件处理函数,在事件发生时,事件处理函数按注册时的顺序执行
removeEventListener(eventType, functionName, object)

卸载成功返回true,失败返回false。

卸载失败的原因可能有:函数列表中没有该函数

eventType 说明:事件类型。

eventType 类型:String。

functionName 说明:事件函数的引用functionName 类型:Object。

object 说明:方法所属的对象,必须与注册时使用的值相同。

object 类型:Object。

卸载(反注册)事件处理函数
removeAllEventListeners() 清空函数列表,卸载(反注册)全部事件处理函数
dispatchMEvent(eventType, event)

eventType 说明:事件类型。

eventType 类型:String。

event 说明:事件参数,事件类型不同,参数也不同。

event 类型:Object

触发eventType类型的事件,执行监听该事件的方法

地图类型枚举类MMapViews

  地图类型枚举类用于设定地图类型。可选的地图类型有普通地图、航拍图、地图和航拍的混合图。 注意:FMP1.0只支持普通地图。
构造方法

属性返回顶部
方法 类型 说明
MAP String 静态属性,表示普通地图类型
SATELLITE String 静态属性,表示航拍地图类型
HYBRID String 静态属性,表示混合地图类型,即普通地图与航拍地图叠加

地图状态枚举类MMapMode

  地图状态枚举类用于设定地图的状态。可选的地图状态有浏览状态和编辑状态。 构造方法

属性返回顶部
方法 类型 说明
BROWSE String 静态属性,表示地图浏览状态
EDIT String 静态属性,表示地图编辑类型

  几何对象枚举类用于设置在地图编辑状态下添加的几何对象类型。可选的对象类型有点、多折线和多边形。
构造方法

方法 类型 说明
TYPE_POINT String 静态属性,表示地图浏览状态
EDIT String 静态属性,表示地图编辑类型

经纬度坐标类MLatLng

  包装一对经纬度坐标,用于标定一个。
构造方法返回顶部
构造方法 参数 说明
MLatLng(latitude, longitude)

latitude 说明:纬度。

latitude 类型:String 。

longitude 说明:经度。

longitude 类型:String。

构造一个MLatLng对象。 注意:参数的顺序是纬度在前,经度在后,与Lat、Lng的顺序对应  
MLatLng(coord)

coord 说明:表示经纬度的一个字符串,形式为"longitude,latitude",按习惯,经度在前,纬度在后,使用逗号分隔。

类型:String

构造一个MLatLng对象。 注意:此构造方法是为方便用户使用设置的,注意参数不同

方法 类型 说明
lat String 纬度
lng String 经度

地图选项类MMapOptions

  包装地图设置选项,初始化地图时使用。
构造方法返回顶部
构造方法 参数 说明
MMapOptions() 构造一个MMapOptions对象

方法 类型 说明
mapId String 地图的id
mapView MMapViews 地图类型
zoomLevel

int

范围:3-17

zoom值
center MLatLng 地图的中心
rotation

foalt

范围:0-360度

地图的旋转角度
miniMap

boolean

范围:true ,False

缺省:False

设置是否初始化显示鹰眼地图

图形样式类MStyle

  包装点、线、面的样式属性。
构造方法返回顶部
构造方法 参数 说明
MStyle() 构造一个MStyle对象

方法 类型 说明
lineColor

16进制整数

范围: 0x000000-0xffffff

缺省: 0x000000,黑色

线条颜色,RGB颜色格式
lineOpacity

int

范围:0-100

缺省:100 百分之百不透明

线条的不透明度
lineSize

int

缺省:1

线条的宽度
lineDash

boolean

缺省:false 实线

线条是否为虚线
fillColor

16进制整数

范围: 0x000000-0xffffff

缺省: 0xffffff,白色

填充颜色,RGB颜色格式
fillOpacity

int

范围:0-100

缺省:100 百分之百不透明

填充的不透明度
sideCount

int

范围:大于等于3

缺省:8

正多边形的边数,只对正多边形适用
labelColor

16进制整数

范围: 0x000000-0xffffff

缺省: 0x000000,黑色

tips的label文字颜色,RGB颜色格式
textContent

String

缺省:"" 内容为空的字符串

tips的文本内容
canBeTop

Boolean

缺省:true

是否允许放在最上层,当鼠标移到对象上时,缺省情况该对象会置于最上层
showTip

Boolean

缺省:true

是否允许显示tip
carSpeed

foalt

范围: 1-100

缺省:5

设置公交、驾车路线演示时小车的速度。carSpeed数值越大,小车运行速度越快
labels

String

缺省:"" 内容为空的字符串

设置地图标点的labels属性
isShowTip

Boolean

缺省:true

设置是否显示标点的Tip信息
isShowLabels

Boolean

缺省:false

设置是否显示地图标点的labels信息
isLabelsBorder

Boolean

缺省:true

设置地图标点的labels是否有边框
isLabelsBackground

Boolean

缺省:true

设置地图标点的labels是否有背景色
borderColor

16进制整数

范围: 0x000000-0xffffff

缺省: 0x000000,黑色

设置地图标点的labels的边框色
backgroundColor

16进制整数

范围: 0x000000-0xffffff

缺省: 0x000000,黑色

设置地图标点的labels的背景色
textSize

int

范围: 1-100

缺省:5

设置地图标点的labels的文字大小
isLabelsFontBold

Boolean

缺省:false

设置地图标点的labels的文字是否加粗

  覆盖在地图表面,随地图移动而移动的所有对象都叫覆盖图(Overlay)。MOverlay是所有几何图形类的父类。它的子类有:MPointOverlay,MPolylineOverlay,MPolygonOverlay,MRectOverlay,MRegularPolygonOverlay,MCircleOverlay等。
继承
MEventControl->MOverlay
构造方法返回顶部
构造方法 参数 说明
MOverlay(id)

id 说明:覆盖图的Id,可选。如果没有指定,则按MOverlay实例的顺序编号。

类型:String

构造一个MOverlay对象,一般不直接创建MOverlay的实例,而是创建其子类的实例,在子类的初始化过程中调用MOverlay的构造函数

方法 类型 说明
TYPE_POINT String 静态属性,表示点
TYPE_POLYLINE String 静态属性,表示多折线
TYPE_RECT String 静态属性,表示多折线
TYPE_POLYGON String 静态属性,表示多边形
TYPE_CIRCLE String 静态属性,表示圆形
TYPE_REGULARPOLYGON String 静态属性,表示正多边形
type String MOverlay的类型 范围:TYPE_POINT、TYPE_POLYLINE、TYPE_RECT、TYPE_POLYGON、TYPE_CIRCLE、TYPE_REGULARPOLYGON

点类MPointOverlay

  在地图上显示为一个有位置的点,有自己的样式和tip,能够接收事件。
继承
MEventControl->MOverlay->MPointOverlay
构造方法返回顶部
构造方法 参数 说明
MPointOverlay(pos, label, style, id)

pos 说明:点的位置

pos 类型:MLatLng

label 说明:点的标注,即点在地图上显示的小标签内容。

label 类型:String

style 说明:点的样式,可选。

style 类型:MStyle

id 说明:可选。可以设置点的id,如果不设定,组件会自动生成。如果使用此参数,必须同时也使用style参数。

id 类型:String

构造一个MPointOverlay对象

方法 类型 说明
pos MLatLng 点的位置
label String 点的标注内容
style MStyle 点的样式

多折线类MPolylineOverlay

  在地图上显示为一条具有若干个节点的多折线,有自己的样式和tip,能够接收事件。
继承
MEventControl->MOverlay->MPolylineOverlay
构造方法返回顶部
构造方法 参数 说明
MPolylineOverlay(points, style, id)

points 说明:节点数组,每个数组元素是一个MLatLng对象。

points 类型:Array

style 说明:多折线的样式,可选。

style 类型:MStyle

id:说明:可选。可以设置多折线的id,如果不设定,组件会自动生成。如果使用此参数,必须同时也使用style参数。

id 类型:String

构造一个MPolylineOverlay对象

方法 类型 说明
points Array 节点数组,每个数组元素是一个MLatLng对象
style MStyle 多折线的样式

多边形类MPolygonOverlay

  在地图上显示为一条具有若干个节点的多边形,有自己的样式和tip,能够接收事件。
继承
MEventControl->MOverlay->MPolygonOverlay
构造方法返回顶部
构造方法 参数 说明
MPolygonOverlay(points, style, id)

points 说明:节点数组,每个数组元素是一个MLatLng对象。

points 类型:Array

style 说明:多边形的样式,可选。

style 类型:MStyle

id 说明:可选。可以设置多边形的id,如果不设定,组件会自动生成。如果使用此参数,必须同时也使用style参数。

id 类型:String

构造一个MPolygonOverlay对象

方法 类型 说明
points Array 节点数组,每个数组元素是一个MLatLng对象
style MStyle 多边形的样式

圆类MCircleOverlay

  在地图上显示为一个圆,有自己的样式和tip,能够接收事件。
继承
MEventControl->MOverlay->MCircleOverlay
构造方法返回顶部
构造方法 参数 说明
MCircleOverlay(center, radius, style, id)

center 说明:圆心的位置

center 类型:MLatLng

radius 说明:圆的半径,单位是“米”。

radius 类型:数字

radius 范围:大于0。

style 说明:圆的样式,可选。

style 类型:MStyle

id 说明:可选。可以设置圆的id,如果不设定,组件会自动生成。如果使用此参数,必须同时也使用style参数。

id 类型:String

构造一个MCircleOverlay对象

方法 类型 说明
center MLatLng 圆心的位置
radius Number 圆的半径
style MStyle 圆的样式

矩形类MRectOverlay

  在地图上显示为一个由左上角和右下角坐标确定的矩形,有自己的样式和tip,能够接收事件。
继承
MEventControl->MOverlay->MRectOverlay
构造方法返回顶部
构造方法 参数 说明
MRectOverlay(topLeft, bottomRight, style, id)

topLeft 说明:矩形左上角的坐标。

topLeft 类型:MLatLng

bottomRight 说明:矩形右下角的坐标。

bottomRight 类型:MLatLng

style 说明:矩形的样式,可选。

style 类型:MStyle

id 说明:可选。可以设置矩形的id,如果不设定,组件会自动生成。如果使用此参数,必须同时也使用style参数。

id 类型:String

构造一个MRectOverlay对象

方法 类型 说明
topLeft MLatLng 左上角的坐标
bottomRight MLatLng 右下角的坐标
style MStyle 矩形的样式

正多边形类MRegularPolygonOverlay

  在地图上显示为一个有若干个节点的正多边形,有自己的样式和tip,能够接收事件。
继承
MEventControl->MOverlay->MRegularPolygonOverlay
构造方法返回顶部
构造方法 参数 说明
MRegularPolygonOverlay(center, radius, style, id)

center 说明:正多边形圆心的位置

center 类型:MLatLng

radius 说明:正多边形的半径,单位是“米”。

radius 类型:数字

radius 范围:大于0。

style 说明:正多边形的样式,可选。

style 类型:MStyle

id 说明:可选。可以设置正多边形的id,如果不设定,组件会自动生成。如果使用此参数,必须同时也使用style参数。

id类型:String

构造一个MRegularPolygonOverlay对象

方法 类型 说明
center MLatLng 正多边形圆心的位置
radius Number 正多边形的半径
style MStyle 正多边形的样式

自定义点类MCustomPointOverlay

  允许使用图片、flash文件等在地图上标注。点击时弹出tip窗口。能够接收事件。
继承
MEventControl->MOverlay->MPointOverlay->MCustomPointOverlay
构造方法返回顶部
构造方法 参数 说明
MCustomPointOverlay(pos, imgURL, style, id)

pos 说明:点的位置

pos 类型:MLatLng

imgURL 说明:标注的图片或flash文件的URL。图片支持gif、jpg、png格式,flash文件支持swf格式。

imgURL 类型:String

style 说明:点的tip的样式,可选。

style 类型:MStyle

id 说明:可选。可以设置自定义点的id,如果不设定,组件会自动生成。如果使用此参数,必须同时也使用style参数。

id 类型:String

构造一个MCustomPointOverlay对象

方法 类型 说明
imgURL String 标注的图片或flash文件的URL

 

 

  MapABC API采用javaScript 面向对象方式,对MapABC POI 查询、空间查询、地址匹配、空间运算、Geocode等功能进行封装。

引用MapABC搜索API

  使用MapABC搜索API,首先您需要在您的页面中引用MapABC搜索API的JavaScript文件。在引用的URL上加上key参数,key的值就是您从api.mapabc.com申请的license。
<html>
<head>
<script type="text/javascript" src="http://api.mapabc.com/api/test/js/ajaxsis.js?key=yourKey">
//注释:KEY值包括调用接口页面URL+用户名=KEY </script>
</head>
<body>...</body>
</html> 注:此地址为MapABC Ajax API测试服务器地址

下面是类的定义说明,构造方法、属性、方法等:
MSearchPointPara MSearchRoutPara MSearchSpatialPara
MAddress MSISSearch MGeoCode

查询POI参数对象类MSearchPointPara

  查询POI参数对象类封装了查询条件参数,适用于关键字查询、周边查询。 构造方法返回顶部
构造方法 参数 说明
MSearchPointPara()

创建一个MSearchPointPara对象

方法 返回类型 参数 样例 说明
setCitycode(citycode) String

citycode:字符串型 必要参数

searchpointpara.setCitycode("010");

设置查询城市区号

setKeyword(keyword) String keyword:字符串型 searchpointpara.setKeyword("银谷大厦"); 设置查询POI关键字
setSearchType(searchtype) String

searchtype:字符串型

searchpointpara.setSearchType("大厦"); 设置查询POI类型
setCenterKeyword
(centerkeyword)
String centerkeyword:字符串型

searchpointpara.setCitycode("010"); searchpointpara.setCenterKeyword("银谷大厦"); searchpointpara.setKeyword("餐厅");

设置周边查询,中心点关键字
setCenXY(x,y) String

x,y:字符串型

此参数作用等同于setCenterKeyword()

searchpointpara.setCitycode("010");
searchpointpara.setCenXY
("mlrckrtuvmrGJIM","otjnkvrnqqONME"); searchpointpara.setKeyword("餐厅");

设置周边查询中心点经纬度坐标

setrange(range) String

range:整型

单位为米,默认为3000M

searchpointpara.setCitycode("010"); searchpointpara.setCenterKeyword("银谷大厦"); searchpointpara.setKeyword("餐厅"); searchpointpara.setrange(2000);

设置周边查询的查询范围

setNumber(number) String

number:整型

此参数用于设置客户端分页查询结果

searchpointpara.setNumber(10);

设置查询结果每页记录数
setPageSum(pagesum) String

pageSum:整型

此参数用于设置客户端分页查询结果

searchpointpara.setPageSum(1);

设置查询返回几页数据
setBatch(batch) String

batch:整型

此参数用于设置客户端分页查询结果

searchpointpara.setBatch(1);

设置查询数据批次
  上面3个参数用于做分页显示,举例说明:如果客户端需要自己做缓存、做分页显示,number×pageSum的积为一次返回的结果数,batch为批号;如果不需要做缓存,pageSum此时为1,这样相当于number含义不变,batch代表批号的同时也相当于具有了pageSum的含义。

查询公交/路径参数对象类MSearchRoutPara

  查询公交/路径参数对象类封装了公交和路径查询条件参数,适用于公交/驾车查询条件
构造方法返回顶部
构造方法 参数 说明
MSearchRoutPara()

创建一个MSearchRoutPara对象


方法 返回类型 参数 样例 说明
setCitycode(citycode) String

citycode:字符串型

公交查询必要参数,跨省路径查询此参数不设置值

searchroutpara.setCitycode("010");

设置查询城市区号

setType(type) String

type:字符串型

公交换乘为bus 驾车路径为drive此参数为必要参数

searchroutpara.setType("bus"); 设置查询类型
setStartXY(x,y) String

x,y :字符串型

此参数为必要参数

searchroutpara.setStartXY
("mlrckrtuvmrGJIM","otjnkvrnqqONME");
设置公交换乘/驾车路径起点经纬度
setEndXY(x,y) String

X,y:字符串型

此参数为必要参数

searchroutpara.setEndXY
("mlrckrtuvmrGJIM","otjnkvrnqqONME");

设置公交换乘/驾车路径终点经纬度

setrouteType(routeType) String

routeType:字符串型

公交查询:

输入“0”时 尽可能乘坐轨道交通和快速公交线路 最快捷模式

输入“1”时 尽可能乘坐月票车线路 最经济模式

输入“2”时 尽可能减少换乘次数 最少换乘模式

输入“3”时 尽可能减少步行距离 最少步行模式

输入“4”时 尽可能乘坐有空调车线 最舒适模式

导航查询:

输入“0”时 速度优先

输入“1”时 费用优先

输入“2”时 距离优先

searchroutpara.setrouteType(”0”); 设置公交路线查询方式(例如:最优线路查询,最快线路查询等)
setresData(resData) String

resData:字符串型(可附加参数)

resData默认=0 表示不返回公交线路的xy坐标和扩展站点信息描述

resData=1 表示返回站点描述信息

resData=2 表示返回路线坐标

resData=3 表示坐标和线站点描述都返回

searchroutpara.setresData("0"); 设置公交名称、ID、站名查询返回值类型
setBusName(busName) String

busName:字符串型

此参数为必要参数

searchroutpara.setBusName
("300");

设置要以哪个公交线路的名称进行查询(例如:300)数字代表线路名称

setIds(ids) String

ids:字符串型

此参数为必要参数

searchroutpara.setIds
("1100000100098");
设置要以哪个公交线路的ID进行查询(例如:1100000100098)数字代表线路的ID
setStationName
(stationName)
String

stationName:字符串型

此参数为必要参数

searchroutpara.setStationName
("五道口");

设置要以公交线路路经站名进行查询(例如:五道口)数字代表线路的ID