Docs / Setup

Setup, provider by provider

MapConductor does not replace a map SDK; it lays a shared API over one. The code that draws the map is common, but getting each SDK into your project — the key, the dependency, the initialisation ritual — still follows that vendor's rules. This is that part, written out for every platform and provider pair.

ANDROID
10 providers
IOS
11 providers
REACT (WEB)
14 providers

01 · The matrix

The combinations that have a guide today. A dash means no module exists for that provider on that platform.

Provider
Android
iOS
React (Web)
Key
Google Maps
Open guide →
+ React Native
Required
MapLibre
Open guide →
+ React Native
None
Mapbox
Conditional
HERE
Open guide →
+ React Native
Required
ArcGIS
Open guide →
+ React Native
Required
MapTiler
Required
TomTom
Required
Longdo
Required
Apple MapKit
Conditional
Leaflet
None
OpenLayers
None
Azure Maps
Required
Cesium
None
Mappls
Required
Open Mobile Maps
None

React Native covers Google Maps, MapLibre, ArcGIS and HERE. It shares the same state objects and components as the Web, so rather than separate pages it is noted inside each React guide.

02 · Choosing a provider

If you are undecided, the quickest route is to get something running on a key-free provider first and swap later. As long as you wrote against the shared API, almost nothing is lost in the swap.

Google Maps
The default choice on all three platforms. Needs a Google Cloud API key.
MapLibre
The open-source renderer. No key — you only choose where tiles come from.
Mapbox
An access token is needed only for Mapbox-hosted styles.
HERE
Strong logistics and navigation styles. Uses an access key ID and secret.
ArcGIS
Brings your GIS assets along. Ships both a 2D and a 3D view.
MapTiler
Sixteen MapTiler Cloud reference styles, selectable by name.
TomTom
TomTom Orbis Maps, with driving-oriented styles.
Longdo
Thailand-focused maps, wrapping Longdo Map API3.
Apple MapKit
Built into iOS with no key; MapKit JS on the Web needs a JWT token.
Leaflet
Web only. A light choice for raster tile maps.
OpenLayers
Web only. Pick it when projections matter.
Azure Maps
Web only. Authenticated with an Azure subscription key.
Cesium
Web only. For a genuine 3D globe.
Mappls
Mappls (MapmyIndia) — strong Indian address and POI coverage.
Open Mobile Maps
An open-source rendering engine. No key — you bring your own style.

03 · Every guide has the same shape

Each page runs in the same order, so when you move between providers you only need to read what differs.

1 · CREDENTIALS
Where the key or token comes from, and how to restrict it.
2 · DEPENDENCIES
Which repository to add, and which modules to name.
3 · INITIALISATION
How the key reaches the SDK — the step that differs most between providers.
4 · VERIFY
Paste-and-run code, plus what to check when it does not work.
API KEYS

MapConductor never holds your key

Your key is fed to the map SDK exactly the way that SDK expects — the Android manifest, an iOS initialisation closure, a state object on the Web. MapConductor never relays or stores it. Restricting and revoking keys stays where it always was: in each provider's own console.

Related pages