IPv4归属地查询API - IP地址定位接口

产品说明

API示例(城市级)

API示例(区县级)

API示例(街道级)

应用领域

安卓(客户端)-SDK

Java(服务端)-SDK

Python(服务端)-SDK

版本说明

参数\版本	街道级	区县级	城市级
适用用户	对定位精度要求极高的公安用户	企业或个人开发者	企业或个人开发者
数据描述	⭐43亿全量IPv4，城市级别 ⭐中国地区（不含港台地区）街道级别 ⭐IP历史位置聚类，去除无效范围 ⭐含运营商数据	⭐43亿全量IPv4，城市级别 ⭐中国地区（不含港台地区）区县级别 ⭐IP地址历史位置聚类，去除无效范围 ⭐含运营商数据	⭐43亿全量IPv4，城市级别 ⭐含运营商数据
更新频率	每日更新	每日更新	每日更新
坐标系	GPS和百度	GPS和百度	GPS和百度
区域类型	单区域或多区域	单区域	单区域
查询速度	⭐1000次/秒	⭐1000次/秒	⭐1000次/秒
付费方式	1.按量付费，按次扣费 2.按年付费，每日限额	1.按量付费，按次扣费 2.按年付费，每日限额	按年付费，每日限额

名词解析

坐标系： WGS84（大地坐标系）：国际标准，一般用国际GPS记录仪记录下来的经纬度，通过GPS定位拿到的原始经纬度； Google地图（中国香港、中国台湾、国外地区）、高德地图（中国台湾、国外地区）、OpenStreetMap地图（全球）、百度地图（国外地区）使用的WGS84坐标系 BD09（百度坐标系）：百度标准，是在GCJ02坐标系的基础之上再次加密偏移后形成的坐标系；百度地图（中国大陆、中国香港、中国台湾）使用BD09坐标系区域类型：单区域是指概率最高的位置区域，即最优区域；多区域是指所有潜在位置区域

技术原理

IP归属地是利用大数据挖掘和大规模网络探测技术，对IP地址的基础信息和网络拓扑数据进行采集、处理，结合IP地址所在的应用场景与网络属性等因素，利用动态密度聚类算法和基于多层神经网络的IP地址定位算法，完成IP地址地理位置定位。

使用方式

购买

第一步 1、选择规格 2、支付宝付款 3、查收购买成功确认邮件

查看KEY

第二步 1、前往 [个人中心](https://account.ipplus360.com/setting) >[我的订单](https://account.ipplus360.com/setting?from=mall)查看KEY 2、多次购买产品版本、付费方式、规格完全一致，生成一个key 3、多次购买产品版本、付费方式、规格有一项不一致，生成多个key

使用

第三步 1、API调用参考对应的API示例

查空率

1.查询成功且返回有效数据，（返回有效数据：查询出的数据不为空且定位精度和承诺定位精度一致），每次扣除1个查询额度。 2.查询成功但未返回有效数据，（未返回有效数据：查询出的数据为空或定位精度和承诺定位精度不一致），每50次扣除1个查询额度。

注意事项

1.街道级数据覆盖中国地区（不含港、台地区），如需境外地区街道级数据库请与客服联系。 2.根据国家主管部门要求，IP归属地将敏感数据予以屏蔽，如果您有特殊需要，请联系客服，我们将依据相关规定，提供相应的数据服务支持。

API接口

接口地址：https://api.ipplus360.com/ip/geo/v1/city/ 请求方式：HTTPS GET/POST 请求示例：https://api.ipplus360.com/ip/geo/v1/city/?key=您申请的key&ip=您需要查询的ip&coordsys=WGS84 调用工具：[[去调试]](https://account.ipplus360.com/login?redirect=https://mall.ipplus360.com/pros/IPSceneAPI)调用说明：已购产品版本的key值，只能用于该版本API调用，不能用于其他版本；

请求参数

名称	必填	类型	示例值	描述
key	是	String		您申请的key
ip	是	String	166.111.4.100	查询的IP
coordsys	否	String	WGS84	坐标系，分为WGS84和BD09，默认为WGS84

返回参数

名称	类型	示例值	描述
code	String	Success	状态码
data.continent	String	亚洲	大洲
data.country	String	中国	国家
data.owner	String	imported inetnum object for IIINT	所属机构
data.isp	String	China Education and Research Network Center,Tsinghua University,Beijing 100084	运营商
data.zipcode	String	100038	邮编
data.timezone	String	UTC+8	时区
data.accuracy	String	城市	精度
data.source	String	数据挖掘	采集方式
data.areacode	String	CN	国家编码
data.adcode	String	110100	行政编码
data.asnumber	String	4538	自治域编码
data.lat	String	40.009424	纬度
data.lng	String	116.332556	经度
data.radius	String	105.2321	定位半径
data.prov	String	北京市	省份
data.city	String	北京市	城市
charge	Boolean	true	本次查询是否扣费
msg	String	查询成功	状态码描述
ip	String	166.111.4.100	查询的IP
coordsys	String	WGS84	坐标系

状态码描述

HTTP状态码	业务状态码	描述
200	Success	查询成功
200	NoData	查询成功，但是结果为空
400	MissingParameter	参数key缺失
400	MissingParameter	参数ip缺失
400	InvalidParameter	参数ip格式不对
400	DailyLimited	每日查询次数已满
429	Throttling	请求过快
400	UnknownError	客户端未知错误
403	KeyNotFound	key不存在
403	KeyUnauthorized	key未授权
403	KeyExpired	不在有效期
403	KeyNotEnoughBalance	余额不足
403	KeyDisabled	key被禁用
500	InternalError	服务器内部错误
503	ServiceUnavailable	服务器临时错误

返回示例值

{ "code": "Success", "data": { "continent": "亚洲", "country": "中国", "owner": "imported inetnum object for IIINT", "isp": "China Education and Research Network Center,Tsinghua University,Beijing 100084", "zipcode": "100038", "timezone": "UTC+8", "accuracy": "城市", "source": "数据挖掘", "areacode": "CN", "adcode": "110100", "asnumber": "4538", "lat": "40.009424", "lng": "116.332556", "radius": "105.2321", "prov": "北京市", "city": "北京市", }, "charge": true, "msg": "查询成功", "ip": "166.111.4.100", "coordsys": "WGS84" }

API接口

接口地址：https://api.ipplus360.com/ip/geo/v1/district/ 请求方式：HTTPS GET/POST 请求示例：https://api.ipplus360.com/ip/geo/v1/district/?key=您申请的key&ip=您需要查询的ip&coordsys=WGS84 调用工具：[[去调试]](https://account.ipplus360.com/login?redirect=https://mall.ipplus360.com/pros/IPSceneAPI)调用说明：已购产品版本的key值，只能用于该版本API调用，不能用于其他版本；

请求参数

名称	必填	类型	示例值	描述
key	是	String		您申请的key
ip	是	String	166.111.4.100	查询的IP
coordsys	否	String	WGS84	坐标系，分为WGS84和BD09，默认为WGS84

返回参数

名称	类型	示例值	描述
code	String	Success	状态码
data.continent	String	亚洲	大洲
data.country	String	中国	国家
data.owner	String	imported inetnum object for IIINT	所属机构
data.isp	String	China Education and Research Network Center,Tsinghua University,Beijing 100084	运营商
data.zipcode	String	100038	邮编
data.timezone	String	UTC+8	时区
data.accuracy	String	城市	精度
data.source	String	数据挖掘	采集方式
data.areacode	String	CN	国家编码
data.adcode	String	110100	行政编码
data.asnumber	String	4538	自治域编码
data.lat	String	40.009424	纬度
data.lng	String	116.332556	经度
data.radius	String	154.1	定位半径
data.prov	String	北京市	省份
data.city	String	北京市	城市
data.district	String	东城区	区县
charge	Boolean	true	本次查询是否扣费
msg	String	查询成功	状态码描述
ip	String	166.111.4.100	查询的IP
coordsys	String	WGS84	坐标系

状态码描述

HTTP状态码	业务状态码	描述
200	Success	查询成功
200	NoData	查询成功，但是结果为空
400	MissingParameter	参数key缺失
400	MissingParameter	参数ip缺失
400	InvalidParameter	参数ip格式不对
400	DailyLimited	每日查询次数已满
429	Throttling	请求过快
400	UnknownError	客户端未知错误
403	KeyNotFound	key不存在
403	KeyUnauthorized	key未授权
403	KeyExpired	不在有效期
403	KeyNotEnoughBalance	余额不足
403	KeyDisabled	key被禁用
500	InternalError	服务器内部错误
503	ServiceUnavailable	服务器临时错误

返回示例值

{ "code": "Success", "data": { "continent": "亚洲", "country": "中国", "owner": "imported inetnum object for IIINT", "isp": "China Education and Research Network Center,Tsinghua University,Beijing 100084", "zipcode": "100038", "timezone": "UTC+8", "accuracy": "城市", "source": "数据挖掘", "areacode": "CN", "adcode": "110100", "asnumber": "4538", "lat": "40.009424", "lng": "116.332556", "radius": "105.2321", "prov": "北京市", "city": "北京市", "district": "东城区", }, "charge": true, "msg": "查询成功", "ip": "166.111.4.100", "coordsys": "WGS84" }

API接口

接口地址：https://api.ipplus360.com/ip/geo/v1/street/psi/ 请求方式：HTTPS GET/POST 请求示例：https://api.ipplus360.com/ip/geo/v1/street/psi/?key=您申请的KEY&ip=您需要查询的ip&coordsys=WGS84&area=multi 调用工具：[[去调试]](https://account.ipplus360.com/login?redirect=https://mall.ipplus360.com/pros/IPSceneAPI)调用说明：已购产品版本的key值，只能用于该版本API调用，不能用于其他版本；

请求参数

名称	必填	类型	示例值	描述
key	是	String		您申请的key
ip	是	String	166.111.4.100	查询的IP
coordsys	否	String	WGS84	坐标系,分为WGS84和BD09,默认为WGS84
area	否	String	multi	区域类型,分为multi和single,默认为multi

返回参数

名称	类型	示例值	描述
code	String	Success	状态码
data.multiAreas.address	String	北京市海淀区学堂路	详细地址
data.multiAreas.lat	String	40.009424	纬度
data.multiAreas.lng	String	116.332556	经度
data.multiAreas.radius	String	0.1541	定位半径
data.multiAreas.prov	String	北京市	省份
data.multiAreas.city	String	北京市	城市
data.multiAreas.district	String	海淀区	区县
data.continent	String	亚洲	大洲
data.country	String	中国	国家
data.consistency	String	3	一致性
data.correctness	String	2	准确度
data.owner	String	imported inetnum object for IIINT	所属机构
data.isp	String	China Education and Research Network Center,Tsinghua University,Beijing 100084	运营商
data.zipcode	String	100038	邮编
data.timezone	String	UTC+8	时区
data.accuracy	String	城市	精度
data.source	String	数据挖掘	采集方式
data.areacode	String	CN	国家编码
data.asnumber	String	4538	自治域编码
charge	Boolean	true	本次查询是否扣费
msg	String	查询成功	状态码描述
ip	String	166.111.4.100	查询的IP
coordsys	String	WGS84	坐标系
area	String	multi	区域类型

名词解析

一致性：描述在一段时间内IP可能发生变化的程度，由精度和应用场景来确定。精度越高，一致性越高；应用场景方面，学校单位的IP比住宅用IP的一致性强。我们设计了由1星到5星的不同级别的一致性，星级越大，一致性越强；5星的一致性强于1星的一致性。准确度：是在定位成功的前提下，对定位结果准确程度的描述。由精度、应用场景（根据IP用途的不同，除了未使用IP和Anycast的IP外分为10种应用场景，分别是数据中心、学校单位、组织机构、交换中心、企业专线、住宅用户、基础设施、公共热点、移动网络和卫星通信）和定位方式（描述通过哪种方式来定位，分为2种情况，分别是地面采集和算法定位）来确定；精度越高，准确度越高；应用场景，覆盖范围越小(如移动网络IP的覆盖范围大于学校类的IP)，准确度越高；定位方式方面，地面采集比算法定位的准确度高。我们设计了由1星到5星的不同级别的准确度，星级越大，准确度越高；5星的准确度高于1星的准确度。

状态码描述

HTTP状态码	业务状态码	描述
200	Success	查询成功
200	NoData	查询成功，但是结果为空
400	MissingParameter	参数key缺失
400	MissingParameter	参数ip缺失
400	InvalidParameter	参数ip格式不对
400	DailyLimited	每日查询次数已满
429	Throttling	请求过快
400	UnknownError	客户端未知错误
403	KeyNotFound	key不存在
403	KeyUnauthorized	key未授权
403	KeyExpired	不在有效期
403	KeyNotEnoughBalance	余额不足
403	KeyDisabled	key被禁用
500	InternalError	服务器内部错误
503	ServiceUnavailable	服务器临时错误

返回示例值

{ "code": "Success", "data": { "multiAreas": [ { "address": "", "lat": "40.009424", "lng": "116.332556", "radius": "0.1541", "prov": "北京市", "city": "北京市", "district": "海淀区" } ], "continent": "亚洲", "country": "中国", "consistency": "2", "correctness": "3", "owner": "imported inetnum object for IIINT", "isp": "China Education and Research Network Center,Tsinghua University,Beijing 100084", "zipcode": "100038", "timezone": "UTC+8", "accuracy": "城市", "source": "数据挖掘", "areacode": "CN", "asnumber": "4538" }, "charge": true, "msg": "查询成功", "ip": "166.111.4.100", "coordsys": "WGS84", "area": "multi" }

应用领域

业务风控反欺诈分析IP归属地信息，识别虚假流量和欺诈账号，保障账号和交易安全，帮助企业持续优化风控与反欺诈模型，降低经济损失。广告投放利用IP地址进行精准广告投放，不涉及用户的隐私和授权问题。对不同地域和用户群制定个性化营销策略，提高在线广告投放的转化率。网络性能优化通过IP地址数据进行网络性能分析，选择传输速度最快的网络路径及运营商进行路由，针对性解决问题提升网络服务质量，提高用户满意度。在线用户匹配当用户关闭手机GPS功能时，可以采用IP地址归属地服务，快速为用户匹配同城区域内的潜在朋友。个性化内容展示为了精确匹配不同客户的需求，通过IP地址归属位置信息，实现更佳的个性化内容推荐，提高营销转化率。网络威胁溯源通过IP地址数据可提升网络威胁溯源能力，助力企业构筑端到端的威胁防线，使网络空间更透明可控。 IP地理位置可视化使用IP地理位置数据可以帮助您在大数据可视化中赋予地图更丰富的内容，供进行IP地理维度分析。法律合规社交媒体平台加入信息发布人的IP归属地，增加置信度。科学研究通过IP地址归属地数据，可以对学术研究和网络实验提供强有力的支撑。

通过API您可以准确快速地查询IP地址的归属地、宿主信息、应用场景、Whois等网络空间地图数据。那么通过埃文科技提供的软件开发工具包(SDK)，可以让您更轻松地使用已购买的API。

使用指南

[[下载]](https://download.ipplus360.com/aw/download/sdk/android/AiwenSDK-1.0.0.aar)

SDK的使用方式一：步骤一：获取公key或私key 1、登录埃文官方网站，在个人中心页面复制公key 2、或者在我的订单页面，复制相应API的私key 步骤二：使用SDK进行查询 1、去商城下载安卓版本的SDK，将aar拷贝到libs目录； 2、在build.gradle 中加入如下配置

implementation fileTree(dir: 'libs',includes: ['*.aar']) implementation group: 'com.squareup.okhttp3', name: 'okhttp', version: '4.10.0' implementation group: 'com.fasterxml.jackson.core', name: 'jackson-databind', version: '2.14.2' implementation group: 'com.fasterxml.jackson.core', name: 'jackson-core', version: '2.14.2' implementation group: 'com.fasterxml.jackson.core', name: 'jackson-annotations', version: '2.14.2'

3、在您调用该SDK之前初始化该SDK，推荐在MainActivity中完成使用公key：

public class MainActivity extends AppCompatActivity { @Override protected void onCreate(Bundle savedInstanceState) { super.onCreate(savedInstanceState); WebServiceClient client = AiWenClient.init("您的公key", this); new Thread(() -> { try { RespLocationCity city = client.city("您要查询的IP"); runOnUiThread(() -> { System.out.println(city.getData().getCity()); System.out.println(city.getData().getProv()); System.out.println(city.getData().getLat()); System.out.println(city.getData().getLng()); }); } catch (IOException | ApiException e) { throw new RuntimeException(e); } }).start(); } }

使用私key：（请注意：使用私key仅能使用相应购买的API服务）

public class MainActivity extends AppCompatActivity { @Override protected void onCreate(Bundle savedInstanceState) { super.onCreate(savedInstanceState); WebServiceClient client = AiWenClient.init("您的私key", this); new Thread(() -> { try { RespLocationCity city = client.city("您要查询的IP"); runOnUiThread(() -> { System.out.println(city.getData().getCity()); System.out.println(city.getData().getProv()); System.out.println(city.getData().getLat()); System.out.println(city.getData().getLng()); }); } catch (IOException | ApiException e) { throw new RuntimeException(e); } }).start(); } }

附1：SDK中的方法与官网API的对应关

SDK	官方API
client.street("IP地址", StreetSubType.PSI)	IPv4归属地（街道级）
client.district("IP地址")	IPv4归属地（区县级）
client.city("IP地址")	IPv4归属地（城市级）
client.district6("IP地址")	IPv6归属地（区县级）
client.city6("IP地址")	IPv6归属地（城市级）
client.host("IP地址")	IP宿主信息
client.scene("IP地址")	IPv4应用场景
client.scene6("IP地址")	IPv6应用场景
client.whois("IP地址")	IP Whois
client.whoisAS("IP地址")	AS Whois
client.proxy("IP地址")	IP代理
client.industry("IP地址")	IPv4行业

方式二：SDK免费获取本机区县级IP定位数据步骤一：区别于方式一的步骤一 1、去商城下载安卓版本的SDK，将aar拷贝到libs目录 2、在build.gradle 中加入如下配置 3、免费获取本机区县级IP定位数据，不需要使用您的公key或者私key，直接调用客户端方法

public class MainActivity extends AppCompatActivity { @Override protected void onCreate(Bundle savedInstanceState) { super.onCreate(savedInstanceState); new Thread(() -> { try { RespLocationDistrict district = AiWenClient.getMyIP(MainActivity.class); runOnUiThread(() -> { System.out.println(district.getData().getCity()); System.out.println(district.getData().getProv()); System.out.println(district.getData().getLat()); System.out.println(district.getData().getLng()); }); } catch (IOException | ApiException e) { throw new RuntimeException(e); } }).start(); } }

「埃文隐私政策」（https://www.ipplus360.com/privacy-policy）「SDK合规指南」（https://www.ipplus360.com/SDK-compliance）

使用指南版本（V1.0.0）

[[下载]](https://download.ipplus360.com/aw/download/sdk/java/AiwenSDK-1.0.0.jar)

Jar包引入项目方式一：以外部jar包引入本地项目 1、在idea上点击file-->Project Structure 2、选择Libraries--->点击+号-->选择Java 3、找到放jar文件的位置，选中jar文件，点击OK，然后下一步一直到最后选择OK就可以了方式二：将外部jar包引入到本地maven仓库中 1、打开命令行窗口，执行下面命令，注意需要将-Dfile的值替换成你的jar包所在路径 mvn install:install-file -DgroupId=com.ipplus360.api -DartifactId=AiwenSDK -Dversion=1.0.0 -Dfile=您存放的路径\AiwenSDK-1.0.0.jar -Dpackaging=jar 待窗口出现BUILD SUCCESS内容后即为完成 2、于项目pom.xml文件加入如下引用后，即可使用SDK

<dependency> <groupId>com.ipplus360.api</groupId> <artifactId>AiwenSDK</artifactId> <version>1.0.0</version> </dependency>

SDK的使用步骤一：获取公key或私key 登录埃文官方网站，在个人中心页面复制公key 或者在我的订单页面，复制相应API的私key 步骤二：使用SDK进行查询使用公key：

WebServiceClient client = new WebServiceClient.Builder("您的公key").build(); RespLocationCity city = client.city("您要查询的IP"); System.out.println(city.getCode()); System.out.println(city.getMsg()); System.out.println(city.getData().getCountry());

使用私key：（请注意：使用私key仅能使用相应购买的API服务）

WebServiceClient client = new WebServiceClient.Builder().build(); RespLocationCity city = client.city("您要查询的IP", new AwKey("您的私key")); System.out.println(city.getCode()); System.out.println(city.getMsg()); System.out.println(city.getData().getCountry());

附1：SDK中的方法与官网API的对应关系

SDK	官方API
client.street("IP地址", StreetSubType.PSI)	IPv4归属地（街道级）
client.district("IP地址")	IPv4归属地（区县级）
client.city("IP地址")	IPv4归属地（城市级）
client.district6("IP地址")	IPv6归属地（区县级）
client.city6("IP地址")	IPv6归属地（城市级）
client.host("IP地址")	IP宿主信息
client.scene("IP地址")	IPv4应用场景
client.scene6("IP地址")	IPv6应用场景
client.whois("IP地址")	IP Whois
client.whoisAS("IP地址")	AS Whois
client.proxy("IP地址")	IP代理
client.industry("IP地址")	IPv4行业

「埃文隐私政策」（https://www.ipplus360.com/privacy-policy）「SDK合规指南」（https://www.ipplus360.com/SDK-compliance）

使用指南版本（V1.0.0）

[[下载]](https://download.ipplus360.com/aw/download/sdk/python/AiwenSDK-1.0.0.tar.gz)

使用pip命令将SDK加载至本地开发环境中 pip install .\AiwenSDK-1.0.0.tar.gz 使用方式使用公key：

import client.aiwenClient from awEnum.MultiFlag import MultiFlag from awEnum.StreetSubType import StreetSubType from awModel.aiwenKey import AiwenKey client = client.aiwenClient.Client('您的公key') info = client.street("您要查询的IP", StreetSubType.PSI, MultiFlag.SINGLE) print(info.data.country)

使用私key：（请注意：使用私key仅能使用相应购买的API服务）

import client.aiwenClient from awEnum.MultiFlag import MultiFlag from awEnum.StreetSubType import StreetSubType from awModel.aiwenKey import AiwenKey client = client.aiwenClient.Client() info = client.street("您要查询的IP", StreetSubType.PSI, MultiFlag.SINGLE, AiwenKey("您的私key")) print(info.data.country)

附1：SDK中的方法与官网API的对应关系

SDK	官方API
client.street("IP地址", StreetSubType.PSI)	IPv4归属地（街道级）
client.district("IP地址")	IPv4归属地（区县级）
client.city("IP地址")	IPv4归属地（城市级）
client.district6("IP地址")	IPv6归属地（区县级）
client.city6("IP地址")	IPv6归属地（城市级）
client.host("IP地址")	IP宿主信息
client.scene("IP地址")	IPv4应用场景
client.scene6("IP地址")	IPv6应用场景
client.whois("IP地址")	IP Whois
client.whoisAS("IP地址")	AS Whois
client.proxy("IP地址")	IP代理
client.industry("IP地址")	IPv4行业

[埃文隐私政策](https://www.ipplus360.com/privacy-policy) [SDK合规指南](https://www.ipplus360.com/SDK-compliance)

购买

查看KEY

使用

产品与服务

解决方案

开发者工具

关于埃文

产品咨询

技术支持

绑定手机号