https://github.com/tornaia/java-offline-geoip

Java Offline GeoIP maps any IP address to its country code
https://github.com/tornaia/java-offline-geoip

apache2-license code country geoip geolite2 geolite2-database ip ipaddress iso iso3166 iso3166-1 iso31661 java java8 library location maven offline opensource

Last synced: 2 months ago
JSON representation

Java Offline GeoIP maps any IP address to its country code

• Host: GitHub
• URL: https://github.com/tornaia/java-offline-geoip
• Owner: tornaia
• License: apache-2.0
• Created: 2018-08-18T13:33:10.000Z (over 6 years ago)
• Default Branch: master
• Last Pushed: 2020-01-05T17:10:22.000Z (almost 5 years ago)
• Last Synced: 2024-10-01T19:18:30.204Z (3 months ago)
• Topics: apache2-license, code, country, geoip, geolite2, geolite2-database, ip, ipaddress, iso, iso3166, iso3166-1, iso31661, java, java8, library, location, maven, offline, opensource
• Language: Java
• Homepage:
• Size: 2.71 MB
• Stars: 12
• Watchers: 2
• Forks: 2
• Open Issues: 0
• Metadata Files:
  • Readme: README.md
  • License: LICENSE.txt

Awesome Lists containing this project

README

        
### Java Offline Geoip

[![GitHub](https://img.shields.io/github/license/tornaia/java-offline-geoip.svg)](https://opensource.org/licenses/Apache-2.0)

##### Donate

Clear feedback. Just if you appreciate my efforts!

[![](https://www.paypalobjects.com/en_US/i/btn/btn_donateCC_LG.gif)](https://www.paypal.com/cgi-bin/webscr?cmd=_s-xclick&hosted_button_id=https://www.paypal.com/cgi-bin/webscr?cmd=_s-xclick&hosted_button_id=TAANNK2KXZXHG)

##### Intro

ISO 3166-1 alpha-2 codes are two-letter country codes defined in ISO 3166-1, part of the ISO 3166 standard published by the International Organization for Standardization (ISO), to represent countries, dependent territories, and special areas of geographical interest. [Read more](https://en.wikipedia.org/wiki/ISO_3166-1_alpha-2)

##### How to use

```java

GeoIP geoIP = GeoIPProvider.getGeoIP();

Optional optionalCountryIsoCode = geoIP.getTwoLetterCountryCode("50.63.202.32");

// optionalCountryIsoCode: Optional[US]

Optional optionalCountryName = geoIP.getCountryName("50.63.202.32");

// optionalCountryName: Optional[United States]

```

##### Maven

```xml

  com.github.tornaia

  java-offline-geoip

  0.1.10

```

##### Prerequisites for development

* OpenJDK 8 or later (https://jdk.java.net/) 

* Maven 3.2.1 or later (https://maven.apache.org/download.cgi)

##### Build

* mvn clean package

##### License

The GeoLite2 databases are distributed under the Creative Commons Attribution-ShareAlike 4.0 International License. The attribution requirement may be met by including the following in all advertising and documentation mentioning features of or use of this database:

This product includes GeoLite2 data created by MaxMind, available from

http://www.maxmind.com.