Documentation / Overview
Mapsource documentation
Guides and API references for OpenStreetMap queries, address and business search, regional POI discovery, basemaps, routing, spatial analysis and elevation. Integrate with REST or MCP using one subscription key.
On this page
Start here
Get a subscription key from pricing, save it as MAPSOURCE_API_KEY in your environment or secret manager, and send it in the Authorization header. The quickstart walks through a request and an interactive map.
To compare the managed services and choose a capability, start with the solutions catalog.
npm i mapsourcecurl --fail-with-body "https://api.mapsource.io/interpreter" \
-H "Authorization: Bearer $MAPSOURCE_API_KEY" \
-H "Content-Type: text/plain" \
--data '[out:json][timeout:30];nwr["amenity"="cafe"](47.60,-122.34,47.62,-122.31);out geom 100;'Check service status for the active query dataset and companion-service availability.
API endpoints
Base URL: https://api.mapsource.io; paths below are relative to it and also work with an /api prefix. Coordinates are decimal degrees. Overpass bounding boxes use south, west, north, east; lookup and discovery use west, south, east, north.
| Endpoint | Purpose | Access |
|---|---|---|
GET / POST /interpreter | Overpass QL | Subscription |
GET /places/lookup | Address, business and brand search with map-focus bias | Every subscription plan |
POST /places/discover | Businesses and POIs within a viewport, polygon or travel-time region | Every subscription plan |
GET /tiles/{style}/{z}/{x}/{y}.png | Dark or light raster tiles, to zoom 20 | Subscription |
GET /tiles/vector/{z}/{x}/{y}.pbf | OpenMapTiles vector tiles, to zoom 14 | Subscription |
GET /elevation?lat=…&lon=… | Point elevation | Subscription |
GET /usage | Usage and plan details | Subscription; no query charge |
POST /mcp | Remote agent tools | Tool-dependent |
POST /x402/interpreter | Paid JSON query | Enabled x402 payment |
GET /tiles/catalog | Raster styles, vector source, and attribution | Public |
GET /status | Service and dataset state | Public |
Guides and reference
Getting started
Services
Overpass queries
Select OpenStreetMap features and retrieve tags and geometry.
Raster and vector basemaps
Display CARTO Dark Matter and Positron tiles, or style OpenMapTiles vector tiles.
Custom basemaps
Style every road class, label and landuse through a stable semantic contract.
Routing and navigation
Route, matrix, isochrone, map matching, snap and visit-order optimization.
Address and business search
Search addresses, businesses and brands with map-focus bias. Find POIs within viewports, polygons or travel-time regions.
Spatial analysis and pipelines
Buffer, measure and combine geometry on the server, and run several steps in one call.
Point elevation
Sample terrain height at a latitude and longitude.
Agents, MCP, and x402
Connect remote tools with a subscription or supported query payments.
Place and feature search with MCP
Look up destinations and discover regional businesses or mapped features without writing QL.
Reference
API reference
REST endpoints, authentication, parameters, limits, and error codes.
Plans and limits
Request allowances, execution limits, and quota headers.
Error reference
Error codes, HTTP status, and retry handling.
Overpass compatibility
Request formats, output modes, defaults, and differences.
Usage, billing, and keys
Monitor usage, manage billing, and replace an API key.
Migration
Move to Mapsource or another compatible service.
Developer resources
mapsourceon npm provides the typed REST client and synchronized OpenAPI contract.mapsource-mcpon npm adapts the hosted MCP endpoint for stdio clients.- OpenAPI specification for REST clients.
- MCP server card and agent-facing contract.
- Runnable TypeScript, Python, and map examples.
- Attribution, privacy, and service terms.
Questions about this guide? Contact support.