使用须知 | JSAPI GL | 百度地图开放平台文档中心

所有文档

JSAPI GL

服务介绍升级指南类参考示例DEMO 更新日志常见问题 GL工具库BMapGLLib BMap Draw

其他版本

友情链接

更新时间: 2026/07/27 10:37

您当前查看的是 JSAPI GL 历史版本文档。该版本仅用于维护现有项目，不建议用于新项目开发。新项目请使用 JSAPI 4.0，如需升级现有项目，请参考升级指南。
You are viewing the legacy JSAPI GL documentation. This version is maintained for existing projects only and is not recommended for new development. For new projects, use the JSAPI 4.0 documentation. If you are upgrading an existing project, please refer to the Migration Guide.

使用须知

服务版本说明书

JavaScript API GL 是基于WebGL全新开发的地图API接口，为了方便开发者迁移升级，大部分接口向下兼容。JavaScript API GL的使用方式请参考开发指南，详细的接口类说明请参考类参考文档，快速了解JavaScript API GL可支持的功能请参考示例中心提供的示例demo。

异步加载

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绘制，若仍然存在兼容性问题，则会降级到瓦片图渲染，确保不同浏览器环境的用户都可以完成地图的基本渲染。

获取技术支持途径

如果您在使用百度地图API中遇到问题，请尝试通过以下途径解决：

确认您使用了正确的地图API地址和API接口。
查看常见问题，自助排查。
通过反馈平台提工单进行反馈。

账号和获取密钥

Hello World

本篇文章对您是否有帮助？