https://github.com/faradayio/argo

Rapid reverse-geocoding using Mapzen Search
https://github.com/faradayio/argo

Last synced: 8 months ago
JSON representation

Rapid reverse-geocoding using Mapzen Search

• Host: GitHub
• URL: https://github.com/faradayio/argo
• Owner: faradayio
• License: mit
• Created: 2016-02-04T02:17:17.000Z (over 10 years ago)
• Default Branch: master
• Last Pushed: 2016-11-07T19:37:06.000Z (over 9 years ago)
• Last Synced: 2025-01-06T18:48:32.775Z (over 1 year ago)
• Language: JavaScript
• Homepage: https://www.npmjs.com/package/argo-geo
• Size: 90.8 KB
• Stars: 8
• Watchers: 7
• Forks: 3
• Open Issues: 1
• Metadata Files:
  • Readme: README.md
  • License: LICENSE

Awesome Lists containing this project

README

          
# Argo

Rapid [reverse-geocoding using Mapzen Search](https://mapzen.com/documentation/search/reverse/)

![argo](boat.jpg)

### Installation

`npm install argo-geo -g`

### Usage

`argo -i  -a  -o  `

### Arguments

* `-i, --input` (_REQUIRED_) Input filename and path (e.g. '/home/ubuntu/inputfile.csv')

* `-a, --auth` (_REQUIRED_) Mapzen authorization token. [Get one here](https://mapzen.com/developers/).

* `-o, --output` (_OPTIONAL_) Output filename and path if desired. Default is the input filename with 'out_' prepended. 

* `-r, --rate` (_OPTIONAL_) Number of requests per second (default = 6)

* `-n, --latitudefield` (_OPTIONAL_) Name of column containing latitude coordinates (default = 'latitude')

* `-w, --longitudefield` (_OPTIONAL_) Name of column containing longitude coordinates (default = 'longitude')

* `-p, --pois` (_OPTIONAL_) Include POI results from [Who's on first](https://whosonfirst.mapzen.com/) instead of just addresses (default = false)

### Notes

* Expects input columns `latitude` and `longitude` - if this is not the case, use `-n` and `-w` to specify coordinate column names.

* Defaults to [openaddresses and openstreetmap results only](https://mapzen.com/documentation/search/reverse/#filter-by-data-source), unless the `p` flag is set

* Defaults to addresses, excluding POIs (schools, parks, etc), unless the `-p` flag is set

* Appends [Mapzen response fields](https://search.mapzen.com/v1/reverse?api_key=search-XXXXXXX&point.lat=48.858268&point.lon=2.294471) `housenumber`, `name`, `locality`, `postalcode`, `region_a`, `confidence`, `distance`, `source`, and `layer` - from the top two results - to the input file schema

### License

MIT