IP 定位框架 GeoIP2 for Java

一、GeoIP2 简介

 
GeoIP 官网：https://www.maxmind.com/en/geoip2-services-and-databases

MaxMind 是位于马萨诸塞州的数字地图公司，提供全世界的 IP 地址的位置数据。MaxMind 的定位服务在全球范围内享有盛誉，是应用最广泛的定位服务。其提供 Geoip 和 Geoip2 两个版本的 IP 地址定位服务，并提供开放源代码数据 GeoLite2，GeoLite2 数据库是 GeoIP2 的免费版，其准确率稍低于付费版。

GeoLite2 数据库由几部分组成：GeoLite2 国家库、GeoLite2 城市库和 Geolite2 ASN。他们分别满足不同的功能，GeoLite2 国家库仅能查询 IP 地址所在的国家和洲；GeoLite2 城市库可以查询到 IP 地址所在的国家、地区、城市、经纬度和邮政编码等信息；Geolite2 ASN 用于查询IP地址所属的自治域 AS 或者运营商 ISP。

GeoLite2 离线数据库每月更新一次，可以通过官方网站下载 MaxMind DB 格式的压缩文件。MaxMind 提供支持 7 种编程语言或软件的 API 支持，包括 C#、C、Java、Perl、PHP、Python、Apache（mod_maxminddb）。还有许多第三方 API 支持更多种编程语言或软件。GeoLite2 支持包括英语、汉语、俄语、日语和西班牙语等在内的多种语言。
 

二、GeoIP2 使用

 

1、下载离线库

 
官方下载地址：https://dev.maxmind.com/geoip/geoip2/downloadable/

百度网盘：https://pan.baidu.com/s/1BMirxMxrGN6G6qZwH597Cg 提取码: vxsb

下载文件解压后得到的 GeoLite2-City.mmdb 为 GeoIP2 离线库文件，大概 60M，不算小，可根据情况决定放在项目资源文件中或者服务器上。

 

2、添加 Maven 依赖

 

<dependency>
    <groupId>com.maxmind.geoip2groupId>
    <artifactId>geoip2artifactId>
    <version>2.13.1version>
dependency>

如果 GeoIP2 运行时报错 com.fasterxml.jackson.databind.JsonMappingException：

Exception in thread "main" java.lang.NoSuchMethodError: com.fasterxml.jackson.databind.JsonMappingException.<init>(Ljava/io/Closeable;Ljava/lang/String;)V

因为缺少 jackson.databind 依赖包，引入 jackson 依赖即可解决：

<dependency>
    <groupId>com.fasterxml.jackson.coregroupId>
    <artifactId>jackson-databindartifactId>
    <version>2.11.0version>
dependency>

 

3、封装 IP 定位工具类

 

import com.maxmind.geoip2.DatabaseReader;
import com.maxmind.geoip2.exception.GeoIp2Exception;
import com.maxmind.geoip2.model.CityResponse;
import com.maxmind.geoip2.record.*;

import java.io.IOException;
import java.io.InputStream;
import java.net.InetAddress;

/**
 * IP 定位工具类
 */
public class IpUtil {
     

    // 全局静态常量，GeoIP2 离线库文件名
    private static final String geoip2DB = "GeoLite2-City.mmdb";

    // 全局静态变量，保证类加载时加载一次，避免反复读取 GeoIP2 离线库
    private static DatabaseReader reader;

    // 静态代码块, 初始化时执行一次
    static {
     
        InputStream database;
        try {
     
            // 读取 GeoIP2 离线库，jar 包中的资源文件无法以 File 方式读取，需要用 InputStream 流式读取
            database = IpUtil.class.getClassLoader().getResourceAsStream(geoip2DB);
            reader = new DatabaseReader.Builder(database).build();
        } catch (IOException e) {
     
            e.printStackTrace();
        }
    }

    /**
     * IP 解析
     *
     * @param ip IP 地址
     * @return IpInfo
     */
    public static IpInfo getIpInfo(String ip) {
     

        IpInfo info = new IpInfo();

        try {
     
            // 根据 IP 地址查询结果
            InetAddress ipAddress = InetAddress.getByName(ip);
            CityResponse response = reader.city(ipAddress);
            // 从查询结果中提取信息（国家，省份，城市，邮编，定位）
            Country country = response.getCountry();
            Subdivision subdivision = response.getMostSpecificSubdivision();
            City city = response.getCity();
            Postal postal = response.getPostal();
            Location location = response.getLocation();
            // 获取信息的中文名称
            info.setIp(ip);
            info.setCountryName(country.getNames().get("zh-CN"));
            info.setCountryCode(country.getIsoCode());
            info.setProvinceName(subdivision.getNames().get("zh-CN"));
            info.setProvinceCode(subdivision.getIsoCode());
            info.setCityName(city.getNames().get("zh-CN"));
            info.setPostalCode(postal.getCode());
            info.setLongitude(location.getLongitude());
            info.setLatitude(location.getLatitude());

        } catch (IOException e) {
     
            e.printStackTrace();
        } catch (GeoIp2Exception e) {
     
            e.printStackTrace();
        }

        return info;
    }

    /**
     * IP 信息实体类
     */
    static class IpInfo {
     

        // IP
        private String ip;

        // 国家
        private String countryName;
        private String countryCode;

        // 省份
        private String provinceName;
        private String provinceCode;

        // 城市
        private String cityName;

        // 邮政编码
        private String postalCode;

        // 经度
        private Double longitude;
        // 纬度
        private Double latitude;

        public String getIp() {
     
            return ip;
        }

        public void setIp(String ip) {
     
            this.ip = ip;
        }

        public String getCountryName() {
     
            return countryName;
        }

        public void setCountryName(String countryName) {
     
            this.countryName = countryName;
        }

        public String getCountryCode() {
     
            return countryCode;
        }

        public void setCountryCode(String countryCode) {
     
            this.countryCode = countryCode;
        }

        public String getProvinceName() {
     
            return provinceName;
        }

        public void setProvinceName(String provinceName) {
     
            this.provinceName = provinceName;
        }

        public String getProvinceCode() {
     
            return provinceCode;
        }

        public void setProvinceCode(String provinceCode) {
     
            this.provinceCode = provinceCode;
        }

        public String getCityName() {
     
            return cityName;
        }

        public void setCityName(String cityName) {
     
            this.cityName = cityName;
        }

        public String getPostalCode() {
     
            return postalCode;
        }

        public void setPostalCode(String postalCode) {
     
            this.postalCode = postalCode;
        }

        public Double getLongitude() {
     
            return longitude;
        }

        public void setLongitude(Double longitude) {
     
            this.longitude = longitude;
        }

        public Double getLatitude() {
     
            return latitude;
        }

        public void setLatitude(Double latitude) {
     
            this.latitude = latitude;
        }

        @Override
        public String toString() {
     
            return "IpInfo{" +
                    "ip='" + ip + '\'' +
                    ", countryName='" + countryName + '\'' +
                    ", countryCode='" + countryCode + '\'' +
                    ", provinceName='" + provinceName + '\'' +
                    ", provinceCode='" + provinceCode + '\'' +
                    ", cityName='" + cityName + '\'' +
                    ", postalCode='" + postalCode + '\'' +
                    ", longitude=" + longitude +
                    ", latitude=" + latitude +
                    '}';
        }

    }

}

用自己的 IP 地址测试一下：

    public static void main(String[] args) {
     
        System.out.println(getIpInfo("112.20.83.138").toString());
    }

测试结果：

IpInfo{
     ip='112.20.83.138', countryName='中国', countryCode='CN', provinceName='江苏省', provinceCode='JS', cityName='南京', postalCode='null', longitude=118.7778, latitude=32.0617}

 

三、GeoIP2 总结

 
GeoLite2 基本上可以满足一般对精度要求不高的 IP 定位需求，离线运行查询速度很快，每秒能查询 2000+ 次，且数据信息较为丰富，唯一的不足是国内城市的查询准确性相对较差，这方面 ip.taobao.com 和 百度地图 api 做得更好，对国内这块的查询准确率和覆盖率上要更高，奈何这两货都是在线查询接口，查询次数和速度都有限制。当然如果项目组不缺钱直接埃文科技一步到位，全球最全 IP 定位数据库，不过我想既然你都看到这了，这钱估计还是得省下来，就老老实实用 GeoIP2 吧 23333~
 

参考文章：

https://zhuanlan.zhihu.com/p/55075356