maddevsio / ariadna Goto Github PK

Geocoder Ariadna on ElasticSearch with OpenStreetMap

License: MIT License

Go 79.52% HTML 7.12% JavaScript 11.48% Dockerfile 1.88%

geocoding-api address-geocoding elasticsearch openstreetmap go golang

ariadna's Introduction

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.

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

ariadna's People

Contributors

Stargazers

Watchers

ariadna's Issues

Use google maps api to improve search quality

Optional autotransliterate feature

We can enable it by flag in config and if enabled then use dicts to autotransliterate data

Low accuracy when geocoding Cuba

Here are two example queries:

Calle 72 No. 4504 y Calle 43, Havana
Calle 46 y Ave. 3ra A, #305, Miramar, La Habana, Havana

Both are giving very unprecise results. At best, it's getting the right Cuba with accuracy down to Havana. At worst, returning Florida or Illinois Cuba.

Use r-tree to search intersections instead of postgresql

Support for different address schemes

Use yandex maps api to improve search quality

Make single geo package for working with geo stuff

Move some settings to ENV

Elasticsearch configuration
pg configuration

Make better way to bulk insert to elasticsearch

Not work with Elastic 1.7.3

When start update data to base,i get error:
Failed to create Elastic search client with error no Elasticsearch node available

I start with this parametr: ./ariadna --es_pg_conn_url "host=localhost user=geo password=geo dbname=geo sslmode=disable" --es_url "http://localhost:9200" --filename "russia-latest.osm.pbf" --download_url "http://download.geofabrik.de/russia-latest.osm.pbf" update

elasticsearch 1.7.3 work on http://localhost:9200
test elasticsearch : curl -X POST 'http://localhost:9200/tutorial/helloworld/2' -d '{ "message": "Hello World!" }'
{"_index":"tutorial","_type":"helloworld","_id":"2","_version":1,"created":true}

2016/05/11 10:27:49 INF [importer] Data inserted
DEPRECATED Action signature. Must be cli.ActionFunc. This is an error in the application. Please contact the distributor of this application if this is not you. See https://github.com/codegangsta/cli/blob/master/CHANGELOG.md#deprecated-cli-app-action-signature

Add documentation with instructions how to use it.
Improve godoc documentation