Skip to content

Geocoder Ariadna on ElasticSearch with OpenStreetMap

License

Notifications You must be signed in to change notification settings

maddevsio/ariadna

Folders and files

NameName
Last commit message
Last commit date

Latest commit

bce8657 · Jun 19, 2020
Jul 18, 2019
Jul 18, 2019
Jul 16, 2019
Jul 18, 2019
Jul 12, 2019
Jul 2, 2019
Jul 18, 2019
Feb 10, 2016
Jun 19, 2020
Jul 18, 2019
Jul 18, 2019
Jul 18, 2019
Jul 18, 2019
Jul 15, 2019

Repository files navigation

Ariadna logo

Developed by Mad Devs Project Status: Active – The project has reached a stable, usable state and is being actively developed. Go Report Card License: MIT

This is the open-source geocoder built on top of ElasticSearch for fast geocoding and providing better search for CIS countries.

You could find more information about Ariadna designing in our blog.

What's a geocoding?

Geocoding is the process of transforming input text, such as an address, or a name of a place—to a location on the earth's surface.

What can the Ariadne geocoder search for?

  • Street + housenumber;
  • Road intersections;
  • Points of interest;
  • Microdictricts;
  • Addresses in microdistricts;
  • Nearest villages and towns;
  • Search with auto replace from dictionary;
  • Reverse geocoding.

What's reverse geocoding?

Reverse geocoding is the opposite, it transforms your current geographic location in to a list of places nearby.

Prerequisites

  • ElasticSearch

Install

go get -u github.com/maddevsio/ariadna

Run

 go run main.go

Configuration

You can use json or yaml files for configuration. Configuration example shown below.

cat ariadna.yml
---                                                                                                                           elastic_index: addresses # index name for elasticsearch
elastic_urls:
  - http://localhost:9200   # array of elasticsearch addresses
osm_filename: kyrgyzstan-latest.osm.pbf # temporary filename for osm.pbf file downloaded from geofabrik        
osm_url: http://download.geofabrik.de/asia/kyrgyzstan-latest.osm.pbf  # Download url for osm.pdf file
index_settings: index.json   # Settings for index
import_country: Кыргызстан   # Country name to import

Contributing

If you'd like to contribute, please fork the repository and make changes as you'd like. Pull requests are warmly welcome.

  1. Fork it ( https://github.com/maddevsio/ariadna/fork )
  2. Create your feature branch (git checkout -b my-new-feature)
  3. Commit your changes (git commit -am 'Add some feature')
  4. Push to the branch (git push origin my-new-feature)
  5. Create a new Pull Request