当前位置：首页 > news >正文

高德地图 API Key 获取指南

news 2026/4/10 11:22:56

概述

高德地图开放平台为开发者提供丰富的地图服务 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>