{"_rev":"3-56c55b0043f28b51a8de684c99b07aac","time":{"created":"2026-09-12T00:34:02.784Z","modified":"2026-09-12T00:34:03.226Z","1.0.1":"2026-09-10T02:53:16.867Z","1.0.4":"2026-09-12T00:34:02.991Z"},"_id":"z-amap-jsapi-loader","name":"z-amap-jsapi-loader","dist-tags":{"latest":"1.0.4"},"versions":{"1.0.4":{"name":"z-amap-jsapi-loader","version":"1.0.4","description":"amap jsapi Loader","main":"dist/index.js","types":"index.d.ts","author":{"name":"zlink.org.cn"},"license":"MIT","devDependencies":{"@ampproject/rollup-plugin-closure-compiler":"^0.23.0","@babel/core":"^7.8.7","@babel/preset-env":"^7.8.7","rollup":"^1.32.0","rollup-plugin-babel":"^4.3.3","rollup-plugin-server":"^0.7.0","rollup-plugin-typescript2":"^0.27.1","typescript":"^3.9.7"},"_id":"z-amap-jsapi-loader@1.0.4","gitHead":"fe856b667b5448a2f8bda981297c60c4222d6111","_nodeVersion":"22.14.0","_npmVersion":"10.9.2","dist":{"integrity":"sha512-r9qsaQ8r+m3U2GgiRHY6ceFD55qcIgCeUm+c1z+Q4NT88jUprAiFmkHHggpozX659jvYNeAmOmt83bnNi63+tw==","shasum":"99a7e5b175a53331d70b73b6089ab4bacafb74d4","tarball":"https://registry.npmjs.org/z-amap-jsapi-loader/-/z-amap-jsapi-loader-1.0.4.tgz","fileCount":7,"unpackedSize":23212,"signatures":[{"keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U","sig":"MEYCIQCbwA6Mor4zzRr+7XV0C9jxaTg3NRjXbiGFxJtCjf+lZAIhAPaCcK41+AMTDPoTN5UyCzyDAdgo9FVBNF4MvTmr8DrT"}]},"_npmUser":{"name":"zlink.org.cn","email":"385680223@qq.com"},"directories":{},"maintainers":[{"name":"zlink.org.cn","email":"385680223@qq.com"}],"_npmOperationalInternal":{"host":"s3://npm-registry-packages-npm-production","tmp":"tmp/z-amap-jsapi-loader_1.0.4_1789173242859_0.02087724545583125"},"_hasShrinkwrap":false}},"maintainers":[{"name":"zlink.org.cn","email":"385680223@qq.com"}],"description":"amap jsapi Loader","author":{"name":"zlink.org.cn"},"license":"MIT","readme":"# z-amap-jsapi-loader\nz-amap-jsapi-loader 是基于高德开放平台官网提供的地图 JSAPI 的加载器amap-jsapi-loader，可帮助开发者快速定位、有效避免加载引用地图 JSAPI 各种错误用法。\n如果你已使用@amap/amap-jsapi-loader,只需将安装的包名替换为z-amap-jsapi-loader\n```\n原安装：npm i @amap/amap-jsapi-loader\n原使用：import AMapLoader from '@amap/amap-jsapi-loader';\n\n改为\n现安装：npm i z-amap-jsapi-loader\n现使用：import AMapLoader from 'z-amap-jsapi-loader';\n```\n\n\n该加载器具有以下特性：\n* 支持以 普通JS 和 npm包 两种方式使用；\n* 有效避免错误异步加载导致的 JSAPI 资源加载不完整问题；\n* 对于加载混用多个版本 JSAPI 的错误用法给予报错处理；\n* 对于不合法加载引用 JSAPI 给予报错处理；\n* 支持指定 JSAPI 版本；\n* 支持插件加载；\n* 允许多次执行加载操作，网络资源不会重复请求，便于大型工程模块管理；\n\n\n# USAGE\n\n## AMapLoader.load方法参数说明\n```js\nAMapLoader.load({\n    \"key\": \"\",              // 申请好的Web端开发者Key，首次调用 load 时必填\n    \"version\": \"2.0\",   // 指定要加载的 JSAPI 的版本，缺省时默认为 1.4.15\n    \"plugins\": [],           // 需要使用的的插件列表，如比例尺'AMap.Scale'等\n    \"AMapUI\": {             // 是否加载 AMapUI，缺省不加载\n        \"version\": '1.1',   // AMapUI 缺省 1.1\n        \"plugins\":[],       // 需要加载的 AMapUI ui插件\n    },\n    \"Loca\":{                // 是否加载 Loca， 缺省不加载\n        \"version\": '1.3.2'  // Loca 版本，缺省 1.3.2\n    },\n}).then(()=>{\n    window.AMap.xx;\n    window.AMapUI.xx;\n    window.Loca.xx\n});\n\n```\n\n## AMapUI\n\nAMapUI 用法和官网有一点点区别。通过 AMapUI.xx 来获取组件\n```js\nAMapLoader.load({\n    key: '',//首次load必填\n    version: '2.0',\n    AMapUI: {\n        version: '1.1',\n        plugins: ['overlay/SimpleMarker'],\n    }\n}).then((AMap) => {\n    map = new AMap.Map('container');\n\n    // !!! 通过 AMap.SimpleMarker 获取组件\n    new AMapUI.SimpleMarker({\n        //前景文字\n        iconLabel: 'A',\n        //图标主题\n        iconTheme: 'default',\n        //背景图标样式\n        iconStyle: 'red',\n        map: map,\n        position: map.getCenter()\n    });\n}).catch((e) => {\n    console.error(e);\n});\n```\n\n\n# 使用\n#### 以普通 JS 方式使用 Loader\n尚未发布在线Loader，可将 dist/index.js 复制到项目下\n```\n<script src=\"../dist/index.js\"></script>\n<script>\n    AMapLoader.load({\n        key:'',//首次load必填\n        version:'2.0',\n        plugins:['AMap.Scale']\n    }).then((AMap)=>{\n        map = new AMap.Map('container');\n        map.addControl(new AMap.Scale())\n    }).catch((e)=>{\n        console.error(e);\n    });   \n</script>\n```\n#### 以 NPM 包方式使用 Loader\n安装\n```\ntnpm i z-amap-jsapi-loader --save-dev\n```\n使用\n```\nimport AMapLoader from 'z-amap-jsapi-loader';\n\nAMapLoader.load().then((AMap)=>{\n    map = new AMap.Map('container');\n}).catch(e=>{\n    console.log(e);\n})\n\n```\n\n\n\n","readmeFilename":"README.md"}