everymap-cli 0.4.7

Unified CLI for geospatial APIs — geocoding, search, routing, matrix, traffic, tiles and more across every EveryMap provider
everymap-cli-0.4.7 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; Photon and 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

Provider support by command

A command a provider cannot serve answers with the documented unsupported-domain error instead of an invented result.

Command HERE Google TomTom MapBox Radar MapQuest OSRM Valhalla
geocode ✅ ✅ ✅ ✅ ✅ ✅ — —
reverse-geocode ✅ ✅ ✅ ✅ ✅ ✅ — —
route ✅ ✅ ✅ ✅ ✅ ✅ ✅ ✅
traffic ✅ — ✅ — — ✅ — —
position ✅ ✅ — — — — — —
isoline ✅ — ✅ ✅ — — — —
match-route ✅ ✅ ✅ ✅ ✅ — — —
tour ✅ — ✅ ✅ ✅ — — —
tile ✅ vector — ✅ raster ✅ vector — ✅ raster — —
attributes ✅ ✅ — — — — — —
map-image ✅ ✅ ✅ ✅ — — — —

tile takes --variant raster|vector; with no variant it uses the first tile contract the provider serves. A raster request also takes --format png|jpeg and --resolution standard|retina, while a vector request is always MVT; a provider that does not publish the requested rendition refuses it with a validation error. Photon and the two URL-template crates are library-only and are not selectable with --provider.

OSRM and Valhalla are keyless: the --api-key slot carries the deployment base URL, and an empty value reaches the crate's documented local default. HERE, Google, TomTom, MapBox and MapQuest authenticate with an API key, and Radar uses an Authorization header.

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"