IP Geo Location
收藏IP Geo Location 数据集详情
总览
- 提供商: Yardbird
- 类别: Location
- API 版本: 1.0.0 (当前)
- 开发者: Yardbird
- 订阅者数量: 2
- 服务等级: 100%
- 延迟: 65ms
- 测试成功率: 100%
- 热度: 8.1
定价方案
| 方案 | 月费 |
|---|---|
| BASIC | $0.00 |
| PRO | $2.99 |
| ULTRA | $9.99 |
| MEGA | $19.99 |
功能描述
通过一个 GET 请求，查询任意公共 IPv4 或 IPv6 地址的地理位置数据。返回国家、地区、城市、坐标、邮政编码和时区信息。不追踪、不记录 IP 地址。
输入参数
- 接口路径:
GET /lookup?ip=8.8.8.8 - 接受的格式: IPv4 和 IPv6
返回字段说明
| 字段 | 类型 | 描述 |
|---|---|---|
country_code |
字符串 | ISO 3166-1 alpha-2 国家代码 (如 US, DE, UA) |
country |
字符串 | 英文全称国家名 |
region_code |
字符串 | ISO 地区代码 — 州或省 (如 CA, NY) |
region |
字符串 | 英文地区/州名 |
city |
字符串 | 英文城市名 |
zip |
字符串 | 邮政编码 |
latitude |
浮点数 | 纬度坐标 |
longitude |
浮点数 | 经度坐标 |
timezone |
字符串 | IANA 时区 (如 America/New_York) |
valid |
布尔值 | 当 IP 为已知公共 IP 且有位置数据时为 true |
注意: 私有地址和保留地址范围（RFC 1918、loopback、link-local）会返回 valid=false，且字段为空。
示例输出
有效 IPv4 (/lookup?ip=8.8.8.8)
json
{
"ip": "8.8.8.8",
"valid": true,
"country_code": "US",
"country": "United States",
"region_code": "CA",
"region": "California",
"city": "Mountain View",
"zip": "94043",
"latitude": 37.386,
"longitude": -122.0838,
"timezone": "America/Los_Angeles"
}
有效 IPv6 (/lookup?ip=2001:4860:4860::8888)
json
{
"ip": "2001:4860:4860::8888",
"valid": true,
"country_code": "US",
"country": "United States",
"region_code": "",
"region": "",
"city": "",
"zip": "",
"latitude": 37.751,
"longitude": -97.822,
"timezone": "America/Chicago"
}
私有 IP (/lookup?ip=192.168.1.1)
json
{
"ip": "192.168.1.1",
"valid": false,
"country_code": "",
"country": "",
"region_code": "",
"region": "",
"city": "",
"zip": "",
"latitude": 0,
"longitude": 0,
"timezone": ""
}
使用场景
- 访问控制 — 按国家阻止或允许访问
- 内容本地化 — 自动选择语言或货币
- 欺诈检测 — 标记来自异常地区的注册行为
- 分析 — 在不存储原始 IP 的情况下，用国家/城市信息丰富事件数据
