Microservice for geo information enrichment.
This microservice allows to obtain geo data from Nominatim and Wikidata. To prevent data from being reloaded repeatedly, once obtained geo data is stored in an Elasticsearch index that should be part of the local machine or the local area network.
Currently, the service provides information for
The application is built using the Playframework and Elasticsearch.
Create and change into a directory where you want to store the project, e.g.:
mkdir ~/git ; cd ~/git
Get the project from GitHub:
git clone https://github.com/hbz/geodata.git
Download activator into your home directory in order to launch the Play app:
cd ~ ; wget http://downloads.typesafe.com/typesafe-activator/1.3.10/typesafe-activator-1.3.10-minimal.zip
unzip typesafe-activator-1.3.10-minimal.zip
Start the app:
cd ~/git/geodata
~/activator-1.3.10-minimal/bin/activator "start 7401"
When startup is complete (Listening for HTTP on /0.0.0.0:7401), exit with Ctrl+D, output will be logged to target/universal/stage/logs/application.log.
The service runs with an embedded Elasticsearch index. The index is created on startup of the application BUT ONLY if it does not yet exist. Note that the index is created incrementally based on the queries the application receives. Additionally, the Nominatim web service restricts the use of the API to one request per second (see http://wiki.openstreetmap.org/wiki/Nominatim_usage_policy). Thus, it takes a considerable amount of time to rebuild the index. If you wish to build the index again, delete the data folder in the project root directory and start the application.
If you'd like to import the project into eclipse, use the activator command eclipse to prepare the project:
cd ~/git~/activator-1.3.10-minimal/bin/activator eclipse