MapHero Developers

Build with MapHero.

Everything you need to add maps and location services to your applications — vector maps, place search, geocoding, routing, optimization and navigation, behind one API key and one credit balance.

Get started Explore API docs

Technical overview

What the platform gives you, and where each piece is documented.

Maps

Published style JSON per map
Vector tiles
Raster tiles
Custom layers and symbology
Glyph sets for label rendering

Maps documentation

Search & location

Place search
Autocomplete
Reverse geocoding
Search within your own layers

Search documentation

Routing & optimization

Point-to-point routes
Turn-by-turn instructions
Multi-stop routes
Distance matrix
Optimized route and fleet distribution
Isochrones and snapping

Routing documentation

SDKs

Web — maphero.js
Android — io.maphero:android-sdk
iOS — MapHero.xcframework
Flutter — maphero_gl
React Native

SDK documentation

The SDKs render maps. Platform APIs — search, routing, geocoding and optimization — are called over REST from any language.

Integration preview

Render your first MapHero map.

index.html

<!-- The MapHero SDK -->
<script src='https://maphero.io/maphero.js'></script>
<link href='https://maphero.io/maphero.css' rel='stylesheet'/>

<div id='map' style='width:100%; height:100%; position:absolute'></div>

const map = new mapHero.Map({
  container: 'map',
  style: 'https://<your-map>.maphero.io/style.json',
  center: [35.25, 32.22],
  zoom: 12
});

search — REST

# Every API takes the same header.
curl 'https://api.maphero.io/places/search?key=Nablus' \
  -H 'X-API-Key: YOUR_API_KEY'

The style URL is your published map’s own domain plus /style.json — the same URL MapHero writes into every published map.

The live map could not start.

Get started

Your first MapHero map in minutes

01
Create an account

An account owns your maps, your API keys and one shared credit balance.
02
Create a map

Everything hangs off a map — its style, its layers and the places your searches run against.
03
Create an API key

Restrict it to the origins your application calls from, so a copied key is useless elsewhere.
04
Call the API

Send X-API-Key and read the result from the data field.

Read the quick start Authentication

Documentation

What the API docs cover

Quick startAccount, key, first request, first map
AuthenticationX-API-Key, publishable and secret keys
Migrating from map-tokenThe legacy header is being retired
API keysCreating, restricting, handling
MapsStyles, tiles and map loads
SearchPlace search and autocomplete
GeocodingReverse geocoding, v1 and v2
RoutingRoutes and turn-by-turn
Multi-stop routingOrdered stops
Distance matrixEvery pair, in one call
SnappingSnap to road, nearest segment
OptimizationBest visiting order
Fleet distributionStops across vehicles
IsochroneReachable areas, point-in-polygon
SDKsWeb, Android, iOS, Flutter, React Native
Usage & creditsWhat each call costs
ErrorsStatus codes and what they mean

Start with the map.

Create a key, render your map, then add search and routing when you need them.

Get started Browse the docs