IP 地理位置

IP 地址对应的大致国家、地区、城市、时区和坐标。

为请求添加网络位置信息。

使用 location.country_code 提供国家建议，并使用 location.timezone 显示时间。允许访客更正该建议；空的位置字段应保留为未知，不要补造城市或坐标。

1.1.1.1完整 IP 报告

Brisbane, Australia

-27.475°, 153.010°

大致网络位置；并非设备位置Natural Earth 地图数据

城市: Brisbane
地区: Queensland
国家: Australia
时区: Australia/Brisbane

IP 位置是网络层面的估计。它不是 GPS 读数、家庭住址，也不是访客实际位置的证明。

API 字段

字段定义示例来自 1.1.1.1

location.country类型： string: 与网络位置估计关联的国家名称。; 示例值"Australia"
location.country_code类型： string: 位置记录中的两字母国家代码。; 示例值"AU"
location.city类型： string: 与网络估计位置关联的城市。可能为空。; 示例值"Brisbane"
location.state类型： string: 与估计位置关联的地区或州。可能为空。; 示例值"Queensland"
location.zipcode类型： string: 来源提供的邮政编码。可能为空。; 示例值""
location.latitude类型： number: 网络位置的大致纬度。; 示例值-27.474848400186662
location.longitude类型： number: 网络位置的大致经度。; 示例值153.00996200912815
location.timezone类型： string: 与位置关联的时区标识符。; 示例值"Australia/Brisbane"

查询一个地址

请求

curl --fail --silent --show-error --max-time 5 \
  "https://api.ipquery.io/1.1.1.1?format=json"

实际响应字段

JSON

{
  "ip": "1.1.1.1",
  "location": {
    "country": "Australia",
    "country_code": "AU",
    "city": "Brisbane",
    "state": "Queensland",
    "zipcode": "",
    "latitude": -27.474848400186662,
    "longitude": 153.00996200912815,
    "timezone": "Australia/Brisbane",
    "localtime": "2026-11-03T14:32:36"
  }
}

摘录显示此单 IP 响应中的相关字段。查看完整 IP 报告

查询建立连接的客户端自身地址时，请使用 https://api.ipquery.io/?format=json。批量查询已禁用。

API 参考

匹配与来源

匹配的 Enterprise MMDB 支持 API 查询；CSV 支持国家和城市汇总。

探索国家完整方法说明