7 uap mobile api reference uap_plug_api uexbaidumap

1、uexBaiduMap1、简介 2、API概览 3、更新历史 接入指引部分： 4、申请成为开发者 5、进入API控制台 6、点击创建应用 7、Andro d平台安全码 8、 OS平台安全码为应用的Bund e Ident f er 9、Andro d打包集成百度插件使用 10、 OS打包集成百度插件使用 11、百度插件打包使用常见问题 1、简介 提供百度地图的相关相关功能.用户 以使用该插件在网页 嵌入一张地图,并实现对地图的基本操作, 例如放大缩小,移动,点击,隐藏, 显示.另外还提供了定位功能,搜索功能,路线规划功能,地理编码功能 .本文的 的是为了开发能够更好更快地将API集成到自己的项

2、 中，在使用前最好先使用好我们提供的demo并对照文档运行看看效果。 这里 以【参考教程】下载uap IDE为开发者工具开发，然后集成到自己的项。 1.1、说明 安卓& OS插件已支持config.xml文件配置AK.注:IDE插件因为涉及到百度方面的ID与Key暂时无法使用,此插件之前需要进行conf g.xm相关配置,具体使用点击查看:附录百 度地图插件接入指引 openc oseh deMapshowMapsetMapTypesetTraff cEnab edsetCentergetCentersetZoomLevezoomInzoomOutrotateover ooksetZoomEn

3、ab esetRotateEnab esetCompassEnab e setScro Enab esetOver ookEnab eaddMarkersOver aysetMarkerOver ay showBubb eh deBubb eaddDotOver ayaddPo y neOver ay addArcOver ayaddC rceOver ayaddPo ygonOver ayaddGroundOver ay addTextOver ayremoveMakersOver ayremoveOver aypo SearchInCtypo NearbySearchpo BoundSea

4、rchbusL neSearchremoveBusL ne preBusL neNodenextBusL neNodesearchRouteP anpreRouteNode removeRouteP annextRouteNodegeocodereverseGeocode getCurrentLocat onstartLocat onstopLocat onsetMyLocat onEnab e setUserTrack ngModezoomContro sEnab edgetD stanceonMapC ckL stener onMapDoub eC ckL steneronMapLongC

5、 ckL steneronMapStatusChangeL steneronMarkerC ckL stener onMarkerBubb eC ckL steneronSDKRece verErroronRece veLocat ononSearchRouteP an onZoomLeve ChangeL stener1.2、UI展示1.3、公告 安卓百度定位sdk升级,配合安卓打包服务升级,插件已经跟新至最新版本,已经公测通过,请使用最新版本(已支持conf g.xm文件配置AK)旧版uexBa duMap 插件已经下架,官方不再维护,如需使用,请跳转到详细官方通告 1.4、开源源码 点击

6、插件中心至插件详情页(插件测试用例与插件源码已经提供)1.5、平台版本支持 本插件的所有API默认支持Android4.0+和iOS7.0+操作系统. 有特殊版本要求的API会在文档中额外说明.1.6、接口有效性 本插件所有API默认在插件版本4.0.0+ 用. 在后续版本中新添加的接口会在文档中额外说明.2、API概览2.1、方法 open /打开地图 uexBaduMap.open(x,y,wdth,heght, ongtude, at tude, ca backFunct on)说明在界面的指定位置显示地图, 成功显示地图后会回调 ca backFunct on参数参数名称 参数类型 是

7、否必选 说明xNumberx坐标是yNumbery坐标是wdthNumber是地图宽度he ghtNumber是地图高度ong tudeNumber是地图中心点经度 at tudeNumber是地图中心点纬度 ca backFunct onFunct on否地图打开后的回调 x,y,wdth,he ght 的单位均为px(x,y)表示地图左 角的坐标 示例uexBaduMap.open(10,100,480,640,116.309,39.977, funct on() consoe. og(open success););close /关闭地图 uexBaduMap.c ose()说明关闭地图

8、参数无示例uexBaduMap.c ose();hideMap /隐藏地图 uexBaduMap.hdeMap()说明隐藏地图参数无示例uexBaduMap.hdeMap();showMap /显示地图uexBaduMap.showMap()说明显示地图参数无示例uexBaduMap.showMap();setMapType /设置地图的类型 uexBaduMap.setMapType(type)说明设置地图的类型 参数参数名称 参数类型 是否必选 说明typeNumber地图的类型(1-标准地图,2-地图)是示例uexBaduMap.setMapType(1);setTrafficEnabl

9、ed /开启或关闭交通图 uexBaduMap.setTraff cEnabed(type)说明开启或关闭交通图 参数说明参数名称 参数类型 是否必选 typeNumber0-关闭,1-开启 是示例uexBaduMap.setTraff cEnabed(1);setCenter /设置地图的中心点 uexBaduMap.setCenter( ongtude, at tude)说明设置地图的中心点经纬度,地图会移动使此点成为地图的中心点 参数说明参数名称 参数类型 是否必选 ong tudeNumber是中心点经度at tudeNumber是中心点纬度示例uexBaduMap.setCenter

10、(121.481,31.227);getCenter /获取地图的中心点 uexBaduMap.getCenter()说明得到当前地图的中心点经纬度 参数 无返回值获取成功后,返回值是JSON对象,格式如下:ongtude:, at tude:如果失败,返回nu示例var data uexBaduMap.getCenter(); aert(data: + JSON.str ngfy(data);setZoomLevel /设置地图的比例级别uexBaduMap.setZoomLeve (zoomLeve )说明设置地图的比例级别 参数说明参数名称 参数类型 是否必选 zoomLeveNumbe

11、r地图的缩放级别 范围:319,数值越大越精确是示例uexBaduMap.setZoomLeve (10);zoomIn /放大一个地图级别 uexBaduMap.zoomIn()说明放大一个地图级别 参数无示例uexBaduMap.zoomIn();zoomOut /缩小一个地图级别uexBaduMap.zoomOut()说明缩小一个地图级别 参数无示例uexBaduMap.zoomOut();rotate /旋转地图uexBaduMap.rotate(ange)说明旋转地图参数说明参数名称 参数类型 是否必选 ang eNumber旋转地图的角度,旋转角范围:-180180,单位:度,逆时

12、针旋转 是示例uexBaduMap.rotate(90);overlook /俯视地图 uexBaduMap.over ook(ange)说明俯视地图参数参数名称 参数类型 是否必选 说明ang eNumber俯视地图的角度,俯角范围:-450,单位:度 是示例uexBaduMap.over ook(-30);setZoomEnable /开启或关闭缩放 uexBaduMap.setZoomEnab e(type)说明开启或关闭缩放 参数说明参数名称 参数类型 是否必选 typeNumber0-关闭,1-开启 是示例uexBaduMap.setZoomEnab e(1);setRotateEn

13、able /开启或关闭旋转 uexBaduMap.setRotateEnabe(type)说明开启或关闭旋转 参数说明参数名称 参数类型 是否必选 typeNumber0-关闭,1-开启 是示例uexBaduMap.setRotateEnabe(1);setCompassEnable /开启或关闭指南针uexBaduMap.setCompassEnabe(type)说明开启或关闭指南针 参数说明参数名称 参数类型 是否必选 typeNumber0-关闭,1-开启 是示例uexBaduMap.setCompassEnabe(1);setScrollEnable /开启或关闭平移 uexBaduM

14、ap.setScro Enabe(type)说明开启或关闭平移 参数说明参数名称 参数类型 是否必选 typeNumber0-关闭,1-开启 是示例uexBaduMap.setScro Enabe(1);setOverlookEnable /开启或关闭俯视 uexBaduMap.setOver ookEnabe(type)说明开启或关闭俯视 参数说明参数名称 参数类型 是否必选 typeNumber0-关闭,1-开启 是示例uexBaduMap.setOver ookEnabe(1);addMarkersOverlay /添加标注 uexBaduMap.addMarkersOver ay(js

15、on);说明添加标注, 注意: json 是String类型,需要将对象JSON.stringify()参数参数类型是否必选参数名称 说明jsonStr ng添加到地图的标注信息的集合.该字符串为JSON格式.如下:是var json d:, ongtude:, at tude:, con:, bubbe:t t e:, bgImage:各字段含义如下 说明参数参数类型 是否必选 dStr ng唯一标识符,不传时插件随机生成 否ong tudeNumber是经度at tudeNumber是纬度conStr ng标注图标路径,支持类型:res:/http:/否bubb eStr ng否自定义弹出

16、气泡 t t eStr ng是自定义弹出气泡标题 bgImageStr ng自定义弹出气泡背景图片,格式:res:/btn.png否返回值返回d组成的一个数组,如果添加失败返回为空 示例var data d:10001,ongtude:116.400244, at tude:39.963175,con:http:/www. /png/mapmarkers/marker_ ns de_azure.png, bubbe:t t e:t t e1,d:10002,ongtude:116.369199, at tude:39.942821, bubbe:t t e:t t e2,

17、bgImage:res:/btn.png,d:111,ongtude:116.404, at tude:39.915,con:http:/www. /png/mapmarkers/marker_ ns de_azure.png, bubbe:t t e:t t e3, bgImage:res:/btn.png;var ds uexBaduMap.addMarkersOver ay(JSON.str ngfy(data); f(! ds)aert(添加失败);setMarkerOverlay /更新设置标注信息 uexBaduMap.setMarkerOver ay(make

18、rId,makerInfo);说明更新设置标注信息 参数参数类型说明参数是否必选 makerIdStr ng是唯一标识符makerInfoStr ng标注信息,json格式，形式见下：是var makerInfo ongtude:, at tude:, con:, bubbe:t t e:,bgImage:各字段含义如下： 是否必选说明字段名称 类型ong tudeNumber是标注经度at tudeNumber是标注纬度conStr ng否标注图标bubb eObject是气泡设置t t eStr ng是气泡标题bgImageStr ng否气泡背景图片示例var makerInfobubbe

19、:bgImage: res:/btn.png, t t e: 这是标题,at tude: 39.021514,ongtude: 116.232323;var makerId 10001;uexBaduMap. setMarkerOver ay (makerId, makerInfo);showBubble /显示标注气泡uexBaduMap.showBubbe(makerId);说明显示指定ID的标注气泡,地图 仅有一个标注气泡显示,其他标注气泡将被隐.参数参数类型参数是否必选 说明makerIdStr ng是唯一标识符示例var makerId 10001; uexBaduMap.showB

20、ubbe(makerId);hideBubble /隐藏标注气泡 uexBaduMap.hdeBubbe();说明当前显示的标注气泡将被隐藏.参数无示例uexBaduMap.hdeBubbe();addDotOverlay /添加点覆盖物uexBaduMap.addDotOver ay(dotInfo);说明添加点覆盖物参数参数类型是否必选参数名称 说明dotInfoStr ng是添加到地图 的圆点信息的集合，形式见下： var dotInfo d:,f Coor:, radus:, ongtude:, at tude:各字段含义如下 参数参数类型 是否必须 说明dStr ng唯一标识符,不传

21、时插件随机生成 否f Co orStr ng圆点颜色,支持格式:#000,#000000是rad usNumber圆点半径,单位:像素是ong tudeNumber是圆点经度at tudeNumber是圆点纬度返回值返回d,如果添加失败返回为空 示例var dotInfo f Coor:#990033, d:150,ongtude:116.400244, at tude:39.963175, radus:50;var d uexBaduMap.addDotOver ay(dotInfo); f(! d)aert(添加失败);addPolylineOverlay /添加折线覆盖物 uexBadu

22、Map.addPoy neOver ay(poy neInfo);说明添加折线覆盖物 参数参数类型是否必选说明参数名称 po y neInfoStr ng的折线信息。该字符串为JSON格式:是添加到地图var poy neInfo f Coor:, neW dth:, property:ongtude:116.357428, at tude:39.93923,ongtude:116.347428, at tude:39.89923各字段含义如下 参数参数类型 是否必须 说明dStr ng唯一标识符,不传时插件随机生成 否f Co orStr ng折线颜色,支持格式:#000,#000000是n

23、eW dthNumber折线线宽,单位:像素是propertyArray是连接点经纬度集合 ong tudeNumber是连接点经度at tudeNumber是连接点纬度返回值返回d,如果添加失败返回为空 示例var poy neInfof Coor:#990033, d:151,neW dth:10.0, property:ongtude:116.357428, at tude:39.93923,ongtude:116.401394, at tude:39.942821,ongtude:116.347428, at tude:39.89923;var d uexBaduMap.addPoy

24、neOver ay(poy neInfo); f(!d)aert(添加失败);addArcOverlay /添加弧形覆盖物 uexBaduMap.addArcOver ay(arcInfo);说明添加弧形覆盖物 参数说明参数名称 参数类型 是否必选 arcInfoStr ng的弧形信息。该字符串为JSON格式:是添加到地图var arcInfo strokeCoor:, neW dth:, startLong tude:, startLat tude:, centerLongtude:, centerLat tude:, endLongtude:, endLat tude:各字段含义如下 是否

25、必须参数参数类型 说明dStr ng唯一标识符,不传时插件随机生成 否strokeCo orStr ng颜色,支持格式:#000,#000000是neW dthNumber是线宽startLong tudeNumber是起点经度startLat tudeNumber是起点纬度centerLong tudeNumber是中点经度是否必须参ce数nterLattude参Nu数mb类er型说中点明纬度endLong tudeNumber是终点经度endLat tudeNumber是终点纬度返回值返回d,如果添加失败返回为空 示例var data centerLat tude:39.942821, c

26、enterLongtude:116.369199, endLat tude:39.906965, endLongtude:116.401394, d:152,neW dth:2.0,startLat tude:39.963175, startLong tude:116.400244, strokeCoor:#990033;var d uexBaduMap.addArcOver ay(data); f(! d)aert(添加失败);addCircleOverlay /添加圆形覆盖物 uexBaduMap.addCrc eOver ay(c rc eInfo);说明添加圆形覆盖物 参数参数名称参数

27、类型 是否必选 说明c rc eInfoStr ng的圆形覆盖物信息。该字符串为JSON格式是添加到地图var c rc eInfo ongtude:, at tude:,radus:1000,f Coor:#4169E1,strokeCoor:#990033, neW dth:4各字段含义如下 参数类型参数是否必须 说明dStr ng唯一标识符,不传时插件随机生成 否rad usNumber半径,单位:米是f Co orStr ng填充颜色,支持格式:#000,#000000是strokeCo orStr ng边框颜色,支持格式:#000,#000000是neW dthNumber是边框宽度

28、参on数gtude参N参u数mb类er型是否必须 说圆心明经度at tudeNumber是圆心纬度返回值返回d,如果添加失败返回为空 示例var data f Coor:#4169E1, d:153, at tude:39.915,neW dth:4, ongtude:116.404, radus:1000, strokeCoor:#990033;var d uexBaduMap.addCrc eOver ay(data); f(! d)aert(添加失败);addPolygonOverlay /添加几何图形覆盖物 uexBaduMap.addPoygonOver ay(poygonInfo)

29、;说明向添加几何图形覆盖物 参数是否必选说明参数名称 参数类型 po ygonInfoStr ng的集合图形信息的集合。该字符串为JSON格式是添加到地图var poygonInfo f Coor:, strokeCoor:, neW dth:, property:ongtude:, at tude:,各字段含义如下 参数类型参数是否必须 说明dStr ng唯一标识符,不传时插件随机生成 否f Co orStr ng填充颜色,支持格式:#000,#000000是strokeCo orStr ng边框颜色,支持格式:#000,#000000是neW dthNumber是边框宽度propertyA

30、rray是连接点经纬度数组 ong tudeNumber是 是否必须 连接点经度说明 参数类型参数at tudeNumber是连接点纬度返回值返回d,如果添加失败返回为空 示例var data f Coor:#990033, d:154,neW dth:2.0, property:at tude:39.93923, ongtude:116.357428,at tude:39.91923, ongtude:116.327428,at tude:39.89923, ongtude:116.347428,at tude:39.89923, ongtude:116.367428,strokeCoor:

31、#990033;var d uexBaduMap.addPoygonOver ay(data); f(! d)aert(添加失败);addGroundOverlay /添加地形图图层覆盖物 uexBaduMap.addGroundOver ay(groundInfo);说明添加地形图图层覆盖物 参数说明参数名称 参数类型 是否必选 groundInfoStr ng的地形图图层信息。该字符串为JSON格式如下：是添加到地图var groundInfo mageUr :, transparency:, mageW dth:, mageHeght:, property:ongtude:, at tu

32、de:各字段含义如下 参数类型参数是否必须 说明dStr ng唯一标识符,不传时插件随机生成 否mageUrStr ng图片路径,支持格式:http:/,res:/是transparencyNumber,范围:0.0f,1.0f是propertyArray地理位置数组,长度为2是ong tudeNumber是经度at tudeNumber是纬度mageW dthNumber是(property数组长度为1时)否(property数组长度为2时)图片宽度,单位:米mageHe ghtNumber图片高度,单位:米否返回值返回d,如果添加失败返回为空 示例var data d:155,mageHe

33、ght:5000,mageUr :http:/ mg0.bdstat / mg/ mage/9baf75d938553886ce515def29441ed31409109131.jpg, mageW dth:10000,property:ongtude:116.380338, at tude:39.92235,ongtude:116.414977, at tude:39.947246,transparency:0.8;var d uexBaduMap.addGroundOver ay(data); f(! d)aert(添加失败);addTextOverlay /添加文字覆盖物 ue

34、xBaduMap.addTextOver ay(textInfo);说明添加文字覆盖物 参数参数类型是否必选参数名称 说明textInfoStr ng添加到地图 的文字覆盖物信息。该字符串为JSON格式如下： 是var textInfo bgCoor:, fontS ze:, fontCoor:, text:, rotate:, ongtude:, at tude:各字段含义如下 参数类型参数是否必须 说明dStr ng唯一标识符,不传时插件随机生成 否bgCo orStr ng文字背景,支持格式:#000,#000000是fontS zeNumber是字体大小fontCo orStr ng字

35、体颜色,支持格式:#000,#000000是textStr ng是文字内容ong tudeNumber是经度at tudeNumber是纬度rotateNumber文字旋转角度(逆时针),旋转角范围:-180180,单位:度 否返回值返回d,如果添加失败返回为空 示例var data bgCoor: #FFFF00,fontS ze: 24,d: 156,ongtude: 116.400244,at tude: 39.963175,rotate: -30, text: badu map;var d uexBaduMap.addTextOver ay(data); f(! d)aert(添加失败

36、);removeMakersOverlay /移除标注 uexBaduMap.removeMakersOver ay( ds);说明移除地图对应标识的覆盖物 参数参数参数类型 是否必须 说明dsStr ng唯一标识符数组,json结构字符串是示例var ds 150,151;uexBaduMap.removeMakersOver ay( ds);removeOverlay /移除覆盖物 uexBaduMap.removeOver ay( d);说明移除地图 对应标识的覆盖物 参数参数类型参数是否必须 说明dStr ng是唯一标识符示例uexBaduMap.removeOver ay(150);

37、poiSearchInCity /城市内检索uexBaduMap.po SearchInCty(json, ca backFunct on);说明根据单个关键字在指定城市内搜索兴趣点, 搜索完成后回调 ca backFunct on参数是否必选参数名称 参数类型 说明jsonStr ng搜索所需要的信息.该字符串为JSON格式，形式见下：是ca backFunct onFunct on是搜索结果的回调方法 var json c ty:, searchKey:, pageNum:各字段含义如下 参数是否必须 说明c ty是城市searchKey是关键字pageNum是结果页索引回调参数:var

38、ca backFunct onfunct on(error,data)参数名称 参数类型 说明参err数or名称 参Nu数mb类er型说搜索明结果，0-成功，非0-失败dataObject成功时返回的数据，形式见下： var data tota Po Num:, tota PageNum:, currentPageNum:, currentPageCapac ty:, po Info:ud:,po Type:, phoneNum:, address:, name:, ongtude:, at tude:, dstance:,c ty:,postCode:各字段含义如下 是否必须参数说明po I

39、nfoPOI信息集合是ong tude是经度at tude是纬度d stance是距离name是名称u d是唯一标识符address是地址c ty是城市phoneNum是电话postCode是邮编po Type类型(POI类型,0:普通点1:公交站2:公交线路3:地铁站4:地铁线路)是tota Po Num是总结果数tota PageNum是总页数currentPageNum是当前页currentPageCapac ty当前页的po 结果数是示例var data c ty: 北 京 , searchKey: 114,pageNum: 0;uexBaduMap.po SearchInCty(da

40、ta, funct on(error,data) aert(JSON.str ngfy(data););poiNearbySearch /周边检索uexBaduMap.po NearbySearch(json, ca backFunct on);说明根据单个关键字在指定的中心点和半径范围内搜索兴趣点 参数是否必选参数名称 参数类型 说明jsonStr ng搜索所需要的信息.该字符串为JSON格式，形式见下：是ca backFunct onFunct on是搜索结果的回调方法 var json ongtude:, at tude:, radus:, searchKey:, pageNum:各字段

41、含义如下 是否必须说明参数ong tude是经度at tude是纬度rad us半径值,单位米是searchKey是关键字pageNum是结果页索引回调参数:var ca backFunct onfunct on(error,data)参数名称 参数类型 说明errorNumber搜索结果，0-成功，非0-失败dataObject成功时返回的数据，形式见下： vardata tota Po Num:, tota PageNum:, currentPageNum:, currentPageCapac ty:, po Info:ud:,po Type:, phoneNum:, address:,

42、name:, ongtude:, at tude:, dstance:,c ty:,postCode:各字段含义如下 是否必须参数说明po InfoPOI信息集合是ong tude是经度at tude是纬度d stance是距离name是名称u d是唯一标识符address是地址c ty是城市phoneNum是电话postCode是邮编po Type类型(POI类型,0:普通点1:公交站2:公交线路3:地铁站4:地铁线路)是tota Po Num是总结果数tota PageNum是总页数currentPageNum是当前页currentPageCapac ty当前页的po 结果数是示例var

43、data ongtude: 116.309,at tude: 39.977,radus: 1000, searchKey: 电影院, pageNum: 0;uexBaduMap.po NearbySearch (jsonStr, funct on(error,data) aert(JSON.str ngfy(data););poiBoundSearch /区域检索uexBaduMap.po BoundSearch(json, ca backFunct on);说明根据单个关键字在指定的矩形区域内搜索兴趣点 参数是否必选参数名称 参数类型 说明jsonStr ng搜索所需要的信息.该字符串为JS

44、ON格式，形式见下：是ca backFunct onFunct on是搜索结果的回调方法 var json searchKe y:, pageNum:, northeast:ongtude:, at tude:,southwest: ongtude:, at tude:各字段含义如下 参数是否必须 说明searchKey是关键字pageNum是结果页索引northeast是东北点southwest是西南点ong tude是经度at tude是纬度回调参数:var ca backFunct onfunct on(error,data)参数名称 参数类型 说明errorNumber搜索结果，0-成

45、功，非0-失败dataObject成功时返回的数据，形式见下： vardata tota Po Num:, tota PageNum:, currentPageNum:, currentPageCapac ty:, po Info:ud:,po Type:, phoneNum:, address:, name:, ongtude:, at tude:, dstance:,c ty:,postCode:各字段含义如下 是否必须参数说明po InfoPOI信息集合是ong tude是经度at tude是纬度d stance是距离name是名称u d是唯一标识符address是地址c ty是城市ph

46、oneNum是电话postCode是邮编po Type类型(POI类型,0:普通点1:公交站2:公交线路3:地铁站4:地铁线路)是tota Po Num是总结果数tota PageNum是总页数currentPageNum是当前页currentPageCapac ty当前页的po 结果数是示例var data searchKey: 电影院, pageNum: 0, northeast: ongtude: 116.326664,at tude: 39.991418,southwest: ongtude: 116.312705,at tude: 39.981730;uexBaduMap.po Bo

47、undSearch(data, funct on(error,data) aert(JSON.str ngfy(data););busLineSearch /公交线路检索 uexBaduMap.busLneSearch(json, ca backFunct on);说明根据公交线路编号在指定城市范围内搜索公交线路详情, 搜索完成后执行回调函数 ca backFunct on参数是否必选参数名称 参数类型 说明jsonStr ng搜索所需要的信息.该字符串为JSON格式，形式见下：是ca backFunct onFunct on是搜索结果的回调方法 var json c ty:, busLneName:各字段含义如下 是否必须参数说明c ty是城市busL neName是公交名