unmap docs Use Unmap's APIs for worldwide maps, elevation and time zones, Canadian search and routing, and fleet optimization. Start with a working example, then find the endpoint parameters, coverage and limits for your application.
Free to start: 10,000 calls a month, no card. Everything answers on https://api.unmap.dev.
Start here Render a live map in under 60 seconds.
Open Call the APIs directly over HTTPS with curl, fetch, Python or MapLibre, without any @unmap packages.
Open Switch a Google Maps, Mapbox, HERE, or Esri app to unmap, or point a Google Route Optimization integration at Unmap Optimize.
Open Find an API Worldwide vector basemaps and terrain for MapLibre and other vector-tile clients. Fifteen styles in light and dark, plus Canadian contours. The coverage page names the active terrain release.
Canadian addresses and place names to coordinates, autocomplete, reverse lookup, nearby places and batch geocoding. Place records include the names available in the source data; business contact details and opening hours are not included.
Canadian directions, travel-time areas, matrices, GPS map matching and stop-order optimization. Optimize assigns shipments to a fleet using Canadian roads, worldwide straight-line travel or supplied matrices. Transit coverage varies; road events cover BC and Alberta. Truck Intelligence is an add-on in preview.
Worldwide DEM elevation and time zones, Canadian catalog layers, point-in-polygon lookup and bounding-box queries. Upload your own overlays. Industry layers and Canadian ski areas require the matching add-on; coverage varies by dataset.
Coverage and known gaps · Plans, limits and add-ons · HTTP quickstart
Browse the docs start
Quickstart Render a live map in under 60 seconds. Overview The API capabilities, map vocabulary and SDK clients available with one key. Authentication API key forms, how to present them, and where to get one. Calling the API directly Call the APIs directly over HTTPS with curl, fetch, Python or MapLibre, without any @unmap packages. guides
Examples Live maps, geocoding, and routing examples you can copy into a project. Tutorials Build a delivery zone map or a nearest-location finder, composing several unmap endpoints into one working thing. Migrate Switch a Google Maps, Mapbox, HERE, or Esri app to unmap, or point a Google Route Optimization integration at Unmap Optimize. frontend
Components Copy-in map components for React, Vue and Nuxt, installed the shadcn way and styled by your design system. Map and markers The map component, markers and popups, and on-map controls, copied into your React or Vue project. Data layers Draw routes, GeoJSON, clusters, heatmaps, arcs and flows on your design tokens, with a legend that switches layers on and off. Search and routing A search box and a routing panel on your own shadcn primitives, calling the unmap geocoding and routing APIs. Overlay components An energy map, layer switches, well and legal land search, identify on click, and treaty context, for maps that compose catalog overlays. Map tools Measure, draw, filter by time, compare two maps, profile elevation, inspect features and list your API calls, on your own shadcn primitives. Blocks Ten whole pages for Next.js and Nuxt, built from the registry: from a branch finder and directions to census, legal land, energy and ski maps. Frameworks Add unmap to Next.js, React, Vue, or Nuxt, with the framework-specific parts spelled out. Use unmap basemaps with mapcn Keep mapcn's shadcn-style React map components and give them an unmap basemap: two style URLs, and nothing else changes. apis
Maps Vector tiles, MapLibre styles, terrain, and the fonts and icons a rendered map needs. Geocoding Canadian full-text search, structured addresses, autocomplete, nearby categories and reverse lookup. Places Canadian points of interest, from the same corpus the geocoder answers from. Name search, nearby categories and by-id lookup, with parameters and coverage limits. Batch geocoding Geocode many Canadian addresses in one request, or a CSV from the command line. Routing Canadian directions, isochrones, travel-time matrices, GPS map matching and stop-order optimization. Transit Scheduled Canadian transit agencies, stops, routes and departures from versioned GTFS releases. Truck Intelligence Which Canadian jurisdictions and restriction classes are active, and which are not. Road events Closures, incidents, construction and road conditions for British Columbia and Alberta, including Alberta's winter road surface. Optimize Assign pickups and deliveries to a fleet, with time windows, load capacities and driver breaks. Uses the Google Route Optimization request format. Elevation DEM elevation, active-source metadata and the sources behind the values. Time zone IANA timezone and UTC offset for any coordinate. overlays
Layers Named Canadian catalog layers, overlay composition, and add-on entitlements. Treaty overlay The Crown's published historic and modern treaty representations as a map overlay, with details for any point. Energy profile Composition preset for Canadian energy overlays. Not a style, mode, or theme. Agriculture profile Composition preset for Canadian agriculture overlays. Not a style, mode, or theme. Mining profile Composition preset for Canadian mining and resource overlays. Not a style, mode, or theme. Remote profile Composition preset for remote and northern Canada overlays. Not a style, mode, or theme. ski
Ski areas Canadian downhill and nordic ski areas from OpenStreetMap: an API of areas with elevation and drive-time facts, 3D lift geometry, and a ski overlay for any style. your data
Bring your own data Upload a small private GeoJSON or PMTiles overlay and paint it on an unmap style. agents
Agents unmap publishes an A2A Agent Card and speaks the A2A JSON-RPC binding at api.unmap.dev/a2a, so another agent can discover the API and call it without reading these docs first. MCP server Connect an AI agent to unmap over the Model Context Protocol: eight read-only tools for Canadian geocoding, routing, isochrones and the layer catalog, alongside worldwide vector maps. WebMCP unmap.dev registers four tools with the browser's model context, so an agent working in the tab can search the docs, read a page, navigate, and list the basemap styles, without a key and without calling the API. reference
API reference Every endpoint on api.unmap.dev with its parameters, its response shape, and the status codes it can answer with. Errors The error contract across the gateway and the account API. Plans & Limits Included calls, overage, origins, and the rate limit every plan shares. Coverage Global maps and DEM alongside Canadian geocoding, routing and contours. Reporting wrong data How to tell us a result is wrong, what happens to the report, and what we do not collect along with it. 