JavaScript API

1、使用附加库library时为什么会出错?

请注意附加库的调用方式,libraries参数用来指明加载的附加库,可以指定多个附加库名称,名称之间用英文半角字符逗号","分隔。比如:

2、设置控件位置时,样式为什么不生效?

需要将qq.maps.ZoomControlStyle.DEFAULT中的DEFAULT改为LARGE。

3、同步创建map和marker,渲染marker是否是同步

如果同步创建map和marker,地图初始化是异步的,所以会导致marker的渲染是异步的,如果想要marker的渲染同步化,则可以先监听地图的idle事件再创建marker。但监听marker的点击事件是不会受到异步影响的。

4、如何一次性清除地图所有覆盖物?

目前没有一次性清除方法,需要依次对覆盖物调用setMap(null)方法。

5、如何获取地图所有覆盖物?

目前不支持获取所有覆盖物。

6、地图 marker 标记太多卡顿,怎么优化?

方案一是使用v2的可视化附加库,用2D散点图来实现;

方案二是切换到GL版本,使用MultiMarker或者3D散点图来实现都可以 (推荐方案二); v2的2D散点图可以支持10w量级,GL的MutliMarker和Dot都支持百万量级。

7、腾讯地图的事件如何阻止冒泡,e.stopPropogation无效?

先在地图容器上监听事件,再调用stopPropogation。

8、有没有API获取多边形的中心点?

没有,推荐用turf.js

9、DrawingManager 在h5端无法绘制多边形围栏?

v2绘图工具不支持在移动端绘制几何图形,只支持在PC端通过鼠标进行操作。如果业务有需求,可以使用JSAPI GL的绘图工具。(因为移动端只能点击,不能滑动,也就是没有mousemove事件,所以除了marker之外其他几何图形都不能绘制)

10、IE浏览器中无法显示矢量图形? IE浏览器报错:对象不支持“setLineDash”属性或方法?

IE5-8不支持Canvas和SVG,请升级或更换浏览器。

11、JavaScript API封装的地址解析访问为何受限?

此功能根据ip受限,每分钟最多100次。

12、无法加载地图,报错:qq.maps.XXX is not a constructor?

该报错表明代码执行时JavaScript API未能完全加载或者加载失败,请优先自查使用JavaScript API的代码片段是否在onload事件之后。

13、为什么在PC上标记点与实际经纬度位置有偏差?

请您先自查经纬度坐标系是否为GCJ-02,若不是则需要通过convertor附加库进行坐标转换。

14、JavaScript API能否提供npm包,或者能否下载地图JavaScript API非压缩?

目前JavaScript API 没有提供npm包,JavaScript API GL的npm包在规划中,敬请期待!

15、如何区分JavaScript API 和 JavaScript API GL?

JavaScript API与 JavaScript API GL是完全独立的两套Web地图引擎。JavaScript API GL是基于WebGL实现的全新3D地图引擎,除了接口与JavaScript API有细微差别,还提供3D视角、室内地图、个性化地图等功能,以及更优化的渲染效果和更流畅的交互体验。

16、JavaScript API 和 JavaScript API GL地图的缩放级别?

JavaScript API缩放等级为3-18级;JavaScript API GL缩放等级为3-20级。

17、鉴权失败,请正确上传key?

您需要在引入JavaScript API时带上key,<script charset="utf-8" src="https://map.qq.com/api/js?v=2.exp&key=YOUR_KEY"></script>

18、vue调用地图显示失败?

出现这个问题可能是您多次重复初始化地图,需要您自查下代码,定位动态变化时可以使用setCenter或其他接口改变地图中心点,应避免重新创建一个新的地图。

19、使用需要注册吗?

需要注册,腾讯位置服务JavaScript API采用申请Key策略, 您只要接受并认可《腾讯地图API使用条款》,申请Key ,并按照参考手册进行开发,即可直接调用。

20、API中使用什么坐标体系?

腾讯地图API使用经纬度坐标,单位为“度”。

JavaScript API GL

1、高速路牌怎么隐藏?

可以设置baseMap,features设为['base', 'building3d', 'point']。

2、GL是否有vue版本的?

没有。

3、JavaScript API GL点聚合自定义样式怎么设置?

参见 https://lbs.qq.com/javascript_gl/doc/markerClusterOptions.html 的enableDefaultStyle方法。

4、实例创建后内存飙升,切换路由时可否销毁腾讯地图的实例?

切换路由的时候可能创建了多个实例,可以使用destroy销毁地图,也可以使用单例模式解决。

5、JavaScript API GL的marker添加多个标记后,如何显示和隐藏某一个标记或者多个标记?

目前没有提供这样的接口控制显示隐藏,可以考虑使用add和remove接口。

6、JavaScript API GL怎么禁用缩放控件和比例尺?

可参考如下链接:https://lbs.qq.com/webDemoCenter/glAPI/glMap/mapControl

7、暂停小车移动了之后,再次启动小车,小车从暂停的点继续移动或从起点开始移动的方式是什么?

resumeMove是从暂停点,moveAlong是重新开始。

8、vue框架如何实现自定义覆盖物?

1). 实现自定义覆盖物,需要继承JavaScript API GL对外提供的DOMOverlay,并复写其中的一些方法

2). 在createDom方法中获取自己需要的dom并作为返回值。dom可以通过document.createElement动态创建;也可以通过document.getElemetById等方法获取已经存在的dom,然后直接使用

3). 实例化DOMOverlay时,执行的顺序是onInit ,createDom

4). 示例可以参考如下链接:https://lbs.qq.com/webDemoCenter/glAPI/glOverlay/domOverlay

9、JavaScript API GL手机端无法点击自定义覆盖物,官网的on方法无响应?

电脑端和移动端点击事件不一样,pc端可参考demo如下:https://lbs.qq.com/webDemoCenter/glAPI/glOverlay/domOverlay。移动端可参考使用touchstart方法

10、JavaScriptAPI GL标注是否有draggable功能?

如果希望拖拽移动Marker,需要使用编辑器接口且开启编辑交互,将Marker图层传入编辑器中设为激活态。

另一种方案是,如果点标注不多的话,建议基于DOMOverlay来实现点标注,可自定义交互功能。

11、JavaScript API GL的marker动画功能后期会支持吗?

MultiMarker不支持动画,官网已新增支持动画的marker的示例demo,链接参考如下:https://lbs.qq.com/webDemoCenter/glAPI/glOverlay/markerFlash

12、JavaScript API GL支持3D模式下拾取建筑模型吗?

不支持。

13、JavaScript API GL是否支持省级轮廓图高亮显示?

1). 如果用户本身就有这个省份的轮廓数据,且搜出来的地点带着省份信息,可以利用可视化api的区域图画出来。或者JavaScript API GL的multiPolyline,multiPolygon画出来。

2). 如果用户没有这个省份的轮廓数据,由于目前还没有提供这种省份轮廓数据,所以无法实现此功能

14、JavaScript API GL在创建个性化地图上与JavaScript API有什么不同吗?

JavaScript API通过加载栅格瓦片显示个性化样式,由于只有4套栅格瓦片,所以只支持4套模板;

JavaScript API GL是加载矢量数据和个性化样式文件来显示个性化样式,所以支持自定义的样式。

15、Angular JS、Vue JS、React JS框架如何引入?

Angular JS、Vue JS、React JS 是 JavaScript 框架,可通过script标签添加到 HTML 页面。建议您使用异步的方式进行加载。异步加载可以减少API引用之后脚本的等待执行,https建议使用异步方式。GL同时也支持同步和异步加载两种方式

同步:https://lbs.qq.com/webDemoCenter/glAPI/glMap/createMap

异步:https://lbs.qq.com/webDemoCenter/glAPI/glMap/mapAsync

16、为什么卫星图层不展示?

因卫星图层不是完全覆盖所有地区的,部分城市会没有卫星图层效果,图层提示信息为“此区域无卫星图”。

17、自定义地图不显示如何反馈?

您这边可以在“控制台-我的工单-个性化地图”提交相关信息反馈给相关工作人员。

18、JavaScript API和JavaScript API GL 能调用地点云数据管理台的数据吗?如何调用?

能调用。JavaScript API和JavaScript API GL是地图显示的部分,与访问地点云不直接相关。可以通过JSONP访问。

位置数据可视化API

1、位置可视化的热力图,最大数据量的渲染时间是多少?

大概5w左右保持流畅,建议在使用热力图最好先对单点数据做一次聚合,不然一方面是影响性能,第二方面是热力图会呈现较强的锯齿感,不够平滑。

2、散点图和热力图支持多少条数据展示?

10万条数据量展示

3、迁徙图和区域图支持多少条数据展示?

1万条数据量展示

地图组件

1、geolocation.watchPosition 时 页面会跳出 是否允许***.com 的位置请求。有什么方法可以禁止弹出事件?

没有,这个是浏览器授权操作。

2、在公众号调用组件,获取的位置不正确?

在公众号调用组件,没有调起定位授权,导致的定位失败,推测可能是浏览器对外部页面的定位授权做了限制,定位授权功能是不受组件控制的,可以尝试使用微信的JSSDK中获取地理位置接口:https://developers.weixin.qq.com/doc/offiaccount/OA_Web_Apps/JS-SDK.html#36 获取到经纬度,然后将获取的坐标传给 “选点组件”(coord参数)的方式来实现对当前位置的检索,看下能否解决问题。

3、地图选点组件是否支持远近排序?

暂不支持按定位点远近排序

4、fultter使用选点组件键盘无法收起?

此为官方flutter_webview插件问题,请使用flutter_webview_plugin插件。

5、无法获取选点列表?

选点组件需要用到webserviceAPI服务,请查看官网-控制台-key设置是否开启webservice服务。

6、调用前端定位组件总是走失败逻辑是什么原因,如何解决?

您可以查看以下几个因素是否有问题:

1)、请查看是否使用Https服务,如果不是,请切换https;

2)、定位时长timeout是否设置的合适,时间太小定位容易失败,建议5s以上;

3)、是否打开了定位权限;

4)、先确认扫描官网二维码是否正常,若正常,说明定位组件本身没有问题,确认在定位时是否有调起定位授权,如果没有调起定位授权,非定位组件原因,可能是浏览器阻止了定位授权,部分解决方案如下:

a)、如果您使用的是方法一,请您尝试方法二或者三看是否解决问题;

b)、您可以使用微信公众号的定位方法https://developers.weixin.qq.com/doc/offiaccount/OA_Web_Apps/JS-SDK.html#36,详细地址可以采用webserviceAPI的逆地址解析服务来解决;

c)、关于APP中使用webview嵌入的问题,组件是给H5使用的,在app中嵌入,会受到webview内核等各种因素的限制,导致无法正常定位。

7、组件定位时提示信息是:apis.map.qq.com 需要获取您的地理位置,这个可以改成自己的域名提示吗?

定位组件不支持修改定位发起域名。

8、授权弹框每次拒绝后,再次打开不提示?如何唤起弹框?

定位授权弹框是浏览器行为,定位组件暂时不控制。

9、腾讯位置服务在PC端测试过程中使用定位组件,一直显示定位中,没有地图显示?

目前地图提供的组件只支持手机端使用,PC端无法使用H5定位组件。

10、什么是地图组件?

地图组件是专为移动端定制的轻应用产品,支持各手机端主流浏览器,可以实现位置展示、路线规划、地图选点、前端定位等多种场景的下的调用。相比于JS API, 可以通过高度参数化的URL直接调用,极大简化开发的复杂度,降低维护成本。

11、使用需要注册吗?

需要注册,腾讯地图地图组件采用申请KEY策略,您只需简单几步,申请好开发者KEY,并按照 开发指南 进行开发,即可开始使用。

12、对移动端设备有什么要求吗?

适用于Android和iOS系统的移动端设备。

13、访问次数有限制吗?

选点组件受webserviceAPI配额影响,其他组件不受影响。

14、如何反馈使用中碰到的问题?

腾讯位置服务产品咨询和意见反馈:https://lbs.qq.com/dev/console/ticket/list

15、定位弹窗是否支持隐藏?

不支持,弹窗是由浏览器控制,组件无法进行干涉。

16、地图组件的URL地址可以在PC上打开吗?

PC端也可以打开地图组件的URL链接,但是由于无法支持地图手势操作以及位置定位,因此没有在移动端的用户体验好。地图组件是应用于移动端的。

URI API

1、为什么通过URL打开地图时,没有显示路线?

请检查参数是否填写完成,格式是否正确。如果希望了解详细的参数错误信息,请在URL中增加debug=true参数,进入调试模式。例:https://apis.map.qq.com/uri/v1/routeplan?type=bus&to=中关村&tocoord=39.9836,116.3164&referer=tengxun&debug=true