API-Dokumentation, SDKs und Integrationsleitfäden
Entdecken Sie API-Endpunkte, Authentifizierung, Limits und Beispiele für mobile SDKs, CLI, MCP, Kartenstile, Ortssuche und Straßendaten.
API-Verzeichnis
Finden Sie APIs nach Name, Aufgabe oder Endpunkt. Jeder Eintrag führt zu Parametern, Beispielen und Nutzungslimits.
Navigation (10)
- Routing API →
Berechnen Sie eine Auto-, Rad- oder Fußroute durch die Punkte in der angegebenen Reihenfolge. Verwenden Sie steps=true für Abbiegehinweise und geometries=geojson für GeoJSON.
GET /api/v1/osrm/route/v1/{profile}/{coordinates} - Isochrones API →
Schätzt die Erreichbarkeit anhand der Fahrzeiten zu Stichprobenpunkten. Ist in jeder Richtung ein Punkt erreichbar, lautet quality.status estimated; andernfalls insufficient_data und polygons ist leer. Ein leeres Ergebnis beweist nicht, dass keine Straßen erreichbar sind. Die Grenze ist eine Näherung; nur Zeitlimits werden unterstützt.
GET /api/1/isochrone - Map Matching API →
Ordnet ungenaue GPS-Spuren dem realen Straßennetz zu (snap to road). Wird verwendet, um Rauschen in GPS-Signalen zu bereinigen.
GET /api/v1/osrm/match/v1/{profile}/{coordinates} - Nearest API →
Ordnet jede Koordinate dem nächstgelegenen realen Straßensegment zu (snap) und gibt Informationen zum Straßennamen zurück.
GET /api/v1/osrm/nearest/v1/{profile}/{coordinates} - Directions API →
Liefert Abbiegehinweise zwischen zwei oder mehr Wegpunkten mit sauberer Anweisungsliste (Text, Distanz, Dauer, Manövertyp und Position). Unterstützt Auto, Fahrrad und zu Fuß sowie bis zu 3 Alternativrouten in einem Aufruf.
GET /api/1/directions - Alternative Routes API →
Liefert Abbiegehinweise zwischen zwei oder mehr Wegpunkten mit sauberer Anweisungsliste (Text, Distanz, Dauer, Manövertyp und Position). Unterstützt Auto, Fahrrad und zu Fuß sowie bis zu 3 Alternativrouten in einem Aufruf.
GET /api/1/directions - Snap to Road API →
Rastet rohe, ungenaue GPS-Punkte auf die nächste Position im Straßennetz ein. Wiederholen Sie den point-Parameter für jede Koordinate (bis zu 100).
GET /api/1/snap - Kraftstoffschätzung API →
Kraftstoffmenge und Fahrtwert aus Entfernung, beladenem Gewicht, Leer-/Volllastverbrauch und Literpreis schätzen. Separat oder im Truck-Aufruf.
POST /api/v1/fuel/estimate - Truck Routing API →
Planen Sie Lkw-Routen im Inland und über Grenzen hinweg, wo Straßen verbunden sind. Senden Sie bei jeder Anfrage die Maße und das Gewicht des beladenen Fahrzeugs.
POST /api/v1/truck/route - Search Along Route API →
Zwischenstopps und zusätzliche Fahrzeit entlang einer Route vergleichen.
POST /api/v1/places/along-route
Betrieb & Ladeplanung (7)
- Route Optimization API →
Plant Flottenrouten unter Berücksichtigung von Kapazitäten, Zeitfenstern, Fähigkeiten und verknüpften Abholungen/Zustellungen. Eine zeitlich begrenzte Heuristik reduziert die Fahrzeit ohne Garantie eines globalen Optimums. Nicht zugewiesene Aufgaben bleiben in solution.unassigned; ungültige Eingaben werden vollständig abgelehnt.
POST /api/1/vrp - Matrix API →
Berechnen Sie Fahrzeiten, Entfernungen oder beides zwischen Start- und Zielpunkten. Wählen Sie Indizes der Koordinatenliste mit sources und destinations.
GET /api/v1/osrm/table/v1/{profile}/{coordinates} - Trip API (TSP) →
Ordnen Sie Stopps eines einzelnen Fahrzeugs anhand des Straßennetzes. Für eine offene Route roundtrip=false&source=first&destination=last verwenden. Eine optimale Reihenfolge ist nicht garantiert.
GET /api/v1/osrm/trip/v1/{profile}/{coordinates} - Standort-Clustering →
Gruppiert (clustert) gegebene Koordinaten nach ihrer geografischen Nähe und Dichte.
POST /api/1/cluster - Ladeplanung →
Planen Sie gemischte Ladungen für Lkw, Auflieger und Container. Prüfen Sie Stapelung, Beladereihenfolge und Platz in 3D oder binden Sie die API ein.
POST /api/v1/load-plansGET /api/v1/load-plansGET /api/v1/load-plans/{id}Alle Endpunkte (+38)
DELETE /api/v1/load-plans/{id}POST /api/v1/load-plans/{id}/cancelGET /api/v1/load-plans/{id}/worksheetGET /api/v1/load-plans/{id}/csvGET /api/v1/load-plans/{id}/modelGET /api/v1/load-plans/pricesGET /api/v1/load-plans/import-previewPOST /api/v1/load-plans/import-previewPOST /api/v1/load-plans/comparePOST /api/v1/load-plans/fleetPOST /api/v1/load-plans/{id}/placement-previewPOST /api/v1/load-plans/{id}/placement-revisionsGET /api/v1/load-plans/{id}/pdfGET /api/v1/load-plans/{id}/xlsxPOST /api/v1/load-plans/{id}/shareDELETE /api/v1/load-plans/{id}/sharePOST /api/v1/load-plans/shared-viewPOST /api/v1/load-plans/palletizePOST /api/v1/load-plans/{id}/axle-estimateGET /api/v1/load-plans/workspace/{kind}GET /api/v1/load-plans/workspace/{kind}/{id}PUT /api/v1/load-plans/workspace/{kind}/{id}DELETE /api/v1/load-plans/workspace/{kind}/{id}GET /api/v1/load-plans/webhookPOST /api/v1/load-plans/webhookDELETE /api/v1/load-plans/webhookGET /api/v1/load-plans/webhook/eventsPOST /api/v1/load-plans/webhook/events/{id}POST /api/v1/load-plans/multi-stopPOST /api/v1/load-plans/bulkPOST /api/v1/load-plans/packagingPOST /api/v1/load-plans/dispatchPOST /api/v1/load-plans/fulfillmentPOST /api/v1/load-plans/simulationGET /api/v1/load-plans/{id}/warehousePOST /api/v1/load-plans/{id}/warehouseGET /api/v1/load-plans/{id}/simulation-reportGET /api/v1/load-plans/partner - Fahrtanalyse: Besuchsnachweis →
Besuchs- und Standzeitnachweis aus Ihrer übermittelten Spur.
POST /api/v1/trip-analytics/visit-proof - Lkw-Flottenoptimierung →
Fahrzeugspezifische statische Lkw-Matrizen.
POST /api/v1/truck/optimize
Suche (8)
- Geocoding API →
Wandelt einen Suchtext in geografische Koordinaten (vorwärts) oder Koordinaten in eine Adresse (rückwärts) um. Schnelle, tippfehlertolerante Autovervollständigung für Straßen, Adressen und POIs (Cafés, Geschäfte, Hotels, Büros). Ideal für Suche während der Eingabe.
GET /api/1/geocode - Places API →
Finde POIs in der Nähe eines Punktes — Cafés, Geschäfte, Hotels, Geldautomaten, Apotheken u. a. — gefiltert nach Kategorie und Radius, nach Entfernung sortiert.
GET /api/1/places - Autocomplete API →
Schnelle, tippfehlertolerante Ortsvorschläge während der Eingabe, mit optionaler Standortgewichtung.
GET /api/1/autocomplete - Batch Geocoding API →
Geokodieren Sie bis zu 100 Adressen pro Anfrage. Die Ergebnisse folgen der Eingabereihenfolge. Jede Adresse kostet einen Credit.
POST /api/1/geocode/batch - Natürlichsprachige Suche →
Orte mit kurzen englischen Suchanfragen finden.
POST /api/v1/search/natural - Ortsdetails →
Quellattribute aus Suchergebnissen lesen.
POST /api/v1/places/details - Structured Geocoding API →
Adressen anhand von Straße, Stadt, Postleitzahl und Land suchen.
POST /api/v1/search/structured - Suggest & Retrieve API →
Ortssuche mit Vorschlägen und sicherem Ergebnisabruf entwickeln.
POST /api/v1/search/suggestPOST /api/v1/search/retrieve
Karten (4)
- Stilvorschau per Text →
Farben und Ebenen beschreiben, prüfen und anwenden.
POST /api/v1/studio/preview - Static Maps API →
Gestaltete Karten als PNG für Berichte und Anwendungen exportieren.
POST /api/v1/maps/static - Studio API →
Kartenstile, Datensätze und Veröffentlichungen aus Ihrer Anwendung verwalten.
GET /api/v1/studio/{resource}POST /api/v1/studio/{resource} - Kartenstile und Vektorkacheln →
Laden Sie öffentliche Basiskarten oder veröffentlichte Stile in MapLibre. Öffentliche Anfragen benötigen keinen API-Schlüssel und kosten keine Credits. Nutzen Sie die Kachel-URLs des Stils und erhalten Sie die Quellenangaben.
GET /api/basemaps/{style}GET /api/map-styles/{id}GET /api/map-styles/{id}/tiles/{dataset}/{z}/{x}/{y}Alle Endpunkte (+2)
GET /api/private-maps/{id}GET /api/private-maps/{id}/tiles/{dataset}/{z}/{x}/{y}
Daten (15)
- Timezone API →
IANA-Zeitzone, aktueller UTC-Offset, Sommerzeit-Status und Ortszeit für jede Koordinate weltweit.
GET /api/1/timezone - Elevation API →
Höhe über dem Meeresspiegel in Metern für jede Koordinate — ein Punkt oder ein ganzes Routenprofil.
GET /api/1/elevation - Boundary Lookup API →
Ermitteln Sie, in welchem Land, Bundesland, welcher Stadt und welchem Bezirk eine Koordinate liegt — auf Wunsch mit Grenzpolygon.
GET /api/1/boundary - Geofencing API →
Prüfen Sie in einem Aufruf, in welche Ihrer Zonen jeder Punkt fällt — Polygon- oder Kreiszäune.
POST /api/1/geofence - Elevation Profile API →
Höhe an jedem Punkt eines Pfades plus Gesamtanstieg, Abstieg und Distanz — ein komplettes Routenprofil.
POST /api/1/elevation/profile - Solar API →
Sonnenauf-/-untergang, Dämmerung, Sonnenmittag und Tageslänge für jede Koordinate und jedes Datum.
GET /api/1/solar - Geometry Utilities API →
Distanz, Peilung, Fläche, Schwerpunkt, Vereinfachung und Polyline-Encode/Decode — Geometrie als Service.
POST /api/1/geometry - Coordinate Conversion API →
Breite/Länge in UTM- und MGRS-Gitterreferenzen und zurück umwandeln.
GET /api/1/convert - Country Info API →
Währung, Vorwahl, Sprachen, Hauptstadt und Flagge jedes Landes per ISO-Code oder Name.
GET /api/1/country - Dataset Query API →
Nahe Objekte in eigenen hochgeladenen Geodatensätzen finden.
POST /api/v1/maps/datasets/{id}/query - Straßendaten-API →
Tempolimits, Straßeneigenschaften und Verkehrszeichenbeobachtungen im verfügbaren Gebiet.
POST /api/v1/roads/lookupPOST /api/v1/roads/batch - Kontonutzung →
Straßendaten: 100.000 Vorgänge pro Monat
POST /api/v1/roads/usage - Verkehrszeichen-API →
Verkehrszeichenbeobachtungen in einem Kartenausschnitt finden: Klassifikation, Koordinaten, Richtung und Beobachtungsdaten mit Cursor-Paginierung.
POST /api/v1/roads/signs - Nachweis der Routen-Compliance →
Quellenqualifizierte Geschwindigkeitsdaten für übermittelte Routenpositionen.
POST /api/v1/roads/compliance - Tempolimit auf Straßen →
Rufen Sie das kartierte Pkw-Tempolimit nahe einer Koordinate ab. Fehlende oder mehrdeutige Werte werden als null zurückgegeben.
GET /api/1/speed-limit
Leitfaden zur Plattformintegration (6)
- Asynchrone Jobs →
Operationen: geocode_batch, matrix, optimize. POST /api/jobs liefert 202 und eine Job-ID. Derselbe Idempotency-Key mit gleichem Inhalt liefert den vorhandenen Job; anderer Inhalt ergibt 409.
POST /api/jobsGET /api/jobsGET /api/jobs/{id}Alle Endpunkte (+1)
DELETE /api/jobs/{id} - Sandbox-API →
Prüfen Sie die Antwortverarbeitung mit Beispieldaten in der Sandbox, bevor Sie kostenpflichtige Live-Anfragen senden.
POST /api/sandbox - Quellenmetadaten →
Prüfen Sie Quellen, geografische Abdeckung und Aktualität je Dienst.
GET /api/source-metadata - Mobiler Zugriff →
Verbinden Sie Ihre App ohne eingebetteten geheimen API-Schlüssel.
POST /api/mobile/challengePOST /api/mobile/token - Remote-MCP-API →
KI-Tools mit Standortdiensten verbinden.
POST /api/mcp - Kompatibilitätsendpunkte →
Prüfen Sie bei bestehenden Integrationen vor dem Wechsel Koordinatenreihenfolge und Antwort-Einheiten.
GET /api/v1/route/{profile}/{coordinates}GET /api/1/routeGET /api/1/route/infoAlle Endpunkte (+9)
GET /api/1/matrixPOST /api/1/matrixPOST /api/1/matrix/calculatePOST /api/1/matchPOST /api/1/elevationPOST /api/1/optimizePOST /api/1/vrp/optimizePOST /api/1/cluster/calculatePOST /api/1/batch-geocode
Einführung
#OSRMRoute bietet APIs für Straßenrouting, Flottenplanung, Adresssuche, Karten und Geodaten. Das Verzeichnis führt zur Anleitung für die gewünschte Operation.
Aktuelle Tariflimits
Guthaben- und Minutenlimits werden von allen Kontoschlüsseln geteilt. Ein zusätzliches Schlüssellimit erhöht das Kontobudget nicht. Enthaltenes Guthaben wird vor gekauftem Guthaben genutzt.
Free umfasst Routing, Route Optimization, Geocoding (einschließlich Rückwärtssuche und Autovervollständigung) und Matrix innerhalb der Tariflimits. Map Matching, Isochrone, Truck Routing, Fuel Estimate und andere eigenständige APIs erfordern einen kostenpflichtigen Tarif, auch PAYG. Der API-Zugriff richtet sich nach dem gültigen Kontotarif; ein positives Guthaben allein hebt Free-Beschränkungen nicht auf. Für Straßendaten und AI gelten weiterhin gesonderte Business-Anforderungen.
Route, Directions und Truck Routing: Findet ein verarbeiteter Aufruf keine erreichbare Straße in der Nähe oder keine verbundene Route, kostet er einmalig 0,5 Credits in allen berechtigten Tarifen einschließlich PAYG. Ungültige Eingaben, Zugriffs-/Tarifablehnungen, fehlende Graphabdeckung und Serverfehler sind kostenlos. Zuerst wird der Preis eines erfolgreichen Aufrufs reserviert; der Rest wird erstattet.
Limits werden geladen…
Die öffentliche Kartendemo unterstützt Route, Matrix, Match, Nearest und Trip mit eigenen Demolimits. Für andere Dienste nutzen Sie Ihren API-Schlüssel und die Beispiele unten.
Authentifizierung
#Senden Sie den API-Schlüssel als Bearer-Token im Authorization-Header. Prüfen Sie in der Anleitung den erforderlichen Schlüsselbereich und die Umgebung. Einige ältere Endpunkte akzeptieren Schlüssel als URL-Parameter.
Authorization: Bearer YOUR_API_KEYFehlercodes
#OSRMRoute verwendet Standard-HTTP-Statuscodes und detaillierte JSON-Fehlermeldungen, um den Zustand einer Anfrage anzuzeigen.
Fehler enthalten error und optional code. Prüfen Sie HTTP-Status und Budget-Header, nicht nur den Meldungstext. Reset-Header beschreiben gleitende Zeitfenster, keinen Reset um Mitternacht.
X-RateLimit-Limit · X-RateLimit-Remaining · X-RateLimit-Reset · X-Compute-* · X-Quota-* · X-Credits-* · Retry-AfterGültigen API-Schlüssel angeben und Status im Dashboard prüfen.
{
"error": "Invalid API Key"
}Guthaben aufladen oder passenden Tarif wählen.
{
"error": "Insufficient balance: this request costs 1 credit and your balance is 0 credits. Top up your account to continue."
}Komplexitätslimits und Schlüsselbeschränkungen im Dashboard prüfen.
{
"error": "This API Key is disabled"
}Retry-After beachten und Anfragen seltener senden.
{
"error": "Rate limit exceeded: this account has exceeded its configured requests-per-minute limit. Please slow down."
}Dienst oder Datenquelle nicht verfügbar. Vorsichtig mit längeren Pausen wiederholen.
{
"error": "Internal Server Error"
}Routing API
#Berechnen Sie eine Auto-, Rad- oder Fußroute durch die Punkte in der angegebenen Reihenfolge. Verwenden Sie steps=true für Abbiegehinweise und geometries=geojson für GeoJSON.
/api/v1/osrm/route/v1/{profile}/{coordinates}Parameter (Query Params)
| Parameter | Typ | Status | Standard | Beschreibung |
|---|---|---|---|---|
| profile | string | Erforderlich | driving | Transportmodus-Profil. Unterstützte Werte: driving (Auto), cycling (Fahrrad), walking (Fußgänger). |
| coordinates | string | Erforderlich | - | Koordinaten der Punkte. Format: lon,lat;lon,lat;lon,lat... (mindestens 2 Punkte). |
| overview | string | Optional | simplified | Detailgrad der zurückgegebenen Routengeometrie: simplified (vereinfacht), full (vollständige Geometrie), false (ohne Geometrie). |
| geometries | string | Optional | polyline | Geometrieformat: geojson (GeoJSON-Objekt), polyline (kodierte Zeichenfolge). |
| steps | boolean | Optional | false | Ob für jede Abbiegung Schritt-für-Schritt-Anweisungen zurückgegeben werden. |
| alternatives | integer | boolean | Optional | false | Anzahl der gesuchten Alternativrouten. Die Verfügbarkeit hängt vom Straßennetz ab. |
Beispielanfrage
Ersetzen Sie YOUR_KEY durch Ihren API-Schlüssel. API-Anfragen verbrauchen Credits; das Kopieren sendet keine Anfrage.
curl "https://osrmroute.com/api/v1/osrm/route/v1/driving/49.8516,40.3777;49.86,40.40?steps=true&overview=full&geometries=geojson" -H "Authorization: Bearer YOUR_KEY"Limits und Koordinaten
Credit-Kosten: 1 Credit je angefangenen Block aus 10 Eingabepunkten, einschließlich Start und Ziel.
Route, Directions und Truck Routing: Findet ein verarbeiteter Aufruf keine erreichbare Straße in der Nähe oder keine verbundene Route, kostet er einmalig 0,5 Credits in allen berechtigten Tarifen einschließlich PAYG. Ungültige Eingaben, Zugriffs-/Tarifablehnungen, fehlende Graphabdeckung und Serverfehler sind kostenlos. Zuerst wird der Preis eines erfolgreichen Aufrufs reserviert; der Rest wird erstattet.
OSRM-Pfad: lon,lat; GeoJSON: [lon,lat].
- points ≥ 2; points ≤ plan.maxRoutePoints
- snap_distance_m ≤ 2000
Auto-, Fuß- und Fahrradrouten sind weltweit verfügbar. Punkte müssen über zugängliche Wege verbunden sein. VRP ist heuristisch, Isochronen sind Näherungen; ein globales Optimum oder Live-Verkehr wird nicht zugesichert.
Aktuelle Tarife und PreiseAbdeckung nach DienstJSON-Antwortbeispiel
Gekürztes JSON-Beispiel. Werte, optionale Felder und Kartendaten können abweichen. Entfernungen sind Meter und Routenzeiten Sekunden, sofern nicht anders angegeben.
{
"code": "Ok",
"routes": [
{
"distance": 3200,
"duration": 420,
"geometry": {
"type": "LineString",
"coordinates": [
[
49.8516,
40.3777
],
[
49.86,
40.4
]
]
},
"legs": [
{
"distance": 3200,
"duration": 420,
"steps": []
}
]
}
],
"waypoints": [
{
"name": "Example road",
"location": [
49.8516,
40.3777
],
"distance": 4.2
}
]
}Dienstspezifische Fehler
Korrigieren Sie fehlende oder ungültige Parameter.
{
"code": "InvalidQuery",
"error": "Coordinates must be finite longitude,latitude pairs."
}Wählen Sie ein unterstütztes Profil. Kein automatischer Wechsel auf Autorouten.
{
"code": "ProfileNotAvailable",
"error": "This travel profile is not available at one or more coordinates. No driving fallback was used."
}Die API konnte die Punkte für das gewählte Profil keinem gemeinsamen Straßennetz zuordnen. Senden Sie verbundene Abschnitte separat.
{
"code": "CrossRegionNotSupported",
"error": "These coordinates are not served by one routing graph. Split the request by region."
}Prüfen Sie, ob die Punkte nahe an zugänglichen Straßen liegen und diese für das gewählte Profil verbunden sind.
{
"code": "NoNearbyRoad",
"error": "No connected route within 2000 metres of the requested coordinates."
}Dienst oder Datenquelle nicht verfügbar. Vorsichtig mit längeren Pausen wiederholen.
{
"code": "RoutingTimeout",
"error": "The routing service did not respond within the request deadline. Retry later."
}Erläuterung der Antwortstruktur
Die Entfernung steht in Metern, die Dauer in Sekunden. Standardmäßig ist die Routenlinie vereinfacht und als polyline codiert. Für die vollständige Linie overview=full verwenden.
Matrix API
#Berechnen Sie Fahrzeiten, Entfernungen oder beides zwischen Start- und Zielpunkten. Wählen Sie Indizes der Koordinatenliste mit sources und destinations.
/api/v1/osrm/table/v1/{profile}/{coordinates}Parameter (Query Params)
| Parameter | Typ | Status | Standard | Beschreibung |
|---|---|---|---|---|
| profile | string | Erforderlich | driving | Transportprofil (driving, cycling, walking). |
| coordinates | string | Erforderlich | - | Matrixpunkte. Format: lon,lat;lon,lat;lon,lat... |
| annotations | string | Optional | duration | Zu berechnende Daten: duration (Zeit), distance (Distanz) oder beides. |
| sources | string | Optional | all | Bei null beginnende Startindizes, durch Semikolons getrennt, oder all. |
| destinations | string | Optional | all | Bei null beginnende Zielindizes, durch Semikolons getrennt, oder all. |
Beispielanfrage
Ersetzen Sie YOUR_KEY durch Ihren API-Schlüssel. API-Anfragen verbrauchen Credits; das Kopieren sendet keine Anfrage.
curl "https://osrmroute.com/api/v1/osrm/table/v1/driving/49.85,40.37;49.86,40.40;49.83,40.39?annotations=duration,distance" -H "Authorization: Bearer YOUR_KEY"Limits und Koordinaten
Credit-Kosten: max(1, ceil(cells * 2 / 5))
OSRM-Pfad: lon,lat; GeoJSON: [lon,lat].
- points ≥ 2; points ≤ plan.maxRoutePoints
- cells = sources × destinations
- credits = max(1, ceil(cells * 2 / 5))
Auto-, Fuß- und Fahrradrouten sind weltweit verfügbar. Punkte müssen über zugängliche Wege verbunden sein. VRP ist heuristisch, Isochronen sind Näherungen; ein globales Optimum oder Live-Verkehr wird nicht zugesichert.
Aktuelle Tarife und PreiseAbdeckung nach DienstJSON-Antwortbeispiel
Gekürztes JSON-Beispiel. Werte, optionale Felder und Kartendaten können abweichen. Entfernungen sind Meter und Routenzeiten Sekunden, sofern nicht anders angegeben.
{
"code": "Ok",
"durations": [
[
0,
420
],
[
430,
0
]
],
"distances": [
[
0,
3200
],
[
3300,
0
]
],
"sources": [
{
"name": "Example road",
"location": [
49.8516,
40.3777
],
"distance": 4.2
},
{
"name": "Second road",
"location": [
49.86,
40.4
],
"distance": 3
}
],
"destinations": [
{
"name": "Example road",
"location": [
49.8516,
40.3777
],
"distance": 4.2
},
{
"name": "Second road",
"location": [
49.86,
40.4
],
"distance": 3
}
]
}Dienstspezifische Fehler
Korrigieren Sie fehlende oder ungültige Parameter.
{
"code": "InvalidQuery",
"error": "Coordinates must be finite longitude,latitude pairs."
}Wählen Sie ein unterstütztes Profil. Kein automatischer Wechsel auf Autorouten.
{
"code": "ProfileNotAvailable",
"error": "This travel profile is not available at one or more coordinates. No driving fallback was used."
}Die API konnte die Punkte für das gewählte Profil keinem gemeinsamen Straßennetz zuordnen. Senden Sie verbundene Abschnitte separat.
{
"code": "CrossRegionNotSupported",
"error": "These coordinates are not served by one routing graph. Split the request by region."
}Prüfen Sie, ob die Punkte nahe an zugänglichen Straßen liegen und diese für das gewählte Profil verbunden sind.
{
"code": "UnreachablePoints",
"error": "Some locations are disconnected in this road network."
}Dienst oder Datenquelle nicht verfügbar. Vorsichtig mit längeren Pausen wiederholen.
{
"code": "RoutingTimeout",
"error": "The routing service did not respond within the request deadline. Retry later."
}Erläuterung der Antwortstruktur
Standardmäßig wird die durations-Matrix geliefert. Verwenden Sie annotations=distance für Entfernungen oder annotations=duration,distance für beides. Dauern stehen in Sekunden, Entfernungen in Metern. Kann kein geeigneter Graph die Matrix vollständig berechnen, liefern getrennte Punkte HTTP 422 UnreachablePoints.
Map Matching API
#Ordnet ungenaue GPS-Spuren dem realen Straßennetz zu (snap to road). Wird verwendet, um Rauschen in GPS-Signalen zu bereinigen.
/api/v1/osrm/match/v1/{profile}/{coordinates}Parameter (Query Params)
| Parameter | Typ | Status | Standard | Beschreibung |
|---|---|---|---|---|
| geometries | string | Optional | polyline | Geometrieformat: geojson (GeoJSON-Objekt), polyline (kodierte Zeichenfolge). |
| profile | string | Erforderlich | driving | Transportprofil. |
| coordinates | string | Erforderlich | - | Die Folge von GPS-Koordinaten zum Zuordnen (lon,lat;lon,lat...) |
| overview | string | Optional | simplified | Geometriegenauigkeit der zugeordneten Route. |
| timestamps | string | Optional | - | Nicht absteigende Unix-Zeitstempel in Sekunden, einer pro Punkt, durch Semikolons getrennt. |
| radiuses | string | Optional | - | GPS-Genauigkeit in Metern, ein Wert pro Punkt, durch Semikolons getrennt. |
Beispielanfrage
Ersetzen Sie YOUR_KEY durch Ihren API-Schlüssel. API-Anfragen verbrauchen Credits; das Kopieren sendet keine Anfrage.
curl "https://osrmroute.com/api/v1/osrm/match/v1/driving/49.851536,40.375480;49.844011,40.379982;49.839336,40.389620;49.837774,40.389268?overview=full&geometries=geojson" -H "Authorization: Bearer YOUR_KEY"Limits und Koordinaten
Credit-Kosten: 1 credit
OSRM-Pfad: lon,lat; GeoJSON: [lon,lat].
- points ≥ 2; points ≤ plan.maxRoutePoints
- tracepoints[]: object | null
Auto-, Fuß- und Fahrradrouten sind weltweit verfügbar. Punkte müssen über zugängliche Wege verbunden sein. VRP ist heuristisch, Isochronen sind Näherungen; ein globales Optimum oder Live-Verkehr wird nicht zugesichert.
Aktuelle Tarife und PreiseAbdeckung nach DienstJSON-Antwortbeispiel
Gekürztes JSON-Beispiel. Werte, optionale Felder und Kartendaten können abweichen. Entfernungen sind Meter und Routenzeiten Sekunden, sofern nicht anders angegeben.
{
"code": "Ok",
"matchings": [
{
"distance": 3200,
"duration": 420,
"geometry": {
"type": "LineString",
"coordinates": [
[
49.8516,
40.3777
],
[
49.86,
40.4
]
]
},
"legs": [
{
"distance": 3200,
"duration": 420,
"steps": []
}
],
"confidence": 0.97
}
],
"tracepoints": [
{
"name": "Example road",
"location": [
49.8516,
40.3777
],
"distance": 4.2
},
null
]
}Dienstspezifische Fehler
Korrigieren Sie fehlende oder ungültige Parameter.
{
"code": "InvalidQuery",
"error": "Coordinates must be finite longitude,latitude pairs."
}Wählen Sie ein unterstütztes Profil. Kein automatischer Wechsel auf Autorouten.
{
"code": "ProfileNotAvailable",
"error": "This travel profile is not available at one or more coordinates. No driving fallback was used."
}Die API konnte die Punkte für das gewählte Profil keinem gemeinsamen Straßennetz zuordnen. Senden Sie verbundene Abschnitte separat.
{
"code": "CrossRegionNotSupported",
"error": "These coordinates are not served by one routing graph. Split the request by region."
}Prüfen Sie, ob die Punkte nahe an zugänglichen Straßen liegen und diese für das gewählte Profil verbunden sind.
{
"code": "NoNearbyRoad",
"error": "No connected route within 2000 metres of the requested coordinates."
}Dienst oder Datenquelle nicht verfügbar. Vorsichtig mit längeren Pausen wiederholen.
{
"code": "RoutingTimeout",
"error": "The routing service did not respond within the request deadline. Retry later."
}Erläuterung der Antwortstruktur
matchings[]: distance — Entfernung (m), duration — Dauer (s), confidence — Konfidenz (0–1), geometry — Geometrie; tracepoints[] — Objekt oder null.
Nearest API
#Ordnet jede Koordinate dem nächstgelegenen realen Straßensegment zu (snap) und gibt Informationen zum Straßennamen zurück.
/api/v1/osrm/nearest/v1/{profile}/{coordinates}Parameter (Query Params)
| Parameter | Typ | Status | Standard | Beschreibung |
|---|---|---|---|---|
| profile | string | Erforderlich | driving | Transportprofil. |
| coordinates | string | Erforderlich | - | Der Punkt, in dessen Nähe gesucht wird. Format: lon,lat (ein einzelnes Paar). |
| number | integer | Optional | 1 | Die Anzahl der zu findenden nächstgelegenen Straßenkandidaten. |
Beispielanfrage
Ersetzen Sie YOUR_KEY durch Ihren API-Schlüssel. API-Anfragen verbrauchen Credits; das Kopieren sendet keine Anfrage.
curl "https://osrmroute.com/api/v1/osrm/nearest/v1/driving/49.8516,40.3777?number=3" -H "Authorization: Bearer YOUR_KEY"Limits und Koordinaten
Credit-Kosten: 1 credit
OSRM-Pfad: lon,lat; GeoJSON: [lon,lat].
- coordinates: 1
- number: default = 1; example = 3
Auto-, Fuß- und Fahrradrouten sind weltweit verfügbar. Punkte müssen über zugängliche Wege verbunden sein. VRP ist heuristisch, Isochronen sind Näherungen; ein globales Optimum oder Live-Verkehr wird nicht zugesichert.
Aktuelle Tarife und PreiseAbdeckung nach DienstJSON-Antwortbeispiel
Gekürztes JSON-Beispiel. Werte, optionale Felder und Kartendaten können abweichen. Entfernungen sind Meter und Routenzeiten Sekunden, sofern nicht anders angegeben.
{
"code": "Ok",
"waypoints": [
{
"name": "Example road",
"location": [
49.8516,
40.3777
],
"distance": 4.2
}
]
}Dienstspezifische Fehler
Korrigieren Sie fehlende oder ungültige Parameter.
{
"code": "InvalidQuery",
"error": "Coordinates must be finite longitude,latitude pairs."
}Wählen Sie ein unterstütztes Profil. Kein automatischer Wechsel auf Autorouten.
{
"code": "ProfileNotAvailable",
"error": "This travel profile is not available at one or more coordinates. No driving fallback was used."
}Prüfen Sie, ob die Punkte nahe an zugänglichen Straßen liegen und diese für das gewählte Profil verbunden sind.
{
"code": "NoNearbyRoad",
"error": "No connected route within 2000 metres of the requested coordinates."
}Dienst oder Datenquelle nicht verfügbar. Vorsichtig mit längeren Pausen wiederholen.
{
"code": "RoutingTimeout",
"error": "The routing service did not respond within the request deadline. Retry later."
}Erläuterung der Antwortstruktur
waypoints[] → name, distance (m), location [lon,lat].
Trip API
#Ordnen Sie Stopps eines einzelnen Fahrzeugs anhand des Straßennetzes. Für eine offene Route roundtrip=false&source=first&destination=last verwenden. Eine optimale Reihenfolge ist nicht garantiert.
/api/v1/osrm/trip/v1/{profile}/{coordinates}Parameter (Query Params)
| Parameter | Typ | Status | Standard | Beschreibung |
|---|---|---|---|---|
| geometries | string | Optional | polyline | Geometrieformat: geojson (GeoJSON-Objekt), polyline (kodierte Zeichenfolge). |
| profile | string | Erforderlich | driving | Transportprofil. |
| coordinates | string | Erforderlich | - | Zu besuchende Punkte. Format: lon,lat;lon,lat... |
| source | string | Optional | any | Der Punkt, an dem die Route beginnen kann (any oder der erste Punkt). |
| destination | string | Optional | any | Der Punkt, an dem die Route endet (any oder der letzte Punkt). |
| roundtrip | boolean | Optional | true | Zum Start zurückkehren. Für false source=first und destination=last verwenden. |
Beispielanfrage
Ersetzen Sie YOUR_KEY durch Ihren API-Schlüssel. API-Anfragen verbrauchen Credits; das Kopieren sendet keine Anfrage.
curl "https://osrmroute.com/api/v1/osrm/trip/v1/driving/49.85,40.37;49.86,40.40;49.83,40.39?source=first&geometries=geojson" -H "Authorization: Bearer YOUR_KEY"Limits und Koordinaten
Credit-Kosten: 5 credits
OSRM-Pfad: lon,lat; GeoJSON: [lon,lat].
- points ≥ 2; points ≤ plan.maxRoutePoints
- credits = 5
Auto-, Fuß- und Fahrradrouten sind weltweit verfügbar. Punkte müssen über zugängliche Wege verbunden sein. VRP ist heuristisch, Isochronen sind Näherungen; ein globales Optimum oder Live-Verkehr wird nicht zugesichert.
Aktuelle Tarife und PreiseAbdeckung nach DienstJSON-Antwortbeispiel
Gekürztes JSON-Beispiel. Werte, optionale Felder und Kartendaten können abweichen. Entfernungen sind Meter und Routenzeiten Sekunden, sofern nicht anders angegeben.
{
"code": "Ok",
"trips": [
{
"distance": 3200,
"duration": 420,
"geometry": {
"type": "LineString",
"coordinates": [
[
49.8516,
40.3777
],
[
49.86,
40.4
]
]
},
"legs": [
{
"distance": 3200,
"duration": 420,
"steps": []
}
]
}
],
"waypoints": [
{
"name": "Example road",
"location": [
49.8516,
40.3777
],
"distance": 4.2,
"trips_index": 0,
"waypoint_index": 0
}
]
}Dienstspezifische Fehler
Korrigieren Sie fehlende oder ungültige Parameter.
{
"code": "InvalidQuery",
"error": "Coordinates must be finite longitude,latitude pairs."
}Wählen Sie ein unterstütztes Profil. Kein automatischer Wechsel auf Autorouten.
{
"code": "ProfileNotAvailable",
"error": "This travel profile is not available at one or more coordinates. No driving fallback was used."
}Die API konnte die Punkte für das gewählte Profil keinem gemeinsamen Straßennetz zuordnen. Senden Sie verbundene Abschnitte separat.
{
"code": "CrossRegionNotSupported",
"error": "These coordinates are not served by one routing graph. Split the request by region."
}Prüfen Sie, ob die Punkte nahe an zugänglichen Straßen liegen und diese für das gewählte Profil verbunden sind.
{
"code": "NoNearbyRoad",
"error": "No connected route within 2000 metres of the requested coordinates."
}Dienst oder Datenquelle nicht verfügbar. Vorsichtig mit längeren Pausen wiederholen.
{
"code": "RoutingTimeout",
"error": "The routing service did not respond within the request deadline. Retry later."
}Erläuterung der Antwortstruktur
trips[]: distance — Entfernung (m), duration — Dauer (s), geometry — Geometrie; waypoints[]: trips_index, waypoint_index — Reihenfolgeindizes, location [lon,lat] — Koordinaten.
Directions API
#Liefert Abbiegehinweise zwischen zwei oder mehr Wegpunkten mit sauberer Anweisungsliste (Text, Distanz, Dauer, Manövertyp und Position). Unterstützt Auto, Fahrrad und zu Fuß sowie bis zu 3 Alternativrouten in einem Aufruf.
/api/1/directionsParameter (Query Params)
| Parameter | Typ | Status | Standard | Beschreibung |
|---|---|---|---|---|
| point | string | Erforderlich | lat,lng | Wegpunkt als lat,lng. Parameter für jeden Stopp wiederholen (mindestens 2). |
| profile | string | Optional | driving | Fortbewegungsart: driving, cycling oder walking. |
| alternatives | integer | Optional | 0 | Anzahl zusätzlich zurückgegebener Alternativrouten (0–3). |
| lang | string | Optional | en | Sprachcode für den Anweisungstext. |
Beispielanfrage
Ersetzen Sie YOUR_KEY durch Ihren API-Schlüssel. API-Anfragen verbrauchen Credits; das Kopieren sendet keine Anfrage.
curl "https://osrmroute.com/api/1/directions?point=40.3777,49.8516&point=40.40,49.86&profile=driving" -H "Authorization: Bearer YOUR_KEY"curl "https://osrmroute.com/api/1/directions?point=40.3777,49.8516&point=40.40,49.86&alternatives=2" -H "Authorization: Bearer YOUR_KEY"Limits und Koordinaten
Credit-Kosten: 1 Credit je angefangenen Block aus 10 Eingabepunkten, einschließlich Start und Ziel.
Route, Directions und Truck Routing: Findet ein verarbeiteter Aufruf keine erreichbare Straße in der Nähe oder keine verbundene Route, kostet er einmalig 0,5 Credits in allen berechtigten Tarifen einschließlich PAYG. Ungültige Eingaben, Zugriffs-/Tarifablehnungen, fehlende Graphabdeckung und Serverfehler sind kostenlos. Zuerst wird der Preis eines erfolgreichen Aufrufs reserviert; der Rest wird erstattet.
Eingabe point=lat,lng. Anweisungen/Wegpunkte: [lat,lng]; GeoJSON: [lon,lat].
- point: repeat ≥ 2; count ≤ plan.maxRoutePoints
- alternatives: 0–3
Auto-, Fuß- und Fahrradrouten sind weltweit verfügbar. Punkte müssen über zugängliche Wege verbunden sein. VRP ist heuristisch, Isochronen sind Näherungen; ein globales Optimum oder Live-Verkehr wird nicht zugesichert.
Aktuelle Tarife und PreiseAbdeckung nach DienstJSON-Antwortbeispiel
Gekürztes JSON-Beispiel. Werte, optionale Felder und Kartendaten können abweichen. Entfernungen sind Meter und Routenzeiten Sekunden, sofern nicht anders angegeben.
{
"code": "Ok",
"profile": "driving",
"routes": [
{
"distance": 3200,
"duration": 420,
"geometry": {
"type": "LineString",
"coordinates": [
[
49.8516,
40.3777
],
[
49.86,
40.4
]
]
},
"instructions": [
{
"text": "Continue on Example road",
"type": "continue",
"modifier": "straight",
"distance": 300,
"duration": 40,
"name": "Example road",
"bearing_after": 90,
"location": [
40.3777,
49.8516
]
}
]
}
],
"waypoints": [
{
"name": "Example road",
"location": [
40.3777,
49.8516
]
}
]
}Dienstspezifische Fehler
Korrigieren Sie fehlende oder ungültige Parameter.
{
"error": "At least two points must be provided (point=lat,lng repeated)."
}Wählen Sie ein unterstütztes Profil. Kein automatischer Wechsel auf Autorouten.
{
"code": "ProfileNotAvailable",
"error": "This travel profile is not available at one or more coordinates. No driving fallback was used."
}Die API konnte die Punkte für das gewählte Profil keinem gemeinsamen Straßennetz zuordnen. Senden Sie verbundene Abschnitte separat.
{
"code": "CrossRegionNotSupported",
"error": "These coordinates are not served by one routing graph. Split the request by region."
}Prüfen Sie, ob die Punkte nahe an zugänglichen Straßen liegen und diese für das gewählte Profil verbunden sind.
{
"code": "NoNearbyRoad",
"error": "No connected route within 2000 metres of the requested coordinates."
}Dienst oder Datenquelle nicht verfügbar. Vorsichtig mit längeren Pausen wiederholen.
{
"code": "RoutingTimeout",
"error": "The routing service did not respond within the request deadline. Retry later."
}Erläuterung der Antwortstruktur
Gibt { code, profile, routes[], waypoints[] } zurück. Jede Route hat distance (m), duration (s), eine GeoJSON-Geometrie und ein instructions[]-Array; jede Anweisung enthält text, type, modifier, distance, duration, name und location [lat,lng].
Snap to Road API
#Rastet rohe, ungenaue GPS-Punkte auf die nächste Position im Straßennetz ein. Wiederholen Sie den point-Parameter für jede Koordinate (bis zu 100).
/api/1/snapParameter (Query Params)
| Parameter | Typ | Status | Standard | Beschreibung |
|---|---|---|---|---|
| point | string | Erforderlich | lat,lng | GPS-Punkt als lat,lng. Parameter für jeden Punkt wiederholen (maximal 100). |
| profile | string | Optional | driving | Straßennetz zum Einrasten: driving, cycling oder walking. |
Beispielanfrage
Ersetzen Sie YOUR_KEY durch Ihren API-Schlüssel. API-Anfragen verbrauchen Credits; das Kopieren sendet keine Anfrage.
curl "https://osrmroute.com/api/1/snap?point=40.3778,49.8517&point=40.3801,49.8600" -H "Authorization: Bearer YOUR_KEY"Limits und Koordinaten
Credit-Kosten: 1 credit
point=lat,lng; JSON-Punkte: [lat,lng]. GeoJSON-Geometrie: [lon,lat].
- point: repeat 1–100
Auto-, Fuß- und Fahrradrouten sind weltweit verfügbar. Punkte müssen über zugängliche Wege verbunden sein. VRP ist heuristisch, Isochronen sind Näherungen; ein globales Optimum oder Live-Verkehr wird nicht zugesichert.
Aktuelle Tarife und PreiseAbdeckung nach DienstJSON-Antwortbeispiel
Gekürztes JSON-Beispiel. Werte, optionale Felder und Kartendaten können abweichen. Entfernungen sind Meter und Routenzeiten Sekunden, sofern nicht anders angegeben.
{
"code": "Ok",
"profile": "driving",
"snapped": [
{
"input": [
40.3777,
49.8516
],
"snapped": [
40.3778,
49.8517
],
"distance": 14,
"name": "Example road"
}
]
}Dienstspezifische Fehler
Korrigieren Sie fehlende oder ungültige Parameter.
{
"error": "At least one point must be provided (point=lat,lng repeated)."
}Wählen Sie ein unterstütztes Profil. Kein automatischer Wechsel auf Autorouten.
{
"code": "ProfileNotAvailable",
"error": "This travel profile is not available at one or more coordinates. No driving fallback was used."
}Prüfen Sie, ob die Punkte nahe an zugänglichen Straßen liegen und diese für das gewählte Profil verbunden sind.
{
"code": "NoNearbyRoad",
"error": "No connected route within 2000 metres of the requested coordinates."
}Dienst oder Datenquelle nicht verfügbar. Vorsichtig mit längeren Pausen wiederholen.
{
"code": "RoutingTimeout",
"error": "The routing service did not respond within the request deadline. Retry later."
}Erläuterung der Antwortstruktur
Gibt { code, profile, snapped[] } zurück. Jedes Element enthält den ursprünglichen input [lat,lng], die eingerastete Position [lat,lng], die Einrastdistanz in Metern und den Straßennamen.
Geocoding API
#Wandelt einen Suchtext in geografische Koordinaten (vorwärts) oder Koordinaten in eine Adresse (rückwärts) um. Schnelle, tippfehlertolerante Autovervollständigung für Straßen, Adressen und POIs (Cafés, Geschäfte, Hotels, Büros). Ideal für Suche während der Eingabe.
/api/1/geocodeParameter (Query Params)
| Parameter | Typ | Status | Standard | Beschreibung |
|---|---|---|---|---|
| q | string | Optional | - | Die zu suchende Adresse (z. B. „Nizami-Straße, Baku“). |
| reverse | boolean | Optional | false | Muss true sein, um Reverse-Geocoding durchzuführen (Suche von Koordinate zu Adresse). |
| point | string | Optional | lat,lng | Koordinate (lat,lng) für Reverse-Geocoding zu einer Adresse. Erforderlich bei reverse=true. |
| limit | integer | Optional | 5 | Maximale Anzahl zurückgegebener Ergebnisse (1–20, Standard 5). |
| lang | string | Optional | en | Bevorzugte Sprache für Ergebnisnamen (z. B. en, az, ru). Standard: en. |
| lat | number | Optional | - | Breitengrad zur Gewichtung der Ergebnisse (nahe zuerst). Zusammen mit lon. |
| lon | number | Optional | - | Längengrad zur Gewichtung der Ergebnisse. Zusammen mit lat. |
| bbox | string | Optional | - | Ergebnisse auf eine Bounding-Box beschränken: minLon,minLat,maxLon,maxLat. |
| osm_tag | string | Optional | - | Nach OSM-Tag filtern, z. B. place (Orte) oder amenity:cafe. Präfix ! zum Ausschließen. |
| country | string | Optional | - | ISO-3166-1-Alpha-2-Ländercode, z. B. AZ. Nur Ergebnisse aus diesem Land. |
| city | string | Optional | - | Verbindlicher Stadtfilter, z. B. Baku. Erfordert genau einen country-Code. |
| elastic | boolean | Optional | true | Elastische (unscharfe, hohe Trefferquote) Suche — Standard true. Toleriert Tippfehler, fehlende Diakritika (ə↔e), Wortreihenfolge, generische Wörter (metro, rayonu) und Hausnummern. false für strikte Übereinstimmung. |
Länder- und Stadtfilter
Ohne country ist die Suche global. country=AZ beschränkt Ergebnisse auf Aserbaidschan; country=AZ&city=Bakı auf Baku in Aserbaidschan. Ohne Treffer wird HTTP 200 mit einer leeren Liste zurückgegeben, ohne die Suche auszuweiten. Stadt ohne Land oder ungültiger Ländercode: HTTP 400 InvalidGeocodeFilter. lat/lon beeinflussen nur die Entfernungssortierung. Datensätze ohne bestätigte Stadt werden bei einem Stadtfilter ausgeschlossen.
GET /api/1/geocode?q=Nizami&country=AZ
GET /api/1/geocode?q=Nizami&country=AZ&city=Bak%C4%B1
HTTP 200: { "hits": [], "took": 12 }
HTTP 400: { "code": "InvalidGeocodeFilter", "error": "city requires exactly one country, for example country=AZ&city=Bakı." }Beispiele
# Auf einen Ort gewichten, nur Orte
GET /api/1/geocode?q=qala&lat=40.41&lon=49.87&osm_tag=place
# Nur ausgewähltes Land und ausgewählte Stadt
GET /api/1/geocode?q=market&country=AZ&city=Bak%C4%B1
# Reverse-Geocoding (Koordinaten zu Adresse)
GET /api/1/geocode?reverse=true&point=40.409,49.867Für die genaue Adresssuche Straße und Hausnummer in q angeben. locality und postcode setzen genau ein Land voraus. unit wählt die passende Einheit aus der Quelle und aktiviert address_mode=units. Der Standardmodus buildings gruppiert Einträge von Einheiten am selben Standort.
/api/1/geocode?q=101+Main+Street&country=US&locality=Boston&postcode=02129&unit=2&address_mode=unitsBeispielanfrage
Ersetzen Sie YOUR_KEY durch Ihren API-Schlüssel. API-Anfragen verbrauchen Credits; das Kopieren sendet keine Anfrage.
curl "https://osrmroute.com/api/1/geocode?q=Nizami&country=AZ&city=Bak%C4%B1&lang=az" -H "Authorization: Bearer YOUR_KEY"Limits und Koordinaten
Credit-Kosten: 1 credit
point=lat,lng; JSON-Punkte: [lat,lng]. GeoJSON-Geometrie: [lon,lat].
- limit: 1–20
- reverse: max_distance_m = 1000
- city: exactly 1 country
Ohne Treffer kann eine erfolgreiche Antwort eine leere Liste liefern. Länder-/Stadtfilter werden nicht erweitert. Adressdetails hängen vom Index ab.
Aktuelle Tarife und PreiseAbdeckung nach DienstJSON-Antwortbeispiel
Gekürztes JSON-Beispiel. Werte, optionale Felder und Kartendaten können abweichen. Entfernungen sind Meter und Routenzeiten Sekunden, sofern nicht anders angegeben.
{
"hits": [
{
"name": "Nizami Street",
"city": "Baku",
"country": "Azerbaijan",
"countrycode": "AZ",
"point": {
"lat": 40.3777,
"lng": 49.8516
}
}
],
"took": 12
}Dienstspezifische Fehler
Korrigieren Sie fehlende oder ungültige Parameter.
{
"error": "The \"q\" parameter (search text) is required."
}Korrigieren Sie fehlende oder ungültige Parameter.
{
"code": "InvalidGeocodeFilter",
"error": "city requires exactly one country, for example country=AZ&city=Bakı."
}Keine indexierte Adresse oder kein Ort im Rückwärtssuchradius.
{
"code": "NoNearbyAddress",
"error": "No indexed address or place within 1 km."
}Erläuterung der Antwortstruktur
hits[]: name, city, country, countrycode — Orts-/Länderangaben, point (lat,lng) — Koordinaten; took — Dauer (ms). reverse=true: source — Quelle, accuracy — Genauigkeit, distance_m — Entfernung.
Orte (POI in der Nähe)
#Finde POIs in der Nähe eines Punktes — Cafés, Geschäfte, Hotels, Geldautomaten, Apotheken u. a. — gefiltert nach Kategorie und Radius, nach Entfernung sortiert.
/api/1/placesParameter (Query Params)
| Parameter | Typ | Status | Standard | Beschreibung |
|---|---|---|---|---|
| point | string | Erforderlich | lat,lng | Mittelpunkt-Koordinate lat,lng (erforderlich). |
| radius | number | Optional | 1 | Suchradius in Kilometern (0.05–20, Standard 1). |
| category | string | Optional | - | OSM-Tag-Filter, z. B. amenity:cafe, shop, tourism:hotel. Präfix ! zum Ausschließen. Leer = alle POIs. |
| limit | integer | Optional | 10 | Max. Ergebnisse (1–50, Standard 10). |
| lang | string | Optional | en | Bevorzugte Sprache für Namen (z. B. en, az, ru). |
Beispielanfrage
Ersetzen Sie YOUR_KEY durch Ihren API-Schlüssel. API-Anfragen verbrauchen Credits; das Kopieren sendet keine Anfrage.
curl "https://osrmroute.com/api/1/places?point=40.371,49.845&radius=1&category=amenity:cafe" -H "Authorization: Bearer YOUR_KEY"Limits und Koordinaten
Credit-Kosten: 1 credit
point=lat,lng; JSON-Punkte: [lat,lng]. GeoJSON-Geometrie: [lon,lat].
- radius: 0.05–20 km
- limit: 1–50
Ohne Treffer kann eine erfolgreiche Antwort eine leere Liste liefern. Länder-/Stadtfilter werden nicht erweitert. Adressdetails hängen vom Index ab.
Aktuelle Tarife und PreiseAbdeckung nach DienstJSON-Antwortbeispiel
Gekürztes JSON-Beispiel. Werte, optionale Felder und Kartendaten können abweichen. Entfernungen sind Meter und Routenzeiten Sekunden, sofern nicht anders angegeben.
{
"places": [
{
"name": "Example cafe",
"category": "amenity",
"type": "cafe",
"distance_m": 85,
"point": {
"lat": 40.3777,
"lng": 49.8516
}
}
],
"took": 12
}Dienstspezifische Fehler
Korrigieren Sie fehlende oder ungültige Parameter.
{
"error": "The \"point\" parameter (lat,lng) is required."
}Dienst oder Datenquelle nicht verfügbar. Vorsichtig mit längeren Pausen wiederholen.
{
"error": "Places service unavailable."
}Erläuterung der Antwortstruktur
places[]: name, category, type — Ortsangaben, distance_m — Entfernung, point (lat,lng) — Koordinaten; took — Dauer (ms).
Autocomplete API
#Schnelle, tippfehlertolerante Ortsvorschläge während der Eingabe, mit optionaler Standortgewichtung.
/api/1/autocompleteParameter (Query Params)
| Parameter | Typ | Status | Standard | Beschreibung |
|---|---|---|---|---|
| q | string | Erforderlich | - | Suchtext — Teileingabe ist möglich. |
| limit | integer | Optional | 8 | Maximale Anzahl an Vorschlägen (1–15). |
| lang | string | Optional | en | Sprachcode für Ergebnis-Labels. |
| lat | number | Optional | - | Breitengrad zur Gewichtung (optional). |
| lon | number | Optional | - | Längengrad zur Gewichtung (optional). |
| country | string | Optional | - | ISO-3166-1-Alpha-2-Ländercode, z. B. AZ. Nur Ergebnisse aus diesem Land. |
| city | string | Optional | - | Verbindlicher Stadtfilter, z. B. Baku. Erfordert genau einen country-Code. |
| osm_tag | string | Optional | - | Vorschläge nach OSM-Typ filtern, z. B. place:city. |
Länder- und Stadtfilter
Ohne country ist die Suche global. country=AZ beschränkt Ergebnisse auf Aserbaidschan; country=AZ&city=Bakı auf Baku in Aserbaidschan. Ohne Treffer wird HTTP 200 mit einer leeren Liste zurückgegeben, ohne die Suche auszuweiten. Stadt ohne Land oder ungültiger Ländercode: HTTP 400 InvalidGeocodeFilter. lat/lon beeinflussen nur die Entfernungssortierung. Datensätze ohne bestätigte Stadt werden bei einem Stadtfilter ausgeschlossen.
GET /api/1/autocomplete?q=Nizami&country=AZ
GET /api/1/autocomplete?q=Nizami&country=AZ&city=Bak%C4%B1
HTTP 200: { "suggestions": [], "took": 12 }
HTTP 400: { "code": "InvalidGeocodeFilter", "error": "city requires exactly one country, for example country=AZ&city=Bakı." }Beispielanfrage
Ersetzen Sie YOUR_KEY durch Ihren API-Schlüssel. API-Anfragen verbrauchen Credits; das Kopieren sendet keine Anfrage.
curl "https://osrmroute.com/api/1/autocomplete?q=niz&lang=az&lat=40.40&lon=49.86" -H "Authorization: Bearer YOUR_KEY"Limits und Koordinaten
Credit-Kosten: 1 credit
point=lat,lng; JSON-Punkte: [lat,lng]. GeoJSON-Geometrie: [lon,lat].
- limit: 1–15
- city: exactly 1 country
Ohne Treffer kann eine erfolgreiche Antwort eine leere Liste liefern. Länder-/Stadtfilter werden nicht erweitert. Adressdetails hängen vom Index ab.
Aktuelle Tarife und PreiseAbdeckung nach DienstJSON-Antwortbeispiel
Gekürztes JSON-Beispiel. Werte, optionale Felder und Kartendaten können abweichen. Entfernungen sind Meter und Routenzeiten Sekunden, sofern nicht anders angegeben.
{
"suggestions": [
{
"name": "Nizami Street",
"city": "Baku",
"country": "Azerbaijan",
"countrycode": "AZ",
"point": {
"lat": 40.3777,
"lng": 49.8516
},
"label": "Nizami Street, Baku, Azerbaijan"
}
],
"took": 12
}Dienstspezifische Fehler
Korrigieren Sie fehlende oder ungültige Parameter.
{
"error": "The \"q\" parameter (search text) is required."
}Korrigieren Sie fehlende oder ungültige Parameter.
{
"code": "InvalidGeocodeFilter",
"error": "city requires exactly one country, for example country=AZ&city=Bakı."
}Erläuterung der Antwortstruktur
Gibt { suggestions[], took } zurück. Jeder Vorschlag hat label, name, city, state, country, countrycode, type, osm_id und point {lat,lng}.
Batch Geocoding API
#Geokodieren Sie bis zu 100 Adressen pro Anfrage. Die Ergebnisse folgen der Eingabereihenfolge. Jede Adresse kostet einen Credit.
/api/1/geocode/batchParameter (Query Params)
| Parameter | Typ | Status | Standard | Beschreibung |
|---|---|---|---|---|
| queries | array | Erforderlich | [] | Array von zu geokodierenden Adressen (max. 100). |
| lang | string | Optional | en | Sprachcode für Ergebnis-Labels. |
| limit | integer | Optional | 1 | Maximale Treffer pro Abfrage (1–5). |
Beispielanfrage
Ersetzen Sie YOUR_KEY durch Ihren API-Schlüssel. API-Anfragen verbrauchen Credits; das Kopieren sendet keine Anfrage.
curl -X POST "https://osrmroute.com/api/1/geocode/batch" \
-H "Authorization: Bearer YOUR_KEY" \
-H "Content-Type: application/json" \
-d '{"queries":["Nizami küçəsi 10","28 May, Bakı"],"lang":"az"}'Limits und Koordinaten
Credit-Kosten: 1 credit / query
Siehe benannte JSON-Felder; diese Anfrage benötigt kein Koordinatenpaar.
- queries: 1–100
- limit: 1–5 / query
- credits = queries.length
Ohne Treffer kann eine erfolgreiche Antwort eine leere Liste liefern. Länder-/Stadtfilter werden nicht erweitert. Adressdetails hängen vom Index ab.
Aktuelle Tarife und PreiseAbdeckung nach DienstJSON-Antwortbeispiel
Gekürztes JSON-Beispiel. Werte, optionale Felder und Kartendaten können abweichen. Entfernungen sind Meter und Routenzeiten Sekunden, sofern nicht anders angegeben.
{
"results": [
{
"query": "Baku",
"hits": [
{
"name": "Nizami Street",
"city": "Baku",
"country": "Azerbaijan",
"countrycode": "AZ",
"point": {
"lat": 40.3777,
"lng": 49.8516
}
}
]
}
],
"count": 1,
"took": 12
}Dienstspezifische Fehler
Korrigieren Sie fehlende oder ungültige Parameter.
{
"error": "Body must include a non-empty \"queries\" array of address strings."
}Korrigieren Sie fehlende oder ungültige Parameter.
{
"error": "A maximum of 100 queries can be geocoded per batch request."
}Erläuterung der Antwortstruktur
Gibt { results[], count, took } zurück. Jedes Ergebnis verknüpft die Eingabe-Query mit einem hits[]-Array; jeder Treffer enthält label, city, country und point {lat,lng}. Die Eingabereihenfolge bleibt erhalten.
Timezone API
#IANA-Zeitzone, aktueller UTC-Offset, Sommerzeit-Status und Ortszeit für jede Koordinate weltweit.
/api/1/timezoneParameter (Query Params)
| Parameter | Typ | Status | Standard | Beschreibung |
|---|---|---|---|---|
| point | string | Optional | - | point=lat,lng oder beide Parameter lat und lon angeben. |
| lat | number | Optional | - | Breitengrad (alternativ zu point). |
| lon | number | Optional | - | Längengrad (alternativ zu point). |
| timestamp | string | Optional | now | Unix-Zeit (Sekunden) oder ISO-Datum für den Offset; Standard ist jetzt. |
Beispielanfrage
Ersetzen Sie YOUR_KEY durch Ihren API-Schlüssel. API-Anfragen verbrauchen Credits; das Kopieren sendet keine Anfrage.
curl "https://osrmroute.com/api/1/timezone?point=40.4093,49.8671" -H "Authorization: Bearer YOUR_KEY"Limits und Koordinaten
Credit-Kosten: 1 credit
point=lat,lng; JSON-Punkte: [lat,lng]. GeoJSON-Geometrie: [lon,lat].
- timestamp: Unix seconds | ISO 8601; default = now
- utc_offset_seconds: seconds
Prüfen Sie Eingabeformat und Einheiten der Beispielwerte.
Aktuelle Tarife und PreiseAbdeckung nach DienstJSON-Antwortbeispiel
Gekürztes JSON-Beispiel. Werte, optionale Felder und Kartendaten können abweichen. Entfernungen sind Meter und Routenzeiten Sekunden, sofern nicht anders angegeben.
{
"timezone": "Asia/Baku",
"point": {
"lat": 40.3777,
"lng": 49.8516
},
"utc_offset": "+04:00",
"utc_offset_seconds": 14400,
"dst": false,
"abbreviation": "GMT+4",
"local_time": "2026-01-01T16:00:00",
"utc_time": "2026-01-01T12:00:00.000Z"
}Dienstspezifische Fehler
Korrigieren Sie fehlende oder ungültige Parameter.
{
"error": "Provide a valid coordinate via point=lat,lng or lat= & lon=."
}Erläuterung der Antwortstruktur
Gibt { timezone, point, utc_offset, utc_offset_seconds, dst, abbreviation, local_time, utc_time } zurück. utc_offset ist ein +HH:MM-String, dst ist true bei Sommerzeit, und local_time ist ein ISO-Zeitstempel mit Zonen-Offset.
Elevation API
#Höhe über dem Meeresspiegel in Metern für jede Koordinate — ein Punkt oder ein ganzes Routenprofil.
/api/1/elevationParameter (Query Params)
| Parameter | Typ | Status | Standard | Beschreibung |
|---|---|---|---|---|
| point | string | Erforderlich | lat,lng | Koordinate als lat,lng. Für jeden Punkt wiederholen (bis 100 bei GET). |
Beispielanfrage
Ersetzen Sie YOUR_KEY durch Ihren API-Schlüssel. API-Anfragen verbrauchen Credits; das Kopieren sendet keine Anfrage.
curl "https://osrmroute.com/api/1/elevation?point=40.4093,49.8671&point=41.30,48.50" -H "Authorization: Bearer YOUR_KEY"Limits und Koordinaten
Credit-Kosten: 1 credit / 10 points
point=lat,lng; JSON-Punkte: [lat,lng]. GeoJSON-Geometrie: [lon,lat].
- GET: point count = 1–100
- POST: points count = 1–1000
- credits = max(1, ceil(points / 10))
- elevation: number | null
- GET with 1 point: elevation alias
Höhen können bei fehlenden Daten null sein. Ersetzen Sie fehlende Werte nicht durch null Meter.
Aktuelle Tarife und PreiseAbdeckung nach DienstJSON-Antwortbeispiel
Gekürztes JSON-Beispiel. Werte, optionale Felder und Kartendaten können abweichen. Entfernungen sind Meter und Routenzeiten Sekunden, sofern nicht anders angegeben.
{
"results": [
{
"point": {
"lat": 40.3777,
"lng": 49.8516
},
"elevation": null
}
],
"unit": "meters"
}Dienstspezifische Fehler
Korrigieren Sie fehlende oder ungültige Parameter.
{
"error": "Provide at least one point=lat,lng (repeatable)."
}Korrigieren Sie fehlende oder ungültige Parameter.
{
"error": "A maximum of 100 points can be queried per GET request; use POST for larger batches."
}Erläuterung der Antwortstruktur
Gibt { results[], unit:"meters" } zurück, wobei jedes Ergebnis { point:{lat,lng}, elevation } ist. elevation ist Meter über dem Meeresspiegel (null wenn unbekannt, 0 über See). Für einen einzelnen Punkt gibt es zusätzlich ein elevation-Feld auf oberster Ebene. Für große Mengen POST { points:[[lat,lng],...] } (bis 1000).
Boundary Lookup API
#Ermitteln Sie, in welchem Land, Bundesland, welcher Stadt und welchem Bezirk eine Koordinate liegt — auf Wunsch mit Grenzpolygon.
/api/1/boundaryParameter (Query Params)
| Parameter | Typ | Status | Standard | Beschreibung |
|---|---|---|---|---|
| point | string | Erforderlich | lat,lng | Koordinate als lat,lng. |
| polygon | boolean | Optional | false | true, um die Grenze zusätzlich als GeoJSON zurückzugeben. |
| lang | string | Optional | en | Sprachcode für Ortsnamen. |
Beispielanfrage
Ersetzen Sie YOUR_KEY durch Ihren API-Schlüssel. API-Anfragen verbrauchen Credits; das Kopieren sendet keine Anfrage.
curl "https://osrmroute.com/api/1/boundary?point=40.4093,49.8671" -H "Authorization: Bearer YOUR_KEY"Limits und Koordinaten
Credit-Kosten: 1 credit
point=lat,lng; JSON-Punkte: [lat,lng]. GeoJSON-Geometrie: [lon,lat].
- polygon: true | false
- HTTP 422: BoundaryCoverageUnavailable
Detaillierte Grenzen sind nur in akzeptierten regionalen Datensätzen verfügbar. Sonst wird BoundaryCoverageUnavailable zurückgegeben.
Aktuelle Tarife und PreiseAbdeckung nach DienstJSON-Antwortbeispiel
Gekürztes JSON-Beispiel. Werte, optionale Felder und Kartendaten können abweichen. Entfernungen sind Meter und Routenzeiten Sekunden, sofern nicht anders angegeben.
{
"point": {
"lat": 40.3777,
"lng": 49.8516
},
"display_name": "Baku, Azerbaijan",
"boundary_scope": "city",
"country": "Azerbaijan",
"countrycode": "AZ",
"city": "Baku",
"boundary": {
"type": "Polygon",
"coordinates": [
[
[
49.84,
40.37
],
[
49.87,
40.37
],
[
49.87,
40.4
],
[
49.84,
40.37
]
]
]
}
}Dienstspezifische Fehler
Korrigieren Sie fehlende oder ungültige Parameter.
{
"error": "Provide a valid coordinate via point=lat,lng or lat= & lon=."
}Hier fehlen detaillierte Verwaltungsdaten. Siehe Abdeckung.
{
"code": "BoundaryCoverageUnavailable",
"error": "Detailed administrative boundary data is not available at this coordinate."
}Erläuterung der Antwortstruktur
Gibt { point, display_name, country, countrycode, state, county, city, district, postcode, osm_id, osm_type } zurück und bei polygon=true eine GeoJSON-Grenzgeometrie.
Geofencing API
#Prüfen Sie in einem Aufruf, in welche Ihrer Zonen jeder Punkt fällt — Polygon- oder Kreiszäune.
/api/1/geofenceParameter (Query Params)
| Parameter | Typ | Status | Standard | Beschreibung |
|---|---|---|---|---|
| fences | array | Erforderlich | [] | Array von Zäunen: { id?, polygon:[[lat,lng],...] } oder { id?, center:[lat,lng], radius_m }. Bis zu 100. |
| points | array | Erforderlich | [] | Array von [lat,lng]-Punkten (bis 1000). |
Beispielanfrage
Ersetzen Sie YOUR_KEY durch Ihren API-Schlüssel. API-Anfragen verbrauchen Credits; das Kopieren sendet keine Anfrage.
curl -X POST "https://osrmroute.com/api/1/geofence" \
-H "Authorization: Bearer YOUR_KEY" \
-H "Content-Type: application/json" \
-d '{"fences":[{"id":"zone1","polygon":[[40.40,49.85],[40.43,49.85],[40.43,49.90],[40.40,49.90]]}],"points":[[40.41,49.87],[40.50,50.10]]}'Limits und Koordinaten
Credit-Kosten: 1 credit / 100 points
point=lat,lng; JSON-Punkte: [lat,lng]. GeoJSON-Geometrie: [lon,lat].
- fences: 1–100
- points: 1–1000
- credits = max(1, ceil(points / 100))
Prüfen Sie Eingabeformat und Einheiten der Beispielwerte.
Aktuelle Tarife und PreiseAbdeckung nach DienstJSON-Antwortbeispiel
Gekürztes JSON-Beispiel. Werte, optionale Felder und Kartendaten können abweichen. Entfernungen sind Meter und Routenzeiten Sekunden, sofern nicht anders angegeben.
{
"results": [
{
"point": {
"lat": 40.3777,
"lng": 49.8516
},
"inside": [
"depot"
]
}
],
"count": 1,
"took": 1
}Dienstspezifische Fehler
Korrigieren Sie fehlende oder ungültige Parameter.
{
"error": "Body must include non-empty \"fences\" and \"points\" arrays."
}Korrigieren Sie fehlende oder ungültige Parameter.
{
"error": "Limits: up to 100 fences and 1000 points per request."
}Erläuterung der Antwortstruktur
Gibt { results[], count } zurück. Jedes Ergebnis ist { point:{lat,lng}, inside:[fenceId,...] } mit allen Zäunen, in denen der Punkt liegt (leer, wenn keiner).
Elevation Profile API
#Höhe an jedem Punkt eines Pfades plus Gesamtanstieg, Abstieg und Distanz — ein komplettes Routenprofil.
/api/1/elevation/profileParameter (Query Params)
| Parameter | Typ | Status | Standard | Beschreibung |
|---|---|---|---|---|
| points | array | Optional | [] | Array von [lat,lng]-Punkten des Pfades (>=2, bis 2000). |
| polyline | string | Optional | - | Codierte Polyline statt points. |
Beispielanfrage
Ersetzen Sie YOUR_KEY durch Ihren API-Schlüssel. API-Anfragen verbrauchen Credits; das Kopieren sendet keine Anfrage.
curl -X POST "https://osrmroute.com/api/1/elevation/profile" \
-H "Authorization: Bearer YOUR_KEY" \
-H "Content-Type: application/json" \
-d '{"points":[[40.37,49.85],[40.80,48.90],[41.30,48.05]]}'Limits und Koordinaten
Credit-Kosten: 1 credit / 10 points
point=lat,lng; JSON-Punkte: [lat,lng]. GeoJSON-Geometrie: [lon,lat].
- points: 2–2000
- credits = max(1, ceil(points / 10))
- elevation: number | null
Höhen können bei fehlenden Daten null sein. Ersetzen Sie fehlende Werte nicht durch null Meter.
Aktuelle Tarife und PreiseAbdeckung nach DienstJSON-Antwortbeispiel
Gekürztes JSON-Beispiel. Werte, optionale Felder und Kartendaten können abweichen. Entfernungen sind Meter und Routenzeiten Sekunden, sofern nicht anders angegeben.
{
"profile": [
{
"point": {
"lat": 40.3777,
"lng": 49.8516
},
"elevation": null,
"distance": 0
},
{
"point": {
"lat": 40.4,
"lng": 49.86
},
"elevation": null,
"distance": 2590
}
],
"total_ascent": 0,
"total_descent": 0,
"min_elevation": null,
"max_elevation": null,
"distance": 2590,
"unit": "meters",
"took": 12
}Dienstspezifische Fehler
Korrigieren Sie fehlende oder ungültige Parameter.
{
"error": "Provide a \"points\" array (>=2 [lat,lng]) or an encoded \"polyline\"."
}Korrigieren Sie fehlende oder ungültige Parameter.
{
"error": "A maximum of 2000 points is allowed per request."
}Erläuterung der Antwortstruktur
Gibt { profile[], total_ascent, total_descent, min_elevation, max_elevation, distance, unit } zurück. Jedes Element { point, elevation, distance } (Meter).
Solar API
#Sonnenauf-/-untergang, Dämmerung, Sonnenmittag und Tageslänge für jede Koordinate und jedes Datum.
/api/1/solarParameter (Query Params)
| Parameter | Typ | Status | Standard | Beschreibung |
|---|---|---|---|---|
| point | string | Erforderlich | lat,lng | Koordinate als lat,lng. |
| date | string | Optional | today | Datum (YYYY-MM-DD) für die Berechnung; Standard heute. |
Beispielanfrage
Ersetzen Sie YOUR_KEY durch Ihren API-Schlüssel. API-Anfragen verbrauchen Credits; das Kopieren sendet keine Anfrage.
curl "https://osrmroute.com/api/1/solar?point=40.4093,49.8671&date=2026-07-07" -H "Authorization: Bearer YOUR_KEY"Limits und Koordinaten
Credit-Kosten: 1 credit
point=lat,lng; JSON-Punkte: [lat,lng]. GeoJSON-Geometrie: [lon,lat].
- date: YYYY-MM-DD; default = today
- times: UTC ISO 8601 | null
Bei Polartag oder Polarnacht können Sonnenzeiten null sein. Zeiten sind UTC.
Aktuelle Tarife und PreiseAbdeckung nach DienstJSON-Antwortbeispiel
Gekürztes JSON-Beispiel. Werte, optionale Felder und Kartendaten können abweichen. Entfernungen sind Meter und Routenzeiten Sekunden, sofern nicht anders angegeben.
{
"point": {
"lat": 40.3777,
"lng": 49.8516
},
"date": "2026-01-01",
"sunrise": "2026-01-01T04:00:00.000Z",
"sunset": "2026-01-01T13:00:00.000Z",
"solar_noon": "2026-01-01T08:30:00.000Z",
"day_length_seconds": 32400
}Dienstspezifische Fehler
Korrigieren Sie fehlende oder ungültige Parameter.
{
"error": "Provide a valid coordinate via point=lat,lng or lat= & lon=."
}Erläuterung der Antwortstruktur
Gibt { point, date, sunrise, sunset, solar_noon, dawn, dusk, golden_hour, night_start, night_end, day_length_seconds } zurück. Zeiten als UTC-ISO; null bei Polartag/-nacht.
Geometry Utilities API
#Distanz, Peilung, Fläche, Schwerpunkt, Vereinfachung und Polyline-Encode/Decode — Geometrie als Service.
/api/1/geometryParameter (Query Params)
| Parameter | Typ | Status | Standard | Beschreibung |
|---|---|---|---|---|
| op | string | Erforderlich | distance | Operation: distance, bearing, destination, midpoint, length, area, centroid, simplify, polyline_encode oder polyline_decode. |
| from | array | Optional | [lat,lng] | Startpunkt [lat,lng]. |
| to | array | Optional | [lat,lng] | Endpunkt [lat,lng]. |
| path | array | Optional | [] | Array von [lat,lng] (length/simplify/polyline_encode). |
| polygon | array | Optional | [] | [lat,lng]-Ring (area). |
distance, bearing, midpoint → from, to
destination → from, bearing (°), distance_m
length → path (≥ 2)
area → polygon (≥ 3)
centroid → points (≥ 1)
simplify → path (2–2000), tolerance_m (10)
polyline_encode → path (≥ 1), precision (5)
polyline_decode → polyline, precision (5)Beispielanfrage
Ersetzen Sie YOUR_KEY durch Ihren API-Schlüssel. API-Anfragen verbrauchen Credits; das Kopieren sendet keine Anfrage.
curl -X POST "https://osrmroute.com/api/1/geometry" \
-H "Authorization: Bearer YOUR_KEY" \
-H "Content-Type: application/json" \
-d '{"op":"distance","from":[40.37,49.85],"to":[40.40,49.86]}'Limits und Koordinaten
Credit-Kosten: 1 credit
point=lat,lng; JSON-Punkte: [lat,lng]. GeoJSON-Geometrie: [lon,lat].
- op: distance | bearing | destination | midpoint | length | area | centroid | simplify | polyline_encode | polyline_decode
Prüfen Sie Eingabeformat und Einheiten der Beispielwerte.
Aktuelle Tarife und PreiseAbdeckung nach DienstJSON-Antwortbeispiel
Gekürztes JSON-Beispiel. Werte, optionale Felder und Kartendaten können abweichen. Entfernungen sind Meter und Routenzeiten Sekunden, sofern nicht anders angegeben.
{
"op": "distance",
"distance": 2590.25,
"unit": "meters"
}Dienstspezifische Fehler
Korrigieren Sie fehlende oder ungültige Parameter.
{
"error": "Invalid geometry input for the requested op."
}Erläuterung der Antwortstruktur
Gibt { op, ... } mit dem Ergebnis der Operation zurück, z. B. { distance, unit }, { bearing_deg }, { point }, { area, unit }, { path } oder { polyline }.
Coordinate Conversion API
#Breite/Länge in UTM- und MGRS-Gitterreferenzen und zurück umwandeln.
/api/1/convertParameter (Query Params)
| Parameter | Typ | Status | Standard | Beschreibung |
|---|---|---|---|---|
| point | string | Optional | lat,lng | Koordinate lat,lng zur Umwandlung in UTM/MGRS. |
| mgrs | string | Optional | - | MGRS-String zur Rückumwandlung in eine Koordinate. |
point=lat,lng, lat und lon zusammen oder mgrs angeben. Ein nicht leeres mgrs hat Vorrang. Die Rückumrechnung liefert den Mittelpunkt der MGRS-Zelle ohne das Feld utm.
Beispielanfrage
Ersetzen Sie YOUR_KEY durch Ihren API-Schlüssel. API-Anfragen verbrauchen Credits; das Kopieren sendet keine Anfrage.
curl "https://osrmroute.com/api/1/convert?point=40.3755,49.8516" -H "Authorization: Bearer YOUR_KEY"Limits und Koordinaten
Credit-Kosten: 1 credit
point=lat,lng; JSON-Punkte: [lat,lng]. GeoJSON-Geometrie: [lon,lat].
- point=lat,lng OR (lat=... AND lon=...) OR mgrs=...
Prüfen Sie Eingabeformat und Einheiten der Beispielwerte.
Aktuelle Tarife und PreiseAbdeckung nach DienstJSON-Antwortbeispiel
Gekürztes JSON-Beispiel. Werte, optionale Felder und Kartendaten können abweichen. Entfernungen sind Meter und Routenzeiten Sekunden, sofern nicht anders angegeben.
{
"point": {
"lat": 40.3755,
"lng": 49.8516
},
"mgrs": "39TVE0251070068",
"utm": {
"zone": 39,
"band": "T",
"easting": 402511,
"northing": 4470068,
"hemisphere": "N"
}
}Dienstspezifische Fehler
Korrigieren Sie fehlende oder ungültige Parameter.
{
"error": "Provide point=lat,lng (or lat= & lon=), or mgrs= to reverse-convert."
}Erläuterung der Antwortstruktur
Gibt { point, mgrs, utm:{ zone, band, easting, northing, hemisphere } } zurück. Bei mgrs= { mgrs, point }.
Country Info API
#Währung, Vorwahl, Sprachen, Hauptstadt und Flagge jedes Landes per ISO-Code oder Name.
/api/1/countryParameter (Query Params)
| Parameter | Typ | Status | Standard | Beschreibung |
|---|---|---|---|---|
| code | string | Optional | AZ | ISO-3166-Alpha-2- oder Alpha-3-Ländercode (z. B. AZ oder AZE). |
| name | string | Optional | - | Ländername statt Code. |
Beispielanfrage
Ersetzen Sie YOUR_KEY durch Ihren API-Schlüssel. API-Anfragen verbrauchen Credits; das Kopieren sendet keine Anfrage.
curl "https://osrmroute.com/api/1/country?code=AZ" -H "Authorization: Bearer YOUR_KEY"Limits und Koordinaten
Credit-Kosten: 1 credit
Siehe benannte JSON-Felder; diese Anfrage benötigt kein Koordinatenpaar.
- code=ISO2/ISO3 OR name=...
Prüfen Sie Eingabeformat und Einheiten der Beispielwerte.
Aktuelle Tarife und PreiseAbdeckung nach DienstJSON-Antwortbeispiel
Gekürztes JSON-Beispiel. Werte, optionale Felder und Kartendaten können abweichen. Entfernungen sind Meter und Routenzeiten Sekunden, sofern nicht anders angegeben.
{
"name": "Azerbaijan",
"official_name": "Republic of Azerbaijan",
"cca2": "AZ",
"cca3": "AZE",
"capital": "Baku",
"region": "Asia",
"subregion": "Western Asia",
"currency": {
"code": "AZN",
"name": "Azerbaijani manat",
"symbol": "₼"
},
"calling_code": "+994",
"languages": [
"Azerbaijani"
],
"flag": "🇦🇿",
"latlng": [
40.5,
47.5
]
}Dienstspezifische Fehler
Korrigieren Sie fehlende oder ungültige Parameter.
{
"error": "Provide code=ISO2/ISO3 or name=CountryName."
}Verwenden Sie einen gültigen Ländercode oder exakten Ländernamen.
{
"error": "Country not found."
}Erläuterung der Antwortstruktur
Gibt { name, official_name, cca2, cca3, capital, region, subregion, currency:{code,name,symbol}, calling_code, languages[], flag, latlng } zurück.
Isochrone API
#Schätzt die Erreichbarkeit anhand der Fahrzeiten zu Stichprobenpunkten. Ist in jeder Richtung ein Punkt erreichbar, lautet quality.status estimated; andernfalls insufficient_data und polygons ist leer. Ein leeres Ergebnis beweist nicht, dass keine Straßen erreichbar sind. Die Grenze ist eine Näherung; nur Zeitlimits werden unterstützt.
/api/1/isochroneParameter (Query Params)
| Parameter | Typ | Status | Standard | Beschreibung |
|---|---|---|---|---|
| point | string | Erforderlich | - | Mittelpunkt. Format: lat,lon. |
| time_limit | integer | Optional | 600 | Fahrzeitlimit (in Sekunden). |
Beispielanfrage
Ersetzen Sie YOUR_KEY durch Ihren API-Schlüssel. API-Anfragen verbrauchen Credits; das Kopieren sendet keine Anfrage.
curl "https://osrmroute.com/api/1/isochrone?point=40.4093,49.8671&time_limit=600" -H "Authorization: Bearer YOUR_KEY"Limits und Koordinaten
Credit-Kosten: 2 credits / minute; minimum 10
point=lat,lng; JSON-Punkte: [lat,lng]. GeoJSON-Geometrie: [lon,lat].
- time_limit: min = 60 s
- time_limit ≤ plan.maxIsochroneMinutes × 60
- quality.status = estimated | insufficient_data; polygons = [] when any bearing lacks a reachable sample
- Sampled OSRM estimate, not an exact reachable-area boundary; an empty polygon does not prove no reachable roads
- credits = max(10, ceil(time_limit_seconds / 30))
Auto-, Fuß- und Fahrradrouten sind weltweit verfügbar. Punkte müssen über zugängliche Wege verbunden sein. VRP ist heuristisch, Isochronen sind Näherungen; ein globales Optimum oder Live-Verkehr wird nicht zugesichert.
Aktuelle Tarife und PreiseAbdeckung nach DienstJSON-Antwortbeispiel
Gekürztes JSON-Beispiel. Werte, optionale Felder und Kartendaten können abweichen. Entfernungen sind Meter und Routenzeiten Sekunden, sofern nicht anders angegeben.
{
"quality": {
"status": "estimated",
"method": "sampled_osrm",
"sampled_points": 80,
"reachable_points": 48,
"covered_bearings": 16,
"total_bearings": 16,
"unknown_points": 0
},
"polygons": [
{
"type": "Feature",
"properties": {
"bucket": 0,
"time_limit": 600
},
"geometry": {
"type": "Polygon",
"coordinates": [
[
[
49.84,
40.37
],
[
49.87,
40.37
],
[
49.87,
40.4
],
[
49.84,
40.37
]
]
]
}
}
]
}Dienstspezifische Fehler
Korrigieren Sie fehlende oder ungültige Parameter.
{
"error": "point parameter is required"
}Komplexitätslimits und Schlüsselbeschränkungen im Dashboard prüfen.
{
"error": "The Isochrone API is not available on your plan. Upgrade your plan to use it."
}Wählen Sie ein unterstütztes Profil. Kein automatischer Wechsel auf Autorouten.
{
"code": "ProfileNotAvailable",
"error": "This travel profile is not available at one or more coordinates. No driving fallback was used."
}Dienst oder Datenquelle nicht verfügbar. Vorsichtig mit längeren Pausen wiederholen.
{
"code": "RoutingTimeout",
"error": "The routing service did not respond within the request deadline. Retry later."
}Erläuterung der Antwortstruktur
polygons[] — GeoJSON Feature; geometry — Polygon [lon,lat]; properties.time_limit — Zeitgrenze (s).
Route Optimization API
#Plant Flottenrouten unter Berücksichtigung von Kapazitäten, Zeitfenstern, Fähigkeiten und verknüpften Abholungen/Zustellungen. Eine zeitlich begrenzte Heuristik reduziert die Fahrzeit ohne Garantie eines globalen Optimums. Nicht zugewiesene Aufgaben bleiben in solution.unassigned; ungültige Eingaben werden vollständig abgelehnt.
/api/1/vrpParameter (Query Params)
| Parameter | Typ | Status | Standard | Beschreibung |
|---|---|---|---|---|
| vehicles | array | Optional | one default vehicle | Die Liste der Fahrzeuge — jeweils mit id, optionaler Kapazität und einem Startort als [lon, lat]-Array (Länge zuerst). |
| services | array | Optional | [] | Die anzufahrenden Stopps — jeweils mit id, einem Standort als [lon, lat]-Array (Länge zuerst) und optionaler Servicezeit. |
| shipments | array | Optional | [] | Verknüpfte Abhol- und Zustellaufgaben mit amount und skills. services, shipments oder beide angeben; höchstens 250 Aufgabenpunkte. |
| profile | string | Optional | driving | Gemeinsames Verkehrsprofil: driving, cycling oder walking, einschließlich dokumentierter Alternativnamen. |
Beispielanfrage
Ersetzen Sie YOUR_KEY durch Ihren API-Schlüssel. API-Anfragen verbrauchen Credits; das Kopieren sendet keine Anfrage.
curl -X POST "https://osrmroute.com/api/1/vrp" \
-H "Authorization: Bearer YOUR_KEY" \
-H "Content-Type: application/json" \
-d '{"vehicles":[{"vehicle_id":"v1","start":[49.85,40.37]}],"services":[{"id":10,"location":[49.86,40.40]}]}'Limits und Koordinaten
Credit-Kosten: max(10, ceil(vehicles * task_points * 13 / 15)) credits
VRP-Arrays start/location: [lon,lat]; Objekte: lat und lng/lon. Zeit in Sekunden.
- vehicles.length ≤ plan.maxVehicles
- vehicles defaults to one vehicle when omitted
- services.length + 2 × shipments.length ≤ 250; vehicles.length ≤ 100
- task_points = services.length + 2 × shipments.length
- credits = max(10, ceil(vehicles * task_points * 13 / 15)); invalid inputs are refunded
- Capacity arrays, time_windows, skills and paired shipments are enforced; unsupported options return 400
- solution.unassigned lists tasks not assigned by the bounded heuristic; this is not proof of infeasibility
- transport_time is travel only; service_time, waiting_time and elapsed time are separate; costs is travel seconds
Auto-, Fuß- und Fahrradrouten sind weltweit verfügbar. Punkte müssen über zugängliche Wege verbunden sein. VRP ist heuristisch, Isochronen sind Näherungen; ein globales Optimum oder Live-Verkehr wird nicht zugesichert.
Aktuelle Tarife und PreiseAbdeckung nach DienstJSON-Antwortbeispiel
Gekürztes JSON-Beispiel. Werte, optionale Felder und Kartendaten können abweichen. Entfernungen sind Meter und Routenzeiten Sekunden, sofern nicht anders angegeben.
{
"status": "finished",
"job_id": "opt-1234567890",
"processing_time": 0,
"solution": {
"unassigned": [],
"quality": {
"solver": "vroom",
"version": "1.15.0",
"constraints_verified": true,
"optimality_proven": false
},
"costs": 420,
"distance": 3200,
"time": 420,
"no_vehicles": 1,
"no_unassigned": 0,
"routes": [
{
"vehicle_id": "v1",
"distance": 3200,
"transport_time": 420,
"activities": [
{
"type": "start",
"location_id": "depot",
"end_time": 0
},
{
"type": "service",
"id": 10,
"location_id": "stop_1",
"arr_time": 200,
"end_time": 200
},
{
"type": "end",
"location_id": "depot",
"arr_time": 420
}
]
}
]
}
}Dienstspezifische Fehler
Korrigieren Sie fehlende oder ungültige Parameter.
{
"code": "InvalidOptimizationInput",
"error": "At least one service with valid coordinates is required."
}Komplexitätslimits und Schlüsselbeschränkungen im Dashboard prüfen.
{
"error": "Your plan allows up to 1 vehicles per request. Upgrade your plan for more."
}Prüfen Sie, ob die Punkte nahe an zugänglichen Straßen liegen und diese für das gewählte Profil verbunden sind.
{
"code": "NoNearbyRoad",
"error": "No connected route within 2000 metres of the requested coordinates."
}Erläuterung der Antwortstruktur
status → finished; job_id — Auftrags-ID; solution: distance — Entfernung (m), time und costs — Zeit (s), no_vehicles, no_unassigned — Anzahlen, routes[] — Routen. routes[]: vehicle_id, distance (m), transport_time (s), activities[] — Aktivitäten.
Location Clustering API
#Gruppiert (clustert) gegebene Koordinaten nach ihrer geografischen Nähe und Dichte.
/api/1/clusterParameter (Query Params)
| Parameter | Typ | Status | Standard | Beschreibung |
|---|---|---|---|---|
| customers | array | Erforderlich | [] | Kundenkoordinaten und Gewichte, die geclustert werden sollen. |
Beispielanfrage
Ersetzen Sie YOUR_KEY durch Ihren API-Schlüssel. API-Anfragen verbrauchen Credits; das Kopieren sendet keine Anfrage.
curl -X POST "https://osrmroute.com/api/1/cluster" \
-H "Authorization: Bearer YOUR_KEY" \
-H "Content-Type: application/json" \
-d '{"customers":[[49.85,40.37],[49.86,40.40],[49.83,40.39]],"clusters":2}'Limits und Koordinaten
Credit-Kosten: 3 credits
Kundenkoordinaten als Eingabe: [lon,lat]; Clusterzentrum als Ausgabe: [lat,lon].
- customers: valid coordinates ≥ 1
- 1 ≤ clusters ≤ valid_customers.length
Prüfen Sie Eingabeformat und Einheiten der Beispielwerte.
Aktuelle Tarife und PreiseAbdeckung nach DienstJSON-Antwortbeispiel
Gekürztes JSON-Beispiel. Werte, optionale Felder und Kartendaten können abweichen. Entfernungen sind Meter und Routenzeiten Sekunden, sofern nicht anders angegeben.
{
"status": "finished",
"job_id": "cluster-1234567890",
"processing_time": 0,
"no_clusters": 1,
"clusters": [
{
"ids": [
"s1",
"s2"
],
"center": [
40.385,
49.855
],
"size": 2
}
]
}Dienstspezifische Fehler
Korrigieren Sie fehlende oder ungültige Parameter.
{
"error": "Provide a \"customers\" array with valid coordinates."
}Erläuterung der Antwortstruktur
status → finished; job_id — Auftrags-ID; no_clusters — Clusterzahl; clusters[]: ids[] — Elemente, center [lat,lon] — Mittelpunkt, size — Größe.
Kompatibilitätsendpunkte
Prüfen Sie bei bestehenden Integrationen vor dem Wechsel Koordinatenreihenfolge und Antwort-Einheiten.
Die Routing-Kurzform entspricht der regulären OSRM-Route. Die ältere Route-API nimmt wiederholte Breiten-/Längengrad-Paare an. paths[].time steht in Millisekunden, paths[].distance in Metern. Route info beschreibt die konfigurierte Abdeckung und kostet einen Credit.
GET /api/v1/route/driving/49.8516,40.3755;49.8378,40.3892
GET /api/1/route?point=40.3755,49.8516&point=40.3892,49.8378
GET /api/1/route/infoDie ältere Matrix-API nimmt wiederholte point-Einträge oder getrennte from_point- und to_point-Listen an. JSON verwendet from_points und to_points als Breiten-/Längengrad-Paare. Zeiten sind Millisekunden, Entfernungen Meter.
GET /api/1/matrix?point=40.3755,49.8516&point=40.3892,49.8378{"from_points":[[40.3755,49.8516]],"to_points":[[40.3892,49.8378]]}Die ältere Match-API nimmt eine GPS-Spur als [lon, lat] an. Optional je Punkt Zeitstempel in Sekunden und Radius in Metern. Entfernungen sind Meter, Zeiten Millisekunden. Die Höhenabfrage nimmt bis zu 1.000 Paare an und liefert Meter oder null.
{"points":[[49.8516,40.3755],[49.8378,40.3892]],"timestamps":[1760000000,1760000120],"radiuses":[20,20]}{"points":[[40.3755,49.8516],[40.3892,49.8378]]}optimize und vrp/optimize verwenden das VRP-Format. Die Aliase für Cluster und Batch-Geocoding verwenden die jeweiligen Standardformate. VRP und Cluster liefern das Ergebnis direkt in der Antwort.
POST /api/1/optimize·POST /api/1/vrp/optimize→ Route Optimization APIPOST /api/1/cluster/calculate→ Location Clustering APIPOST /api/1/batch-geocode→ Batch Geocoding API
Offizielle SDKs
Kotlin für Android/JVM und Swift für iOS. Geografische OSRMRoute-APIs mit typisierten Modellen und asynchronen Anfragen.