Maps and directions for your website and app.

Put a world map on your website and add walk, bike, drive and transit directions from your backend with one API key. Carpathian Maps is built on OpenStreetMap data and runs on Carpathian's own map server, with map files that are never billed.

maps.carpathian.ai / v1 / route
shell / request
curl https://maps.carpathian.ai/v1/route \
  -H "Authorization: Bearer $MAPS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"origin":{"lat":41.5868,"lng":-93.625},
       "destination":{"lat":41.6005,"lng":-93.6091},
       "mode":"transit"}'
json / response
{
  "route": {
    "mode": "transit",
    "duration_s": 1500,
    "distance_m": 4551,
    "path": [[41.5868, -93.625], [41.5871, -93.6249]],
    "steps": [
      { "instruction": "Walk to 6th Ave & Keo Way", "travel": "walk" },
      { "instruction": "Take 6 to DART Central Station", "travel": "bus", "line": "6" }
    ]
  }
}
A world map
Drawn with MapLibre from map files that are never billed
Directions
Walk, bike, drive and transit routes with steps, from your backend
Travel-time areas
Everywhere reachable from a point in up to four travel times
A key per app
Its own websites, limits and key

What you can build with it

The map and the directions work separately, so a store locator can use only the map and a delivery quote can use only the API.

A map on your site

The map is drawn in the browser by MapLibre GL JS from public map files, styled with the Protomaps basemap in light, dark, white, grayscale or black. It covers the whole planet, and once your website is listed on an app the map draws on the next page load.

Directions

Send two points and a mode, and get back the time in seconds, the distance in meters, the path to draw and one step per instruction, with an arrow hint for each turn. Transit answers name the line and the departure time, and include the walk to and from the stops.

Travel-time areas

Send one point and up to four travel times, and get back the area someone can reach in each, as GeoJSON you can fill on the map. It is what you reach for when a page says within 15 minutes of you, or when a delivery zone should follow the roads instead of a circle.

Map files
Never billed, however many visitors load your map
Directions
Free up to a monthly allowance, then billed per 1,000
Per-app limits
Requests a minute and a day, set by you
OpenStreetMap data
The whole planet, in five map styles

Keys and websites, one app at a time

Create an app for each website or service that uses the map, and each one gets its own key, its own website list and its own limits.

Only the websites you list can load your map, so nobody else can embed it and run up your usage. Directions are called from your backend with the key, so it never sits in browser code.

Rotating a key or deleting an app is protected by two-factor authentication.

  • A separate key, website list and limits for every app
  • Requests a minute and a day, set by you
  • A spend cap that pauses your keys instead of running past it
  • Viewing, managing and deleting granted to different people
carpathian.ai / dashboard / maps access
  • View
    See the organization's map apps, the websites each one lists, and their usage
  • Manage
    Create apps, change their websites and limits, and rotate their keys
  • Delete
    Remove an app and retire its key

Carpathian Maps FAQ

What does Carpathian Maps include?
A world map you draw on your own site with MapLibre, and a directions API your backend calls for walk, bike, drive and transit routes and for the areas reachable from a point within a travel time. Both are served from Carpathian's own map server at maps.carpathian.ai.
What does it cost?
The map files are never billed. Route and travel-time requests are free up to a monthly allowance for your organization, then billed per 1,000 on your monthly invoice at the rate on the Carpathian Maps service page. Requests the server fails to answer on its side do not count.
Can another site embed my map on my account?
No. Each app lists the websites allowed to load its map, and a browser on any other website is refused. Directions need the app's key, which belongs on your backend and never in browser or mobile code.
What happens if a key leaks?
Rotate it. The old key stops working on the map server within a minute, and rotating a key or deleting an app needs two-factor authentication. Each app also has its own limit of requests a minute and a day, so a leaked or looping key cannot run past what you set.

Put a map on your site.

Create an account, add a payment card, turn on Carpathian Maps from Services, and create an app with your website listed. The map files are never billed and directions are free up to a monthly allowance, so you can build the whole thing before the first invoice line appears.

Maps and Directions API | Carpathian Maps