news 2026/4/16 12:37:17

高德地图 API Key 获取指南

作者头像

张小明

前端开发工程师

1.2k 24
文章封面图
高德地图 API Key 获取指南

概述

高德地图开放平台为开发者提供丰富的地图服务 API，包括地图展示、定位、搜索、路线规划等功能。获取 API Key 是使用高德地图服务的第一步。

一、准备工作

1. 注册账号

  • 访问官网：https://lbs.amap.com/

  • 注册开发者账号：

    • 点击右上角"注册"或"登录"
    • 使用手机号或邮箱注册
    • 完成实名认证（个人/企业）

2. 实名认证

  • 个人开发者：需要身份证认证
  • 企业开发者：需要营业执照等企业资质
  • 认证作用：提高 API 调用配额，解锁更多功能

二、获取 API Key 步骤

步骤 1：登录控制台

  1. 访问 https://console.amap.com/
  2. 使用注册的账号登录

步骤 2：创建应用

  1. 进入控制台后，点击左侧菜单“应用管理”→“我的应用”

  2. 点击右上角“创建新应用”按钮

  3. 填写应用信息：

    • 应用名称：自定义名称（如：我的地图应用）

    • 应用类型：选择 Web 服务、Android、iOS 等

    • 应用描述：简要描述应用用途

步骤 3：添加 Key

  1. 在创建的应用中，点击“添加 Key”按钮

  2. 填写 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
      • 多个域名用换行分隔

  3. 选择需要使用的服务：

    • ☑️ Web 服务 API
    • ☑️ 定位服务
    • ☑️ 地图显示
    • ☑️ 搜索服务
    • ☑️ 路线规划
    • ☑️ 其他需要的服务

  4. 点击“提交”完成创建

步骤 4：获取 Key

  1. 创建成功后，在应用列表中可以看到新创建的应用
  2. 点击应用名称进入详情页
  3. 在“Key”列表中可以看到生成的 API Key
  4. 复制 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:

  1. 登录控制台
  2. 进入"应用管理" → “我的应用”
  3. 点击应用名称查看统计信息
  4. 可以查看每日/每月调用量

Q3: API Key 有调用限制吗？

A:

  • 个人开发者：有每日调用量限制
  • 企业开发者：配额更高，可申请提升
  • 具体限制见控制台中的配额说明

Q4: API Key 泄露了怎么办？

A:

  1. 立即登录控制台
  2. 删除或禁用泄露的 Key
  3. 创建新的 Key 并更新应用
  4. 检查是否有异常调用记录

Q5: 可以创建多个 API Key 吗？

A:

  • ✅ 可以，一个应用可以创建多个 Key
  • 建议为不同环境（开发/测试/生产）创建不同的 Key
  • 便于管理和监控

Q6: Web 服务 API 和 JavaScript API 的区别？

A:

  • Web 服务 API：服务端调用，需要 IP 白名单
  • JavaScript API：前端调用，需要 HTTP 引用白名单
  • 根据使用场景选择对应的 Key 类型

七、配额和计费

免费配额

  • 个人开发者：每日有一定免费调用量
  • 企业开发者：免费配额更高
  • 超出免费配额后按量计费

查看配额

  1. 控制台 → “应用管理” → “配额管理”
  2. 查看各服务的调用量和剩余配额
  3. 可以申请提升配额

计费说明

  • 不同服务有不同的计费标准
  • 详细价格见：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 的流程：

  1. 注册账号→ 完成实名认证
  2. 创建应用→ 填写应用信息
  3. 添加 Key→ 配置安全设置
  4. 获取 Key→ 复制并保存
  5. 集成使用→ 在代码中使用 Key

关键注意事项：

  • 🔒 必须配置安全设置（IP 白名单/HTTP 引用白名单）
  • 📊 定期查看调用量和配额
  • 🔄 不同环境使用不同的 Key
  • ⚠️ 妥善保管 API Key，避免泄露
版权声明: 本文来自互联网用户投稿，该文观点仅代表作者本人，不代表本站立场。本站仅提供信息存储空间服务，不拥有所有权，不承担相关法律责任。如若内容造成侵权/违法违规/事实不符，请联系邮箱：809451989@qq.com进行投诉反馈，一经查实，立即删除！
网站建设 2026/4/16 10:19:17

华为OD机考双机位C卷- 分月饼 （Java Python JS C++ C ）

最新华为上机考试 真题目录：点击查看目录 华为OD面试真题精选：点击立即查看 华为OD机考双机位C卷- 题目描述 中秋节，公司分月饼，m 个员工，买了 n 个月饼，m ≤ n，每个员工至少分 1 个月饼，但可以分多个， 单人分到最多月饼的个数是 Max1 ，单人分到第二多月饼个数是…

作者头像 李华
网站建设 2026/4/16 10:17:46

万字亿集流量系统架构总结笔记(上)

亿集流量自己的提取 注&#xff1a; 这里感觉是对需求的探讨和技术选型的分析&#xff0c;但是不一定就有最推荐的具体设计&#xff0c;更多的是提供思路。 这里有的东西并不具有通用性的服务设计&#xff0c;所以仅讲解 基本通识&#xff0c;不做具体设计。 还有这里感觉我更…

作者头像 李华
网站建设 2026/4/16 10:21:08

直觉模糊不确定性建模与应用【附代码】

✅ 博主简介&#xff1a;擅长数据搜集与处理、建模仿真、程序设计、仿真代码、论文写作与指导&#xff0c;毕业论文、期刊论文经验交流。 ✅成品或者定制&#xff0c;扫描文章底部微信二维码。 (1)基于包含度的粗糙直觉模糊集理论与图像增强 直觉模糊集通过隶属度、非隶属度和…

作者头像 李华
网站建设 2026/4/10 7:11:07

计算机Java毕设实战-基于springboot的线上超市购物管理系统的设计与实现基于 SpringBoot 的超市便利店信息管理系统设计与实现【完整源码+LW+部署说明+演示视频，全bao一条龙等】

博主介绍&#xff1a;✌️码农一枚 &#xff0c;专注于大学生项目实战开发、讲解和毕业&#x1f6a2;文撰写修改等。全栈领域优质创作者&#xff0c;博客之星、掘金/华为云/阿里云/InfoQ等平台优质作者、专注于Java、小程序技术领域和毕业项目实战 ✌️技术范围&#xff1a;&am…

作者头像 李华
网站建设 2026/4/16 9:06:54

Java计算机毕设之基于springboot的眼科诊所管理系统的设计与实现基于springboot的眼科医院管理系统的设计与实现（完整前后端代码+说明文档+LW，调试定制等）

博主介绍&#xff1a;✌️码农一枚 &#xff0c;专注于大学生项目实战开发、讲解和毕业&#x1f6a2;文撰写修改等。全栈领域优质创作者&#xff0c;博客之星、掘金/华为云/阿里云/InfoQ等平台优质作者、专注于Java、小程序技术领域和毕业项目实战 ✌️技术范围&#xff1a;&am…

作者头像 李华