概述
高德地图开放平台为开发者提供丰富的地图服务 API，包括地图展示、定位、搜索、路线规划等功能。获取 API Key 是使用高德地图服务的第一步。
一、准备工作
1. 注册账号
访问官网：https://lbs.amap.com/
注册开发者账号：
- 点击右上角"注册"或"登录"
- 使用手机号或邮箱注册
- 完成实名认证（个人/企业）
2. 实名认证
- 个人开发者：需要身份证认证
- 企业开发者：需要营业执照等企业资质
- 认证作用：提高 API 调用配额，解锁更多功能
二、获取 API Key 步骤
步骤 1：登录控制台
- 访问 https://console.amap.com/
- 使用注册的账号登录
步骤 2：创建应用
进入控制台后，点击左侧菜单“应用管理”→“我的应用”
点击右上角“创建新应用”按钮
填写应用信息：
应用名称：自定义名称（如：我的地图应用）
应用类型：选择 Web 服务、Android、iOS 等
应用描述：简要描述应用用途
步骤 3：添加 Key
在创建的应用中，点击“添加 Key”按钮
填写 Key 信息：
必填项：
- Key 名称：自定义名称
- 服务平台：
- Web 服务（JS API）
- Android 平台
- iOS 平台
- 服务端
安全设置（重要）：
IP 白名单：限制允许调用 API 的 IP 地址
- 格式：
192.168.1.1或192.168.1.0/24（支持 CIDR） - 多个 IP 用换行分隔
- 留空表示不限制（不推荐生产环境）
- 格式：
HTTP 引用白名单：Web 服务需要设置
- 格式：
https://www.example.com - 支持通配符：
*.example.com - 多个域名用换行分隔
- 格式：
选择需要使用的服务：
- ☑️ Web 服务 API
- ☑️ 定位服务
- ☑️ 地图显示
- ☑️ 搜索服务
- ☑️ 路线规划
- ☑️ 其他需要的服务
点击“提交”完成创建
步骤 4：获取 Key
- 创建成功后，在应用列表中可以看到新创建的应用
- 点击应用名称进入详情页
- 在“Key”列表中可以看到生成的 API Key
- 复制 Key：点击复制按钮或手动复制
三、API Key 类型说明
1. Web 服务 API Key
用途：
- 服务端调用高德地图 API
- 地理编码、逆地理编码
- 地点搜索、路线规划等
特点：
- 需要设置 IP 白名单
- 适合后端服务调用
- 安全性较高
2. JavaScript API Key
用途：
- 前端网页中嵌入高德地图
- 地图展示、交互
- 前端定位、搜索等
特点：
- 需要设置 HTTP 引用白名单
- 暴露在前端代码中
- 需要做好域名限制
3. Android/iOS Key
用途：
- 移动端应用集成
- 原生地图 SDK
特点：
- 需要设置应用包名（Android）或 Bundle ID（iOS）
- 绑定具体应用
四、安全配置建议
⚠️ 重要安全设置
1. IP 白名单（服务端 Key）
推荐配置：
# 单个 IP 192.168.1.100 # IP 段（CIDR） 192.168.1.0/24 # 多个 IP 192.168.1.100 10.0.0.50注意事项：
- ✅ 生产环境必须设置 IP 白名单
- ✅ 不要设置为
0.0.0.0/0（允许所有 IP） - ✅ 定期检查和更新白名单
2. HTTP 引用白名单（Web Key）
推荐配置：
# 单个域名 https://www.example.com # 子域名通配符 *.example.com # 多个域名 https://www.example.com https://api.example.com注意事项：
- ✅ 使用 HTTPS 协议
- ✅ 精确匹配域名，避免使用通配符
* - ✅ 不要设置为
*（允许所有域名）
3. 应用包名/Bundle ID（移动端）
- Android：设置应用的包名（Package Name）
- iOS：设置应用的 Bundle Identifier
五、API Key 使用示例
Web 服务 API 调用示例
// 地理编码示例constaxios=require('axios');constapiKey='your-api-key';constaddress='北京市海淀区中关村';axios.get('https://restapi.amap.com/v3/geocode/geo',{params:{key:apiKey,address:address}}).then(response=>{console.log(response.data);}).catch(error=>{console.error(error);});JavaScript API 使用示例
<!DOCTYPEhtml><html><head><metacharset="utf-8"><title>高德地图示例</title><scriptsrc="https://webapi.amap.com/maps?v=2.0&key=YOUR_API_KEY"></script></head><body><divid="container"style="width:100%;height:400px;"></div><script>varmap=newAMap.Map('container',{zoom:13,center:[116.397428,39.90923]});</script></body></html>六、常见问题
Q1: API Key 申请后多久生效？
A:通常立即生效，如未生效请检查：
- 安全设置是否正确
- 服务是否已开通
- 账号是否完成实名认证
Q2: 如何查看 API 调用量？
A:
- 登录控制台
- 进入"应用管理" → “我的应用”
- 点击应用名称查看统计信息
- 可以查看每日/每月调用量
Q3: API Key 有调用限制吗？
A:
- 个人开发者：有每日调用量限制
- 企业开发者：配额更高，可申请提升
- 具体限制见控制台中的配额说明
Q4: API Key 泄露了怎么办？
A:
- 立即登录控制台
- 删除或禁用泄露的 Key
- 创建新的 Key 并更新应用
- 检查是否有异常调用记录
Q5: 可以创建多个 API Key 吗？
A:
- ✅ 可以，一个应用可以创建多个 Key
- 建议为不同环境（开发/测试/生产）创建不同的 Key
- 便于管理和监控
Q6: Web 服务 API 和 JavaScript API 的区别？
A:
- Web 服务 API：服务端调用，需要 IP 白名单
- JavaScript API：前端调用，需要 HTTP 引用白名单
- 根据使用场景选择对应的 Key 类型
七、配额和计费
免费配额
- 个人开发者：每日有一定免费调用量
- 企业开发者：免费配额更高
- 超出免费配额后按量计费
查看配额
- 控制台 → “应用管理” → “配额管理”
- 查看各服务的调用量和剩余配额
- 可以申请提升配额
计费说明
- 不同服务有不同的计费标准
- 详细价格见：https://lbs.amap.com/api/webservice/price
- 建议根据实际需求选择合适的服务
八、最佳实践
1. 环境分离
- 开发环境：使用独立的 Key，IP 白名单设置为开发服务器
- 测试环境：使用独立的 Key，IP 白名单设置为测试服务器
- 生产环境：使用独立的 Key，严格限制 IP 白名单
2. 密钥管理
- ✅ 不要将 API Key 提交到代码仓库
- ✅ 使用环境变量存储 Key
- ✅ 定期轮换 Key
- ✅ 监控异常调用
3. 错误处理
- 实现重试机制
- 记录调用日志
- 监控 API 调用状态
- 设置调用量告警
4. 性能优化
- 合理使用缓存
- 避免重复调用
- 批量处理请求
- 使用 CDN 加速（Web 服务）
九、相关资源
官方文档
- 开放平台首页：https://lbs.amap.com/
- API 文档：https://lbs.amap.com/api
- 开发指南：https://lbs.amap.com/api/javascript-api/summary
- 示例代码：https://lbs.amap.com/demo/javascript-api/example/map/map-show
技术支持
- 开发者社区：https://lbsbbs.amap.com/
- 工单系统：控制台 → “工单管理”
- 客服支持：400-810-0080
SDK 下载
- JavaScript API：通过 CDN 引入
- Android SDK：https://lbs.amap.com/api/android-sdk/download
- iOS SDK：https://lbs.amap.com/api/ios-sdk/download
十、快速开始 Checklist
- 注册高德开放平台账号
- 完成实名认证
- 创建应用
- 添加 Key 并配置安全设置
- 复制 API Key
- 在代码中集成 API Key
- 测试 API 调用
- 配置监控和告警
- 查看调用统计
总结
获取高德地图 API Key 的流程：
- 注册账号→ 完成实名认证
- 创建应用→ 填写应用信息
- 添加 Key→ 配置安全设置
- 获取 Key→ 复制并保存
- 集成使用→ 在代码中使用 Key
关键注意事项：
- 🔒 必须配置安全设置（IP 白名单/HTTP 引用白名单）
- 📊 定期查看调用量和配额
- 🔄 不同环境使用不同的 Key
- ⚠️ 妥善保管 API Key，避免泄露
 和概率路网 (PRM) 进行串联运动规划器的路径规划附matlab代码)
