Skip to main content
GuidesAPI ReferenceExamples

Cloud REST APIs

|

Integrate powerful location-based features with a flexible and lightweight REST architecture.

Discover RESTful web services designed for modern mapping and navigation applications - from precise routing and turn-by-turn navigation to advanced isochrone analysis and multi-transport mode support.

Whether you're building fleet management solutions with truck routing, developing pedestrian navigation apps, or creating advanced location-based services with EV charge-aware routing, Magic Lane REST APIs provide everything you need to put location intelligence at the heart of your application: comprehensive routing with vehicle specifications, multi-modal transport options, isochrone calculations for reach analysis, and more.

Additional advanced features include customizable route types (fastest, shortest, economic, scenic), detailed vehicle profiles for different transport modes (car, truck, bike, pedestrian, public transport), EV-specific routing with charging station integration, terrain and elevation data, route avoidance options, and real-time traffic considerations.

API Services​

Magic Lane Cloud REST APIs are divided into several distinct services:

  • Maps & 3D Scene - Rendering and visualization services
  • Locations & Search - Geocoding and points of interest
  • Routes & Navigation - Routing and reachability analysis
  • Fleet Management - Solve vehicle routing problems efficiently

Each service contains specific APIs designed to work together seamlessly while maintaining independence for flexible integration.

Reading this Documentation​

Each API endpoint in this documentation is described using several parts:

  • The HTTP method: POST.
  • The base path: All URLs referenced in the documentation have the base path https://api.magiclane.net/api/v1. This base path goes before the endpoint path.
  • The endpoint path: For example, /routing or /isochrones.
  • Request body: Require JSON formatted request bodies (application/json content type)
  • Authentication requirements. All API endpoints require a valid API token passed in the Authorization header.
  • Code examples. Each endpoint includes example requests showing the complete request structure with sample parameters.

The Magic Lane Cloud REST APIs described in this documentation are subject to Magic Lane's Terms of Service.

API Authentication​

To access Magic Lane API endpoints, you need a valid API key, which will authenticate API requests to your account. You must supply a valid API key using the Authorization header in every request.

Getting an API Key​

To obtain your API key:

  1. Visit the Magic Lane Developer Portal
  2. Follow the step-by-step guide to create your account and generate an API key

Using Your API Key​

Include your API key in the Authorization header of each request:

curl -X POST https://api.magiclane.net/api/v1/routing \
  -H "Authorization: YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "transport": "car",
    "type": "fastest",
    "waypoints": [[13.388860, 52.517037], [13.397634, 52.529407]]
  }'

Important: Keep your API key secure. Do not share it publicly or commit it to public repositories.

Last updated on