Routing & Navigation APIs

Calculate routes, optimize travel time, and build navigation experiences

Global routing and navigation APIs for turn-by-turn directions, matrix routing, traffic-influenced routes, and isochrones. SDKs integrate into navigation, logistics, fleet management, travel applications, and more.

What You Can Do

The Stadia Maps routing and navigation APIs help you build real-time navigation, optimize multi-stop routes, and account for traffic and terrain. Whether you need precise routing, batch distance calculations, or terrain-aware navigation, Stadia Maps provides comprehensive routing capabilities:

  • Standard Routing: Calculate routes with detailed turn-by-turn guidance for vehicles, pedestrians, and cyclists
  • Time/Distance Matrix: Compute travel times and distances between multiple origin-destination pairs in a single request
  • Isochrones: Calculate areas reachable within a specified time or distance
  • Optimized Routing: Find the most efficient route through multiple waypoints
  • Traffic-Influenced Profiles: Incorporate real-time and historical traffic conditions into route calculations (premium add-on)
  • Nearest Roads: Snap coordinates to the nearest roadway
  • Map Matching: Align GPS traces to the underlying road network
  • Trace Attributes: Retrieve detailed road attributes for traced segments
  • Elevation: Account for terrain grade and slope in route planning

Each capability is available through REST APIs with predictable credit-based pricing and global coverage.

Use Cases & Applications

Stadia Maps routing APIs power applications across multiple industries:

  • Logistics & Fleet Management: Optimize delivery routes, calculate ETAs, monitor vehicle tracking with traffic-aware routing
  • Last-Mile Delivery: Plan multi-stop routes, reduce delivery time, improve driver safety with terrain-aware navigation
  • Real Estate: Show property accessibility, calculate commute times from listings, enable location-based recommendations
  • Travel & Tourism: Calculate hiking times accounting for elevation, power multi-destination trip planning, optimize tour routes
  • Field Service: Route field teams to job sites, calculate service area coverage via isochrones, optimize maintenance schedules
  • Rideshare & Mobility: Enable turn-by-turn navigation, calculate fares based on actual travel time, optimize matching algorithms

All powered by our global routing engine and accessible via multiple SDK languages for rapid integration.

Global Coverage & Reliability

Stadia Maps routing is powered by OpenStreetMap data and Valhalla, a widely-used open-source routing engine. Our coverage spans:

  • Global routing support for vehicles, pedestrians, and cyclists with highest coverage in North America, Europe, and major urban centers worldwide
  • Real-time traffic data integration where available
  • Elevation data for terrain-aware routing calculations
  • Regular updates as map data improves
  • Matrix routing for large-scale batch calculations

Unlike user-tracking solutions, Stadia Maps doesn't collect telemetry or behavioral data. We're GDPR and CCPA compliant, with EU data centers available for organizations with data residency requirements.


Turn-by-Turn Directions

Our turn-by-turn directions API calculates precise routes with detailed guidance maneuvers, including estimated travel time and distance. Supports vehicle, pedestrian, and bicycle routing with real-time updates for navigation applications.

Learn more about Turn-by-Turn Directions

Matrix Routing

Calculate travel times and distances between all origin-destination pairs simultaneously. Matrix routing powers multi-stop optimization, service area analysis, and accessibility calculations without iterative API calls.

Learn more about Matrix Routing

Isochrones

Determine which locations are reachable within a specified time or distance, visualize service areas, and analyze accessibility. Isochrones enable competitive analysis and territory planning with travel-time boundaries.

Learn more about Isochrones

Simple, Predictable Pricing

Stadia Maps uses a credit-based billing system. Start free and upgrade anytime as your usage grows. Mid-cycle plan changes are prorated.

  • Free: 200,000 credits/month (non-commercial use)
  • Starter: $20/month, 1,000,000 credits/month, overage at 3¢/1,000
  • Standard: $80/month, 7,500,000 credits/month, overage at 2¢/1,000
  • Professional: $250/month, 25,000,000 credits/month, overage at 1.5¢/1,000

Every routing request costs a fixed number of credits:

  • Standard Routing: 20 credits/request
  • Nearest Roads: 20 credits/request
  • Map Matching: 20 credits/request
  • Trace Attributes: 20 credits/request
  • Isochrones: 20 credits/request
  • Optimized Routing: 40 credits/request
  • Time/Distance Matrix: 10 credits/element
  • Traffic-Influenced Profiles: 60 credits/request or per element
  • Premium Traffic-Influenced Profiles: 120 credits/request or per element
  • Elevation: 5 credits/request

Pricing that grows with you.

  • Fixed, transparent pricing that aligns with your traffic volume
  • No upfront costs, build and test risk-free with a 14-day free trial
  • Full access to all routing capabilities without hidden fees
See our Free Trials & Billing FAQs

Support You Can Count On

Learn more about our Support experience

SDKs & Code Samples

Integrate Stadia Maps routing with official SDKs in multiple languages:

  • JavaScript/TypeScript
  • Python
  • Kotlin
  • Swift
  • PHP

Plus REST API access for any language. Complete code examples and tutorials are available in our documentation, including getting started guides for each SDK, common use cases (turn-by-turn navigation, matrix routing, route optimization), performance optimization tips, and batch routing with request queuing (Professional plans and above).

Access our full docs at docs.stadiamaps.com and generate your own client libraries using our OpenAPI specification.

View SDK Documentation

Stadia Maps Supports the Open-Source Community

In addition to using OpenStreetMap as our primary data source, we maintain and contribute to several open-source projects, including:


Frequently Asked Questions

What's the difference between turn-by-turn and matrix routing?

Turn-by-turn directions provide detailed guidance for a single route between two points. Matrix routing calculates travel times between multiple origins and destinations simultaneously, ideal for optimization problems.

How accurate are the routing calculations?

Accuracy depends on the quality of the road data and traffic data (when enabled). For mission-critical applications, validate estimates against your own historical patterns and adjust routing logic accordingly.

Can I use traffic-influenced routing everywhere?

Traffic data integration is available in major metropolitan areas and corridors. Check our documentation for current coverage; non-traffic-covered areas fall back to base routing without penalty.

Do you track user location data?

No. Stadia Maps doesn't collect telemetry, track end users, or sell behavioral data. We're fully GDPR and CCPA compliant. See our privacy commitment for details.

What if I exceed my monthly credits?

If you've enabled additional usage, overages are billed at your plan's rate. If you haven't enabled overages, requests will return a 429 rate-limit error. Upgrade your plan anytime, and changes are prorated.

What are the API rate limits?

There's no fixed requests-per-second limit. Your constraint is monthly credits. Contact us if you need specialized rate-limit arrangements.

What SDKs do you support?

Official SDKs in JavaScript/TypeScript, Python, Kotlin, Swift, and PHP. You can also generate clients in other languages using our OpenAPI specification and tools like openapi-generator.

Can I use this for commercial purposes?

Yes. The free plan is for non-commercial use only. Commercial use requires a paid subscription (starting at $20/month). Academic research qualifies for free tier if non-commercial.

What is the best routing API?

The right routing API depends on whether you need real-time traffic, which modes of transport you support, your coverage area, and whether you need batch optimization. Stadia Maps is built for developers who need transparent pricing, global coverage, and no tracking of end users. Learn more about routing APIs here.

What is an isochrone?

An isochrone is a shape on a map that shows everywhere you can reach from a starting point within a set travel time or distance, given a mode of travel. Also called a travel time map, isoline, or reachable range, an isochrone follows the road, path, or transit network, so the shape reflects how people actually move, not just how far a straight line goes. The Stadia Maps Isochrone API returns them as GeoJSON polygons or linestrings for driving, walking, cycling, and nearly a dozen other travel modes. Learn more about isochrones here.

What is a distance matrix API?

A distance matrix API returns the travel time and distance between every combination of a set of starting points and a set of destinations, in a single request. Ask it about three warehouses and five delivery addresses and you get back all 15 pairs at once. The Stadia Maps Time/Distance Matrix API lets you compare travel times between a set of possible start and end points, using the same road network and travel modes as the rest of the Stadia Maps Routing API. Learn more about distance matrix APIs here.