Skip to main content

Map Base Tiles API

The base map underneath everything else you render - streets, buildings and terrain, in a choice of visual styles.

Where it's used​

Use cases, value and how it works

Overview & Solution

Every map needs something underneath the pins, routes and zones you draw - a base layer showing streets, terrain and buildings. Building and hosting that yourself is a project on its own; most teams just need it to be there, load fast, and look right for what they're building.

The Map Base Tiles API serves that base layer, in a choice of styles so the map fits the app it's in - a bright dashboard, a dark control room screen, a terrain view, or real satellite imagery.

Industry Use Cases

1. Operations Dashboards & Control Rooms

  • Dark style - a low-glare basemap that keeps vehicle markers, tracks and alerts readable on a screen viewed for hours at a time.

2. Customer & Field-Facing Apps

  • Light style - a bright, familiar basemap for consumer-facing screens like order tracking or a branch locator.

3. Land, Agriculture & Site Planning

  • Satellite imagery - real overhead imagery for verifying land use, crop cover or site layout, where street-map styling alone doesn't show what's actually on the ground.

4. Outdoor & Rural Operations

  • Terrain style - elevation and land contours visible for planning routes or coverage across hilly or rural areas.

API reference​

Map Visualization · API key only

Quick try​

curl
curl -X GET 'https://map-cdn.sovereignsolutions.tech/styles/3d/3d.json?api-key=$API_KEY'

Endpoints​

MethodPathPurpose
GET/styles/3d/3d.jsonMap style - 3D
GET/styles/basic/basic.jsonMap style - Basic
GET/styles/bright/bright.jsonMap style - Bright
GET/styles/dark/dark.jsonMap style - Dark
GET/styles/fiord/fiord.jsonMap style - Fiord
GET/styles/liberty/liberty.jsonMap style - Liberty
GET/styles/positron/positron.jsonMap style - Positron
GET/styles/terrain/terrain.jsonMap style - Terrain
GET/styles/toner/toner.jsonMap style - Toner

Map style - 3D​

GET https://map-cdn.sovereignsolutions.tech/styles/3d/3d.json

Auth: api-key query parameter only - no bearer token, no tenant in the URL

Errors: non-2xx responses use the standard status codes listed on Errors.

Map style - Basic​

GET https://map-cdn.sovereignsolutions.tech/styles/basic/basic.json

Auth: api-key query parameter only - no bearer token, no tenant in the URL

Errors: non-2xx responses use the standard status codes listed on Errors.

Map style - Bright​

GET https://map-cdn.sovereignsolutions.tech/styles/bright/bright.json

Auth: api-key query parameter only - no bearer token, no tenant in the URL

Errors: non-2xx responses use the standard status codes listed on Errors.

Map style - Dark​

GET https://map-cdn.sovereignsolutions.tech/styles/dark/dark.json

Auth: api-key query parameter only - no bearer token, no tenant in the URL

Errors: non-2xx responses use the standard status codes listed on Errors.

Map style - Fiord​

GET https://map-cdn.sovereignsolutions.tech/styles/fiord/fiord.json

Auth: api-key query parameter only - no bearer token, no tenant in the URL

Errors: non-2xx responses use the standard status codes listed on Errors.

Map style - Liberty​

GET https://map-cdn.sovereignsolutions.tech/styles/liberty/liberty.json

Auth: api-key query parameter only - no bearer token, no tenant in the URL

Errors: non-2xx responses use the standard status codes listed on Errors.

Map style - Positron​

GET https://map-cdn.sovereignsolutions.tech/styles/positron/positron.json

Auth: api-key query parameter only - no bearer token, no tenant in the URL

Errors: non-2xx responses use the standard status codes listed on Errors.

Map style - Terrain​

GET https://map-cdn.sovereignsolutions.tech/styles/terrain/terrain.json

Auth: api-key query parameter only - no bearer token, no tenant in the URL

Errors: non-2xx responses use the standard status codes listed on Errors.

Map style - Toner​

GET https://map-cdn.sovereignsolutions.tech/styles/toner/toner.json

Auth: api-key query parameter only - no bearer token, no tenant in the URL

Errors: non-2xx responses use the standard status codes listed on Errors.

Notes​

Available styles: basic, bright, dark, fiord, liberty, positron, terrain, toner, 3d.

The style URL carries the API key as a query parameter, e.g. https://map-cdn.sovereignsolutions.tech/styles/basic/basic.json?api-key=<apiKey>.