sypexgeo4j - is a Java REST client for Sypex geo service. Sypex REST API allows to run up to 10000 requests per month for free.

[] (https://travis-ci.org/sypexgeo/sypexgeo4j)

Maven

<dependency>
    <groupId>com.github.sypexgeo</groupId>
    <artifactId>sypexgeo</artifactId>
    <version>1.0.1</version>
</dependency

Usage

// Initialize client. The 'auth key' may be null
SxGeoResult result = SxRestClient.create("auth key").get("93.92.217.228");
result.setCache(myCacheImpl); // set cache implementation (optional) 

// Most important fields have dedicated fields
result.city.name.en() ➟ "Seattle"
result.city.name.ru() ➟ "Сиэтл"
result.city.timeZone ➟ "America/Los_Angeles"
result.region.name.de() ➟ "Washington (Bundesstaat)"
result.country.name.fr() ➟ "États-Unis"

// All values from response are available as attributes
res.country.getStringAttribute(SxValue.AREA)  ➟ "9629091"
res.country.getIntAttribute(SxValue.AREA)  ➟ 9629091

Requirements

Java 1.8+

License

This project available under Apache License Version 2.0