Getting Started

Introduction

What the Navvo API is, who it's for, and what you can build with it.

Introduction

The Navvo API lets you embed the Middle East's mapping platform directly into your own product — websites, mobile apps, dashboards, fleet systems, and back-office tools. It is a single, coherent HTTP API for maps, search, geocoding, routing, live traffic, street-level imagery, and movement telemetry.

These docs are for developers integrating Navvo into another platform. They describe every request, parameter, and response shape you need. They do not cover running or operating Navvo itself.

Base URL — every endpoint lives under:

https://navvo.io/api/v1

What you can build

Maps in your app

A complete Navvo Maps basemap — vector & raster tiles, light/dark/satellite styles, and overlays — served first-party from Navvo.

Store & place locators

Search for places, show rich details (hours, photos, ratings), and guide users to the right entrance.

Directions & ETAs

Turn-by-turn routing, travel-time matrices, and ETAs adjusted for live, Navvo-sourced traffic.

Fleet & logistics

Optimize multi-stop routes, score route risk, and contribute anonymous probe data to improve traffic.

The API at a glance

Domain	Scope	What it does
Search	`search`	Full-text place search across the Middle East.
Geocoding	`geocode`	Forward & reverse geocoding (address ⇄ coordinates).
Places	`places`	Place listings and rich detail, including arrival guidance.
Routing	`routing`	Directions, matrix, isochrones, map-matching, optimization.
Traffic & Incidents	`traffic`	Live/typical congestion, traffic-aware ETAs, crowd incidents.
Telemetry	`telemetry`	Submit anonymous trips; read aggregated traffic data.
Map Tiles & Styles	`tiles`	Navvo Maps styles, vector/raster tiles, glyphs, sprites.
Map Data & Risk	`tiles` / `routing`	Map config, overlays, weather, and route-risk scoring.
Imagery	`imagery`	Street-level photos and road features.
Geo 3D Details	`geo`	3D building/road/vegetation features for map scenes.

How it works

Get an API key. Create an organization, a project, and an API key in the Navvo developer portal. See Authentication.
Send your key with every request via the x-api-key header (or the api_key query parameter for map URLs).
Call the endpoint you need. Each key carries scopes that grant access to specific domains.

New to the API? Jump straight to the Quickstart and make your first call in a few minutes.

Coverage & data sources

Navvo is built for the Middle East. Map, geocoding, routing, and 3D detail data are built from Navvo's own map data and Navvo's routing and geocoding engines. Live traffic is derived entirely from Navvo's own anonymous probe network — there is no third-party traffic feed. Street-level imagery is sourced from the Navvo imagery network.

Attribution is required when you display Navvo map tiles, imagery, or derived data — see Conventions.

Quickstart

Get an API key and make your first Navvo API call in a few minutes.