腾讯地图Android SDK是一套基于Android1.6及以上设备的应用接口,通过该接口,您可以方便地访问腾讯地图为您提供的高质量地点数据和服务,构建丰富而实用的地图及位置服务类应用。腾讯地图Android SDK除提供创建底图、缩放、平滑移图等基础功能外,还提供定位、 逆地址解析、实时路况等拓展服务,助您在应用开发中事半功倍。腾讯地图Android SDK的服务需要注册,免费向第三方提供,任何非盈利性网站均可使用。
目前腾讯手机地图SDK没有单日调用上限的限制。
腾讯手机地图SDK提供了基本的地图构建,POI搜索,反地址解析,实时路况;自定义图层等丰富功能,具体的内容您可以详细阅读 参考手册进行进一步的了解。
或者是在代码中配置key
打开Android 应用工程的”AndroidManifest.xml“配置文件,package属性所对应的内容为应用包名。
在控制台的Key设置页面,可以在如下图的位置,设置key与package的对应关系。
可以在官网下载资源包中查看,例如TencentMapSDK_Android_3D_v4.3.5,当前您下载的SDK版本是4.3.5。
2D地图功能单一包含地图显示、绘制Marker、圆形、矩形、线段和一些基本的地图事件操作。但是由于2D地图SDK已经停止更新,建议开发者使用最新的3D地图SDK。
3D地图效果炫,支持旋转,3D楼块,提供更多实用接口如热力图、个性化图层、路况、GroundOverlay、离线地图等。
//使用以下方法可以指定地图显示中心点的坐标
//获得指定城市中心点的经纬度坐标,可以使用以下方法设置设置地图的可视区域。
常见的白屏原因是地图正常绘制渲染,但内部资源没有被正常加载,请开发者检查一下网络、权限、存储是否正常。 另外,Android 10的适配版本为4.2.8,请同步更新SDK版本。
黑屏情况主要的可能原因是地图没有正常绘制渲染,请开发者检查一下地图视图有没有正常绑定各个生命周期方法。
初始化崩溃常见的问题是地图引擎库没有正常配置,或者混淆出现问题导致,请参考工程配置进行完整的配置。
//开启路况服务
检查地图KEY是否已经授权了室内图能力,并绑定了指定的室内建筑,再调整地图缩放级别到室内图可用级别。
您需要将MapView替换为TextureMapView 修改参考如下代码:
修改为:
目前地图SDK只有海外地图可以切换英文和中文显示,国内地图目前只支持中文。
地图SDK从4.3.5版本开始,支持离线地图功能,具体使用请参考开发指南中的离线地图。
可以通过的接口tencentMap.setPoisEnabled(boolean enabled)来设置是否显示POI。
可以通过tencentMap.setBuildingEnable(boolean use3DStyle)来设置是否显示3D楼块。
可以通过marker. setFixingPoint(int x, int y);方法将Marker点固定设置在屏幕的某个位置。
Marker是绘制在地图之上的图片资源,当使用海量的Marker数据时,为了性能体验,建议使用点聚合来辅助显示。
Marker支持Animation动画,目前支持平移、缩放、旋转、渐变四种。 可以通过marker.setAnimation(Animation animation); 设置动画。
支持。使用View型InfoWindow可支持自定义View,然后使用Drawable动画来实现Gif动效。
在实现该接口方法时候,应该在接口的实现内部提供一个无父级的View对象。另外,需要注意一个问题:在接口实现中,不能调用Marker.showInfoWIndow,否则会导致方法循环调用。
Marker提供了setZIndex(float zIndex) 方法,相同显示level,zIndex值大的会覆盖在值小的上面。
在创建Polygon数据模型时,需要注意传入的坐标要按照顶点连接顺序传入,保证图形闭合时顶点连线不会交叉。
需保证最上层显示的文本信息中PolylineOptions.TextPriority的属性为:HIGH
可以通过polygon.setLevel(int level)来设置Polygon与楼块,道路,POI的显示层级关系。 相同Level内的显示层级关系通过polygon.setZIndex(int zIndex) 来控制,zIndex越大越靠上显示。
线覆盖物与其他图形不同,由于一般线是绘制在道路中的,因此具有POI避让规则,会让线周围的POI自动隐藏。
如果您的key的WebServiceAPI功能开启了签名校验,就不能直接使用SDK的检索功能了,需要按照签名规则通过HTTP请求WebService接口的方式来实现检索功能。如果您要直接调用SDK中封装好的API来实现检索功能,那在Key的配置中的WebServiceAPI不要勾选SK校验。
2D地图SDK没有提供检索功能接口,建议您将SDK升级到3D地图SDK,或者使用HTTP请求WebService API的接口来实现检索功能。
SearchParam param = new SearchParam(String keyword,Boundary boundary);参数keyword不可以设置为null或空字符串。 API的接口来实现检索功能。
通过MyLocationStyle设置自定义小蓝点样式
SDK4.3.5版本新增 tencentMap.setMyLocationClickListener(OnMyLocationClickListener var1) , 监听方法,该方法会在点击定位图标时调用。
定位精度圈会根据当前定位信息的精度来缩放。定位圈越大,精度越低;定位圈越小,精度越高。在室外一般精度会高一些,室内由于gps信号不好,精度就会低。
1).商户标注问题请关注“腾讯位置服务”公众号反馈;
2).开发问题请在此页面(https://lbs.qq.com/dev/console/ticket/list )提交工单反馈。