API Documentation

Base URL: https://api.mapriot.com

All API requests require an API key. Get yours from the dashboard.

Authentication

Append ?apiKey=<your-key> to every request:

https://api.mapriot.com/planet/14/8873/5504?apiKey=<your-key>

When using the outdoor style with a map library, the style JSON triggers additional requests for tiles, fonts, and sprites — all of which also need your API key. Each platform handles this differently:

  • MapLibre GL JS — use transformRequest (example)
  • Leaflet — use transformRequest via maplibre-gl-leaflet, or include the key directly in the raster tile URL (example)
  • Android — use an OkHttp interceptor (example)
  • iOS — use a URLProtocol interceptor (example)
  • OpenLayers — include the key directly in the raster tile URL (example)

Billing units

Each API request consumes units against your monthly plan limit. Limits are soft on paid plans — requests are never blocked. You receive an email notification when approaching or exceeding your limit.

Request typeUnits
Vector or raster source tile1
Composite raster tile5
Elevation query (single or batch)1
Static map image10
Fonts, sprites, style JSON, TileJSON0

Endpoints

Styles

URLDescription
GET /styles/outdoor.json?apiKey=<key>Outdoor style

Tile sources

SourceType
planetVector — worldwide OSM→
contoursVector — elevation contour lines→
hillshadingRaster-DEM — digital elevation model→
reliefRaster — shaded relief overlay→

APIs

URLDescription
/styles/{style}/raster/{z}/{x}/{y}?apiKey=<key>Composite raster tiles→
/elevation/{lat}/{lng}?apiKey=<key>Elevation at a point→
POST /elevation?apiKey=<key>Elevation for multiple points→
/static/center/{lat},{lng},{zoom}/…?apiKey=<key>Static map image→
/static/bounds/{bbox}/…?apiKey=<key>Static image from bounding box→
/static/path/{size}?points=…&apiKey=<key>Static image auto-fit to path→