Valkyrie Route provides a high-performance, daily-updated Valhalla routing engine optimized for the United States.
Our data is sourced from OpenStreetMap and processed every 24 hours to ensure you have the freshest routing graph available. Whether you are managing a fleet of trucks or building a consumer navigation app, our API delivers sub-millisecond latency and enterprise-grade reliability.
Valkyrie is built on top of the open-source Valhalla routing engine. For advanced usage, detailed parameter lists, and complex routing scenarios not covered here, please refer to the official Valhalla API Reference.
All API requests require a valid API key. You can obtain an API key by signing up for an account and generating one in your dashboard.
Include the API key in the X-Secret header of your requests:
X-Secret: YOUR_API_KEYGet turn-by-turn directions between two or more locations.
The request accepts a JSON object with the following parameters:
| Parameter | Type | Description |
|---|---|---|
locations | Array | List of locations (lat, lon) to visit in order. |
costing | String | The routing profile to use (e.g., auto, truck). |
directions_options | Object | Optional configuration for guidance instructions. See Valhalla docs. |
id | String | Name your route request. If id is specified, the naming will be sent through to the response. |
units | String | Distance units. Options: miles, kilometers (default). |
curl https://valkyrieroute.com/api/v1/route \
-d '{
"locations":[
{"lat":40.712,"lon":-74.006},
{"lat":39.952,"lon":-75.165}
],
"costing":"truck"
}' \
-H "X-Secret: YOUR_API_KEY"Valkyrie supports standard Valhalla costing models optimized for different transport modes.
Standard car routing. Optimizes for fastest time considering speed limits and road hierarchy.
Routing for heavy vehicles. Acknowledges truck restrictions, weight limits, and suitable roads.
Prefers bike lanes, lower speed roads, and avoids highways.
Walking directions. Uses sidewalks, footpaths, and allows routing against traffic flow.
Routing for buses. Favors roads where buses are permitted and avoids restricted maneuvers.
Routing for motorcycles. Similar to auto but considers motorcycle-specific access rules.
Routing for motor scooters. Avoids high-speed roads and highways suitable only for lower speed vehicles.
Optimized for taxi services. Similar to auto routing but may allow usage of restricted taxi lanes.