Appearance
高精度IP定位要申请 key 吗?百度、高德 IP 定位 API 的门槛与踩坑记录(Python 实现)
上周有个做本地生活小程序的读者来问:他想在首页显示「你所在的城市」,搜到的东西全是「高精度IP定位」,点进去是百度地图开放平台,于是花了一下午注册开发者、建应用、等审核,最后调接口拿到一句 AK参数不存在。
这个流程我太熟了。问题不在于他笨,而在于**「高精度IP定位」这个词其实指向两种完全不同的东西**:一种是地图厂商顺带提供的 IP 定位接口,另一种是专门的 IP 归属地查询服务。名字像,门槛、字段、配额、精度都不一样。这篇把百度、高德两家地图 API 的 IP 定位实测一遍,说清楚什么情况下该申请 key、什么情况下白忙一场。
一、先说清楚:地图厂商的 IP 定位是什么定位
百度地图 Web 服务里有个 location/ip,高德开放平台里有个 v3/ip,腾讯位置服务也有一套。它们的共同点是:定位能力是地图能力的一部分,IP 定位只是其中一个小接口,服务对象是「已经在地图生态里」的开发者。
两家官方文档自己就把话说得很直白:
- 百度:
每个key支持100万次/天,超过限制不返回数据,并且明确写着「IP定位的结果精度较差,主要应用获取省份或者城市的位置信息」,移动端建议改用定位 SDK。 - 高德:
v3/ip的ip参数注明「仅支持国内」,调用量的限制按 key 的流量等级来定。
也就是说,官方对这个小接口的定位是:给地图应用打个底,知道用户大概在哪个城市。它不是为「查 IP 归属地」这件事设计的。
二、实测:跑起来之前会撞到的五个坑
以下输出都是今天在本机跑出来的原始结果。
坑 1:没有 key,一个字都查不到。
text
GET https://api.map.baidu.com/location/ip?ip=223.5.5.5&coor=bd09ll
{"status":101,"message":"AK参数不存在"}
GET https://api.map.baidu.com/location/ip?ak=E4805d16520de693a3fe707cdc962045&ip=223.5.5.5
{"status":200,"message":"APP不存在,AK有误请检查再重试"}
GET https://restapi.amap.com/v3/ip?key=test&ip=223.5.5.5
{"status":"0","info":"INVALID_USER_KEY","infocode":"10001"}注意百度这里的状态码有点反直觉:ak 填错返回的 status 是 200,成功也是 0/200 之间来回,真正判断成败要看 status 字段的值和业务语义。写代码时别用 HTTP 状态码判断,必须看响应体。
坑 2:key 绑了「服务平台」类型,选错就报错。
申请的时候要选这个 key 给谁用——Web 服务、JS API、Android、iOS、微信小程序各不相同。想在后端调 location/ip,key 必须选「服务端 / Web 服务」;选成 JS API 去调,会拿到 USERKEY_PLAT_NOMATCH(高德是 10009)。这一步卡住的人最多,因为报错信息只说要你检查 key,不告诉你是类型不对。
坑 3:配额看着很大,实际卡在认证和精度上。
百度的「100 万次/天」是每个 key 的上限,但个人开发者的 key 往往还需要实名/企业认证才能把流量等级提上去,而且超过限制是不返回数据,不是排队。高德同样按 key 的调用量等级限制,配额用完当天就没得用了(10003)。
坑 4:字段不够用。
拿本地生活这个场景说,除了省市,多数团队还需要运营商、邮编、区号,做风控的还要区分家宽、企业、机房。地图 API 给的是地图需要的那些字段:
百度 location/ip | 高德 v3/ip | 专用 IP 归属地接口 | |
|---|---|---|---|
| 省份 / 城市 | ✅ | ✅ | ✅ |
| 区县 | 大城区偶尔有 | ❌(给 adcode) | 免费版为空,VIP 版提供 |
| 运营商 ISP | 在 address 字符串里,要切分 | ❌ | ✅ 独立字段 |
| 邮编 / 区号 / 大区 | ❌ | ❌ | ✅ |
| 经纬度 | ✅(BD-09) | ❌(给矩形范围) | ✅(城市中心点) |
| 是否要 key | 必须 | 必须 | 免费版不需要 |
坑 5:坐标系不统一,混着用会偏移。
百度返回的经纬度是百度自己的 BD-09 坐标,高德返回的属于 GCJ-02。你要是从两个来源攒数据再画到同一张地图上,同一个城市会出现几百米的错位——上次有个读者就是拿 A 家的坐标往 B 家的地图上打点,热力图偏到隔壁区去了。
三、该怎么选:看你要的是「地图」还是「位置」
分界线很清楚:
- 产品里要画地图、选点、逆地理编码 → 老老实实申请地图 key,IP 定位顺手用,反正 key 已经有了。
- 只是想知道用户大概在哪个城市(登录地打标、城市级内容分发、日志地域统计、风控辅助)→ 用专门的 IP 归属地接口,一个 GET 就完事,不需要注册、不需要 key、不需要在控制台里改「服务平台类型」。
后一种需求其实占了绝大多数。前面那位读者要的就是首页显示城市,用地图 key 属于拿螺丝刀去砸钉子。
四、Python 实现:两种来源统一封装,一行命令对比
下面这段把这三种来源封成同一套返回结构,方便你实测对比后决定。代码里保留了错误分支,因为实际踩坑基本都发生在错误分支上。
python
#!/usr/bin/env python3
# ipgeo.py —— IP 归属地统一封装:专用 IP 接口(IP9) / 百度 IP 定位 / 高德 IP 定位
# 用法: python3 ipgeo.py 223.5.5.5
# python3 ipgeo.py 223.5.5.5 --source all --key 你的key
# 依赖: pip install requests
import argparse
import sys
import time
import requests
IP9 = "https://ip9.com.cn/get"
BAIDU = "https://api.map.baidu.com/location/ip"
AMAP = "https://restapi.amap.com/v3/ip"
PACE = 1.05 # IP9 免费版 60 次/分钟/IP,留点余量
_last_call = [0.0]
def _pace():
wait = _last_call[0] + PACE - time.monotonic()
if wait > 0:
time.sleep(wait)
_last_call[0] = time.monotonic()
def query_ip9(ip=""):
"""专用 IP 归属地接口:不传 ip 查当前请求方 IP,传了就查指定 IP。"""
_pace()
params = {"ip": ip} if ip else {}
r = requests.get(IP9, params=params, timeout=3,
headers={"Accept": "application/json"})
body = r.json()
ret = body.get("ret")
if ret == 400:
return {"ok": False, "err": "IP 格式不合法(ret=400)"}
if ret == 429:
return {"ok": False, "err": "触发频率限制(ret=429),稍后重试"}
if ret != 200 or not isinstance(body.get("data"), dict):
return {"ok": False, "err": f"接口返回异常(ret={ret})"}
d = body["data"]
return {
"ok": True, "source": "ip9",
"ip": d.get("ip", ""), "country": d.get("country", ""),
"prov": d.get("prov", ""), "city": d.get("city", ""),
"isp": d.get("isp", ""), "lng": d.get("lng", ""), "lat": d.get("lat", ""),
"post_code": d.get("post_code", ""), "area_code": d.get("area_code", ""),
"area": d.get("area", ""), # 区县:VIP 版才有,免费版为空
}
def query_baidu(ip, ak):
"""百度地图 Web 服务 IP 定位:必须带 ak,返回的是百度自己的坐标。"""
r = requests.get(BAIDU, params={"ip": ip, "ak": ak, "coor": "bd09ll"}, timeout=3)
body = r.json()
if body.get("status") != 0:
# 101=AK不存在 / 200家族=AK有误或APP不存在 / 302=配额权限问题
return {"ok": False, "source": "baidu",
"err": f"status={body.get('status')} message={body.get('message') or body.get('msg')}"}
content = body.get("content") or {}
detail = content.get("address_detail") or {}
point = content.get("point") or {}
addr_parts = str(body.get("address", "")).split("|")
return {
"ok": True, "source": "baidu", "ip": ip,
"country": "中国" if addr_parts and addr_parts[0] == "CN" else "",
"prov": detail.get("province", ""), "city": detail.get("city", ""),
"isp": addr_parts[4] if len(addr_parts) > 4 else "",
"lng": point.get("x", ""), "lat": point.get("y", ""), # BD-09
}
def query_amap(ip, key):
"""高德 Web 服务 IP 定位:必须带 key,官方参数说明 ip 仅支持国内。"""
r = requests.get(AMAP, params={"ip": ip, "key": key, "output": "json"}, timeout=3)
body = r.json()
if body.get("status") != "1" or not body.get("province"):
# 10001=INVALID_USER_KEY / 10003=日调用量超限 / 10009=平台类型不匹配
return {"ok": False, "source": "amap",
"err": f"status={body.get('status')} info={body.get('info')} infocode={body.get('infocode')}"}
return {
"ok": True, "source": "amap", "ip": ip, "country": "中国",
"prov": body.get("province", ""), "isp": "", "lng": "", "lat": "",
"rectangle": body.get("rectangle", ""), # 高德只给 adcode 和矩形范围
}
def render(res):
if not res.get("ok"):
return f"[{res.get('source', '?')}] 查询失败:{res['err']}"
keys = ["ip", "country", "prov", "city", "isp", "lng", "lat", "source"]
return " ".join(f"{k}={res[k]}" for k in keys if res.get(k))
def main():
ap = argparse.ArgumentParser()
ap.add_argument("ip", nargs="?", default="")
ap.add_argument("--source", choices=["ip9", "baidu", "amap", "all"], default="ip9")
ap.add_argument("--key", default="", help="百度 ak / 高德 key")
args = ap.parse_args()
if args.source in ("ip9", "all"):
print(render(query_ip9(args.ip)))
if args.source in ("baidu", "all"):
if not args.key:
print("[baidu] 跳过:没有 ak(百度 IP 定位必须申请密钥)", file=sys.stderr)
else:
print(render(query_baidu(args.ip, args.key)))
if args.source in ("amap", "all"):
if not args.key:
print("[amap] 跳过:没有 key(高德 Web 服务 API 必须申请 key)", file=sys.stderr)
else:
print(render(query_amap(args.ip, args.key)))
if __name__ == "__main__":
main()实跑结果(本机,2026-10 实测):
text
$ python3 ipgeo.py 223.5.5.5
ip=223.5.5.5 country=中国 prov=浙江 city=杭州 isp=AliDNS/DoH/DoT/阿里云 lng=120.15 lat=30.29 source=ip9
$ python3 ipgeo.py 999.1.1.1
[?] 查询失败:IP 格式不合法(ret=400)
$ python3 ipgeo.py 223.5.5.5 --source all --key test
ip=223.5.5.5 country=中国 prov=浙江 city=杭州 isp=AliDNS/DoH/DoT/阿里云 lng=120.15 lat=30.29 source=ip9
[baidu] 查询失败:status=200 message=APP不存在,AK有误请检查再重试
[amap] 查询失败:status=0 info=INVALID_USER_KEY infocode=10001注意最后两行:没有可用的 key 时,地图 API 一个字段都拿不到,而专用接口这边城市、运营商、经纬度一次给全。这就是两种路线的实际差距。
五、落地时最容易忽略的几件事
把判断逻辑写在响应体上,不是 HTTP 状态码。 百度 ak 出错时 HTTP 是 200,高德限速时 HTTP 也是 200。只看 r.status_code == 200 就认为查询成功,线上会安静地给用户显示空城市。
限速和缓存别省。 免费接口按 60 次/分钟/IP 限制,做批量(日志回刷、Excel 补表)时一定要串行 + 间隔,并把结果落盘缓存——同一个 IP 在一天内反复查是最没必要的浪费。触发 429 要能优雅退出,而不是无限重试把自己打黑。
带 key 的接口不要放在前端直调。 地图 JS API 的 key 是给浏览器用的,但服务端的 Web 服务 key 一旦写进前端代码就等于公开了,被刷流量是你的配额。要么放服务端代调,要么用 Nginx 代理转发并隐藏 key。
配额要按 UV 算,不是按请求数。 100 万次/天听起来能撑很久,但如果一个日均 5 万 UV 的站点每个页面都调一次,一天就是 5 万次起,还要算爬虫和重试。真正上线前先估算量级,别等上线当天才发现要提额。
海外用户要单独处理。 高德 IP 定位的 ip 参数只支持国内地址,做跨境业务时要么换服务,要么对境外 IP 走另一条链路。
总结
地图厂商的 IP 定位接口,本质是给地图应用打的底:要申请 key、要选对平台类型、配额按流量等级走、精度官方自己说只到城市级,字段也偏地图场景。做「显示用户所在城市」这类需求,用专门的 IP 归属地接口更直接——一个 GET,不注册、不申请 key,返回的字段里运营商、邮编、区号、经纬度都齐了。
接口就一个:https://ip9.com.cn/get?ip=<IP>(不传参数查当前请求方 IP,IPv4/IPv6 都支持),免费版 60 次/分钟/IP;需要区县 area、ip_type(家宽/企业/机房)、ip_asn 这些字段时属于 VIP 版能力,具体口径以官网 https://www.ip9.com.cn 为准。先把城市级跑通,业务真有更细的需求再升级,比一上来折腾 key 划算得多。