JarCastingJOpenCage
This api provides a java client to the OpenCage geocoding service. https://opencagedata.com/api
Usage
Maven
<dependency>
<groupId>com.byteowls</groupId>
<artifactId>jopencage</artifactId>
<version>replace.with.version</version>
</dependency>
Gradle
implementation "com.byteowls:jopencage:REPLACE.WITH.VERSION"
Example
Forward
// In real live application the JOpenCageGeocoder should be a Singleton
JOpenCageGeocoder jOpenCageGeocoder = new JOpenCageGeocoder(YOUR_API_KEY);
JOpenCageForwardRequest request = new JOpenCageForwardRequest("Graz");
request.setMinConfidence(1);
request.setNoAnnotations(false);
request.setNoDedupe(true);
JOpenCageResponse response = jOpenCageGeocoder.forward(request);
Reverse
// In real live application the JOpenCageGeocoder should be a Singleton
JOpenCageGeocoder jOpenCageGeocoder = new JOpenCageGeocoder(YOUR_API_KEY);
JOpenCageReverseRequest request = new JOpenCageReverseRequest(-22.6792, 14.5272);
request.setNoAnnotations(true);
JOpenCageResponse response = jOpenCageGeocoder.reverse(request);
Libraries
- JDK 8+
- Apache Http Client
- FasterXml Jackson
- Slf4j
Testing
For running the tests you have to use your OWN OpenCage API Key. Get a free trail key at https://opencagedata.com/dashboard#api-keys
./gradlew -DOPENCAGE_API_KEY=ABCDEFG_YOUR_KEY test
Gradle
./gradlew wrapper --gradle-version 6.8.3
Contribute
Changelog
See CHANGELOG.
License
Apache 2.0. Please see LICENSE.
BYTEOWLS Software & Consulting
This plugin is powered by BYTEOWLS Software & Consulting.
If you need extended support for this project like critical changes or releases ahead of schedule. Feel free to contact us for a consulting offer.
Disclaimer
We have no business relation to OpenCage.