{"openapi":"3.1.0","info":{"title":"ApiNavi API","version":"1.0.0","summary":"Location APIs at half of HERE's list price","description":"Location APIs priced at exactly half of HERE Technologies' published list price. Free allowances match HERE's service for service.","contact":{"email":"support@apinavi.com","url":"https://apinavi.com"},"license":{"name":"Proprietary","url":"https://apinavi.com/legal/terms"}},"servers":[{"url":"https://api.apinavi.com","description":"Production"}],"security":[{"bearerAuth":[]}],"components":{"securitySchemes":{"bearerAuth":{"type":"http","scheme":"bearer","bearerFormat":"opaque"}}},"tags":[{"name":"geocoding-search","description":"Forward, reverse and batch geocoding over 250M addressed points in 200+ countries."},{"name":"routing","description":"Routes, matrices, isolines and fleet-wide tour optimisation on one road graph."},{"name":"maps","description":"MVT tiles at 0.044 per thousand at volume, four ready styles, full style spec."},{"name":"traffic","description":"Speeds, jam factors and incident geometry referenced to the same road graph as routing."},{"name":"places","description":"Autosuggest, category browse and lookup across 1 200 categories."},{"name":"fleet","description":"The operational layer: what a route costs, where the asset actually is, when it crossed."}],"paths":{"/v1/geocode":{"get":{"operationId":"geocode","summary":"Geocoding & Search — geocode","tags":["geocoding-search"],"x-billed-service":"geocoding","x-rate-usd":0.44,"x-rate-unit":"1000_requests","parameters":[{"name":"q","in":"query","required":true,"description":"","example":"Torstraße 66, Berlin","schema":{"type":"string"}},{"name":"in","in":"query","required":false,"description":"restrict the search space","example":"countryCode:DEU","schema":{"type":"string"}},{"name":"lang","in":"query","required":false,"description":"","example":"de","schema":{"type":"string"}},{"name":"limit","in":"query","required":false,"description":"","example":"5","schema":{"type":"string"}}],"responses":{"200":{"description":"OK"},"400":{"description":"invalidParameter"},"401":{"description":"unauthenticated"},"429":{"description":"rateLimited"}}}},"/v1/revgeocode":{"get":{"operationId":"reverse","summary":"Geocoding & Search — reverse","tags":["geocoding-search"],"x-billed-service":"geocoding","x-rate-usd":0.44,"x-rate-unit":"1000_requests","parameters":[{"name":"at","in":"query","required":true,"description":"","example":"52.5296,13.4030","schema":{"type":"string"}},{"name":"types","in":"query","required":false,"description":"","example":"address,street","schema":{"type":"string"}},{"name":"lang","in":"query","required":false,"description":"","example":"en","schema":{"type":"string"}}],"responses":{"200":{"description":"OK"},"400":{"description":"invalidParameter"},"401":{"description":"unauthenticated"},"429":{"description":"rateLimited"}}}},"/v1/geocode/batch":{"post":{"operationId":"batch","summary":"Geocoding & Search — batch","tags":["geocoding-search"],"x-billed-service":"geocoding","x-rate-usd":0.44,"x-rate-unit":"1000_requests","parameters":[{"name":"rows","in":"body","required":true,"description":"","example":"up to 50 000 per job","schema":{"type":"string"}},{"name":"callback","in":"body","required":false,"description":"","example":"https://your.app/hooks/geocode","schema":{"type":"string"}}],"responses":{"200":{"description":"OK"},"400":{"description":"invalidParameter"},"401":{"description":"unauthenticated"},"429":{"description":"rateLimited"}}}},"/v1/routes":{"get":{"operationId":"route","summary":"Routing — route","tags":["routing"],"x-billed-service":"routing","x-rate-usd":0.75,"x-rate-unit":"1000_requests","parameters":[{"name":"origin","in":"query","required":true,"description":"","example":"52.5296,13.4030","schema":{"type":"string"}},{"name":"destination","in":"query","required":true,"description":"","example":"52.5170,13.3889","schema":{"type":"string"}},{"name":"transportMode","in":"query","required":false,"description":"car · truck · bike · pedestrian · scooter","example":"truck","schema":{"type":"string"}},{"name":"departureTime","in":"query","required":false,"description":"enables live + historical traffic","example":"2026-07-27T08:30:00Z","schema":{"type":"string"}},{"name":"return","in":"query","required":false,"description":"","example":"polyline,summary,actions","schema":{"type":"string"}}],"responses":{"200":{"description":"OK"},"400":{"description":"invalidParameter"},"401":{"description":"unauthenticated"},"429":{"description":"rateLimited"}}}},"/v1/matrix":{"post":{"operationId":"matrix","summary":"Routing — matrix","tags":["routing"],"x-billed-service":"matrix","x-rate-usd":2.5,"x-rate-unit":"1000_requests","parameters":[{"name":"origins","in":"body","required":true,"description":"","example":"[{lat,lng} × 500]","schema":{"type":"string"}},{"name":"destinations","in":"body","required":true,"description":"","example":"[{lat,lng} × 500]","schema":{"type":"string"}},{"name":"regionDefinition","in":"body","required":false,"description":"","example":"world","schema":{"type":"string"}}],"responses":{"200":{"description":"OK"},"400":{"description":"invalidParameter"},"401":{"description":"unauthenticated"},"429":{"description":"rateLimited"}}}},"/v1/isolines":{"get":{"operationId":"isoline","summary":"Routing — isoline","tags":["routing"],"x-billed-service":"isoline","x-rate-usd":0.75,"x-rate-unit":"1000_requests","parameters":[{"name":"origin","in":"query","required":true,"description":"","example":"48.8566,2.3522","schema":{"type":"string"}},{"name":"range[type]","in":"query","required":false,"description":"time · distance · consumption","example":"time","schema":{"type":"string"}},{"name":"range[values]","in":"query","required":false,"description":"","example":"600,1200,1800","schema":{"type":"string"}}],"responses":{"200":{"description":"OK"},"400":{"description":"invalidParameter"},"401":{"description":"unauthenticated"},"429":{"description":"rateLimited"}}}},"/v1/tours":{"post":{"operationId":"tour","summary":"Routing — tour","tags":["routing"],"x-billed-service":"tour","x-rate-usd":17.49,"x-rate-unit":"optimisation","parameters":[{"name":"fleet","in":"body","required":true,"description":"","example":"vehicle types, shifts, capacities","schema":{"type":"string"}},{"name":"plan","in":"body","required":true,"description":"","example":"jobs with time windows","schema":{"type":"string"}},{"name":"objectives","in":"body","required":false,"description":"","example":"minimise cost, then lateness","schema":{"type":"string"}}],"responses":{"200":{"description":"OK"},"400":{"description":"invalidParameter"},"401":{"description":"unauthenticated"},"429":{"description":"rateLimited"}}}},"/v1/tiles/vector/{z}/{x}/{y}.mvt":{"get":{"operationId":"vector","summary":"Maps — vector","tags":["maps"],"x-billed-service":"tilesVector","x-rate-usd":0.25,"x-rate-unit":"1000_requests","parameters":[{"name":"style","in":"query","required":false,"description":"navi-night · navi-day · terrain · minimal","example":"navi-night","schema":{"type":"string"}},{"name":"lang","in":"query","required":false,"description":"","example":"fr","schema":{"type":"string"}}],"responses":{"200":{"description":"OK"},"400":{"description":"invalidParameter"},"401":{"description":"unauthenticated"},"429":{"description":"rateLimited"}}}},"/v1/tiles/raster/{z}/{x}/{y}.png":{"get":{"operationId":"raster","summary":"Maps — raster","tags":["maps"],"x-billed-service":"tilesRaster","x-rate-usd":0.25,"x-rate-unit":"1000_requests","parameters":[{"name":"scale","in":"query","required":false,"description":"1 or 2 for HiDPI","example":"2","schema":{"type":"string"}},{"name":"style","in":"query","required":false,"description":"","example":"navi-day","schema":{"type":"string"}}],"responses":{"200":{"description":"OK"},"400":{"description":"invalidParameter"},"401":{"description":"unauthenticated"},"429":{"description":"rateLimited"}}}},"/v1/static":{"get":{"operationId":"static","summary":"Maps — static","tags":["maps"],"x-billed-service":"tilesRaster","x-rate-usd":0.25,"x-rate-unit":"1000_requests","parameters":[{"name":"center","in":"query","required":true,"description":"","example":"41.3874,2.1686","schema":{"type":"string"}},{"name":"zoom","in":"query","required":false,"description":"","example":"13","schema":{"type":"string"}},{"name":"size","in":"query","required":false,"description":"","example":"1200x630","schema":{"type":"string"}},{"name":"overlay","in":"query","required":false,"description":"","example":"route:polyline,pin:41.39,2.17","schema":{"type":"string"}}],"responses":{"200":{"description":"OK"},"400":{"description":"invalidParameter"},"401":{"description":"unauthenticated"},"429":{"description":"rateLimited"}}}},"/v1/traffic/flow":{"get":{"operationId":"flow","summary":"Traffic — flow","tags":["traffic"],"x-billed-service":"traffic","x-rate-usd":1.25,"x-rate-unit":"1000_requests","parameters":[{"name":"in","in":"query","required":true,"description":"","example":"bbox:13.30,52.48,13.48,52.56","schema":{"type":"string"}},{"name":"locationReferencing","in":"query","required":false,"description":"","example":"olr,shape","schema":{"type":"string"}}],"responses":{"200":{"description":"OK"},"400":{"description":"invalidParameter"},"401":{"description":"unauthenticated"},"429":{"description":"rateLimited"}}}},"/v1/traffic/incidents":{"get":{"operationId":"incidents","summary":"Traffic — incidents","tags":["traffic"],"x-billed-service":"traffic","x-rate-usd":1.25,"x-rate-unit":"1000_requests","parameters":[{"name":"in","in":"query","required":true,"description":"","example":"circle:48.86,2.35;r=5000","schema":{"type":"string"}},{"name":"criticality","in":"query","required":false,"description":"","example":"major,critical","schema":{"type":"string"}}],"responses":{"200":{"description":"OK"},"400":{"description":"invalidParameter"},"401":{"description":"unauthenticated"},"429":{"description":"rateLimited"}}}},"/v1/autosuggest":{"get":{"operationId":"autosuggest","summary":"Places — autosuggest","tags":["places"],"x-billed-service":"places","x-rate-usd":1,"x-rate-unit":"1000_requests","parameters":[{"name":"q","in":"query","required":true,"description":"","example":"torstr","schema":{"type":"string"}},{"name":"at","in":"query","required":true,"description":"","example":"52.5296,13.4030","schema":{"type":"string"}},{"name":"limit","in":"query","required":false,"description":"","example":"8","schema":{"type":"string"}}],"responses":{"200":{"description":"OK"},"400":{"description":"invalidParameter"},"401":{"description":"unauthenticated"},"429":{"description":"rateLimited"}}}},"/v1/browse":{"get":{"operationId":"browse","summary":"Places — browse","tags":["places"],"x-billed-service":"places","x-rate-usd":1,"x-rate-unit":"1000_requests","parameters":[{"name":"at","in":"query","required":true,"description":"","example":"40.4168,-3.7038","schema":{"type":"string"}},{"name":"categories","in":"query","required":false,"description":"1 200+ categories","example":"ev-charging,fuel","schema":{"type":"string"}},{"name":"radius","in":"query","required":false,"description":"","example":"3000","schema":{"type":"string"}}],"responses":{"200":{"description":"OK"},"400":{"description":"invalidParameter"},"401":{"description":"unauthenticated"},"429":{"description":"rateLimited"}}}},"/v1/lookup":{"get":{"operationId":"lookup","summary":"Places — lookup","tags":["places"],"x-billed-service":"places","x-rate-usd":1,"x-rate-unit":"1000_requests","parameters":[{"name":"id","in":"query","required":true,"description":"","example":"here:pds:place:276u33db-...","schema":{"type":"string"}}],"responses":{"200":{"description":"OK"},"400":{"description":"invalidParameter"},"401":{"description":"unauthenticated"},"429":{"description":"rateLimited"}}}},"/v1/tolls":{"get":{"operationId":"tolls","summary":"Fleet — tolls","tags":["fleet"],"x-billed-service":"routing","x-rate-usd":0.75,"x-rate-unit":"1000_requests","parameters":[{"name":"route","in":"query","required":true,"description":"","example":"polyline or route id","schema":{"type":"string"}},{"name":"vehicle","in":"query","required":false,"description":"","example":"type:truck;axles:5;emission:euro6","schema":{"type":"string"}},{"name":"currency","in":"query","required":false,"description":"","example":"EUR","schema":{"type":"string"}}],"responses":{"200":{"description":"OK"},"400":{"description":"invalidParameter"},"401":{"description":"unauthenticated"},"429":{"description":"rateLimited"}}}},"/v1/positions":{"post":{"operationId":"positions","summary":"Fleet — positions","tags":["fleet"],"x-billed-service":"matrix","x-rate-usd":2.5,"x-rate-unit":"1000_requests","parameters":[{"name":"assets","in":"body","required":true,"description":"","example":"[{id, lat, lng, ts, speed}]","schema":{"type":"string"}},{"name":"mapMatch","in":"body","required":false,"description":"snap to the road graph","example":"true","schema":{"type":"string"}}],"responses":{"200":{"description":"OK"},"400":{"description":"invalidParameter"},"401":{"description":"unauthenticated"},"429":{"description":"rateLimited"}}}},"/v1/geofences":{"post":{"operationId":"geofences","summary":"Fleet — geofences","tags":["fleet"],"x-billed-service":"matrix","x-rate-usd":2.5,"x-rate-unit":"1000_requests","parameters":[{"name":"shape","in":"body","required":true,"description":"","example":"polygon | circle | corridor","schema":{"type":"string"}},{"name":"webhook","in":"body","required":false,"description":"","example":"https://your.app/hooks/fence","schema":{"type":"string"}}],"responses":{"200":{"description":"OK"},"400":{"description":"invalidParameter"},"401":{"description":"unauthenticated"},"429":{"description":"rateLimited"}}}}}}