Java wrapper for the what3words API
Java
Fetching latest commit…
Cannot retrieve the latest commit at this time.
Permalink
Failed to load latest commit information.
src
.gitignore
LICENSE
README.md
pom.xml

README.md

w3w-java-wrapper

Java wrapper for the what3words web-API.

Use the what3words API in your Java applications.

Methods

ScreenShot

Code Samples

String apiKey = "my-super-w3w-apikey";
What3Words w3w = new What3Words(apiKey);
String[] words = {"goldfish", "fuzzy", "aggregates"};
try {
    double[] coords = w3w.wordsToPosition(words);
    System.out.println(coords[0] +  " / " + coords[1]);
} catch (Exception e) {
    // do your error handling
}
String apiKey = "my-super-w3w-apikey";
What3Words w3w = new What3Words(apiKey);
Double[] coords = {49.422636, 8.320833};
try {
    // optionally set a different language
    String[] words = w3w.positionToWords(coords, "de");
    System.out.println(words[0] +  "." + words[1] +  "." + words[2]);
} catch (Exception e) {
    // do your error handling
}

Build

JDK and Maven need to be installed on your system.

  • Clone this repository
  • Run mvn package -DW3W_API_KEY=YOUR-API-KEY or
  • Run mvn package in case you do not want to enter your API key for test. Tests requiring API key will be skipped.
  • Under target/ you will find the file w3w-java-wrapper-<version>-jar-with-dependencies.jar which can be embedded into your Java application

Contributions

Any contribution is warmly welcome:

  • Documentation
  • Bug reporting
  • Bug fixes
  • Code enhancements

Credits

Thanks to what3words for offering such a great project and for any help we received by their team.

Also a big thank you to all who contributed to this project:

Who do I talk to?

You need more information or support? Please contact us at

info__(at)meggsimum(dot)__de