IPv4 归属地

描述：IPv4归属地是将网络空间地图测绘技术与人工智能(AI）算法相结合，利用动态密度聚类算法和基于多层神经网络的IP地址定位算法，完成IP地址地理位置定位。IPv4归属地数据接口是IP地址定位数据库的在线调用接口，分为街道级、区县级、城市级共3个版本类型，能够满足客户不同定位精度的需求。

价格：￥0.00

400-0371-911

街道级
区县级
城市级

付费方式

按年付费
按量付费

选择规格

购买年限

- +

按年付费时，每日限额次数不变，可使用年限增加

立即购买

购买提醒：API产品仅支持在线接口调用，不支持实时地图查询

产品说明
API示例
应用领域
SDK

版本说明

	版本
参数

街道级

区县级

城市级

适用用户

对定位精度要求极高的公安用户

企业或个人开发者

数据描述

43亿全量IPv4，城市级别

中国地区（不含港台地区）街道级别

IP历史位置聚类，去除无效范围

含运营商数据

43亿全量IPv4，城市级别

中国地区（不含港台地区）区县级别

IP地址历史位置聚类，去除无效范围

含运营商数据

43亿全量IPv4，城市级别

含运营商数据

更新频率

每日更新

坐标系

GPS和百度

区域类型

单区域或多区域

单区域

查询速度

1000次/秒

付费方式

1.按量付费，按次扣费

2.按年付费，每日限额

1.按量付费，按次扣费

2.按年付费，每日限额

按年付费，每日限额

技术原理

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

使用方式

购买

第一步

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

第二步

1、前往个人中心>我的订单查看KEY

2、多次购买产品版本、付费方式、规格完全一致，生成一个key

3、多次购买产品版本、付费方式、规格有一项不一致，生成多个key
使用

第三步

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

查空率

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

注意事项

1.根据国家主管部门要求，IP归属地将敏感数据予以屏蔽，如果您有特殊需要，请联系客服，我们将依据相关规定，提供相应的数据服务支持。

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
调用工具：调用说明：已购产品版本的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	北京市海淀区学堂路9999999999999999	详细地址
		lat	String	40.009424	纬度
		lng	String	116.332556	经度
		radius	String	154.1	定位半径
		prov	String	北京市	省份
		city	String	北京市	城市
		district	String	海淀区	区县
	continent		String	亚洲	大洲
	country		String	中国	国家
	consistency		String	3	一致性
	correctness		String	2	准确度
	owner		String	imported inetnum object for IIINT	所属机构
	isp		String	China Education and Research Network Center,Tsinghua University,Beijing 100084	运营商
	zipcode		String	100038	邮编
	timezone		String	UTC+8	时区
	accuracy		String	城市	精度
	source		String	数据挖掘	采集方式
	areacode		String	CN	国家编码
	asnumber		String	4538	自治域编码
charge			Boolean	true	本次查询是否扣费
msg			String	查询成功	状态码描述
ip			String	166.111.4.100	查询的IP
coordsys			String	WGS84	坐标系
area			String	multi	区域类型

状态码描述

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":"154.1",
          "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地址归属地数据，可以对学术研究和网络实验提供强有力的支撑。

安卓（客户端）
Java（服务端）
Python（服务端）

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

使用指南

版本（V1.0.0）

下载

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

client.street("IP地址", StreetSubType.PSI)

client.district("IP地址")

client.city("IP地址")

client.district6("IP地址")

client.city6("IP地址")

client.host("IP地址")

client.scene("IP地址")

client.scene6("IP地址")

client.whois("IP地址")

client.whoisAS("IP地址")

client.proxy("IP地址")

client.industry("IP地址")

官方API

IPv4归属地（街道级）

IPv4归属地（区县级）

IPv4归属地（城市级）

IPv6归属地（区县级）

IPv6归属地（城市级）

IP宿主信息

IPv4应用场景

IPv6应用场景

IP Whois

AS Whois

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();
  }
}

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

client.street("IP地址", StreetSubType.PSI)

client.district("IP地址")

client.city("IP地址")

client.district6("IP地址")

client.city6("IP地址")

client.host("IP地址")

client.scene("IP地址")

client.scene6("IP地址")

client.whois("IP地址")

client.whoisAS("IP地址")

client.proxy("IP地址")

client.industry("IP地址")

官方API

IPv4归属地（街道级）

IPv4归属地（区县级）

IPv4归属地（城市级）

IPv6归属地（区县级）

IPv6归属地（城市级）

IP宿主信息

IPv4应用场景

IPv6应用场景

IP Whois

AS Whois

IP代理

IPv4行业

使用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

client.street("IP地址", StreetSubType.PSI)

client.district("IP地址")

client.city("IP地址")

client.district6("IP地址")

client.city6("IP地址")

client.host("IP地址")

client.scene("IP地址")

client.scene6("IP地址")

client.whois("IP地址")

client.whoisAS("IP地址")