Routenplanung

METRON Routes

Routen, Matrizen, Erreichbarkeitsflächen und Spurzuordnung auf OpenStreetMap-Daten. Die Stufe (Basis, Pro, Enterprise) ergibt sich je Anfrage aus den verwendeten Angaben. Mit profile transit auch Verbindungen im öffentlichen Verkehr in Deutschland.

Preise

Route (Basis)

50Credits

Route (Pro)

100Credits

Route (Enterprise)

200Credits

Matrix, erste 625 Paare (Basis)

50Credits

Matrix, erste 625 Paare (Pro)

100Credits

Matrix, erste 625 Paare (Enterprise)

150Credits

Matrix, jedes weitere Paar (Basis)

1Credits

Matrix, jedes weitere Paar (Pro)

2Credits

Matrix, jedes weitere Paar (Enterprise)

4Credits

Erreichbarkeitsfläche (Basis)

40Credits

Erreichbarkeitsfläche (Pro)

80Credits

Erreichbarkeitsfläche (Enterprise)

200Credits

Spur zur Straße (Pro)

100Credits

Spur zur Straße (Enterprise)

100Credits

Schlüssel und Zugriff

Serverseitig verwenden Sie einen sk_-Schlüssel im Authorization-Header. Im Browser verwenden Sie für Route und Erreichbarkeitsfläche einen pk_-Schlüssel, den Sie an erlaubte Seiten (Origins) binden; er wird als Parameter key übergeben. Matrix und Spurzuordnung verlangen einen sk_-Schlüssel. Der Zugriff ist je Konto freigeschaltet (Scope metron:routes).

Abrechnung

Abgerechnet wird nur bei Erfolg (Status 200). Antworten mit Status 4xx, 422 oder 503 kosten nichts. Bei der Matrix richtet sich der Preis nach der Zahl der Paare (Quellen mal Ziele): die ersten 625 Paare einer Anfrage zum Preis je Paar, jedes weitere Paar zum günstigeren Zusatzpreis.

Stufen

Die Stufe ergibt sich aus der Anfrage: Sie fällt in die höchste Stufe, die eine ihrer Angaben verlangt. Die abgerechnete Stufe steht im Antwort-Header X-Metron-Tier (basis, pro oder enterprise).

StufeAngaben, die diese Stufe auslösen
BasisProfile auto, bicycle und pedestrian; bis zu 3 Zwischenstopps; eine Alternative; avoid mit tolls, highways, ferries; Fahranweisungen als Text.
ProProfile truck, bus, taxi, motorcycle und scooter; 4 bis 25 Zwischenstopps; 2 bis 3 Alternativen; avoid_areas; arrive_by; max_speed; attributes; navigation; format=osrm; allow_private; traffic=true (Staus in Routenwahl und Dauer). Die Spurzuordnung ist immer Pro. Profil transit (öffentlicher Verkehr, wird wie eine Pro-Route abgerechnet).
Enterpriseoptimize (Reihenfolge der Stopps), rest_times (Lenk- und Ruhezeiten nach EU 561/2006), places_along (Orte entlang der Route, höchstens 3 Kategorien) und weather (Wetter entlang der Route, DACH und Südtirol).

Schlägt eine Anreicherung fehl (zum Beispiel die Ortssuche entlang der Route), kommt die Route trotzdem und wird als Pro abgerechnet. Das Feld enrichment_errors nennt dann den Grund.

Obergrenze max_tier

Mit max_tier (basis, pro oder enterprise) begrenzen Sie die Stufe einer Anfrage. Verlangt die Anfrage mehr, antwortet die Schnittstelle mit 400 und dem Code tier_exceeded; das Feld required nennt die nötige Stufe. Berechnet wird dann nichts.

Antwort-Header

X-Metron-Tier nennt die abgerechnete Stufe. Bei der Matrix nennt X-Metron-Pairs zusätzlich die Zahl der abgerechneten Paare.

Grenzen

  • Route: bis zu 27 Orte (Start, Ziel und höchstens 25 Zwischenstopps).
  • Matrix: höchstens 2.500 Paare und höchstens 100 Punkte insgesamt. Ohne targets zählen die Quellen doppelt (sie sind zugleich die Ziele). Größere Matrizen teilen Sie in Blöcke auf.
  • Erreichbarkeitsfläche: höchstens 4 Konturen, je höchstens 60 Minuten oder 200 km.
  • Spurzuordnung: höchstens 5.000 Punkte.
  • optimize: höchstens 12 Orte innerhalb von 150 km.

Endpunkte

Orte sind Objekte der Form {"lat": 48.1371, "lon": 11.5754}.

POST/v1/metron/routes/route

Berechnet eine Route zwischen zwei oder mehr Orten, auf Wunsch mit Alternativen, Navigationsdaten und Enterprise-Anreicherungen.

Parameter

  • locationsarray<{lat, lon}>
    Ja

    Orte als Liste von {lat, lon}, mindestens Start und Ziel, bis zu 27.

  • profilestring
    Ja

    auto, bicycle, pedestrian (Basis); truck, bus, taxi, motorcycle, scooter (Pro). transit (öffentlicher Verkehr, Pro).

  • truckobjectOptional

    Fahrzeugdaten für truck: height, width, length (Meter), weight, axle_load (Tonnen), hazmat (boolean).

  • alternativesinteger 0–3OptionalStandard: 0

    Zahl der Alternativrouten, 0 bis 3. Ab 2 Stufe Pro.

  • avoidarray<string>Optional

    Liste aus tolls, highways, ferries.

  • avoid_areasarray<GeoJSON>Optional

    Zu meidende Flächen als GeoJSON (Polygon, MultiPolygon, Feature oder FeatureCollection); höchstens 20 Flächen und 2.000 Punkte. Pro.

  • headingfloat 0–360Optional

    Fahrtrichtung am Start in Grad (0 bis 360).

  • depart_atstringOptional

    Abfahrt als Ortszeit im Format JJJJ-MM-TTThh:mm. Bei transit: Abfahrt am Start, ohne Angabe jetzt.

  • arrive_bystringOptional

    Ankunft als Ortszeit im Format JJJJ-MM-TTThh:mm. Pro; nicht zusammen mit depart_at. Bei transit: spätestmögliche Ankunft als Ortszeit am Ziel, gleichbedeutend mit depart_at und transit.arrive_by.

  • transitobjectOptional

    Optionen für profile transit: arrive_by, modes, access, egress, max_transfers, alternatives. Siehe Abschnitt Öffentlicher Verkehr.

  • languagestringOptionalStandard: de-DE

    Sprache der Anweisungen, zum Beispiel de-DE (Standard) oder en.

  • max_speedfloatOptional

    Höchstgeschwindigkeit des Fahrzeugs in km/h, bis 300. Pro.

  • attributesbooleanOptionalStandard: false

    Straßenattribute je Abschnitt. Pro.

  • navigationbooleanOptionalStandard: false

    Sprach- und Bannerhinweise, Fahrspuren, Tempolimits, Ampeln. Pro.

  • format"metron" | "osrm"OptionalStandard: metron

    metron (Standard) oder osrm. osrm ist Pro.

  • trafficbooleanOptionalStandard: false

    Staus und aktuelle Geschwindigkeiten in Routenwahl und Dauer berücksichtigen (Autobahnen in Deutschland). Sperrungen gelten auch ohne traffic. Pro.

  • allow_privatebooleanOptionalStandard: false

    Ziele dürfen auf Privatwegen liegen: schaltet das Anfahren der nächsten öffentlichen Straße am Ziel ab (siehe Ankunft am Ziel). Pro.

  • optimizebooleanOptionalStandard: false

    Reihenfolge der Zwischenstopps optimieren. Enterprise.

  • rest_timesobjectOptional

    Objekt {rules: "eu561", driving_so_far_min, start_of_shift}. Enterprise.

  • places_alongarray<string>Optional

    Liste von Kategorien, höchstens 3. Enterprise.

  • weatherbooleanOptionalStandard: false

    Wetter entlang der Route. Enterprise.

  • max_tier"basis" | "pro" | "enterprise"Optional

    basis, pro oder enterprise: Obergrenze der Stufe.

  • keystringOptional

    pk_-Schlüssel, wenn Sie keinen Authorization-Header senden können.

Request

curl -X POST "https://api.centra.dbpg.io/v1/metron/routes/route" \
  -H "Authorization: Bearer sk_your_api_key" \
  -H "Content-Type: application/json" \
  -d '{
    "locations": [
      { "lat": 48.1371, "lon": 11.5754 },
      { "lat": 52.5200, "lon": 13.4050 }
    ],
    "profile": "auto",
    "alternatives": 1,
    "language": "de-DE"
  }'

Response

{
  "routes": [
    {
      "geometry": { "type": "LineString", "coordinates": [[11.5754, 48.1371], ...] },
      "distance_m": 585000,
      "duration_s": 22000,
      "legs": [ { "distance_m": 585000, "duration_s": 22000, "steps": [ ... ] } ]
    }
  ],
  "tier": "basis",
  "attribution": "© OpenStreetMap-Mitwirkende"
}
const res = await fetch("https://api.centra.dbpg.io/v1/metron/routes/route", {
  method: "POST",
  headers: { Authorization: "Bearer sk_your_api_key", "Content-Type": "application/json" },
  body: JSON.stringify({
    locations: [{ lat: 48.1371, lon: 11.5754 }, { lat: 52.52, lon: 13.405 }],
    profile: "truck",
    truck: { height: 4, weight: 40 },
    traffic: true,
    max_tier: "pro",
  }),
});
console.log(res.headers.get("X-Metron-Tier")); // "pro"
const { routes, traffic } = await res.json();
POST/v1/metron/routes/matrix

Berechnet Dauer und Entfernung für alle Paare aus Quellen und Zielen. Zeilen sind Quellen, Spalten sind Ziele, jeweils in Eingabereihenfolge; Sekunden und Meter als ganze Zahlen, null wenn ein Paar nicht erreichbar ist.

Parameter

  • sourcesarray<{lat, lon}>
    Ja

    Quellen als Liste von {lat, lon}.

  • targetsarray<{lat, lon}>Optional

    Ziele als Liste von {lat, lon}. Ohne Angabe ist die Matrix quadratisch über sources.

  • profilestring
    Ja

    auto, bicycle, pedestrian (Basis); truck, bus, taxi, motorcycle, scooter (Pro). transit (öffentlicher Verkehr, Pro).

  • metricsarray<string>Optional

    Teilmenge von duration und distance. Ohne Angabe beides.

  • truckobjectOptional

    Fahrzeugdaten für truck: height, width, length (Meter), weight, axle_load (Tonnen), hazmat (boolean).

  • avoidarray<string>Optional

    Liste aus tolls, highways, ferries.

  • max_tier"basis" | "pro" | "enterprise"Optional

    basis, pro oder enterprise: Obergrenze der Stufe.

Request

curl -X POST "https://api.centra.dbpg.io/v1/metron/routes/matrix" \
  -H "Authorization: Bearer sk_your_api_key" \
  -H "Content-Type: application/json" \
  -d '{
    "sources": [{ "lat": 48.1371, "lon": 11.5754 }, { "lat": 48.3705, "lon": 10.8978 }],
    "targets": [{ "lat": 47.4979, "lon": 19.0402 }, { "lat": 48.7758, "lon": 9.1829 }],
    "profile": "auto"
  }'

Response

{
  "duration": [[31000, 12400], [29000, 9800]],
  "distance": [[760000, 230000], [720000, 185000]],
  "traffic": null,
  "tier": "basis",
  "attribution": "© OpenStreetMap-Mitwirkende"
}
const res = await fetch("https://api.centra.dbpg.io/v1/metron/routes/matrix", {
  method: "POST",
  headers: { Authorization: "Bearer sk_your_api_key", "Content-Type": "application/json" },
  body: JSON.stringify({ sources: points, profile: "auto", metrics: ["duration"] }),
});
console.log(res.headers.get("X-Metron-Pairs")); // pairs billed
POST/v1/metron/routes/isochrone

Liefert die Fläche, die sich von einem Ort aus in einer Zeit oder Strecke erreichen lässt, als GeoJSON.

Parameter

  • location{lat, lon}
    Ja

    Ausgangsort als {lat, lon}.

  • profilestring
    Ja

    auto, bicycle, pedestrian (Basis); truck, bus, taxi, motorcycle, scooter (Pro). transit (öffentlicher Verkehr, Pro).

  • truckobjectOptional

    Fahrzeugdaten für truck: height, width, length (Meter), weight, axle_load (Tonnen), hazmat (boolean).

  • contoursarray<object>
    Ja

    Liste von {time} in Minuten (bis 60) oder {distance} in Kilometern (bis 200); höchstens 4, Zeit und Strecke nicht gemischt.

  • avoid_areasarray<GeoJSON>Optional

    Zu meidende Flächen als GeoJSON (Polygon, MultiPolygon, Feature oder FeatureCollection); höchstens 20 Flächen und 2.000 Punkte. Pro.

  • max_tier"basis" | "pro" | "enterprise"Optional

    basis, pro oder enterprise: Obergrenze der Stufe.

  • keystringOptional

    pk_-Schlüssel, wenn Sie keinen Authorization-Header senden können.

Request

curl -X POST "https://api.centra.dbpg.io/v1/metron/routes/isochrone" \
  -H "Authorization: Bearer sk_your_api_key" \
  -H "Content-Type: application/json" \
  -d '{
    "location": { "lat": 48.1371, "lon": 11.5754 },
    "profile": "auto",
    "contours": [{ "time": 10 }, { "time": 20 }]
  }'

Response

{
  "type": "FeatureCollection",
  "features": [ { "type": "Feature", "geometry": { "type": "Polygon", ... }, "properties": { ... } } ],
  "tier": "basis",
  "attribution": "© OpenStreetMap-Mitwirkende"
}
const res = await fetch("https://api.centra.dbpg.io/v1/metron/routes/isochrone?key=pk_your_public_key", {
  method: "POST",
  headers: { "Content-Type": "application/json" },
  body: JSON.stringify({
    location: { lat: 48.1371, lon: 11.5754 },
    profile: "bicycle",
    contours: [{ time: 15 }],
  }),
});
const areas = await res.json();
POST/v1/metron/routes/match

Ordnet eine aufgezeichnete GPS-Spur dem Straßennetz zu.

Parameter

  • pointsarray<{lat, lon, time}>
    Ja

    GPS-Punkte als Liste von {lat, lon, time}; time (Unix-Sekunden) ist optional. 2 bis 5.000 Punkte.

  • profilestring
    Ja

    auto, bicycle, pedestrian (Basis); truck, bus, taxi, motorcycle, scooter (Pro). transit (öffentlicher Verkehr, Pro).

  • truckobjectOptional

    Fahrzeugdaten für truck: height, width, length (Meter), weight, axle_load (Tonnen), hazmat (boolean).

  • max_tier"basis" | "pro" | "enterprise"Optional

    basis, pro oder enterprise: Obergrenze der Stufe.

Request

curl -X POST "https://api.centra.dbpg.io/v1/metron/routes/match" \
  -H "Authorization: Bearer sk_your_api_key" \
  -H "Content-Type: application/json" \
  -d '{
    "profile": "auto",
    "points": [
      { "lat": 48.1371, "lon": 11.5754, "time": 1761730000 },
      { "lat": 48.1402, "lon": 11.5811, "time": 1761730030 }
    ]
  }'

Response

{
  "tier": "pro",
  "attribution": "© OpenStreetMap-Mitwirkende"
}
const res = await fetch("https://api.centra.dbpg.io/v1/metron/routes/match", {
  method: "POST",
  headers: { Authorization: "Bearer sk_your_api_key", "Content-Type": "application/json" },
  body: JSON.stringify({ profile: "auto", points: trace }),
});
if (res.status === 422) console.log((await res.json()).error); // unmatched_trace

Matrix als Eingabe für Kairos Graph

Die Matrix passt direkt in das Feld matrices von Kairos Graph. Das folgende Beispiel holt die Dauer-Matrix und setzt sie als Kosten und Dauer in eine Kairos-Graph-Anfrage ein.

const headers = { Authorization: "Bearer sk_your_api_key", "Content-Type": "application/json" };

// 1. Duration matrix over all nodes (depot first)
const m = await (await fetch("https://api.centra.dbpg.io/v1/metron/routes/matrix", {
  method: "POST",
  headers,
  body: JSON.stringify({ sources: places, profile: "auto", metrics: ["duration"] }),
})).json();

// 2. The matrix goes straight into Kairos Graph
const result = await (await fetch("https://api.centra.dbpg.io/v1/kairos/graph", {
  method: "POST",
  headers,
  body: JSON.stringify({
    graph: {
      nodes: places.map((_, i) => ({ id: "n" + i })),
      matrices: { default: { cost: m.duration, duration: m.duration } },
    },
    task: {
      type: "tours",
      agents: [{ id: "van-1", start: "n0", end: "n0", capacity: [10] }],
      visits: places.slice(1).map((_, i) => ({ id: "v" + i, node: "n" + (i + 1), demand: [1], service_duration: 300 })),
    },
    config: { time_limit_seconds: 30 },
  }),
})).json();

Verkehr

Sperrungen auf Autobahnen in Deutschland sowie auf Autobahnen und Schnellstraßen in Österreich umgeht jede Route, Matrix und Erreichbarkeitsfläche für Kraftfahrzeuge, in jeder Stufe und auch ohne traffic=true; traffic nennt dann die Quellen und closures_considered. Verbindliche Sperrungen der ASFINAG gelten immer. Mit traffic=true (Pro) berücksichtigt die Route zusätzlich Staus und aktuelle Geschwindigkeiten bei Wahl und Dauer. Gesperrt ist jeweils die gemeldete Fahrtrichtung, bei beidseitigen Sperrungen beide. Sperrungen, deren Lage nur ungefähr bekannt ist, werden als Fläche um die gemeldete Lage umfahren. Liegt ein Start, Zwischenstopp oder Ziel in einer Sperrung oder bis 250 m daneben und ist er nur durch sie erreichbar, bleibt allein diese Sperrung unberücksichtigt; alle anderen gelten weiter. Die Daten für Deutschland stammen von „Die Autobahn GmbH des Bundes“ (GeoNutzV), die für Österreich von der ASFINAG (CC BY 4.0, verändert). Staus und Verzögerungen liegen nur für Deutschland vor. Verkehr gilt nur für Profile für Kraftfahrzeuge; bicycle und pedestrian ergeben 400 (field: traffic). Das Objekt traffic enthält source (alle Quellennennungen in einer Zeichenkette, getrennt durch „ | “), attributions (dieselben Nennungen als Liste), sources (["api"] oder ["api","datex"]), as_of, jams_as_of (Stand der Staudaten), live_speeds (true, wenn Live-Geschwindigkeiten verwendet wurden) und closures_considered (Zahl der berücksichtigten Sperrungen; gezählt wird, was in die Berechnung einging, nicht die tatsächlich gefahrenen Umwege). Verkehr wirkt nur bei Abfahrten von 15 Minuten in der Vergangenheit bis 60 Minuten in der Zukunft; außerhalb davon steht in traffic.skipped der Wert future_departure oder past_departure, und die Route wird nicht als Verkehrsroute abgerechnet. Sind die Daten älter als 30 Minuten oder fällt die Aktualisierung aus, ist traffic gleich null, enrichment_errors enthält "traffic", und die Route entsteht und wird ohne Verkehr abgerechnet. Matrix und Erreichbarkeitsfläche antworten bei traffic=true mit 400 (not_available).

Lkw-Abdeckung

Beschränkungen für Lkw (Höhe, Breite, Länge, Gewicht, Achslast, Gefahrgut) stammen aus OpenStreetMap und sind nicht überall vollständig erfasst. Die Route ist eine Planungsgrundlage; die Beschilderung vor Ort gilt.

Öffentlicher Verkehr

Mit profile transit berechnet /v1/metron/routes/route Verbindungen von Tür zu Tür mit Bus, Straßenbahn, U-Bahn, S-Bahn, Regional- und Fernzug sowie Fähre, einschließlich Fußwegen und Umstiegen. Das Profil gehört zur Stufe Pro und wird wie eine Pro-Route abgerechnet; Zu- und Abgang mit Rad oder Auto kosten nichts extra.

Abdeckung: Deutschland. Grundlage ist der Sollfahrplan; Verspätungen und Ausfälle fließen nicht ein. Der Fahrplan reicht einige Wochen in die Zukunft. Liegt der Zeitpunkt außerhalb, antworten wir mit outside_timetable und nennen in valid_from und valid_until den gültigen Zeitraum.

Die Anfrage enthält genau zwei Orte (Start und Ziel) und depart_at als Ortszeit am Start; ohne depart_at gilt jetzt. Mit transit.arrive_by: true ist depart_at die spätestmögliche Ankunft, als Ortszeit am Ziel; arrive_by ist dafür die Kurzform. Angaben für Straßenrouten (zum Beispiel truck, avoid, alternatives, navigation, traffic) sind mit transit nicht zulässig und werden mit bad_request beantwortet.

  • transit.modes: Verkehrsmittel, ohne Angabe alle. rail (alle Züge außer U-Bahn), long_distance (Fernverkehr), regional, suburban (S-Bahn), subway, tram, bus, coach (Fernbus), ferry, other (Seilbahnen und Ähnliches). Ohne Fernverkehr zum Beispiel: ["regional", "suburban", "subway", "tram", "bus", "ferry"].
  • transit.access und transit.egress: Weg zur ersten und von der letzten Haltestelle. walk (Standard), bicycle (eigenes Rad), car (nur access: mit dem Auto zu einer Haltestelle mit Parkplatz). Je Weg höchstens 30 Minuten. rental (Leihräder und Leihscooter) ist vorgesehen und wird derzeit mit not_available beantwortet.
  • transit.max_transfers: höchstens so viele Umstiege, 0 bis 8. transit.alternatives: Zahl der Verbindungen in der Antwort, 1 bis 5, Standard 3.
curl -X POST "https://api.centra.dbpg.io/v1/metron/routes/route" \
  -H "Authorization: Bearer sk_your_api_key" \
  -H "Content-Type: application/json" \
  -d '{
    "profile": "transit",
    "locations": [
      { "lat": 52.4990, "lon": 13.4177 },
      { "lat": 52.5356, "lon": 13.1998 }
    ],
    "depart_at": "2026-11-03T12:00",
    "transit": {
      "modes": ["regional", "suburban", "subway", "tram", "bus"],
      "access": ["walk"],
      "max_transfers": 3,
      "alternatives": 3
    }
  }'

Die Antwort enthält in routes bis zu alternatives Verbindungen. Bei einer Abfahrtszeit steht die früheste Ankunft vorn, bei Gleichstand die mit weniger Umstiegen; bei einer Ankunftszeit die späteste Abfahrt, die noch rechtzeitig ankommt. Jede Verbindung hat departure und arrival (Ortszeit mit Zeitzonen-Offset), duration_s, distance_m, transfers, geometry und legs.

Jeder Abschnitt in legs hat mode (walk, bicycle, car oder ein Verkehrsmittel aus transit.modes), departure, arrival, duration_s, distance_m und geometry. Fahrten haben zusätzlich line (zum Beispiel U8, RE8, ICE 785), headsign (Fahrtziel), operator (Verkehrsunternehmen), from und to (Haltestelle mit name, lat, lon und, soweit im Fahrplan angegeben, track), intermediate_stops (Zahl der Zwischenhalte) sowie color und text_color, wenn die Linie eine Farbe hat. Liegt das Ziel zu Fuß nah, kann eine Verbindung aus einem einzigen Fußweg bestehen (bis 30 Minuten). Die Linien in geometry sind auf 4 Meter genau vereinfacht und behalten an jeder Haltestelle einen Punkt; distance_m misst den vollständigen Weg.

{
  "routes": [
    {
      "departure": "2026-11-03T12:00:00+01:00",
      "arrival": "2026-11-03T12:40:00+01:00",
      "duration_s": 2400,
      "distance_m": 18500,
      "transfers": 2,
      "geometry": { "type": "LineString", "coordinates": [[13.417748, 52.499047], ...] },
      "legs": [
        { "mode": "walk", "departure": "2026-11-03T12:00:00+01:00", "arrival": "2026-11-03T12:01:00+01:00",
          "duration_s": 60, "distance_m": 26, "geometry": { ... } },
        { "mode": "subway", "line": "U8", "headsign": "S+U Wittenau (Berlin)", "operator": "Berliner Verkehrsbetriebe",
          "from": { "name": "U Kottbusser Tor (Berlin)", "lat": 52.498959, "lon": 13.418101, "track": "2 (U8)" },
          "to": { "name": "S+U Alexanderplatz Bhf (Berlin)", "lat": 52.521048, "lon": 13.412764, "track": "2 (U8)" },
          "departure": "2026-11-03T12:01:00+01:00", "arrival": "2026-11-03T12:08:00+01:00",
          "intermediate_stops": 3, "duration_s": 420, "distance_m": 2600, "geometry": { ... } },
        ...
      ]
    }
  ],
  "tier": "pro",
  "attribution": "© OpenStreetMap-Mitwirkende; Fahrplandaten: DELFI e.V. (delfi.de), CC BY 4.0, von dbpg bearbeitet"
}

Ankunft am Ziel

Liegt ein Ziel oder Zwischenstopp an einem Weg, der in OpenStreetMap für Autos privat oder gesperrt ist (etwa Betriebsstraßen auf dem Flughafenvorfeld oder Mitarbeiterparkplätze), endet die Route am nächsten öffentlichen Weg in der Nähe, höchstens das Dreifache des Abstands zur nächsten Straße oder diesen Abstand plus 200 m entfernt. Gibt es dort keinen, bleibt das Ziel unverändert. Private Abschnitte auf der Anfahrt bleiben erlaubt; betroffen ist nur der Endpunkt. Wege mit Zufahrt für Anlieger, Kunden oder Lieferverkehr gelten als öffentlich. Der Startpunkt wird nie verschoben. Das gilt in allen Stufen ohne Aufpreis; mit allow_private: true (Pro) entfällt es. Für Flughäfen und Bahnhöfe empfehlen wir als Ziel den navigation_point aus METRON Places, sofern vorhanden.

Wetter entlang der Route

Mit weather=true (Enterprise) liefert die Antwort Wetter an Punkten entlang der Route, geplant zur voraussichtlichen Ankunftszeit. Die Abdeckung umfasst Deutschland, Österreich, die Schweiz und Südtirol.

Lenk- und Ruhezeiten

Mit rest_times (Enterprise) plant die Route Pausen und Ruhezeiten nach EU 561/2006, mit Rastplatz, wo einer gefunden wird. Das Feld rules ist eu561; optional geben Sie driving_so_far_min (bis 1.440) und start_of_shift an. Verfügbar für die Profile truck, bus und auto, nicht zusammen mit arrive_by. Die Antwort trägt den Hinweis „Planungshilfe ohne Gewähr“; sie ersetzt weder die Fahrerkarte noch eine Rechtsberatung. Zeitangaben der Antwort (arrival_with_breaks, eta) stehen in der Ortszeit des jeweiligen Orts, mit UTC-Versatz nach ISO 8601: die Ankunft in der Zeitzone des Ziels, jeder Wetterpunkt in seiner eigenen.

places_along (Enterprise) liefert Orte entlang der Route aus METRON Places. Kategorien: fuel, charging_station, parking, toilets, restaurant, fast_food, cafe, hotel, supermarket; höchstens 3 je Anfrage.

Nennung

Jede Antwort enthält das Feld attribution mit „© OpenStreetMap-Mitwirkende“. Zeigen Sie diese Nennung an. Ist traffic nicht null, zeigen Sie zusätzlich den Text aus traffic.source an (oder jede Nennung aus traffic.attributions). Er nennt jede verwendete Quelle: „Die Autobahn GmbH des Bundes“, bei verwendeten Staudaten „Die Autobahn GmbH des Bundes; Verortung: BASt TMC-LCL (CC BY 4.0)“, und für Österreich die Nennung der ASFINAG mit Lizenz CC BY 4.0, dem Hinweis auf die Veränderung der Daten und „© OpenStreetMap-Mitwirkende, ODbL“. Übernehmen Sie den Text unverändert. ÖPNV-Antworten (profile transit) nennen zusätzlich „Fahrplandaten: DELFI e.V. (delfi.de), CC BY 4.0, von dbpg bearbeitet“; zeigen Sie beide Nennungen an.

Datenschutz

Positionen, Spuren und Ziele werden nicht dauerhaft gespeichert. Das Nutzungsprotokoll enthält nur Endpunkt, Status, Dauer, Stufe und Konto.

Fehler

Fehler kommen als JSON mit dem Feld error.

  • bad_request 400. Eine Angabe ist ungültig; das Feld field nennt sie.
  • tier_exceeded 400. Die Anfrage verlangt mehr als max_tier erlaubt; required nennt die Stufe.
  • not_available 400. Die Angabe wird für diesen Endpunkt oder dieses Profil noch nicht angeboten (zum Beispiel traffic bei der Matrix). Bei profile transit: Zwischenstopps (field locations) und rental als Zu- oder Abgang (field transit.access oder transit.egress).
  • no_route 422. Zwischen den Orten gibt es keine Verbindung. Bei profile transit auch, wenn ein Ort außerhalb Deutschlands liegt oder keine Haltestelle in Reichweite ist.
  • outside_timetable 422. Der Zeitpunkt liegt außerhalb des geladenen Fahrplans (profile transit); valid_from und valid_until nennen den gültigen Zeitraum.
  • unmatched_location 422. Ein Ort liegt zu weit von einer befahrbaren Straße entfernt; index nennt seine Position, bei der Matrix zusammen mit index_side (sources oder targets).
  • unmatched_trace 422. Die Spur lässt sich keinem Straßenverlauf zuordnen.
  • unavailable 503. Der Dienst ist ausgelastet; der Header Retry-After nennt die Wartezeit in Sekunden.
  • Wie bei allen Diensten: 401 ohne gültigen Schlüssel, 402 bei zu geringem Guthaben, 403 bei fehlendem Scope oder einem pk_-Schlüssel an Matrix oder Spurzuordnung, 429 bei Überschreiten des Ratenlimits.