https://github.com/dmitry/geo_pointer
Reverse geo pointer of hierarchical OpenStreetMap administrative locations using overpass API
https://github.com/dmitry/geo_pointer
Last synced: about 1 year ago
JSON representation
Reverse geo pointer of hierarchical OpenStreetMap administrative locations using overpass API
- Host: GitHub
- URL: https://github.com/dmitry/geo_pointer
- Owner: dmitry
- License: mit
- Created: 2016-09-06T13:01:40.000Z (almost 10 years ago)
- Default Branch: master
- Last Pushed: 2016-09-28T12:00:05.000Z (over 9 years ago)
- Last Synced: 2025-02-07T08:49:15.555Z (over 1 year ago)
- Language: Ruby
- Homepage: http://geo.dmitry.eu/
- Size: 38.2 MB
- Stars: 2
- Watchers: 2
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
# GEO Pointer
Reverse geocoder of hierarchical OpenStreetMap administrative locations using overpass API.
API service allows to receive hierarchical information of the admin boundaries around the world using the [OSM](http://www.openstreetmap.com/) data through the [overpass API](http://wiki.openstreetmap.org/wiki/Overpass_API).
# How to use
Pass coordinates to the URL `/{lat},{lng}` and receive back GeoJSON features with the locaitons in hierarchical order (from country to the city) with translations, bounding box, meta information, full multipolygon shape geometry and area size.
# Demo
You can try out demo, but please don't use it in production as it could be changed in the nearest future:
[geo.dmitry.eu](http://geo.dmitry.eu/)
# Installation
## Requirements
- ruby 2.2.4
- apt-get install libgeos-dev (GEOS library for rGeo gem)
## Up and run
Use `rackup` in development or `puma`, `passenger` or other `rack` supported server to run in the production.
## Setup own Overpass API server
Please follow to the installation guide using docker image: [docker-overpass-api](https://github.com/dmitry/docker-overpass-api).
Setup `OVERPASS_HOST` environment to use this newly installed Overpass API server.
# Docker
## Get overpass API
```
git submodule update --init --recursive
```
Download planet and filter it.
## Run
```
sudo docker-compose -p geo_pointer up -d
```
And wait around 1 hour before it starts and generates all required files.