Nextzen / Mapzen Turn-by-Turn API
Apr 24,2026

GISBox is a one-stop 3D GIS data editing, conversion and publishing platform that supports editing in multiple GIS formats such as OSGB/GEOTIFF/RVT, converting to 3DTiles/Terrain and publishing.

Introduction

Nextzen / Mapzen Turn-by-Turn API is an open-source navigation service that supports multiple modes of transportation including car, bicycle, walking, and public transit. It is used to integrate route planning, navigation instructions, and travel time estimation into web or mobile applications. It provides dynamic route calculation and real-time navigation capabilities, allowing developers to implement draggable waypoints and obtain text-based navigation instructions in Leaflet maps via plugins such as lrm-mapzen. Since the Mapzen service has been shut down, Nextzen, as its successor, offers a similar API integration solution, including routing and map data services.

File Structure

The file structure of the Nextzen / Mapzen Turn-by-Turn API primarily revolves around its implementation as a Leaflet Routing Machine (LRM) plugin (lrm-mapzen). The core components include:

Routing Service Integration Module: Responsible for replacing LRM's default routing engine with the Mapzen/Nextzen Turn-by-Turn routing service, handling route calculation requests (including car, bicycle, walking, and multimodal), and returning the results (route geometry, distance, duration) to LRM.
Maneuver Parser: Parses the raw data returned by the routing service to generate detailed text-based navigation instructions (turn-by-turn directions) for developers to display in the application's text narrative area.
Route Line Interaction Module: Handles the drawing of route lines on Leaflet maps and supports real-time recalculation and updating of routes when users drag waypoints (start, end, via points).
API Key Configuration & Management: Contains the logic for appending necessary API keys when sending requests to the Mapzen/Nextzen service; developers need to configure their valid API Key here.
GeoJSON/TopoJSON or MVT Data Processing Component: Processes the route geometry data returned by the routing service (typically in GeoJSON, TopoJSON, or Mapbox Vector Tile format) and converts it into layers renderable by Leaflet.

Pros

Open Source with Strong Customizability: API-related tools such as lrm-mapzen and nextzen.js are open-sourced on GitHub, allowing developers to freely modify and extend the code to suit specific needs.
Easy Integration with Leaflet: Through the lrm-mapzen plugin, the API seamlessly supports Leaflet Routing Machine, simplifying the addition of draggable waypoints and navigation instructions to web maps.
Provides JavaScript SDK: The nextzen.js SDK encapsulates the core functionality of Mapzen products, making it easy for developers to quickly call routing services, including route calculation and travel time estimation.

Cons

Poor Maintenance Status: Related projects such as lrm-mapzen and nextzen.js were last updated in 2018–2019, indicating that active development may have ceased, leading to compatibility and support risks.
Uncertain Service Availability: Since the Mapzen service has been shut down, Nextzen, as a successor, offers a similar API, but migration and stability issues may exist, affecting use in production environments.
Low Information Source Credibility: The reference data has poor reliability; API documentation and examples may be outdated or incomplete, increasing the difficulty of integration.

Application Scenario

Nextzen / Mapzen Turn-by-Turn API can be used to integrate real-time route planning and navigation functionality into web and mobile applications. It supports travel time estimation and dynamic route calculation for multiple modes of transportation including car, bicycle, walking, and public transit, helping developers build interactive map navigation services. It is particularly well-suited for custom map applications that implement draggable waypoints and text-based navigation instructions via Leaflet framework plugins (such as lrm-mapzen), thereby enhancing the user experience.