Nominatim Java API client

A simple client library for the Nominatim API written in Java

License	GNU Lesser General Public License, Version 3
Categories	MINA Net Networking
GroupId	fr.dudie
ArtifactId	nominatim-api
Last Version	3.4
Release Date	Jun 19, 2019
Type	jar
Description	Nominatim Java API client A simple client library for the Nominatim API written in Java
Project URL	https://github.com/jeremiehuchet/nominatim-java-api
Project Organization	Dudie
Source Code Management	https://github.com/jeremiehuchet/nominatim-java-api/tree/master

Download nominatim-api

Filename	Size
nominatim-api-3.4.pom
nominatim-api-3.4.jar	25 KB
nominatim-api-3.4-sources.jar	12 KB
nominatim-api-3.4-javadoc.jar	81 KB

How to add to project

Apache Maven

<!-- https://jarcasting.com/artifacts/fr.dudie/nominatim-api/ -->
<dependency>
    <groupId>fr.dudie</groupId>
    <artifactId>nominatim-api</artifactId>
    <version>3.4</version>
</dependency>

Gradle Groovy

// https://jarcasting.com/artifacts/fr.dudie/nominatim-api/
implementation 'fr.dudie:nominatim-api:3.4'

Gradle Kotlin

// https://jarcasting.com/artifacts/fr.dudie/nominatim-api/
implementation ("fr.dudie:nominatim-api:3.4")

Apache Buildr

'fr.dudie:nominatim-api:jar:3.4'

Apache Ivy

<dependency org="fr.dudie" name="nominatim-api" rev="3.4">
  <artifact name="nominatim-api" type="jar" />
</dependency>

Groovy Grape

@Grapes(
@Grab(group='fr.dudie', module='nominatim-api', version='3.4')
)

Scala SBT

libraryDependencies += "fr.dudie" % "nominatim-api" % "3.4"

Leiningen

[fr.dudie/nominatim-api "3.4"]

Dependencies

compile (4)

Group / Artifact	Type	Version
org.slf4j : slf4j-api	jar	1.7.26
com.google.code.gson : gson	jar	2.8.5
com.github.filosganga : geogson-jts	jar	1.1.100
org.apache.httpcomponents : httpclient	jar	4.5.9

test (3)

Group / Artifact	Type	Version
junit : junit	jar	4.12
org.apache.commons : commons-lang3	jar	3.9
org.slf4j : slf4j-log4j12	jar	1.7.26

Project Modules

There are no modules declared in this project.

Nominatim Java API

This library provides a client for Nominatim. This API provides search and reverse geocoding operations.

Quickstart

Maven users can add the following dependency to their pom.xml:

<dependency>
  <groupId>fr.dudie</groupId>
  <artifactId>nominatim-api</artifactId>
  <version>3.4</version>
</dependency>

Note that it is fair and reasonable to specify an email address when using the Nominatim API, see the Notminatim Usage Policy for more informations.

If you are sending in large numbers of requests it is particularly important that we have some way of contacting you - otherwise, in the event of problems, the only alternative is to ban your IP and wait for you to contact us.

How to use

See the API javadoc and JUnit tests.

Java & Android

I don't use it anymore in android app but it should still be compatible with Android.

Features

See the releases page.

Please ask for enhancements and report bugs on Github tracker or contact us.

Versions

Version
3.4 Jun 19, 2019
3.3.1 Jun 17, 2019
3.3 Apr 23, 2017
3.2 Sep 12, 2015
3.1 Aug 6, 2015
3.0.1 Jan 18, 2015
3.0 Jul 25, 2014
2.0.2 May 19, 2013
2.0.1 Jan 8, 2013
2.0 Jun 15, 2012
1.0.1 Jan 26, 2012
1.0 Sep 28, 2011