开发注意事项
最后更新时间:2025-03-13
-
开发者必须到腾讯地图官网申请开发者Key,才能正常使用SDK的功能,如果输入Key不正确,则地图无法正常浏览,所有的查询功能都无法使用。
-
Key的输入位置,统一在AndroidManifest.xml文件中输入,其他地方输入无效,具体位置请参见demo或者开发指南。
-
项目必须使用UTF-8编码格式,如果出现类似“at java.net.URLEncoder.encode”的错误,请检查项目编码格式
-
建议使用继承自官方demo里的SupportMapFragmentActivity类的窗体来装载地图,因为SupportMapFragmentActivity会自动管理MapView的生命周期。如果不使用,则开发者需要自己管理MapView的生命周期。
-
如果出现oom(Out of Memory)异常,请确认是否使用了继承自官方demo里的SupportMapFragmentActivity的类来装载地图,如果没有使用,则需要在相应的父窗体生命周期函数里,调用MapView的相应生命周期方法,如MapView.onPause(),MapView.onDestroy()等。如果因为开发者其他功能占用太多内存而影响到地图模块的内存使用,建议把地图模块放在独立进程中运行,可以通过设置Activity的LaunchMode实现。
-
地理编码类GeocoderSearch的地理编码功能,如果查询没有结果,建议加入行政区划信息,或者使用更加详细的位置描述,例如,如果查询“银科大厦”没有结果,可以使用“北京海淀区银科大厦”。
-
地图SDK不包含定位功能,如果用户想使用定位功能,可以使用单独的腾讯定位SDK。
-
地图SDK使用国测局坐标系,GPS坐标需要转换到国测局坐标系,才能在腾讯地图中正确标注,目前暂时不提供坐标转换方法。使用腾讯定位sdk获取的坐标,是可以在腾讯地图SDK中正确标注的。
-
如有问题,可以到腾讯地图开发者论坛或者技术支持qq群寻求帮助。
数据安全说明
为了保障用户的数据安全及APP的合规使用,在调用腾讯地图SDK时需要传入用户的实际位置信息,腾讯地图SDK会基于用户所在位置动态分配对应服务,对于上传的定位内容仅读取,不保存到本地,也不上传服务器;
新增接口如下:
类 | 方法&属性 | 说明 |
---|---|---|
CustomLocationProvider |
void setMyLocationSource(CustomLocationProvider.MyLocationSource myLocationSource) |
设置定位源 |
void setMyLocationSource(Handler requestHandler, CustomLocationProvider.MyLocationSource myLocationSource) |
设置定位源,支持指定发起请求过程的线程 | |
MyLocationSource |
Location getMyLocation() |
新增定位源接口 |