everymap-cli 0.4.1

Unified CLI for geospatial APIs — geocoding, search, routing, matrix, traffic, tiles and more across every EveryMap provider
everymap-cli-0.4.1 is not a library.

EveryMap-RS

One trait surface over eleven geospatial providers for Rust: HERE Technologies, Google Maps, TomTom, MapBox, Radar, MapQuest, Photon, OSRM, Valhalla, and URL-template sources for any {z}/{x}/{y} raster or vector tileset. Business logic targets the contract, and a provider is a constructor change rather than a rewrite. Every provider crate builds for native and browser targets.

Contracts: geocoding and reverse geocoding, settled place search, type-ahead completion, navigation-grade routing, distance matrices, traffic flow and incidents, raster tiles, vector tiles, isolines, map matching, tour planning, network positioning, geodata attributes, static map images, elevation and offline routing.


everymap-cli

Unified command-line interface for EveryMap-RS — one binary and 11 geospatial commands. It selects HERE, Google, TomTom, MapBox, Radar, MapQuest, OSRM and Valhalla; the URL-template raster and vector crates are available through the library. A provider answers a command it cannot serve with the documented unsupported-domain error.

Installation

cargo install everymap-cli

Prebuilt binaries for 5 targets (Linux x86_64/ARM64, macOS Intel/Apple Silicon, Windows) are attached to each GitHub Release.

Commands

Command Purpose
geocode Forward geocoding
reverse-geocode Coordinates to address
route Directions between two points
traffic Traffic flow and incidents
position Network positioning
isoline Reachable range / isochrones
match-route Map matching (snap to road)
tour Waypoint optimization (TSP)
tile Download a raster or vector map tile to a file (--variant raster|vector)
attributes Geodata attributes (e.g. HERE roads, buildings, landmarks)
map-image Save a static map image to a file

Usage

Global flags (--provider, --api-key, --output, --verbose) must come before the subcommand:

# HERE provider (default)
everymap --api-key $HERE_KEY geocode "Brandenburg Gate, Berlin"
everymap --api-key $HERE_KEY route --origin "52.52,13.405" --destination "52.54,13.42"

# Switch provider with --provider
everymap --provider google --api-key $GOOGLE_KEY geocode "Brandenburg Gate, Berlin"
everymap --provider tomtom --api-key $TOMTOM_KEY geocode "Berlin"
everymap --provider mapbox --api-key $MAPBOX_KEY route --origin "52.52,13.405" --destination "52.54,13.42"
everymap --provider radar --api-key $RADAR_KEY geocode "Berlin"

# Output formats: json (default), pretty, summary
everymap --output summary --api-key $KEY geocode "Paris"

# Verbose mode shows the redacted request URL, raw body, and timing on stderr
everymap --verbose --api-key $KEY geocode "Paris"

# Binary commands save to a file (--output-file; defaults: tile.png, tile.mvt, map.png)
everymap --api-key $KEY tile --z 14 --x 4494 --y 2832
everymap --provider tomtom --api-key $TOMTOM_KEY tile --variant raster --z 14 --x 4494 --y 2832 --format png
# Vector tiles: a provider that serves MVT, e.g. HERE or MapBox
everymap --provider mapbox --api-key $MAPBOX_KEY tile --variant vector --z 14 --x 4494 --y 2832
everymap --api-key $KEY map-image --lat 52.52 --lng 13.40 --zoom 14

# Negative longitudes: use --lng=VALUE (with =) to avoid CLI arg parsing issues
everymap --api-key $KEY reverse-geocode --lat 37.77 --lng=-122.42

API keys can also come from the EVERYMAP_API_KEY environment variable or ~/.everymap/config.toml:

[providers.here]
api_key = "your-here-key"

[providers.google]
api_key = "your-google-key"