web端常见问题-地图开放平台| 腾讯位置服务

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

请注意附加库的调用方式，libraries参数用来指明加载的附加库，可以指定多个附加库名称，名称之间用英文半角字符逗号","分隔。比如： <script src="https://map.qq.com/api/js?v=2.exp&key=YOUR_KEY&libraries=drawing,geometry,autocomplete,convertor"></script>

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

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

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

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

6、地图 marker 标记太多卡顿，怎么优化？

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

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

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

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

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 ，并按照参考手册进行开发，即可直接调用。

1、高速路牌怎么隐藏？

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

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、为什么卫星图层不展示？

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

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

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

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

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

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

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

在公众号调用组件，没有调起定位授权，导致的定位失败，推测可能是浏览器对外部页面的定位授权做了限制，定位授权功能是不受组件控制的，可以尝试使用微信的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内核等各种因素的限制，导致无法正常定位。