在开发中经常会遇到通过IP来获取用户位置信息的场景,如根据位置做风控策略等等,Geolocation是由MaxMind公司开源的IP数据库,本次我们介绍该开源工具的简单使用。
步骤一: GeoLite2-City.mmdb是一款被MaxMind公司开发的开源Geolocation库,可以利用 IP 地址来获取其地理位置信息。这是一个免费版的数据库,它提供国家、省份、城市、经纬度等信息,我们可以使用它来做 IP 地址的地理定位。
在项目中增加MaxMind的数据库读取依赖。如果你使用的是Maven来构建项目,只需在pom.xml文件中加入以下依赖:
<dependency>
<groupId>com.maxmind.geoip2</groupId>
<artifactId>geoip2</artifactId>
<version>2.15.0</version>
</dependency>
步骤二:准备GeoLite2城市数据库
下载GeoLite2-City.mmdb数据库文件。你可以直接从MaxMind的官方网站上下载这个数据库:https://dev.maxmind.com/geoip/geoip2/geolite2/
步骤三:使用DatabaseReader获取地理位置信息
接下来,我们需要使用DatabaseReader类来查询IP对应的地理位置信息。假设我们的GeoLite2-City.mmdb数据库文件路径为 geolite/GeoLite2-City.mmdb,以下是操作代码:
import java.io.InputStream;
import java.io.Serializable;
import java.net.InetAddress;
import java.util.Optional;
import org.slf4j.Logger;
import org.slf4j.LoggerFactory;
import org.springframework.core.io.FileSystemResourceLoader;
import com.maxmind.geoip2.DatabaseReader;
import com.maxmind.geoip2.model.CityResponse;
import com.maxmind.geoip2.record.City;
import com.maxmind.geoip2.record.Country;
import com.maxmind.geoip2.record.Location;
import lombok.AllArgsConstructor;
import lombok.Builder;
import lombok.Data;
import lombok.NoArgsConstructor;
import lombok.experimental.UtilityClass;
@UtilityClass
public class GeoIpLocatorUtils {
private static final Logger logger = LoggerFactory.getLogger(GeoIpLocatorUtils.class);
private static final String GEO_LITE_CITY_PATH = "classpath:geolite/GeoLite2-City.mmdb";
private static DatabaseReader reader;
static {
try {
InputStream inputStream =
new FileSystemResourceLoader().getResource(GEO_LITE_CITY_PATH).getInputStream();
reader = new DatabaseReader.Builder(inputStream).build();
} catch (Exception e) {
logger.error("Load reader database error.");
throw new IllegalArgumentException();
}
}
public static GeoLocation getLocation(String ipAddress) {
try {
InetAddress ip = InetAddress.getByName(ipAddress);
Optional<CityResponse> optional = reader.tryCity(ip);
if (optional.isPresent()) {
CityResponse response = optional.get();
City city = response.getCity();
Country country = response.getCountry();
Location location = response.getLocation();
return GeoLocation.builder()
.countryIsoCode(country.getIsoCode())
.country(country.getName())
.city(city.getName())
.latitude(location.getLatitude())
.longitude(location.getLongitude())
.build();
}
} catch (Exception e) {
logger.error("Geo ip get location error. ipAddress={}", ipAddress);
return null;
}
return null;
}
@Data
@Builder
@AllArgsConstructor
@NoArgsConstructor
public static class GeoLocation implements Serializable {
private static final long serialVersionUID = -446831836931739094L;
private String country;
private String countryIsoCode;
private String city;
private Double latitude;
private Double longitude;
}
}