每天30万次免费调用！高德天气Web API接入避坑指南（Key申请、adcode获取全流程）

高德天气API实战：从Key申请到精准调用的全流程解析

清晨六点，上海浦东某共享办公空间里，李工程师的咖啡已经见了底。他正在为客户的社区团购小程序紧急添加天气预警功能——需要在三小时内完成从API接入到前端展示的全流程。此时，一份清晰的避坑指南或许能让他少走弯路。本文将系统梳理高德天气Web API的完整接入路径，特别聚焦开发者最常遇到的五个关键卡点。

1. 密钥申请与类型选择的黄金法则

申请密钥看似简单，但90%的初级开发者会在这个环节埋下隐患。高德控制台提供多种Key类型，而天气接口需要的是Web服务API密钥（非JavaScript API或Android/iOS密钥）。这个细微差别常被忽视，导致后续调用失败。

申请步骤分解：

1. 访问高德开放平台控制台
2. 创建新应用时，应用类型选择"天气服务"（非必选但建议）
3. 在"添加Key"界面勾选"Web服务"选项
4. 提交后等待约5分钟密钥生效

关键提示：同一个账号可创建多个Key，建议按项目分立密钥以便监控调用量

常见配置误区对照表：

错误配置	正确做法	引发的症状
使用JS API密钥	申请Web Service专用密钥	返回"INVALID_USER_KEY"
IP白名单未设置	生产环境需绑定服务器IP	返回"INVALID_USER_IP"
未启用天气服务	控制台需开通天气API权限	返回"SERVICE_NOT_EXIST"

// 密钥有效性快速检测脚本（Node.js示例）
const axios = require('axios');
const testKey = async (key) => {
  try {
    const res = await axios.get('https://restapi.amap.com/v3/weather/weatherInfo', {
      params: { key, city: '110101' } // 北京东城区adcode
    });
    return res.data.status === '1';
  } catch (e) {
    return false;
  }
};

2. 破解adcode编码体系的实战手册

adcode（行政区域代码）是高德天气API的核

转载自 CSDN-专业IT技术社区

原文链接：https://blog.csdn.net/weixin_27219587/article/details/160430558