Skip to content

高精度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 划算得多。