tencentMap

概述

TencentMap 封装了腾讯地图原生SDK ,使用本插件可以轻松访问腾讯地图服务和数据,本插件提供地图显示、实时路况、离线地图、地址解析等功能接口。本插件中方法基于同一个Activity,如发现某些功能未实现,请尝试关闭其他功能再试。

注意事项:

使用本插件前需要先获取AppKey

  1. 进入控制台进行选择我的应用并创建应用
  2. 填写应用信息,勾选地图SDK、WebService API,并勾选条款
  3. 点击添加生成KEY

得到AppKey之后,需要配置 config.xml 文件,配置方法如下:

<meta-data name="TencentMapSDK" value="您申请的Key"/>

privacyCompliance

申请同意隐私政策 申请同意隐私政策

注意:使用本插件必须首先实现本方法,同意隐私政策后才能正常使用地图功能。

privacyCompliance({param})

params

agreeprivacy:

  • 类型:布尔类型
  • 描述:用户是否同意隐私政策
  • 取值范围:
    • true:同意
    • false:不同意

示例代码

var TencentMap = api.require('TencentMap');
var param = {
    "agreeprivacy":true
}
TencentMap.privacyCompliance(param);	    

可用性

Android系统,iOS系统

可提供的1.0.0及更高版本

showMap

显示地图

注意:本插件中的地图页面由Android Activity渲染,直接使用安卓设备的关闭手势即可关闭地图页面。

showMap()

示例代码

var TencentMap = api.require('TencentMap');
TencentMap.showMap();

可用性

Android系统,iOS系统

可提供的1.0.0及更高版本

showPosition

获取定位信息并在地图上展示

注意1:此方法需要在showMap()之前调用;定位或取消定位,根据所传参数不同,都由本接口实现。

注意2:触发该方法后会在地图上显示定位,但不返回具体的信息字段,如需详细的定位信息字段请使用TencentLocation插件。

showPosition({params},callback(ret))

params

status:

  • 类型:布尔类型
  • 描述:定位开关
  • 取值范围:
    • true:开启
    • false:关闭

callback(ret)

ret:

  • 类型:JSON对象
  • 内部字段:
{
    "status":false		//布尔类型;定位失败返回该字段
    "msg":""			//字符串类型;取值范围:
                        //"定位失败,请检查网络"(由于网络原因引起的定位失败会返回该字段)
                        //"定位失败,请检查是否打开定位权限"(由于定位权限原因引起的定位失败会返回该字段)
}

示例代码

var TencentMap = api.require('TencentMap');
var param = {
    "status":true	//开启定位
    "status":false	//关闭定位
}
TencentMap.showPosition(param,function(ret){
    alert(JSON.stringify(ret));
});

可用性

Android系统,iOS系统

可提供的1.0.0及更高版本

switchMapType

切换地图类型

注意:此方法需要在showMap()之前调用

switchMapType({params})

params

type:

  • 类型:字符串类型
  • 描述:地图类型
  • 取值范围:
    • "normal":普通地图
    • "dark":暗色地图
    • "satellite":卫星地图
  • 默认值:normal

示例代码

var TencentMap = api.require('TencentMap');
var param = {
    "type":"dark"
}
TencentMap.switchMapType(param);

可用性

Android系统,iOS系统

可提供的1.0.0及更高版本

timeRoadCondition

实时路况

注意:此方法需要在showMap()之前调用;开启和关闭实时路况,通过所传参数不同,都由本接口实现。

timeRoadCondition({params})

params

roadCondition:

  • 类型:布尔类型
  • 描述:实时路况开关
  • 取值范围:
    • true:开启
    • false:关闭

示例代码

var TencentMap = api.require('TencentMap');
TencentMap.timeRoadCondition({
    "roadCondition":true	//开启实时路况
    "roadCondition":false   //关闭实时路况
});

可用性

Android系统,iOS系统

可提供的1.0.0及更高版本

is3DMap

显示3D立体建筑物效果

注意:此方法需要在showMap()之前调用;开启或关闭3D建筑物效果,通过所传参数不同,都由本接口实现。

is3DMap({params})

params

is3D:

  • 类型:布尔类型
  • 描述:3D立体建筑物显示效果开关
  • 取值范围:
    • true:开启
    • false:关闭

示例代码

var TencentMap = api.require('TencentMap');
TencentMap.is3DMap({
    "is3D":true			//开启3D建筑物效果
    "is3D":false		//关闭3D建筑物效果
});

可用性

Android系统,iOS系统

可提供的1.0.0及更高版本

setMapView

设置地图视野

说明:以第三人称视角俯视观察建筑物

注意:此方法需要在showMap()之前调用;设置或取消地图视野,根据所传参数不同,都由本接口实现。

setMapView({param})

params

status:

  • 类型:布尔类型
  • 描述:设置地图视野开关
  • 取值范围:
    • true:开启
    • false:关闭

longitude:

  • 类型:数字类型
  • 描述:观察点经度

latitude:

  • 类型:数字类型
  • 描述:观察点纬度

zoom:

  • 类型:数字类型
  • 描述:(选填项)地图显示级别
  • 默认值:19
  • 说明:该参数数值越大,地图显示范围越小但越详细

skew:

  • 类型:数字类型
  • 描述:倒伏角度。以观察点为顶点与地图平面的垂线和地图中心点之间的夹角

rotate:

  • 类型:数字类型
  • 描述:旋转角度。观察点与地图中心点之间的夹角在地图平面上的投影与北极的夹角

isAnimation:

  • 类型:布尔类型
  • 描述:(选填项)切换到地图的展示区域是否显示动画
  • 取值范围:
    • true:开启
    • false:关闭

示例代码

var TencentMap = api.require('TencentMap');
var param = {
    "status":true,//设置地图视野
    "status":false,//关闭地图视野
    "longitude":116.337000,
    "latitude":39.977290,
    "zoom":19,
    "skew":45,
    "rotate":45,
    "isAnimation":true
}
TencentMap.setMapView(param);

可用性

Android系统,iOS系统

可提供的1.0.0及更高版本

setViewField

设置视野范围

说明:允许将地图设置到合适的视野,并把一系列点、地图覆盖物都在一屏内展示出来。

注意:此方法需要在showMap()之前调用;设置或取消地图视野范围,根据所传参数不同,都由本接口实现。

setViewField({param})

params

status:

  • 类型:布尔类型
  • 描述:地图视野范围开关
  • 取值范围:
    • true:开启
    • false:关闭

pointArray:

  • 类型:数字类型数组

  • 描述:视野范围坐标点的经度纬度集合

  • 说明:

    • 该数组需要传递【偶数】个数元素

    • 每两个元素是一个坐标点的坐标。例如所传数组为:

      "pointArray":[
          40.042893,
          116.269673,
          40.038951,
          116.275241,
          40.039970,
          116.275250
      ]
      

      那么说明,视野范围坐标点一(40.042893,116.269673)、坐标点二(40.038951,116.275241),以此类推。

    • 每一个范围点的纬度必须在前,经度必须在后

centerLat:

  • 类型:数字类型
  • 描述:中心点纬度

centerLog:

  • 类型:数字类型
  • 描述:中心点经度

padding:

  • 类型:数字类型
  • 描述:(选填项)视野范围与屏幕之间的距离(类似于padding)
  • 默认值:50

示例代码

var TencentMap = api.require('TencentMap');
var param = {
    "status":true,		//设置视野范围
    "status":false,		//取消视野范围设置
    "pointArray":[
        40.042893,
        116.269673,
        40.038951,
        116.275241,
        40.039970,
        116.275250
    ],
    "centerLat":40.040429,
    "centerLog":116.273525,
    "padding":50
}
TencentMap.setViewField(param);

可用性

Android系统,iOS系统

可提供的1.0.0及更高版本

setViewLimit

限制显示区域

说明:只能在一定区域内缩放、移动地图视野。

注意:此方法需要在showMap()之前调用;设置或取消区域显示限制,根据所传参数不同,都由本接口实现。

setViewLimit({params})

params

status:

  • 类型:布尔类型
  • 描述:限制显示区域开关
  • 取值范围:
    • true:开启
    • false:关闭

aLat:

  • 类型:数字类型
  • 描述:左上角坐标纬度

aLog:

  • 类型:数字类型
  • 描述:左上角坐标经度

bLat:

  • 类型:数字类型
  • 描述:右下角坐标纬度

bLog:

  • 类型:数字类型
  • 描述:右下角坐标经度

示例代码

var TencentMap = api.require('TencentMap');
var param = {
    "status":true,		//开启视野限制
    "status":false,		//取消视野限制
    "aLat":40.042893,
    "aLog":116.269673,
    "bLat":40.038951,
    "bLog":116.275241
}
TencentMap.setViewLimit(param);

可用性

Android系统,iOS系统

可提供的1.0.0及更高版本

drawSignInMap

绘制标记点

说明:在地图上标记一个经纬度坐标的覆盖物。

注意:此方法需要在showMap()之前调用;绘制或取消绘制标记点,根据所传参数不同,都由本接口实现。

signInMap({param},callback(ret))

params

status:

  • 类型:布尔类型
  • 描述:绘制标记点开关
  • 取值范围:
    • true:绘制
    • false:取消绘制

longitude:

  • 类型:数字类型
  • 描述:绘制点经度

latitude:

  • 类型:数字类型
  • 描述:绘制点纬度

isAllowClick:

  • 类型:布尔类型

  • 描述:(选填项)标记点是否允许被点击,允许后点击会返回该点经纬度、海拔

  • 取值范围:

    • true:允许
    • false:不允许
  • 默认值:false

isAllowDrag:

  • 类型:布尔类型
  • 描述:(选填项)标记点是否允许被拖动,允许后拖动会分别返回拖动前和拖动后的坐标经纬度、海拔
  • 取值范围:
    • true:允许
    • false:不允许
  • 默认值:false

flat:

  • 类型:布尔类型
  • 描述:(选填项)是否支持3D悬浮
  • 默认值:false

clockwise:

  • 类型:布尔类型
  • 描述:(选填项)设置旋转方向是否顺时针
  • 取值范围:
    • true:顺时针旋转
    • false:逆时针旋转
  • 默认值:true

rotation:

  • 类型:数字类型
  • 描述:(选填项)设置标记点旋转角度
  • 默认值:0

callback(ret)

ret:

  • 类型:JSON对象
  • 内部字段:
{
    "status":true				//布尔类型;当开启点击或拖拽后,返回以下字段
    "latitude":40.011313		//纬度
    "longitude":116.391907		//经度
    "altitude":0				//海拔
} 

示例代码

var TencentMap = api.require('TencentMap');
var param = {
    "status":true,
    "longitude":116.391907,
    "latitude":40.011313,
    "isAllowClick":true,
    "isAllowDrag":true,
    "flat":true,
    "clockwise":false,
    "rotation":30
}
TencentMap.signInMap(param,function(ret){
    console.log(JSON.stringify(ret));
});

可用性

Android系统,iOS系统

可提供的1.0.0及更高版本

drawPlaneInMap

绘制遮挡面

注意:此方法需要在showMap()之前调用;绘制或取消绘制遮挡面,根据所传参数不同,都由本接口实现。

drawPlaneInMap({param})

params

status:

  • 类型:布尔类型
  • 描述:绘制遮挡面开关
  • 取值范围:
    • true:开启
    • false:关闭

drawPlaneArr:

  • 类型:字符串类型

  • 描述:经纬度坐标点

  • 说明:例如,所传字符串为:

    • {"drawPlaneArr":"39.984864,116.305756,39.983618,116.305848,39.982347,116.305966,39.982412,116.308111,39.984122,116.308224,39.984955,116.308099,39.984864,116.305756"}
      

      由此说明,坐标点一:(39.984864,116.305756)、坐标点二:(39.983618,116.305848),以此类推

    • 坐标点经纬度顺序不能颠倒

    • 坐标点经纬度一一对应

示例代码

var TencentMap = api.require('TencentMap');
var param = {
    "status":true, //绘制遮挡面
    "status":false //取消绘制遮挡面   
    "drawPlaneArr":""
}
TencentMap.drawPlaneInMap(param)

可用性

Android系统,iOS系统

可提供的1.0.0及更高版本

drawCircleInMap

绘制标记圆

注意:此方法需要在showMap()之前调用;绘制或取消绘制标记圆,根据所传参数不同,都由本接口实现。

drawCircleInMap({param})

params

status:

  • 类型:布尔类型
  • 描述:绘制标记圆开关
  • 取值范围:
    • true:开启
    • false:关闭

longitude:

  • 类型:数字类型
  • 描述:圆中心点经度

latitude:

  • 类型:数字类型
  • 描述:圆中心点纬度

cirRadius:

  • 类型:数字类型
  • 描述:圆半径

示例代码

var TencentMap = api.require('TencentMap');
var param = {
    "status":true,		//绘制圆
    "status":false,		//取消绘制
    "longitude":116.307771,
    "latitude":39.984059,
    "cirRadius":1000
}
TencentMap.drawCircleInMap(param);

可用性

Android系统,iOS系统

可提供的1.0.0及更高版本

searchLocation

搜索地点并在地图中显示

注意:此方法需要在showMap()之前调用;开始或取消搜索,根据所传参数不同,都由本接口实现。

searchLocation({params},callback(ret))

params

status:

  • 类型:布尔类型
  • 描述:地点搜索开关
  • 取值范围:
    • true:开启
    • false:关闭

locationName:

  • 类型:字符串类型
  • 描述:搜索地点名称

locationCity:

  • 类型:字符串类型
  • 描述:搜索的区域/范围

autoExtend:

  • 类型:布尔类型

  • 描述:(选填项)如果在当前所设置区域内未找到地点,是否扩大区域

  • 取值范围

    • true:扩大范围
    • false:不扩大范围
  • 默认值:false

callback(ret)

ret:

  • 类型:JSON对象
  • 内部字段:
{
    "status":""					//布尔类型;true||false
    "code":""					//数字类型;错误码(地址查询错误时返回此字段)
    "msg":""					//字符串类型;错误信息(地址查询错误时返回此字段)
    "result0":{					//地址查找成功时返回此字段
        "address":"北京市海淀区北清路68号"		  //地址
        "title":"用友产业园"					     //建筑名称
        "tel":"010-62436688"					//联系电话
        "longitude":116.238672				    //经度
        "latitude":40.069065					//纬度
    }
    "result1":{									
        ...
    },
}

示例代码

var TencentMap = api.require('TencentMap');
var param = {
    "status":true,
    "locationName":"用友产业园",
    "locationCity":"北京",
    "autoExtend":false
}
TencentMap.searchLocation(param,function(ret){
    console.log(JSON.stringify(ret));
});

可用性

Android系统,iOS系统

可提供的1.0.0及更高版本

addressResolution

地址解析

说明:由地址描述到所述位置坐标的转换、并在地图上标注功能。

注意:此方法需要在showMap()之前调用;地址解析或取消解析,根据所传参数不同,都由本接口实现。

addressResolution({params},callback(ret))

params

status:

  • 类型:布尔类型
  • 描述:地址解析开关
  • 取值范围:
    • true:开启
    • false:关闭

address:

  • 类型:字符串类型
  • 描述:解析地址

region:

  • 类型:字符串类型
  • 描述:地址解析范围

callback(ret)

ret:

  • 类型:JSON对象
  • 内部字段:
{
    "status":true				//布尔类型;true||false
    "code":""					//数字类型;错误码(地址解析错误时返回此字段)
    "msg":""					//字符串类型;错误信息(地址解析错误时返回此字段)
    "province":"北京市"		  //省
    "city":"北京市"			  //市
    "district":"海淀区"		  //区
    "street":"海淀西大街"		 //街道
    "street_number":"74"		//街道代码
    "latitude":39.982915		//纬度
    "longitude":116.307015		//经度
}

示例代码

var TencentMap = api.require('TencentMap');
var param = {
    "status":true,	//地址解析
    "status":false, //取消
    "address":"北京市海淀区彩和坊路海淀西大街74号",
    "region":"北京"
}
TencentMap.addressResolution(param,function(ret){
    console.log(JSON.stringify(ret));
});

可用性

Android系统,iOS系统

可提供的1.0.0及更高版本

reAddressResolution

逆地址解析

说明:由坐标到坐标所在位置的文字描述转换功能

注意:此方法需要在showMap()之前调用;开启或取消逆解析,根据所传参数不同,都由本接口实现。

reAddressResolution({param},callback(ret))

params

status:

  • 类型:布尔类型
  • 描述:地址逆解析开关
  • 取值范围:
    • true:开启
    • false:关闭

longitude:

  • 类型:数字类型
  • 描述:经度

latitude:

  • 类型:数字类型
  • 描述:纬度

category:

  • 类型:字符串类型
  • 描述:解析所需服务类型的地点信息

callback(ret)

ret:

  • 类型:JSON对象
  • 内部字段:
{
    "status":""				//布尔类型;true||false
    "code":""				//数字类型;错误码(地址解析错误时返回此字段)
    "msg":""				//字符串类型;错误信息(地址解析错误时返回此字段)
    "result0":""			//解析结果
    "result1":""
    ...
}

示例代码

var TencentMap = api.require('TencentMap');
var param = {
    "status":true,		//开启地址逆解析
    "status":false,		//取消地址逆解析
    "latitude":39.984154,
    "longitude":116.307490,
    "category":"面包"
}
TencentMap.reAddressResolution(param,function(ret){
    console.log(JSON.stringify(ret));
});

可用性

Android系统,iOS系统

可提供的1.0.0及更高版本

queryDistrict

行政区查询

注意:行政区划的数据并不会经常更新,用户可以降低查询频率

stopFootOrRidePosition()

callback(ret)

ret:

  • 类型:JSON对象
  • 内部字段:
{
    "status":""					//布尔类型;true||false
    "msg":""					//字符串类型;查询错误信息(查询失败返回此字段)
    "result0":{
        "fullname":"北京市"	  //全称
        "name":"北京"			   //名称
        "latitude":39.90469		//纬度
        "longitude":116.40717	//经度
    }
    "result1":{
        "fullname":"天津市"
        "name":"天津"
        "latitude":39.0851
        "longitude":117.19937
    }
    ...
}

示例代码

var TencentMap = api.require('TencentMap');
module.queryDistrict(function(ret){
    console.log(JSON.stringify(ret));
})

可用性

Android系统,iOS系统

可提供的1.0.0及更高版本

planCarRoute

汽车路线规划

注意:此方法需要在showMap()之前调用;开始或取消路线规划,根据所传参数不同,都由本接口实现。

planCarRoute({params},callback(ret))

params

status:

  • 类型:布尔类型
  • 描述:汽车路线规划开关
  • 取值范围:
    • true:开启
    • false:关闭

fromLat:

  • 类型:数字类型
  • 描述:起点纬度

fromLog:

  • 类型:数字类型
  • 描述:起点经度

toLat:

  • 类型:数字类型
  • 描述:终点纬度

toLog:

  • 类型:数字类型
  • 描述:终点纬度

roadType:

  • 类型:字符串类型
  • 描述:(选填项)起点道路类型
  • 取值范围:
    • notConside:不考虑起点道路类型
    • aboveBridge:在桥上
    • belowBridge:在桥下
    • mainRoad:在主路
    • sideRoad:在辅路
  • 默认值:notConside

carPolicy:

  • 类型:字符串类型
  • 描述:(选填项)驾车规划策略1
  • 取值范围:
    • leastTime:参考实时路况,时间最短
    • pickup:接乘客
    • trip:送乘客
  • 默认值:leastTime

preference:

  • 类型:字符串类型
  • 描述:(选填项)驾车规划策略2
  • 取值范围:
    • navPointFirst:通过终点坐标查找所在地点(如小区/大厦等),并使用地点出入口做为目的地,使路径更为合理
    • avoidHighWay:不走高速
    • leastFee:少收费
    • realTraffic:参考实时路况
  • 默认值:navPointFirst

heading:

  • 类型:数字类型
  • 描述:(选填项)在起点位置时的车头方向,取值范围0~360(0度代表正北,顺时针)
  • 默认值:90

speed:

  • 类型:数字类型
  • 描述:(选填项)速度
  • 注意:当速度 < 1.39米/秒,heading属性值将被忽略
  • 默认值:3 m/s

accuracy:

  • 类型:数字类型
  • 描述:(选填项)定位精度
  • 注意:取大于0数值;当定位精度 > 30米时,heading属性值将被忽略
  • 默认值:30 m

callback(ret)

ret:

  • 类型:JSON对象
  • 内部字段:
{
    "status":""				//布尔类型;true||false
    "msg":""				//字符串类型;导航失败原因(路线规划失败时返回此字段)
    "code":""				//数字类型;错误码(路线规划失败时返回此字段)
    "distance":500609		//数字类型;导航距离
    "duration":638			//数字类型;所需时间
    "journeyThrough":[		//数组类型;导航过程坐标点经纬度
        {"lat":26.646451,"log":117.098207}
        {"lat":26.645536422729492,"log":117.09788513183594}
        {"lat":26.644926071166992,"log":117.09784698486328}
        ...
    ]
}

示例代码

var TencentMap = api.require('TencentMap');
var param = {
    "status":true,		//开启路线规划
    "status":false		//关闭路线规划
    "fromLat":26.66493,
    "fromLog":117.09568,
    "toLat":26.8857,
    "toLog":120.00514,
    "roadType":"roadType",
    "carPolicy":"pickup",
    "heading":90,
    "speed":10,
    "preference":"avoidHighWay",
    "accuracy":30,
}
TencentMap.planCarRoute(param,function(ret){
    console.log(JSON.stringify(ret));
})

可用性

Android系统,iOS系统

可提供的1.0.0及更高版本

planWalkRoute

步行路线规划

注意:此方法需要在showMap()之前调用;开始或取消路线规划,根据所传参数不同,都由本接口实现。

planWalkRoute({params},callback(ret))

params

status:

  • 类型:布尔类型
  • 描述:步行路线规划开关
  • 取值范围:
    • true:开启
    • false:关闭

fromLat:

  • 类型:数字类型
  • 描述:起点纬度

fromLog:

  • 类型:数字类型
  • 描述:起点经度

toLat:

  • 类型:数字类型
  • 描述:终点纬度

toLog:

  • 类型:数字类型
  • 描述:终点纬度

callback(ret)

ret:

  • 类型:JSON对象
  • 内部字段:
{
    "status":""				//布尔类型;true||false
    "code":""				//数字类型;错误码(路线规划失败时会返回该字段)
    "msg":""				//字符串类型;描述信息(路线规划失败时会返回该字段)
    "result":[
        {
            "distance":302						//行进距离
             "description":"行进302米,直行"		 //信息描述
            "direction":"西"						//行进方向
        }	
        ...
    ]
}

示例代码

var TencentMap = api.require('TencentMap');
var param = {
    "status":true,		//开启路线规划
    "status":false		//关闭路线规划
    "fromLat":40.15008,
    "fromLog":116.2956047,
    "toLat":40.06877,
    "toLog":116.2386506,
}
TencentMap.planWalkRoute(param,function(ret){
    console.log(JSON.stringify(ret));
})

可用性

Android系统,iOS系统

可提供的1.0.0及更高版本

planBikeRoute

骑行路线规划

注意:此方法需要在showMap()之前调用;开始或取消路线规划,根据所传参数不同,都由本接口实现。

planWalkRoute({params},callback(ret))

params

status:

  • 类型:布尔类型
  • 描述:骑行路线规划开关
  • 取值范围:
    • true:开启
    • false:关闭

fromLat:

  • 类型:数字类型
  • 描述:起点纬度

fromLog:

  • 类型:数字类型
  • 描述:起点经度

toLat:

  • 类型:数字类型
  • 描述:终点纬度

toLog:

  • 类型:数字类型
  • 描述:终点纬度

callback(ret)

ret:

  • 类型:JSON对象
  • 内部字段:
{
    "status":""			//布尔类型;true||false
    "code":""			//数字类型;错误码(路线规划失败时会返回该字段)
    "msg":""			//字符串类型;描述信息(路线规划失败时会返回该字段)
    "result":[
        {
            "distance":16							//距离
            "description":"从起点朝西,行进16米,偏左转"	 //描述信息
            "direction":"西"						    //行进方向
        }
        ...
    ]
}

示例代码

var TencentMap = api.require('TencentMap');
var param = {
    "status":true,		//开启路线规划
    "status":false		//关闭路线规划
    "fromLat":40.15008,
    "fromLog":116.2956047,
    "toLat":40.06877,
    "toLog":116.2386506,
}
TencentMap.planBikeRoute(param,function(ret){
    console.log(JSON.stringify(ret));
})

可用性

Android系统,iOS系统

可提供的1.0.0及更高版本

planBusRoute

公交地铁路线规划

注意:此方法需要在showMap()之前调用;开始或取消路线规划,根据所传参数不同,都由本接口实现。

planBusRoute({params},callback(ret))

params

status:

  • 类型:布尔类型
  • 描述:骑行路线规划开关
  • 取值范围:
    • true:开启
    • false:关闭

fromLat:

  • 类型:数字类型
  • 描述:起点纬度

fromLog:

  • 类型:数字类型
  • 描述:起点经度

toLat:

  • 类型:数字类型
  • 描述:终点纬度

toLog:

  • 类型:数字类型
  • 描述:终点纬度

isSubway:

  • 类型:布尔类型
  • 描述:路线规划中是否乘坐地铁
  • 取值范围:
    • true:不乘坐地铁
    • false:乘坐地铁
  • 默认值:false

callback(ret)

ret:

  • 类型:JSON对象
  • 内部字段:
{
    "status":""			//布尔类型;true||false
    "code":""			//数字类型;错误码(路线规划失败时会返回该字段)
    "msg":""			//字符串类型;描述信息(路线规划失败时会返回该字段)
    "line":[			//数组类型;路线规划详情
        {
            "vehicle":"SUBWAY"		//出行类型;
                                    //取值范围:"SUBWAY":地铁;"BUS":公交
            "title":"地铁昌平线"		 //线路名称
            "station_count":3		//经停站数量
            "geton":"沙河"		   //起点站
            "getoff":"生命科学园"	 //终点站
        }
        ...
    ]
}

示例代码

var TencentMap = api.require('TencentMap');
var param = {
    "status":true,		//开启路线规划
    "status":false		//关闭路线规划
    "fromLat":40.15008,
    "fromLog":116.2956047,
    "toLat":40.06877,
    "toLog":116.2386506,
    "isSubway":false
}
TencentMap.planBusRoute(param,function(ret){
    console.log(JSON.stringify(ret));
})

可用性

Android系统,iOS系统

可提供的1.0.0及更高版本

onOutLineMap

打开离线地图功能开关

注意:使用离线地图相关功能必须先实现此方法

onOutLineMap(callback(ret))

callback(ret)

ret:

  • 类型:JSON对象
  • 内部字段:
{
    "status":true		//布尔类型;开启成功
}

示例代码

var TencentMap = api.require('TencentMap');
module.onOutLineMap(param,function(ret){
    alert(JSON.stringify(ret));
})

可用性

Android系统,iOS系统

可提供的1.0.0及更高版本

offOutLineMap

关闭离线地图功能开关

offOutLineMap(callback(ret))

callback(ret)

ret:

  • 类型:JSON对象
  • 内部字段:
{
    "status":true		//布尔类型;关闭成功
}

示例代码

var TencentMap = api.require('TencentMap');
module.offOutLineMap(param,function(ret){
    alert(JSON.stringify(ret));
})

可用性

Android系统,iOS系统

可提供的1.0.0及更高版本

getOutLineMapData

获取可使用的离线地图数据资源列表

建议在使用离线地图功能前实现该方法。该方法的返回字段是作为离线地图中的下载、查询功能的必须参数。

getOutLineMapData(cakkback(ret))

callback(ret)

ret:

  • 类型:JSON对象
  • 内部字段:
{
    "status":false						//未打开离线地图开关时返回此字段
    "msg":"请检查是否打开离线地图开关"		//未打开离线地图开关时返回此字段
    "0":{
        "name":"全国概略图"				 //数据名称
        "size":7483562					//数据大小
        "isUpgrade":true				//是否需要更新;true代表数据需要更新;false代表数据已是最新
        "percentage":0					//数据百分比[0-100]
    }
    "1":{"name":"北京市","size":195609312,"isUpgrade":true,"percentage":0}
    "2":{"name":"上海市","size":192156603,"isUpgrade":true,"percentage":0}
    "3":{"name":"天津市","size":99778048,"isUpgrade":true,"percentage":0}
    "4":{"name":"重庆市","size":182727505,"isUpgrade":true,"percentage":0}
    "32":{"name":"香港特别行政区","size":38859740,"isUpgrade":true,"percentage":0}
    "33":{"name":"澳门特别行政区","size":6860485,"isUpgrade":true,"percentage":0}
    "34":{"name":"台湾省","size":43917885,"isUpgrade":true,"percentage":0}
}

示例代码

var TencentMap = api.require('TencentMap');
TencentMap.getOutLineMapData(function(ret){
    console.log(JSON.stringify(ret));
});

可用性

Android系统,iOS系统

可提供的1.0.0及更高版本

dlOffLineCityMap

获取某个城市的离线控制器、下载城市的离线地图

dlOffLineCityMap({param},callback(ret))

params

cityCode:

  • 类型:数字类型
  • 描述:城市
  • 说明:城市与数字之间的对应关系即为 getOutLineMapData() 的返回值。比如:此时参数传入 1 ,即代表我们需要下载“北京市”的离线地图数据,以此类推

callback(ret)

ret:

  • 类型:JSON对象
  • 内部字段:
{
    "status":""			//字符串类型;下载状态
                        //取值范围:
                        READY(准备开始)
                        START(开始下载)
                        DOWNLOADING(正在下载)
                        COMPLETED(下载完成)
                        CANCEL(取消下载)
    "process":""		//数字类型;下载进度
}

示例代码

var TencentMap = api.require('TencentMap');
var param = {
    "cityCode":3
}
TencentMap.dlOffLineCityMap(param,function(ret){
    console.log(JSON.stringify(ret));
});

可用性

Android系统,iOS系统

可提供的1.0.0及更高版本

stopOffLineCityMap

取消下载

stopOffLineCityMap(callback(ret))

callback(ret)

ret:

  • 类型:JSON对象
  • 内部字段
{
    "status":true
    "msg":"已停止下载"
}

示例代码

var TencentMap = api.require('TencentMap');
TencentMap.stopOffLineCityMap(function(ret){
    alert(JSON.stringify(ret));
});

可用性

Android系统,iOS系统

可提供的1.0.0及更高版本

clearOffLineCityMap

清除离线地图数据下载缓存

clearOffLineCityMap(callback(ret))

callback(ret)

ret:

  • 类型:JSON对象
  • 内部字段:
{
    "status":""			//布尔值;true||false
}

示例代码

var TencentMap = api.require('TencentMap');
TencentMap.clearOffLineCityMap(function(ret){
    alert(JSON.stringify(ret));
});

可用性

Android系统,iOS系统

可提供的1.0.0及更高版本

isOffLineCityUp

检查城市离线地图数据是否需要更新

isOffLineCityUp({param},callback(ret))

params

cityCode:

  • 类型:数字类型
  • 描述:城市
  • 说明:城市与数字之间的对应关系即为 getOutLineMapData() 的返回值。比如:此时参数传入 1 ,即代表我们需要下载“北京市”的离线地图数据,以此类推

callback(ret)

ret:

  • 类型:JSON对象
  • 内部字段:
{
    "name":""		//字符串类型;城市名称
    "status":""		//布尔类型;true||false
    "msg":""		//"离线地图数据需要更新"
                    //"离线地图数据已是最新"
}

示例代码

var TencentMap = api.require('TencentMap');
var param = {
    "cityCode":1
}
TencentMap.isOffLineCityUp(param,function(ret){
    alert(JSON.stringify(ret));
})

可用性

Android系统,iOS系统

可提供的1.0.0及更高版本

showOutLineMap

打开离线地图

注意:调用该方法前,首先需要调用onOutLineMap()、dlOffLineCityMap()方法;并且,showOutLineMap参数值所对应的城市地图数据需确保已经下载完毕;为确保离线地图打开成功,建议参数值与dlOffLineCityMap()参数值相同

showOutLineMap({param},callback(ret))

param

cityCode:

  • 类型:数字类型
  • 描述:城市
  • 说明:城市与数字之间的联系即为 getOutLineMapData() 的返回值。比如:此时参数传入 1 ,即代表我们打开“北京市”的离线地图,以此类推

callback(ret)

{
    "status":false			//布尔类型;未打开离线地图开关时返回此字段
    "msg":""				//字符串类型;取值范围:
                            //"请检查是否打开离线地图开关"(未打开离线地图开关时返回此字段)
                            //"cityCode错误或不支持离线地图"(传入了不存在的cityCode或不支持离线地图城市返回此字段)
                                            
}

##示例代码

var TencentMap = api.require('TencentMap');
var param = {
    "cityCode":3 	
}
TencentMap.showOutLineMap(param,function(ret){
    alert(JSON.stringify(ret));
});

可用性

Android系统,iOS系统

可提供的1.0.0及更高版本

carMoveAnimation

路线动态移动

注意:展示如何在地图上实现轨迹点的平滑移动效果;目前该方法不支持自定义样式

注意:此方法需要在showMap()之前调用;动态移动或取消移动,根据所传参数不同,都由本接口实现。

carMoveAnimation({params},callback(ret))

params

status:

  • 类型:布尔类型
  • 描述:路线动态移动开关
  • 取值范围:
    • true:开启
    • false:关闭

alignmentArr:

  • 类型:字符串类型
  • 描述:路线轨迹,具体格式如示例代码

示例代码

var TencentMap = api.require('TencentMap');
var param = {
    "status":true  		//开启
    "status":false  	//关闭
"alignmentArr":"39.98409,116.30804,39.98409,116.3081,39.98409,116.3081,39.98397,116.30809,39.9823,116.30809,39.9811,116.30817,39.9811,116.30817,39.97918,116.308266,39.97918,116.308266,39.9791,116.30827,39.9791,116.30827,39.979008,116.3083,39.978756,116.3084,39.978386,116.3086,39.977867,116.30884,39.977547,116.308914"
}
TencentMap.carMoveAnimation(param);

可用性

Android系统,iOS系统

可提供的1.0.0及更高版本

convertLoglat

经纬度转换为像素点

convertLoglat({params},callback(ret))

params

longitude:

  • 类型:数字类型
  • 描述:经度

latitude:

  • 类型:数字类型
  • 描述:纬度

callback(ret)

ret:

  • 类型:JSON对象
  • 内部字段:
{
    "x":803			//数字类型;横坐标像素
    "y":627			//数字类型;竖坐标像素
}

示例代码

var TencentMap = api.require('TencentMap');
var param = {
    "latitude":39.977290,
    "longitude":116.337000
}
TencentMap.convertLoglat(param,function(ret){
    alert(JSON.stringify(ret));
});

可用性

Android系统,iOS系统

可提供的1.0.0及更高版本

convertPoint

像素点转换成经纬度

convertPoint({params},callback(ret))

params

x:

  • 类型:数字类型
  • 描述:横坐标像素点

y:

  • 类型:数字类型
  • 描述:纵坐标像素点

callback(ret)

ret:

  • 类型:JSON对象
  • 内部字段:
{
    "latitude":39.977290		//纬度
    "longitude":116.337000		//经度
}

示例代码

var TencentMap = api.require('TencentMap');
var param = {
    "x":803,
    "y":627
}
TencentMap.convertPoint(param,function(ret){
    alert(JSON.stringify(ret));
});

可用性

Android系统,iOS系统

可提供的1.0.0及更高版本

setMapUIControls

设置UI控件

注意:此方法需要在showMap()之前调用;设置或取消设置,根据所传参数不同,都由本接口实现。

setMapUIControls({params})

params

status:

  • 类型:布尔类型
  • 描述:设置UI控件开关
  • 取值范围:
    • true:开启
    • false:关闭

logoSize:

  • 类型:数字类型
  • 描述:"腾讯地图"logo大小(logo只支持修改尺寸,不可隐藏)
  • 默认值:1

isCompassShow:

  • 类型:布尔类型
  • 描述:是否显示指南针
  • 取值范围:
    • true:显示
    • false:不显示
  • 默认值:false

isScaleShow

  • 类型:布尔类型
  • 描述:是否显示比例尺
  • 取值范围:
    • true:显示
    • false:不显示
  • 默认值:true

isfadeInOrOut

  • 类型:布尔类型
  • 描述:设置比例尺是否淡出
  • 取值范围:
    • true:是
    • false:否
  • 默认值:false

示例代码

var TencentMap = api.require('TencentMap');
var param = {
    "status":true,		//开启设置UI控件
    "status":false,		//关闭设置UI控件
    "logoSize":0.7,
    "isCompassShow":true,
    "isScaleShow":true,
    "isfadeInOrOut":true
}
TencentMap.setMapUIControls(param)

可用性

Android系统,iOS系统

可提供的1.0.0及更高版本

changeMapUIPosition

调整UI位置

changeMapUIPosition({param})

params

status:

  • 类型:布尔类型
  • 描述:调整UI位置开关
  • 取值范围:
    • true:开启
    • false:关闭

logoPosition:

  • 类型:数字类型
  • 描述:修改"腾讯地图"logo位置
  • 取值范围:
    • 0:左下角
    • 1:右下角
    • 2:右上角
    • 3:左上角
    • 4:底边中央
    • 5:顶部中央
  • 默认值:1

scalePosition:

  • 类型:数字类型
  • 描述:修改比例尺位置
  • 取值范围:
    • 0:左下角
    • 1:右下角
    • 2:右上角
    • 3:左上角
    • 4:底边中央
    • 5:顶部中央
  • 默认值:0

compassTop:

  • 类型:数字类型
  • 描述:指南针上边缘距离屏幕上边缘的值,单位:像素
  • 默认值:50

compassLeft:

  • 类型:数字类型
  • 描述:指南针左边缘距离屏幕左边缘的值,单位:像素
  • 默认值:50

示例代码

var TencentMap = api.require('TencentMap');
var param = {
    "status":true,		//修改UI控件位置
    "status":false,		//取消修改UI控件位置
    "logoPosition":3,
    "scalePosition":0,
    "compassTop":50,
    "compassLeft":100
}
TencentMap.changeMapUIPosition(param);

可用性

Android系统,iOS系统

可提供的1.0.0及更高版本

是否仍需要帮助? 请保持联络!
最后更新于 2024/10/21