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)
Route (Pro)
Route (Enterprise)
Matrix, erste 625 Paare (Basis)
Matrix, erste 625 Paare (Pro)
Matrix, erste 625 Paare (Enterprise)
Matrix, jedes weitere Paar (Basis)
Matrix, jedes weitere Paar (Pro)
Matrix, jedes weitere Paar (Enterprise)
Erreichbarkeitsfläche (Basis)
Erreichbarkeitsfläche (Pro)
Erreichbarkeitsfläche (Enterprise)
Spur zur Straße (Pro)
Spur zur Straße (Enterprise)
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).
| Stufe | Angaben, die diese Stufe auslösen |
|---|---|
| Basis | Profile auto, bicycle und pedestrian; bis zu 3 Zwischenstopps; eine Alternative; avoid mit tolls, highways, ferries; Fahranweisungen als Text. |
| Pro | Profile 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). |
| Enterprise | optimize (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}.
/v1/metron/routes/routeBerechnet eine Route zwischen zwei oder mehr Orten, auf Wunsch mit Alternativen, Navigationsdaten und Enterprise-Anreicherungen.
Parameter
locationsarray<{lat, lon}>JaOrte als Liste von {lat, lon}, mindestens Start und Ziel, bis zu 27.
profilestringJaauto, bicycle, pedestrian (Basis); truck, bus, taxi, motorcycle, scooter (Pro). transit (öffentlicher Verkehr, Pro).
truckobjectOptionalFahrzeugdaten für truck: height, width, length (Meter), weight, axle_load (Tonnen), hazmat (boolean).
alternativesinteger 0–3OptionalStandard:0Zahl der Alternativrouten, 0 bis 3. Ab 2 Stufe Pro.
avoidarray<string>OptionalListe aus tolls, highways, ferries.
avoid_areasarray<GeoJSON>OptionalZu meidende Flächen als GeoJSON (Polygon, MultiPolygon, Feature oder FeatureCollection); höchstens 20 Flächen und 2.000 Punkte. Pro.
headingfloat 0–360OptionalFahrtrichtung am Start in Grad (0 bis 360).
depart_atstringOptionalAbfahrt als Ortszeit im Format JJJJ-MM-TTThh:mm. Bei transit: Abfahrt am Start, ohne Angabe jetzt.
arrive_bystringOptionalAnkunft 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.
transitobjectOptionalOptionen für profile transit: arrive_by, modes, access, egress, max_transfers, alternatives. Siehe Abschnitt Öffentlicher Verkehr.
languagestringOptionalStandard:de-DESprache der Anweisungen, zum Beispiel de-DE (Standard) oder en.
max_speedfloatOptionalHöchstgeschwindigkeit des Fahrzeugs in km/h, bis 300. Pro.
attributesbooleanOptionalStandard:falseStraßenattribute je Abschnitt. Pro.
navigationbooleanOptionalStandard:falseSprach- und Bannerhinweise, Fahrspuren, Tempolimits, Ampeln. Pro.
format"metron" | "osrm"OptionalStandard:metronmetron (Standard) oder osrm. osrm ist Pro.
trafficbooleanOptionalStandard:falseStaus und aktuelle Geschwindigkeiten in Routenwahl und Dauer berücksichtigen (Autobahnen in Deutschland). Sperrungen gelten auch ohne traffic. Pro.
allow_privatebooleanOptionalStandard:falseZiele dürfen auf Privatwegen liegen: schaltet das Anfahren der nächsten öffentlichen Straße am Ziel ab (siehe Ankunft am Ziel). Pro.
optimizebooleanOptionalStandard:falseReihenfolge der Zwischenstopps optimieren. Enterprise.
rest_timesobjectOptionalObjekt {rules: "eu561", driving_so_far_min, start_of_shift}. Enterprise.
places_alongarray<string>OptionalListe von Kategorien, höchstens 3. Enterprise.
weatherbooleanOptionalStandard:falseWetter entlang der Route. Enterprise.
max_tier"basis" | "pro" | "enterprise"Optionalbasis, pro oder enterprise: Obergrenze der Stufe.
keystringOptionalpk_-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();/v1/metron/routes/matrixBerechnet 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}>JaQuellen als Liste von {lat, lon}.
targetsarray<{lat, lon}>OptionalZiele als Liste von {lat, lon}. Ohne Angabe ist die Matrix quadratisch über sources.
profilestringJaauto, bicycle, pedestrian (Basis); truck, bus, taxi, motorcycle, scooter (Pro). transit (öffentlicher Verkehr, Pro).
metricsarray<string>OptionalTeilmenge von duration und distance. Ohne Angabe beides.
truckobjectOptionalFahrzeugdaten für truck: height, width, length (Meter), weight, axle_load (Tonnen), hazmat (boolean).
avoidarray<string>OptionalListe aus tolls, highways, ferries.
max_tier"basis" | "pro" | "enterprise"Optionalbasis, 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/v1/metron/routes/isochroneLiefert die Fläche, die sich von einem Ort aus in einer Zeit oder Strecke erreichen lässt, als GeoJSON.
Parameter
location{lat, lon}JaAusgangsort als {lat, lon}.
profilestringJaauto, bicycle, pedestrian (Basis); truck, bus, taxi, motorcycle, scooter (Pro). transit (öffentlicher Verkehr, Pro).
truckobjectOptionalFahrzeugdaten für truck: height, width, length (Meter), weight, axle_load (Tonnen), hazmat (boolean).
contoursarray<object>JaListe von {time} in Minuten (bis 60) oder {distance} in Kilometern (bis 200); höchstens 4, Zeit und Strecke nicht gemischt.
avoid_areasarray<GeoJSON>OptionalZu 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"Optionalbasis, pro oder enterprise: Obergrenze der Stufe.
keystringOptionalpk_-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();/v1/metron/routes/matchOrdnet eine aufgezeichnete GPS-Spur dem Straßennetz zu.
Parameter
pointsarray<{lat, lon, time}>JaGPS-Punkte als Liste von {lat, lon, time}; time (Unix-Sekunden) ist optional. 2 bis 5.000 Punkte.
profilestringJaauto, bicycle, pedestrian (Basis); truck, bus, taxi, motorcycle, scooter (Pro). transit (öffentlicher Verkehr, Pro).
truckobjectOptionalFahrzeugdaten für truck: height, width, length (Meter), weight, axle_load (Tonnen), hazmat (boolean).
max_tier"basis" | "pro" | "enterprise"Optionalbasis, 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_traceMatrix 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_request400. Eine Angabe ist ungültig; das Feld field nennt sie.tier_exceeded400. Die Anfrage verlangt mehr als max_tier erlaubt; required nennt die Stufe.not_available400. 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_route422. 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_timetable422. Der Zeitpunkt liegt außerhalb des geladenen Fahrplans (profile transit); valid_from und valid_until nennen den gültigen Zeitraum.unmatched_location422. 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_trace422. Die Spur lässt sich keinem Straßenverlauf zuordnen.unavailable503. 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.