Java API for Sypex Geo Web Service
Java
Switch branches/tags
Nothing to show
Clone or download
Fetching latest commit…
Cannot retrieve the latest commit at this time.
Permalink
Failed to load latest commit information.
src
.gitignore
.travis.yml
LICENSE
README.md
pom.xml

README.md

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

[Build Status] (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