JS API 的加载 最后更新时间: 2023年03月30日

JS API 2.0 版本提供了两种方案引入：

1. 使用 JS API Loader 进行加载；

2. 以<script>标签的方式加载；

准备

使用 JS API Loader (推荐)

JS API Loader 是我们提供的 API 加载器，可帮助开发者快速定位、有效避免加载引用地图 JS API 各种错误用法，具有以下特性：

• 支持以 <script>标签和 npm 包两种方式使用；
• 有效避免错误异步加载导致的 JS API 资源加载不完整问题；
• 对于加载混用多个版本 JS API 的错误用法给予报错处理；
• 对于不合法加载引用 JS API 给予报错处理；
• 支持指定 JS API 版本；
• 支持插件加载；
• 允许多次执行加载操作，网络资源不会重复请求，便于大型工程模块管理；
• 支持 IE9 以上的浏览器，不支持 IE8 以下

<script> 标签加载 Loader 

使用<script>标签加载 loader.js

<script src="https://webapi.amap.com/loader.js"></script>
<script type="text/javascript" >
  window._AMapSecurityConfig = {
  securityJsCode:'「您申请的安全密钥」',
}
AMapLoader.load({
  "key": "",              // 申请好的Web端开发者Key，首次调用 load 时必填
  "version": "2.0",   // 指定要加载的 JS API 的版本，缺省时默认为 1.4.15
  "plugins": [],           // 需要使用的的插件列表，如比例尺'AMap.Scale'等
  "AMapUI": {             // 是否加载 AMapUI，缺省不加载
    "version": '1.1',   // AMapUI 版本
    "plugins":['overlay/SimpleMarker'],       // 需要加载的 AMapUI ui插件
  },
  "Loca":{                // 是否加载 Loca， 缺省不加载
    "version": '2.0'  // Loca 版本
  },
}).then((AMap)=>{
  var map = new AMap.Map('container');
  map.addControl(new AMap.Scale());
}).catch((e)=>{
  console.error(e);  //加载错误提示
});   
</script>

NPM 安装 Loader

安装：

npm i @amap/amap-jsapi-loader --save

 使用 NPM 安装 Loader，并设置 key 和安全密钥：

import AMapLoader from '@amap/amap-jsapi-loader';
window._AMapSecurityConfig = {
  securityJsCode:'「您申请的安全密钥」',
}
AMapLoader.load({
  "key": "",              // 申请好的Web端开发者Key，首次调用 load 时必填
  "version": "2.0",   // 指定要加载的 JS API 的版本，缺省时默认为 1.4.15
  "plugins": [],           // 需要使用的的插件列表，如比例尺'AMap.Scale'等
}).then((AMap)=>{
  map = new AMap.Map('container');
}).catch(e => {
  console.log(e);
})

<script> 标签加载 JS API 脚本

同步加载

<script> 标签加载 JS API 2.0

<div id='container' ></div>
<script type="text/javascript">
  window._AMapSecurityConfig = {
  securityJsCode:'「您申请的安全密钥」',
}
</script>
<script type="text/javascript" src="https://webapi.amap.com/maps?v=2.0&key=您申请的key值"></script> 
<script type="text/javascript" >
  // 地图初始化应该在地图容器div已经添加到DOM树之后
  var map = new AMap.Map('container', {
    zoom:12
  })
</script>

异步加载

使用appendChild()：

//设置您的安全密钥
window._AMapSecurityConfig = {
  securityJsCode:'「您申请的安全密钥」',
}
// 声明异步加载回调函数
window.onLoad  = function(){ 
  var map = new AMap.Map('container');
}
var url = 'https://webapi.amap.com/maps?v=2.0&key=您申请的key值&callback=onLoad';
var jsapi = document.createElement('script');
jsapi.charset = 'utf-8';
jsapi.src = url;
document.head.appendChild(jsapi);

使用 async 属性：

// 声明异步加载回调函数
<script  type="text/javascript" >
  //设置您的安全密钥
  window._AMapSecurityConfig = {
  securityJsCode:'「您申请的安全密钥」',
}
window.onLoad  = function(){ 
  var map = new AMap.Map('container');
}
</script>
<script src="https://webapi.amap.com/maps?v=2.0&key=您申请的key值&callback=onLoad" async="async"  type="text/javascript" ></script>