← Back to Home

🗺️ Maps & Routing APIs

Advanced routing and spatial operations with multi-waypoint optimization, distance matrices, and detailed turn-by-turn navigation.
API Endpoints
INTRO MAP Initialization
Get Started with MAP
POST Routing
/api/local-maps/route
POST Distance Matrix
/api/local-maps/table
POST Route Snapping
/api/local-maps/match
POST TSP Solver
/api/local-maps/trip
GET Nearest Road
/api/local-maps/nearest
GET Tile Server
/styles/basic/{z}/{x}/{y}.png
POST Directions Alternatives
/api/local-maps/route/alternatives
POST Isochrone
/api/local-maps/isochrone
POST Route Optimization
/api/local-maps/optimize
GET Map JS SDK
/map/local-maps.js

🗺️ MAP Initialization & Getting Started

Use the required JavaScript file below to integrate MAP API features in your frontend.

Asset Type Details Download
MAP API JavaScript JS Required for map rendering and route interactions. Download
How to Use on Your Page
1
Include the JS file
<script src="http://localhost:8000/map/local-maps.js"></script>
2
Add a map container
<meta name="api-token" content="YOUR_ACTIVE_API_TOKEN" />

<div
    id="localMap"
    class="local-maps-canvas"
    data-lat="12.9716"
    data-lng="77.5946"
    data-zoom="12"
    data-tile-url="https://api.systha.com/styles/basic/{z}/{x}/{y}.png"
    data-route-endpoint="/api/local-maps/route"
    style="height: 420px;"
></div>
3
Initialize and load a route
<script>
    document.addEventListener('DOMContentLoaded', async function () {
        const map = window.LocalMaps.create('#localMap');

        await map.loadRoute([
            [77.5946, 12.9716],
            [77.6200, 12.9900]
        ]);
    });
</script>

Routing

Multi-waypoint routing with turn-by-turn directions

POST /api/local-maps/route
Description
Get turn-by-turn directions
Quick Tips
  • Use your bearer token in headers
  • Check response format below
  • Test with our API demo tab
cURL Example 
curl -X POST https://api.zipsuite.io/api/local-maps/route

Distance Matrix

Distance/time matrices between multiple locations

POST /api/local-maps/table
Description
Compute distances between locations
Quick Tips
  • Use your bearer token in headers
  • Check response format below
  • Test with our API demo tab
cURL Example 
curl -X POST https://api.zipsuite.io/api/local-maps/table

Route Snapping

Snap GPS coordinates to road network

POST /api/local-maps/match
Description
Snap GPS traces to roads
Quick Tips
  • Use your bearer token in headers
  • Check response format below
  • Test with our API demo tab
cURL Example 
curl -X POST https://api.zipsuite.io/api/local-maps/match

TSP Solver

Traveling Salesman Problem solver

POST /api/local-maps/trip
Description
Find optimal waypoint ordering
Quick Tips
  • Use your bearer token in headers
  • Check response format below
  • Test with our API demo tab
cURL Example 
curl -X POST https://api.zipsuite.io/api/local-maps/trip

Nearest Road

Snap coordinate to nearest road

GET /api/local-maps/nearest
Description
Find nearest road segment
Quick Tips
  • Use your bearer token in headers
  • Check response format below
  • Test with our API demo tab
cURL Example 
curl -X GET https://api.zipsuite.io/api/local-maps/nearest

Tile Server

Vector tiles for map rendering

GET /styles/basic/{z}/{x}/{y}.png
Description
Get vector map tiles
Quick Tips
  • Use your bearer token in headers
  • Check response format below
  • Test with our API demo tab
cURL Example 
curl -X GET https://api.zipsuite.io/styles/basic/10/512/512.png

Directions Alternatives

Get fastest, shortest, scenic routes

POST /api/local-maps/route/alternatives
Description
Get multiple route options
Quick Tips
  • Use your bearer token in headers
  • Check response format below
  • Test with our API demo tab
cURL Example 
curl -X POST https://api.zipsuite.io/api/local-maps/route/alternatives

Isochrone

Areas reachable within time/distance

POST /api/local-maps/isochrone
Description
Generate reachability area
Quick Tips
  • Use your bearer token in headers
  • Check response format below
  • Test with our API demo tab
cURL Example 
curl -X POST https://api.zipsuite.io/api/local-maps/isochrone

Route Optimization

Multi-stop delivery route optimization

POST /api/local-maps/optimize
Description
Optimize delivery routes
Quick Tips
  • Use your bearer token in headers
  • Check response format below
  • Test with our API demo tab
cURL Example 
curl -X POST https://api.zipsuite.io/api/local-maps/optimize

Map JS SDK

JavaScript SDK for interactive maps

GET /map/local-maps.js
Description
Embed interactive maps
Quick Tips
  • Use your bearer token in headers
  • Check response format below
  • Test with our API demo tab
cURL Example 
curl -X GET https://api.zipsuite.io/map/local-maps.js