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.
- Repository: https://github.com/angoratek/everymap-rs
- Core API docs: https://docs.rs/everymap-core
- Other crates:
everymap-core·everymap-providers-here·everymap-providers-google·everymap-providers-tomtom·everymap-providers-mapbox·everymap-providers-radar·everymap-providers-mapquest·everymap-providers-photon·everymap-providers-osrm·everymap-providers-valhalla·everymap-providers-url-template-raster·everymap-providers-url-template-vector·everymap-cli
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
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 | 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)
# Switch provider with --provider
# Output formats: json (default), pretty, summary
# Verbose mode shows the redacted request URL, raw body, and timing on stderr
# Binary commands save to a file (--output-file; defaults: tile.png, tile.mvt, map.png)
# Vector tiles: a provider that serves MVT, e.g. HERE or MapBox
# Negative longitudes: use --lng=VALUE (with =) to avoid CLI arg parsing issues
API keys can also come from the EVERYMAP_API_KEY environment variable or ~/.everymap/config.toml:
[]
= "your-here-key"
[]
= "your-google-key"