使用须知
更新时间:2020年08月07日
服务版本说明书
JavaScript API GL v1.0 是基于WebGL全新开发的地图API接口。为了方便开发者迁移升级,大部份接口向下兼容。目前GL v1.0版本接口包含了3D地图的渲染、基本控件、覆盖物。在后面的版本中,将对原v2.0、v3.0中的核心功能进行补全。目前版本支持的主要功能如下表所示:
分类 | 功能 | 接口 | 说明 |
核心 | 3D地图渲染 | Map | 支持3D地图、无级缩放、调整地图视野倾斜角、旋转角度和地球模式。支持核心属性的配置,鼠标交互事件等 |
控件 |
比例尺控件 | ScaleControl | 根据地图缩放级别自动调整比例尺长度和单位 |
缩放控件 | ZoomControl | 控制地图放大或缩小zoom级别 | |
覆盖物 |
点 | Marker | 点覆盖物,基本向下兼容旧版本功能 |
折线 | Polyline |
折线覆盖物,基本向下兼容旧版本功能 | |
多边形 | Polygon | 多边形覆盖物,基本向下兼容旧版本功能 | |
圆形 | Circle |
圆形覆盖物,基本向下兼容旧版本功能 |
移动平台上的地图应用开发
JavaScript API GL版本对手机性能要求较高,当前版本不建议在移动端调用。若涉及移动端JS服务调用,请使用JavaScript API v3.0版本:
异步加载
JavaScript API GL v1.0支持异步加载,您可以在引用脚本的时候添加callback参数,当脚本加载完成后callback函数会被立刻调用。请参考下面的使用示例:
<!DOCTYPE html> <html> <head> <meta charset="utf-8"/> <title>异步加载</title> <script type="text/javascript"> function initialize() { var mp = new BMapGL.Map('map'); mp.centerAndZoom(new BMapGL.Point(121.491, 31.233), 11); } function loadScript() { var script = document.createElement("script"); script.src = "https://api.map.baidu.com/api?v=1.0&type=webgl&ak=您的密钥&callback=initialize"; document.body.appendChild(script); } window.onload = loadScript; </script> </head> <body></body> </html>
兼容性
JavaScript API GL v1.0 基于WebGL开发,对于用户的浏览器环境有兼容性要求。需要完整支持WebGL的现代浏览器来支持渲染。对于WebGL支持欠佳的浏览器会降级为Canvas绘制,若仍然存在兼容性问题,则会降级到瓦片图渲染。确保不同浏览器环境的用户都可以完成地图的基本渲染。
获取技术支持途径