osrmroute
API-Dokumentation, SDKs und IntegrationsleitfädenIntegration und Migration
OSRMRoute / API

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.

OpenAPI · Postman

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/info
    Alle 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.

HTTP
Authorization: Bearer YOUR_API_KEY

Fehlercodes

#

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-After

Gültigen API-Schlüssel angeben und Status im Dashboard prüfen.

HTTP 401
{
  "error": "Invalid API Key"
}

Guthaben aufladen oder passenden Tarif wählen.

HTTP 402
{
  "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.

HTTP 403
{
  "error": "This API Key is disabled"
}

Retry-After beachten und Anfragen seltener senden.

HTTP 429
{
  "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.

HTTP 500
{
  "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.

GET
/api/v1/osrm/route/v1/{profile}/{coordinates}

Parameter (Query Params)

ParameterTypStatusStandardBeschreibung
profilestringErforderlichdrivingTransportmodus-Profil. Unterstützte Werte: driving (Auto), cycling (Fahrrad), walking (Fußgänger).
coordinatesstringErforderlich-Koordinaten der Punkte. Format: lon,lat;lon,lat;lon,lat... (mindestens 2 Punkte).
overviewstringOptionalsimplifiedDetailgrad der zurückgegebenen Routengeometrie: simplified (vereinfacht), full (vollständige Geometrie), false (ohne Geometrie).
geometriesstringOptionalpolylineGeometrieformat: geojson (GeoJSON-Objekt), polyline (kodierte Zeichenfolge).
stepsbooleanOptionalfalseOb für jede Abbiegung Schritt-für-Schritt-Anweisungen zurückgegeben werden.
alternativesinteger | booleanOptionalfalseAnzahl 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.

Routing API
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 Dienst

JSON-Antwortbeispiel

Gekürztes JSON-Beispiel. Werte, optionale Felder und Kartendaten können abweichen. Entfernungen sind Meter und Routenzeiten Sekunden, sofern nicht anders angegeben.

HTTP 200 · application/json
{
  "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.

HTTP 400
{
  "code": "InvalidQuery",
  "error": "Coordinates must be finite longitude,latitude pairs."
}

Wählen Sie ein unterstütztes Profil. Kein automatischer Wechsel auf Autorouten.

HTTP 422
{
  "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.

HTTP 422
{
  "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.

HTTP 422
{
  "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.

HTTP 504
{
  "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.

GET
/api/v1/osrm/table/v1/{profile}/{coordinates}

Parameter (Query Params)

ParameterTypStatusStandardBeschreibung
profilestringErforderlichdrivingTransportprofil (driving, cycling, walking).
coordinatesstringErforderlich-Matrixpunkte. Format: lon,lat;lon,lat;lon,lat...
annotationsstringOptionaldurationZu berechnende Daten: duration (Zeit), distance (Distanz) oder beides.
sourcesstringOptionalallBei null beginnende Startindizes, durch Semikolons getrennt, oder all.
destinationsstringOptionalallBei 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.

Matrix API
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 Dienst

JSON-Antwortbeispiel

Gekürztes JSON-Beispiel. Werte, optionale Felder und Kartendaten können abweichen. Entfernungen sind Meter und Routenzeiten Sekunden, sofern nicht anders angegeben.

HTTP 200 · application/json
{
  "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.

HTTP 400
{
  "code": "InvalidQuery",
  "error": "Coordinates must be finite longitude,latitude pairs."
}

Wählen Sie ein unterstütztes Profil. Kein automatischer Wechsel auf Autorouten.

HTTP 422
{
  "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.

HTTP 422
{
  "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.

HTTP 422
{
  "code": "UnreachablePoints",
  "error": "Some locations are disconnected in this road network."
}

Dienst oder Datenquelle nicht verfügbar. Vorsichtig mit längeren Pausen wiederholen.

HTTP 504
{
  "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.

GET
/api/v1/osrm/match/v1/{profile}/{coordinates}

Parameter (Query Params)

ParameterTypStatusStandardBeschreibung
geometriesstringOptionalpolylineGeometrieformat: geojson (GeoJSON-Objekt), polyline (kodierte Zeichenfolge).
profilestringErforderlichdrivingTransportprofil.
coordinatesstringErforderlich-Die Folge von GPS-Koordinaten zum Zuordnen (lon,lat;lon,lat...)
overviewstringOptionalsimplifiedGeometriegenauigkeit der zugeordneten Route.
timestampsstringOptional-Nicht absteigende Unix-Zeitstempel in Sekunden, einer pro Punkt, durch Semikolons getrennt.
radiusesstringOptional-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.

Map Matching API
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 Dienst

JSON-Antwortbeispiel

Gekürztes JSON-Beispiel. Werte, optionale Felder und Kartendaten können abweichen. Entfernungen sind Meter und Routenzeiten Sekunden, sofern nicht anders angegeben.

HTTP 200 · application/json
{
  "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.

HTTP 400
{
  "code": "InvalidQuery",
  "error": "Coordinates must be finite longitude,latitude pairs."
}

Wählen Sie ein unterstütztes Profil. Kein automatischer Wechsel auf Autorouten.

HTTP 422
{
  "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.

HTTP 422
{
  "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.

HTTP 422
{
  "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.

HTTP 504
{
  "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.

GET
/api/v1/osrm/nearest/v1/{profile}/{coordinates}

Parameter (Query Params)

ParameterTypStatusStandardBeschreibung
profilestringErforderlichdrivingTransportprofil.
coordinatesstringErforderlich-Der Punkt, in dessen Nähe gesucht wird. Format: lon,lat (ein einzelnes Paar).
numberintegerOptional1Die 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.

Nearest API
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 Dienst

JSON-Antwortbeispiel

Gekürztes JSON-Beispiel. Werte, optionale Felder und Kartendaten können abweichen. Entfernungen sind Meter und Routenzeiten Sekunden, sofern nicht anders angegeben.

HTTP 200 · application/json
{
  "code": "Ok",
  "waypoints": [
    {
      "name": "Example road",
      "location": [
        49.8516,
        40.3777
      ],
      "distance": 4.2
    }
  ]
}
Dienstspezifische Fehler

Korrigieren Sie fehlende oder ungültige Parameter.

HTTP 400
{
  "code": "InvalidQuery",
  "error": "Coordinates must be finite longitude,latitude pairs."
}

Wählen Sie ein unterstütztes Profil. Kein automatischer Wechsel auf Autorouten.

HTTP 422
{
  "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.

HTTP 422
{
  "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.

HTTP 504
{
  "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.

GET
/api/v1/osrm/trip/v1/{profile}/{coordinates}

Parameter (Query Params)

ParameterTypStatusStandardBeschreibung
geometriesstringOptionalpolylineGeometrieformat: geojson (GeoJSON-Objekt), polyline (kodierte Zeichenfolge).
profilestringErforderlichdrivingTransportprofil.
coordinatesstringErforderlich-Zu besuchende Punkte. Format: lon,lat;lon,lat...
sourcestringOptionalanyDer Punkt, an dem die Route beginnen kann (any oder der erste Punkt).
destinationstringOptionalanyDer Punkt, an dem die Route endet (any oder der letzte Punkt).
roundtripbooleanOptionaltrueZum 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.

Trip API (TSP)
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 Dienst

JSON-Antwortbeispiel

Gekürztes JSON-Beispiel. Werte, optionale Felder und Kartendaten können abweichen. Entfernungen sind Meter und Routenzeiten Sekunden, sofern nicht anders angegeben.

HTTP 200 · application/json
{
  "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.

HTTP 400
{
  "code": "InvalidQuery",
  "error": "Coordinates must be finite longitude,latitude pairs."
}

Wählen Sie ein unterstütztes Profil. Kein automatischer Wechsel auf Autorouten.

HTTP 422
{
  "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.

HTTP 422
{
  "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.

HTTP 422
{
  "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.

HTTP 504
{
  "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.

GET
/api/1/directions

Parameter (Query Params)

ParameterTypStatusStandardBeschreibung
pointstringErforderlichlat,lngWegpunkt als lat,lng. Parameter für jeden Stopp wiederholen (mindestens 2).
profilestringOptionaldrivingFortbewegungsart: driving, cycling oder walking.
alternativesintegerOptional0Anzahl zusätzlich zurückgegebener Alternativrouten (0–3).
langstringOptionalenSprachcode für den Anweisungstext.

Beispielanfrage

Ersetzen Sie YOUR_KEY durch Ihren API-Schlüssel. API-Anfragen verbrauchen Credits; das Kopieren sendet keine Anfrage.

Directions API
curl "https://osrmroute.com/api/1/directions?point=40.3777,49.8516&point=40.40,49.86&profile=driving" -H "Authorization: Bearer YOUR_KEY"
Alternative Routes API
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 Dienst

JSON-Antwortbeispiel

Gekürztes JSON-Beispiel. Werte, optionale Felder und Kartendaten können abweichen. Entfernungen sind Meter und Routenzeiten Sekunden, sofern nicht anders angegeben.

HTTP 200 · application/json
{
  "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.

HTTP 400
{
  "error": "At least two points must be provided (point=lat,lng repeated)."
}

Wählen Sie ein unterstütztes Profil. Kein automatischer Wechsel auf Autorouten.

HTTP 422
{
  "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.

HTTP 422
{
  "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.

HTTP 422
{
  "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.

HTTP 504
{
  "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).

GET
/api/1/snap

Parameter (Query Params)

ParameterTypStatusStandardBeschreibung
pointstringErforderlichlat,lngGPS-Punkt als lat,lng. Parameter für jeden Punkt wiederholen (maximal 100).
profilestringOptionaldrivingStraß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.

Snap to Road API
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 Dienst

JSON-Antwortbeispiel

Gekürztes JSON-Beispiel. Werte, optionale Felder und Kartendaten können abweichen. Entfernungen sind Meter und Routenzeiten Sekunden, sofern nicht anders angegeben.

HTTP 200 · application/json
{
  "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.

HTTP 400
{
  "error": "At least one point must be provided (point=lat,lng repeated)."
}

Wählen Sie ein unterstütztes Profil. Kein automatischer Wechsel auf Autorouten.

HTTP 422
{
  "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.

HTTP 422
{
  "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.

HTTP 504
{
  "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.

GET
/api/1/geocode

Parameter (Query Params)

ParameterTypStatusStandardBeschreibung
qstringOptional-Die zu suchende Adresse (z. B. „Nizami-Straße, Baku“).
reversebooleanOptionalfalseMuss true sein, um Reverse-Geocoding durchzuführen (Suche von Koordinate zu Adresse).
pointstringOptionallat,lngKoordinate (lat,lng) für Reverse-Geocoding zu einer Adresse. Erforderlich bei reverse=true.
limitintegerOptional5Maximale Anzahl zurückgegebener Ergebnisse (1–20, Standard 5).
langstringOptionalenBevorzugte Sprache für Ergebnisnamen (z. B. en, az, ru). Standard: en.
latnumberOptional-Breitengrad zur Gewichtung der Ergebnisse (nahe zuerst). Zusammen mit lon.
lonnumberOptional-Längengrad zur Gewichtung der Ergebnisse. Zusammen mit lat.
bboxstringOptional-Ergebnisse auf eine Bounding-Box beschränken: minLon,minLat,maxLon,maxLat.
osm_tagstringOptional-Nach OSM-Tag filtern, z. B. place (Orte) oder amenity:cafe. Präfix ! zum Ausschließen.
countrystringOptional-ISO-3166-1-Alpha-2-Ländercode, z. B. AZ. Nur Ergebnisse aus diesem Land.
citystringOptional-Verbindlicher Stadtfilter, z. B. Baku. Erfordert genau einen country-Code.
elasticbooleanOptionaltrueElastische (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.

Beispiele
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

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.867

Fü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.

GET
/api/1/geocode?q=101+Main+Street&country=US&locality=Boston&postcode=02129&unit=2&address_mode=units

Beispielanfrage

Ersetzen Sie YOUR_KEY durch Ihren API-Schlüssel. API-Anfragen verbrauchen Credits; das Kopieren sendet keine Anfrage.

Geocoding API
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 Dienst

JSON-Antwortbeispiel

Gekürztes JSON-Beispiel. Werte, optionale Felder und Kartendaten können abweichen. Entfernungen sind Meter und Routenzeiten Sekunden, sofern nicht anders angegeben.

HTTP 200 · application/json
{
  "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.

HTTP 400
{
  "error": "The \"q\" parameter (search text) is required."
}

Korrigieren Sie fehlende oder ungültige Parameter.

HTTP 400
{
  "code": "InvalidGeocodeFilter",
  "error": "city requires exactly one country, for example country=AZ&city=Bakı."
}

Keine indexierte Adresse oder kein Ort im Rückwärtssuchradius.

HTTP 422
{
  "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.

GET
/api/1/places

Parameter (Query Params)

ParameterTypStatusStandardBeschreibung
pointstringErforderlichlat,lngMittelpunkt-Koordinate lat,lng (erforderlich).
radiusnumberOptional1Suchradius in Kilometern (0.05–20, Standard 1).
categorystringOptional-OSM-Tag-Filter, z. B. amenity:cafe, shop, tourism:hotel. Präfix ! zum Ausschließen. Leer = alle POIs.
limitintegerOptional10Max. Ergebnisse (1–50, Standard 10).
langstringOptionalenBevorzugte 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.

Places API
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 Dienst

JSON-Antwortbeispiel

Gekürztes JSON-Beispiel. Werte, optionale Felder und Kartendaten können abweichen. Entfernungen sind Meter und Routenzeiten Sekunden, sofern nicht anders angegeben.

HTTP 200 · application/json
{
  "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.

HTTP 400
{
  "error": "The \"point\" parameter (lat,lng) is required."
}

Dienst oder Datenquelle nicht verfügbar. Vorsichtig mit längeren Pausen wiederholen.

HTTP 502
{
  "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.

GET
/api/1/autocomplete

Parameter (Query Params)

ParameterTypStatusStandardBeschreibung
qstringErforderlich-Suchtext — Teileingabe ist möglich.
limitintegerOptional8Maximale Anzahl an Vorschlägen (1–15).
langstringOptionalenSprachcode für Ergebnis-Labels.
latnumberOptional-Breitengrad zur Gewichtung (optional).
lonnumberOptional-Längengrad zur Gewichtung (optional).
countrystringOptional-ISO-3166-1-Alpha-2-Ländercode, z. B. AZ. Nur Ergebnisse aus diesem Land.
citystringOptional-Verbindlicher Stadtfilter, z. B. Baku. Erfordert genau einen country-Code.
osm_tagstringOptional-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.

Beispiele
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.

Autocomplete API
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 Dienst

JSON-Antwortbeispiel

Gekürztes JSON-Beispiel. Werte, optionale Felder und Kartendaten können abweichen. Entfernungen sind Meter und Routenzeiten Sekunden, sofern nicht anders angegeben.

HTTP 200 · application/json
{
  "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.

HTTP 400
{
  "error": "The \"q\" parameter (search text) is required."
}

Korrigieren Sie fehlende oder ungültige Parameter.

HTTP 400
{
  "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.

POST
/api/1/geocode/batch

Parameter (Query Params)

ParameterTypStatusStandardBeschreibung
queriesarrayErforderlich[]Array von zu geokodierenden Adressen (max. 100).
langstringOptionalenSprachcode für Ergebnis-Labels.
limitintegerOptional1Maximale Treffer pro Abfrage (1–5).

Beispielanfrage

Ersetzen Sie YOUR_KEY durch Ihren API-Schlüssel. API-Anfragen verbrauchen Credits; das Kopieren sendet keine Anfrage.

Batch Geocoding API
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 Dienst

JSON-Antwortbeispiel

Gekürztes JSON-Beispiel. Werte, optionale Felder und Kartendaten können abweichen. Entfernungen sind Meter und Routenzeiten Sekunden, sofern nicht anders angegeben.

HTTP 200 · application/json
{
  "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.

HTTP 400
{
  "error": "Body must include a non-empty \"queries\" array of address strings."
}

Korrigieren Sie fehlende oder ungültige Parameter.

HTTP 400
{
  "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.

GET
/api/1/timezone

Parameter (Query Params)

ParameterTypStatusStandardBeschreibung
pointstringOptional-point=lat,lng oder beide Parameter lat und lon angeben.
latnumberOptional-Breitengrad (alternativ zu point).
lonnumberOptional-Längengrad (alternativ zu point).
timestampstringOptionalnowUnix-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.

Timezone API
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 Dienst

JSON-Antwortbeispiel

Gekürztes JSON-Beispiel. Werte, optionale Felder und Kartendaten können abweichen. Entfernungen sind Meter und Routenzeiten Sekunden, sofern nicht anders angegeben.

HTTP 200 · application/json
{
  "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.

HTTP 400
{
  "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.

GET
/api/1/elevation

Parameter (Query Params)

ParameterTypStatusStandardBeschreibung
pointstringErforderlichlat,lngKoordinate 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.

Elevation API
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 Dienst

JSON-Antwortbeispiel

Gekürztes JSON-Beispiel. Werte, optionale Felder und Kartendaten können abweichen. Entfernungen sind Meter und Routenzeiten Sekunden, sofern nicht anders angegeben.

HTTP 200 · application/json
{
  "results": [
    {
      "point": {
        "lat": 40.3777,
        "lng": 49.8516
      },
      "elevation": null
    }
  ],
  "unit": "meters"
}
Dienstspezifische Fehler

Korrigieren Sie fehlende oder ungültige Parameter.

HTTP 400
{
  "error": "Provide at least one point=lat,lng (repeatable)."
}

Korrigieren Sie fehlende oder ungültige Parameter.

HTTP 400
{
  "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.

GET
/api/1/boundary

Parameter (Query Params)

ParameterTypStatusStandardBeschreibung
pointstringErforderlichlat,lngKoordinate als lat,lng.
polygonbooleanOptionalfalsetrue, um die Grenze zusätzlich als GeoJSON zurückzugeben.
langstringOptionalenSprachcode für Ortsnamen.

Beispielanfrage

Ersetzen Sie YOUR_KEY durch Ihren API-Schlüssel. API-Anfragen verbrauchen Credits; das Kopieren sendet keine Anfrage.

Boundary Lookup API
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 Dienst

JSON-Antwortbeispiel

Gekürztes JSON-Beispiel. Werte, optionale Felder und Kartendaten können abweichen. Entfernungen sind Meter und Routenzeiten Sekunden, sofern nicht anders angegeben.

HTTP 200 · application/json
{
  "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.

HTTP 400
{
  "error": "Provide a valid coordinate via point=lat,lng or lat= & lon=."
}

Hier fehlen detaillierte Verwaltungsdaten. Siehe Abdeckung.

HTTP 422
{
  "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.

POST
/api/1/geofence

Parameter (Query Params)

ParameterTypStatusStandardBeschreibung
fencesarrayErforderlich[]Array von Zäunen: { id?, polygon:[[lat,lng],...] } oder { id?, center:[lat,lng], radius_m }. Bis zu 100.
pointsarrayErforderlich[]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.

Geofencing API
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 Dienst

JSON-Antwortbeispiel

Gekürztes JSON-Beispiel. Werte, optionale Felder und Kartendaten können abweichen. Entfernungen sind Meter und Routenzeiten Sekunden, sofern nicht anders angegeben.

HTTP 200 · application/json
{
  "results": [
    {
      "point": {
        "lat": 40.3777,
        "lng": 49.8516
      },
      "inside": [
        "depot"
      ]
    }
  ],
  "count": 1,
  "took": 1
}
Dienstspezifische Fehler

Korrigieren Sie fehlende oder ungültige Parameter.

HTTP 400
{
  "error": "Body must include non-empty \"fences\" and \"points\" arrays."
}

Korrigieren Sie fehlende oder ungültige Parameter.

HTTP 400
{
  "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.

POST
/api/1/elevation/profile

Parameter (Query Params)

ParameterTypStatusStandardBeschreibung
pointsarrayOptional[]Array von [lat,lng]-Punkten des Pfades (>=2, bis 2000).
polylinestringOptional-Codierte Polyline statt points.

Beispielanfrage

Ersetzen Sie YOUR_KEY durch Ihren API-Schlüssel. API-Anfragen verbrauchen Credits; das Kopieren sendet keine Anfrage.

Elevation Profile API
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 Dienst

JSON-Antwortbeispiel

Gekürztes JSON-Beispiel. Werte, optionale Felder und Kartendaten können abweichen. Entfernungen sind Meter und Routenzeiten Sekunden, sofern nicht anders angegeben.

HTTP 200 · application/json
{
  "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.

HTTP 400
{
  "error": "Provide a \"points\" array (>=2 [lat,lng]) or an encoded \"polyline\"."
}

Korrigieren Sie fehlende oder ungültige Parameter.

HTTP 400
{
  "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.

GET
/api/1/solar

Parameter (Query Params)

ParameterTypStatusStandardBeschreibung
pointstringErforderlichlat,lngKoordinate als lat,lng.
datestringOptionaltodayDatum (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.

Solar API
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 Dienst

JSON-Antwortbeispiel

Gekürztes JSON-Beispiel. Werte, optionale Felder und Kartendaten können abweichen. Entfernungen sind Meter und Routenzeiten Sekunden, sofern nicht anders angegeben.

HTTP 200 · application/json
{
  "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.

HTTP 400
{
  "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.

POST
/api/1/geometry

Parameter (Query Params)

ParameterTypStatusStandardBeschreibung
opstringErforderlichdistanceOperation: distance, bearing, destination, midpoint, length, area, centroid, simplify, polyline_encode oder polyline_decode.
fromarrayOptional[lat,lng]Startpunkt [lat,lng].
toarrayOptional[lat,lng]Endpunkt [lat,lng].
patharrayOptional[]Array von [lat,lng] (length/simplify/polyline_encode).
polygonarrayOptional[][lat,lng]-Ring (area).
op → JSON
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.

Geometry Utilities API
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 Dienst

JSON-Antwortbeispiel

Gekürztes JSON-Beispiel. Werte, optionale Felder und Kartendaten können abweichen. Entfernungen sind Meter und Routenzeiten Sekunden, sofern nicht anders angegeben.

HTTP 200 · application/json
{
  "op": "distance",
  "distance": 2590.25,
  "unit": "meters"
}
Dienstspezifische Fehler

Korrigieren Sie fehlende oder ungültige Parameter.

HTTP 400
{
  "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.

GET
/api/1/convert

Parameter (Query Params)

ParameterTypStatusStandardBeschreibung
pointstringOptionallat,lngKoordinate lat,lng zur Umwandlung in UTM/MGRS.
mgrsstringOptional-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.

Coordinate Conversion API
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 Dienst

JSON-Antwortbeispiel

Gekürztes JSON-Beispiel. Werte, optionale Felder und Kartendaten können abweichen. Entfernungen sind Meter und Routenzeiten Sekunden, sofern nicht anders angegeben.

HTTP 200 · application/json
{
  "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.

HTTP 400
{
  "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.

GET
/api/1/country

Parameter (Query Params)

ParameterTypStatusStandardBeschreibung
codestringOptionalAZISO-3166-Alpha-2- oder Alpha-3-Ländercode (z. B. AZ oder AZE).
namestringOptional-Ländername statt Code.

Beispielanfrage

Ersetzen Sie YOUR_KEY durch Ihren API-Schlüssel. API-Anfragen verbrauchen Credits; das Kopieren sendet keine Anfrage.

Country Info API
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 Dienst

JSON-Antwortbeispiel

Gekürztes JSON-Beispiel. Werte, optionale Felder und Kartendaten können abweichen. Entfernungen sind Meter und Routenzeiten Sekunden, sofern nicht anders angegeben.

HTTP 200 · application/json
{
  "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.

HTTP 400
{
  "error": "Provide code=ISO2/ISO3 or name=CountryName."
}

Verwenden Sie einen gültigen Ländercode oder exakten Ländernamen.

HTTP 404
{
  "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.

GET
/api/1/isochrone

Parameter (Query Params)

ParameterTypStatusStandardBeschreibung
pointstringErforderlich-Mittelpunkt. Format: lat,lon.
time_limitintegerOptional600Fahrzeitlimit (in Sekunden).

Beispielanfrage

Ersetzen Sie YOUR_KEY durch Ihren API-Schlüssel. API-Anfragen verbrauchen Credits; das Kopieren sendet keine Anfrage.

Isochrones API
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 Dienst

JSON-Antwortbeispiel

Gekürztes JSON-Beispiel. Werte, optionale Felder und Kartendaten können abweichen. Entfernungen sind Meter und Routenzeiten Sekunden, sofern nicht anders angegeben.

HTTP 200 · application/json
{
  "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.

HTTP 400
{
  "error": "point parameter is required"
}

Komplexitätslimits und Schlüsselbeschränkungen im Dashboard prüfen.

HTTP 403
{
  "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.

HTTP 422
{
  "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.

HTTP 504
{
  "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.

POST
/api/1/vrp

Parameter (Query Params)

ParameterTypStatusStandardBeschreibung
vehiclesarrayOptionalone default vehicleDie Liste der Fahrzeuge — jeweils mit id, optionaler Kapazität und einem Startort als [lon, lat]-Array (Länge zuerst).
servicesarrayOptional[]Die anzufahrenden Stopps — jeweils mit id, einem Standort als [lon, lat]-Array (Länge zuerst) und optionaler Servicezeit.
shipmentsarrayOptional[]Verknüpfte Abhol- und Zustellaufgaben mit amount und skills. services, shipments oder beide angeben; höchstens 250 Aufgabenpunkte.
profilestringOptionaldrivingGemeinsames 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.

Route Optimization API
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 Dienst

JSON-Antwortbeispiel

Gekürztes JSON-Beispiel. Werte, optionale Felder und Kartendaten können abweichen. Entfernungen sind Meter und Routenzeiten Sekunden, sofern nicht anders angegeben.

HTTP 200 · application/json
{
  "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.

HTTP 400
{
  "code": "InvalidOptimizationInput",
  "error": "At least one service with valid coordinates is required."
}

Komplexitätslimits und Schlüsselbeschränkungen im Dashboard prüfen.

HTTP 403
{
  "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.

HTTP 422
{
  "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.

POST
/api/1/cluster

Parameter (Query Params)

ParameterTypStatusStandardBeschreibung
customersarrayErforderlich[]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.

Standort-Clustering
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 Dienst

JSON-Antwortbeispiel

Gekürztes JSON-Beispiel. Werte, optionale Felder und Kartendaten können abweichen. Entfernungen sind Meter und Routenzeiten Sekunden, sofern nicht anders angegeben.

HTTP 200 · application/json
{
  "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.

HTTP 400
{
  "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.

HTTP
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/info

Die ä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.

HTTP
GET /api/1/matrix?point=40.3755,49.8516&point=40.3892,49.8378
POST /api/1/matrix · POST /api/1/matrix/calculate
{"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.

POST /api/1/match
{"points":[[49.8516,40.3755],[49.8378,40.3892]],"timestamps":[1760000000,1760000120],"radiuses":[20,20]}
POST /api/1/elevation
{"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.

Karten-Playground

Offizielle SDKs

Kotlin für Android/JVM und Swift für iOS. Geografische OSRMRoute-APIs mit typisierten Modellen und asynchronen Anfragen.

JavaScript / TypeScriptPythonKotlin / AndroidSwift / iOSSDKs ansehen

OSRMRoute Support

Schreiben Sie direkt unserem Team

WIR HELFEN IHNEN

Wie können wir helfen?

Senden Sie eine Nachricht. Ticketantworten gehen auch an Ihre bestätigte E-Mail-Adresse.

Ihre Chats

Ihre Chats erscheinen hier.