更新记录

2.0.0（2023-06-07）

项目重构

• 将之前的js方法，进行重构,支持uni_modules快速引入
• 完善文档，对新手友好，快速上手
• 使用本插件只需要两步:
  • 1.导入插件
  • 2.配置高德的微信小程序key

1.0.0（2020-01-13）

1.完成调用高德地图api进行路线规划基本功能

平台兼容性

Lyn4ever-gaodeRoutePlanning

一、说明

• 本插件的原理是利用高德地图API进行路线规划，然后利用官方的map组件进行展示。
• 本插件的key不需要配置密钥，如果你觉得需要配置密钥才显示，那就是其他问题。
• 官方map组件支持的平台，本插件完全支持，但除小程序外的其他平台，需要再manifest.json中进行配置，uniapp官方文档已经很清楚了，请自行查阅文档。
• 请原谅，非本插件问题（如：是小程序平台使用地图的问题），本人一律不予回复。
• 如有其他疑问，请发邮件或者评论，私信不一定能看到，谢谢理解。

二、高德KEY申请

注意：本项目中使用的是高德地图微信小程序Key，是支持所有平台运行的，但其他平台需要单独配置，具体查看下文[各平台适配](#各平台适配)。

2.1 官方文档

https://lbs.amap.com/api/wx/summary/或https://developer.amap.com/api/wx/summary/

2.2 步骤

1. 填写应用信息
2. 添加微信小程序Key

三、使用步骤

3.1 从插件市场导入uni_modules

3.2 申请并配置自己的key

修改/uni_modules/Lyn4ever-gaodeRoutePlanning\bin\config.js文件中的key为自己的

3.3 在页面中引入组件并传参数

<Lyn4ever-gaodeRoutePlanning 
        :longitude="longitude" 
        :latitude="latitude" 
        width="100vw" 
        heith="100vh"
        :Config="Config" 
        :startPoi="startPoi" 
        :wayPoi="wayPoi" 
        :endPoi="endPoi"/>

3.4 参数说明

• Config 配置详解	参数名	说明	必填	格式	默认	说明
  showMarks	是否显示地图上的Marker点	否	Boolean	true	--
  lineColor	路径颜色	否	String	#0606ff	颜色值
  lineWidth	路径宽度	否	String	4	px单位
  startImage	起点图片	否	String	见页面	绝对路径/相对路径/base64/url
  wayImage	途径点图片	否	Object	见页面	绝对路径/相对路径/base64/url
  endImage	终点图片	否	String	见页面	绝对路径/相对路径/base64/url

四、各平台适配

各平台的适配能力主要取决于uniapp官方map组件，具体差异请参考uniapp-组件-地图-map

• 小程序
  • 各家小程序平台一般都内置了地图SDK,无需单独配置，可直接使用
  • 小程序平台，请注意配置域名白名单 (https://restapi.amap.com)
• App
  • 需要配置manifest.json并配置对应的key(注意，这里的key与本项目无关，具体方法参看App端地图模块配置)
  • 2021年起，使用uniapp开发的App。高德、百度、腾讯等地图服务商开始商业授权,具体参看App地图商业授权相关说明。
• H5
  • 在uniapp的H5中，要想使用地图，同时也需要配置对应的key(注意，这里的key并非本项目的key,具体方法请参见H5中地图sdk配置)

五、相关问题

• [system] Map key not configured.
  • 这是由于你在使用h5进行调试的时候，没有在manifest.json中配置高德地图的key,请参考上文解决。与本项目无关
• 提示需要密钥与key搭配使用
  • 应该是你配置的问题，本插件的目前不需要密钥。因此这问题非本插件问题，不予回复（我猜应该是你在h5平台使用的吧，请自行查阅官方文档）。