文档中心
IP查询（优化版）
IP查询（优化版）
通过终端设备IP地址获取其当前所在地理位置，常用于显示当地城市天气预报、初始化用户城市等非精确定位场景。
更新日期
2025-06-24 10:43:10
请求方式
GET
返回格式
json
调用权限
无需实名认证
参考价格
0.00000元/次
按量计费
每次请求API接口：0.00000 元
接口信息
https://api.covibe.cn/api/location/api.php
json
GET
https://api.covibe.cn/api/location/api.php?apikey=你开通的apikey&type=json,text,html&ip=IP地址
请求参数说明
| 名称 | 必填 | 类型 | 说明 |
|---|---|---|---|
apikey |
必填 | string | 你开通的apikey |
type |
可选 | string | json,text,html |
ip |
必填 | string | IP地址 |
返回参数说明
| 名称 | 类型 | 说明 |
|---|---|---|
|
int |
返回示例
json
{
"code": 200,
"msg": "查询成功",
"data": {
"ip": "39.128.98.90",
"location": {
"lat": 22.00008,
"lng": 100.77163
},
"address": {
"nation": "中国",
"nation_code": 156,
"province": "云南省",
"city": "西双版纳傣族自治州",
"district": "景洪市",
"adcode": 532801
}
}
}错误码参照
| 错误码 | 说明 |
|---|---|
100 |
您的apikey值为空！ |
101 |
您的apikey值不存在！ |
102 |
当前来源地址不在白名单内！ |
103 |
当前接口为实名认证后可用，请您先进行实名！ |
104 |
当前接口为企业认证后可用，请您先进行企业认证！ |
105 |
当前接口未通过审核或已停止运营！ |
106 |
您的余额不足，请及时充值！ |
107 |
您当前的接口免费期限已过期，请及时续费！ |
108 |
您的点数包已用完，请及时充值！ |
109 |
您的账号已被封禁，不可使用任何接口！ |
|