w3w-java-wrapper

KO | EN

gitlite — search

#javascript #python #hacktoberfest #react #ai #typescript #llm #go #golang #android #machine-learning #rust #deep-learning #linux

w3w-java-wrapper

★ 8 Open GitHub ↗

Java wrapper for the what3words API

// repository documentation

Was this content helpful?

★ 0 (0 ratings)

# w3w-java-wrapper
Java wrapper for the [what3words](http://what3words.com/) [web-API](https://docs.what3words.com/api/v2/).

Use the what3words API in your Java applications.

## Methods

![ScreenShot](https://cloud.githubusercontent.com/assets/1185547/11721162/c1375aa0-9f62-11e5-873f-d1103118d36f.png)

## Code Samples

```java
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
}
```

```java
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 ](http://what3words.com/) 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:
  * [@chrismayer](https://github.com/chrismayer)
  * [@tsamaya](https://github.com/tsamaya)
  * [@jstastny](https://github.com/jstastny)

## Who do I talk to?
You need more information or support? Please contact us at

info__(at)__meggsimum__(dot)__de

w3w-java-wrapper

Explore Similar Repositories

Was this content helpful?

Recent Feedback

Download README