Ortssuche
METRON Places
Vervollständigung, Ortsabruf, Rückwärtssuche, Umkreis- und Korridorsuche auf OpenStreetMap-Daten. Die IDs passen zu den Orten in den Kartenkacheln von METRON Maps.
Preise
Ortssuche (Vervollständigungs-Sitzung)
Ortsabruf
Umgebungssuche (Seite)
Routenkorridor (Seite)
Umkehrsuche
Ladesäulen-Suche Basis
Ladesäulen-Suche Pro (Live-Status)
Ladesäulen-Suche Enterprise
Ladesäule Details Basis
Ladesäule Details Pro (Live-Status)
Ladesäule Details Enterprise
Abfahrten an einer Haltestelle (Sollfahrplan)
Abfahrten mit Echtzeit (Enterprise, sobald Echtzeitdaten angebunden sind)
Schlüssel und Zugriff
Serverseitig verwenden Sie einen sk_-Schlüssel im Authorization-Header. Im Browser verwenden Sie einen pk_-Schlüssel, den Sie an erlaubte Seiten (Origins) binden; er wird als Parameter key übergeben. Der Zugriff auf METRON Places ist je Konto freigeschaltet (Scope metron:places).
Abgerechnet wird nur bei Erfolg. Antworten mit Status 4xx oder 5xx kosten nichts, ebenso Korrekturen. Eine Umleitung (301) auf eine neue ID kostet ebenfalls nichts; folgen Sie ihr, der Abruf unter der neuen ID wird dann berechnet.
Sitzungen bei der Vervollständigung
Beim Tippen entstehen viele Anfragen. Damit sie nicht einzeln berechnet werden, fasst eine Sitzung sie zusammen. Sie vergeben die Sitzungskennung selbst.
- Der Parameter session ist bei der Vervollständigung Pflicht: 16 bis 64 Zeichen aus A–Z, a–z, 0–9, _ und -. Ohne gültige session antwortet die Schnittstelle mit 400.
- Eine Sitzung wird einmal berechnet (120 Credits), mit der ersten erfolgreichen Anfrage. Weitere Anfragen derselben Sitzung kosten nichts.
- Die Sitzung endet mit der Auswahl, also dem Ortsabruf mit derselben session (dieser Abruf ist dann kostenlos), nach 2 Minuten ohne Anfrage oder nach 50 Anfragen.
- Ein Ortsabruf ohne laufende Sitzung kostet 120 Credits. Erzeugen Sie für jede neue Suche eine neue Kennung, zum Beispiel mit crypto.randomUUID().
- Die erste Vervollständigung nach dem Ende einer Sitzung eröffnet eine neue Sitzung und wird mit 120 Credits berechnet, auch wenn Sie dieselbe Kennung weiterverwenden. Verwenden Sie für jede neue Suche eine neue Kennung.
Beispiel im Browser
const session = crypto.randomUUID(); // 36 characters, valid
async function suggest(q) {
const url = new URL("https://api.centra.dbpg.io/v1/metron/places/autocomplete");
url.search = new URLSearchParams({ q, session, key: "pk_your_public_key", lang: "de" });
const res = await fetch(url);
if (!res.ok) throw new Error((await res.json()).error);
return (await res.json()).features;
}
// On selection: the lookup with the same session is free and ends it.
async function select(id) {
const url = new URL(`https://api.centra.dbpg.io/v1/metron/places/${id}`);
url.search = new URLSearchParams({ session, key: "pk_your_public_key" });
return (await fetch(url)).json();
}Orts-IDs und Karten-Features
Jeder Ort trägt eine ID mit Quellenkennung, etwa osm:n123456. Der Buchstabe nach dem Doppelpunkt gibt die Art des OpenStreetMap-Objekts an: n für Knoten, w für Weg, r für Relation. Die IDs bleiben über die monatlichen Aktualisierungen hinweg gültig, solange es das Objekt gibt. Wurde ein Ort einem anderen zugeordnet, antwortet der Ortsabruf mit 301 und dem neuen Pfad im Header Location. Für entfernte Orte ist 404 mit dem Code removed vorgesehen; vergeben wird er erst mit den monatlichen Aktualisierungen.
Orte in den Kartenkacheln von METRON Maps tragen dieselbe ID als Feature-ID: Typ mal 2^44 plus OSM-ID (Typ 1 Knoten, 2 Weg, 3 Relation). Der Knoten osm:n123456 hat also die Feature-ID 17592186167872 (2^44 + 123456), der Weg osm:w123456 die Feature-ID 35184372212288. Der Ortsabruf akzeptiert beide Schreibweisen, sodass ein Klick auf der Karte direkt zum Abruf führt. Andere Zahlen beantwortet er mit 400 (bad_request).
Bei einer Umleitung (301) enthält der Header Location nur den neuen Pfad. Mit einem pk_-Schlüssel hängen Sie key (und gegebenenfalls session) selbst wieder an die URL an.
Klick auf ein Karten-Feature
map.on("click", "pois", async (e) => {
const featureId = e.features[0].id; // e.g. 17592186167872 = 2^44 + 123456 = osm:n123456
const res = await fetch(
`https://api.centra.dbpg.io/v1/metron/places/${featureId}?key=pk_your_public_key`
);
if (res.status === 404) return; // no details for this place (not_found), not billed
const { feature, details } = await res.json();
});Endpunkte
/v1/metron/places/autocompleteSchlägt Orte und Adressen zu einem Suchbegriff vor. Pflichtparameter sind q und session. Die Sitzungsregel steht oben. Abkürzungen, Kurz- und Zweitnamen sowie Betreiber und Marken werden erkannt (LMU, Hbf, KaDeWe, BK). Bei Straße und Hausnummer steht die Adresse selbst vor den Geschäften im Haus. Ein Vorschlag mit properties.type "address" ist eine Adresse; ist seine id null, wurde er aus den Adressteilen eines Geschäfts an dieser Adresse gebildet, und es gibt keinen Ortsabruf dazu. Name ist dann „Straße Hausnummer“, address enthält street, housenumber, postcode, city und weitere Teile. Treffer mit bekanntem Betreiber oder bekannter Marke tragen properties.operator und properties.brand.
Parameter
qstringJaSuchbegriff, höchstens 200 Zeichen.
sessionstringJaSitzungskennung, 16 bis 64 Zeichen aus A–Z, a–z, 0–9, _ und -. Pflicht.
langstringOptionalSprache der Kategoriebezeichnungen und Ortsnamen, zum Beispiel de oder en.
lat, lonfloatOptionalBreitengrad, −90 bis 90. Bei der Vervollständigung zusammen mit lon als Standortbezug.
bboxstringOptionalSuchfenster als minLon,minLat,maxLon,maxLat.
countrystringOptionalLänder als ISO-Codes, kommagetrennt, zum Beispiel DE,AT.
limitinteger 1–10OptionalStandard:5Anzahl Treffer.
keystringOptionalNur für pk_-Schlüssel: der öffentliche Schlüssel als Parameter.
Request
curl -G "https://api.centra.dbpg.io/v1/metron/places/autocomplete" \
-H "Authorization: Bearer sk_your_api_key" \
--data-urlencode "q=Brandenburger" \
-d "session=7c9e6679-7425-40de-944b-e07fc1f90ae7" \
-d "lang=de"Response
{
"type": "FeatureCollection",
"features": [
{
"type": "Feature",
"geometry": { "type": "Point", "coordinates": [13.3777, 52.5163] },
"properties": {
"id": "osm:n123456",
"name": "Brandenburger Tor",
"category": "attraction",
"category_label": "Attraction",
"address": { "street": "Pariser Platz", "city": "Berlin", "countrycode": "DE" },
"source": "osm",
"license": "ODbL-1.0"
}
}
],
"attribution": "© OpenStreetMap-Mitwirkende"
}/v1/metron/places/{id}Liefert zu einer ID die Grundangaben und Zusatzangaben wie Öffnungszeiten, Webseite, Telefon, E-Mail, Barrierefreiheit, Marke, Betreiber, Wikidata-IDs (wikidata, operator_wikidata, brand_wikidata), Kurz- und amtlichen Namen (short_name, official_name) und bei Haltestellen die Linien. Die ID ist osm:n123 oder die Feature-ID aus der Karte. Mit einer laufenden session ist der Abruf kostenlos. Zusatzangaben gibt es vor allem für Geschäfte, Gastronomie, Sehenswürdigkeiten und Haltestellen. Straßen und Plätze, Städte, Orte und Ortsteile, Landkreise, Bundesländer und Staaten liefert der Ortsabruf mit Name, Adressteilen und Mittelpunkt, dazu ihre Ausdehnung als bbox [West, Süd, Ost, Nord], soweit bekannt. Für Adressen mit Hausnummer antwortet er mit 404 (not_found); ihre Angaben stehen vollständig im Suchtreffer. Eine Antwort mit 404 wird nicht berechnet.
Parameter
idstring (path)JaOrt-ID (osm:n123) oder Feature-ID aus der Karte.
sessionstringOptionalSitzungskennung, 16 bis 64 Zeichen aus A–Z, a–z, 0–9, _ und -. Pflicht.
langstringOptionalSprache der Kategoriebezeichnungen und Ortsnamen, zum Beispiel de oder en.
keystringOptionalNur für pk_-Schlüssel: der öffentliche Schlüssel als Parameter.
Request
curl "https://api.centra.dbpg.io/v1/metron/places/osm:n123456?session=7c9e6679-7425-40de-944b-e07fc1f90ae7" \
-H "Authorization: Bearer sk_your_api_key"Response
{
"feature": {
"type": "Feature",
"geometry": { "type": "Point", "coordinates": [13.3777, 52.5163] },
"properties": {
"id": "osm:n123456",
"name": "Brandenburger Tor",
"category": "attraction",
"category_label": "Attraction",
"address": { "street": "Pariser Platz", "city": "Berlin", "countrycode": "DE" },
"source": "osm",
"license": "ODbL-1.0"
}
},
"details": {
"opening_hours": "24/7",
"website": "https://example.org",
"phone": null,
"email": null,
"wheelchair": "yes",
"brand": null,
"lines": []
},
"attribution": "© OpenStreetMap-Mitwirkende"
}/v1/metron/places/reverseLiefert zu einer Koordinate den nächsten Ort oder die nächste Adresse.
Parameter
latfloatJaBreitengrad, −90 bis 90. Bei der Vervollständigung zusammen mit lon als Standortbezug.
lonfloatJaLängengrad, −180 bis 180.
radius_mfloat 1–1000OptionalStandard:100Radius in Metern.
limitinteger 1–5OptionalStandard:1Anzahl Treffer.
langstringOptionalSprache der Kategoriebezeichnungen und Ortsnamen, zum Beispiel de oder en.
keystringOptionalNur für pk_-Schlüssel: der öffentliche Schlüssel als Parameter.
Request
curl -G "https://api.centra.dbpg.io/v1/metron/places/reverse" \
-H "Authorization: Bearer sk_your_api_key" \
-d "lat=52.5163" -d "lon=13.3777"Response
{
"type": "FeatureCollection",
"features": [ ... ],
"attribution": "© OpenStreetMap-Mitwirkende"
}/v1/metron/places/departuresNächste Abfahrten an einer Haltestelle oder einem Bahnhof nach dem Sollfahrplan: Linie, Verkehrsmittel, Ziel, Gleis bzw. Steig und Verkehrsunternehmen. Deutschland, alle Verkehrsmittel.
Parameter
stopstringJaID eines Ortes (osm:n123 oder Karten-ID), in der Regel eine Haltestelle oder ein Bahnhof.
timestring (RFC 3339)OptionalBeginn des Zeitfensters, z. B. 2026-10-30T08:00:00+01:00. Ohne Angabe: jetzt.
durationinteger 1–720OptionalStandard:60Länge des Zeitfensters in Minuten.
limitinteger 1–50OptionalStandard:10Anzahl Treffer.
modesstringOptionalKommagetrennte Auswahl: train, suburban, subway, tram, bus, coach, ferry, cable, monorail, taxi, other.
realtimebooleanOptionalStandard:falsetrue fordert Echtzeitdaten an (Enterprise). Noch nicht verfügbar, siehe Abfahrten.
langstringOptionalSprache der Kategoriebezeichnungen und Ortsnamen, zum Beispiel de oder en.
keystringOptionalNur für pk_-Schlüssel: der öffentliche Schlüssel als Parameter.
Request
curl -G "https://api.centra.dbpg.io/v1/metron/places/departures" \
-H "Authorization: Bearer sk_your_api_key" \
-d "stop=osm:n2470201868" -d "limit=5"Response
{
"place": { "id": "osm:n2470201868", "name": "München Hauptbahnhof", "category": "station" },
"stations": [ { "name": "München Hbf", "gtfs_id": "de:09162:6" } ],
"departures": [
{ "time": "2026-10-30T08:01:00+01:00", "line": "S1", "mode": "suburban",
"headsign": "Flughafen München", "platform": null, "agency": "DB Regio AG S-Bahn München" },
{ "time": "2026-10-30T08:02:00+01:00", "line": "RE72", "mode": "train",
"headsign": "Memmingen, Bahnhof ZOB", "platform": "26", "agency": "Arverio Bayern GmbH" }
],
"realtime": { "requested": false, "available": false },
"schedule": { "stand": "2026-10-24", "valid_from": "2026-10-10", "valid_until": "2026-12-12", "stale": false },
"timezone": "Europe/Berlin",
"attribution": "DELFI e.V.",
"license": "CC-BY-4.0"
}/v1/metron/places/nearbyOrte im Umkreis einer Koordinate, nach Entfernung sortiert, bis zu 50 Treffer je Seite. Jede Seite wird einzeln berechnet; die nächste Seite holen Sie mit next_cursor. Mit operator oder brand erhalten Sie alle Standorte eines Betreibers oder einer Marke, zum Beispiel operator=LMU oder brand=Q125054.
Parameter
latfloatJaBreitengrad, −90 bis 90. Bei der Vervollständigung zusammen mit lon als Standortbezug.
lonfloatJaLängengrad, −180 bis 180.
radius_mfloat 1–50000OptionalStandard:1000Radius in Metern.
qstringOptionalSuchbegriff, höchstens 200 Zeichen.
categorystringOptionalKategorie-Schlüssel; ein unbekannter Schlüssel ergibt 400.
operatorstringOptionalNur Orte dieses Betreibers: Wikidata-ID (Q55044) oder Name (LMU, Stadtwerke München). Ein Name trifft den Betreiber vom Anfang an und alle Wikidata-IDs, die zu diesem Namen bekannt sind.
brandstringOptionalNur Orte dieser Marke: Wikidata-ID (Q125054) oder Name (Aldi, Burger King), wie operator.
sortstringOptionalStandard:distancedistance (Standard) oder relevance; relevance ordnet mit q nach Namenstreffer.
cursorstringOptionalnext_cursor der vorigen Seite.
limitinteger 1–50OptionalStandard:20Anzahl Treffer.
langstringOptionalSprache der Kategoriebezeichnungen und Ortsnamen, zum Beispiel de oder en.
keystringOptionalNur für pk_-Schlüssel: der öffentliche Schlüssel als Parameter.
Request
curl -G "https://api.centra.dbpg.io/v1/metron/places/nearby" \
-H "Authorization: Bearer sk_your_api_key" \
-d "lat=52.5163" -d "lon=13.3777" -d "radius_m=500" -d "limit=50"Response
{
"type": "FeatureCollection",
"features": [
{ "type": "Feature", "geometry": { ... },
"properties": { "id": "osm:n123456", "distance_m": 120, ... } }
],
"next_cursor": "…",
"attribution": "© OpenStreetMap-Mitwirkende"
}/v1/metron/places/corridorOrte entlang einer Linie, zum Beispiel einer Route, innerhalb von width_m Metern. Die Linie ist ein GeoJSON-LineString oder eine kodierte Polyline. Jede Seite wird einzeln berechnet; die nächste Seite holen Sie mit next_cursor und dem unveränderten Rumpf.
Parameter
lineobjectJaGeoJSON-LineString mit [lon, lat] oder {"polyline": "…", "precision": 5 | 6}.
width_mfloat 1–5000JaBreite des Korridors in Metern, 1 bis 5.000.
qstringOptionalSuchbegriff, höchstens 200 Zeichen.
categorystringOptionalKategorie-Schlüssel; ein unbekannter Schlüssel ergibt 400.
sortstringOptionalStandard:distancedistance (Standard) oder relevance; relevance ordnet mit q nach Namenstreffer.
cursorstringOptionalnext_cursor der vorigen Seite.
limitinteger 1–50OptionalStandard:20Anzahl Treffer.
langstringOptionalSprache der Kategoriebezeichnungen und Ortsnamen, zum Beispiel de oder en.
Request
curl -X POST "https://api.centra.dbpg.io/v1/metron/places/corridor" \
-H "Authorization: Bearer sk_your_api_key" \
-H "Content-Type: application/json" \
-d '{
"line": { "type": "LineString", "coordinates": [[13.40, 52.52], [13.74, 51.05]] },
"width_m": 1000,
"category": "fuel",
"limit": 50
}'Response
{
"type": "FeatureCollection",
"features": [ ... ],
"next_cursor": null,
"attribution": "© OpenStreetMap-Mitwirkende"
}/v1/metron/places/correctionsMeldet einen falschen oder fehlenden Ort oder unzulässige Inhalte in den Daten eines Orts. Die Meldung ist kostenlos.
Parameter
kind"wrong" | "missing" | "inappropriate"Jawrong (Ort falsch), missing (Ort fehlt) oder inappropriate (rechtswidrige oder anstößige Inhalte).
idstring | integerAlternativeID des betroffenen Orts (osm:n123 oder Feature-ID). Entweder id oder point.
point[lat, lon]Alternative[lat, lon] für einen fehlenden Ort. Entweder id oder point.
textstringJaFreitext, höchstens 2.000 Zeichen.
donation_consentbooleanOptionaltrue, wenn die Meldung an offene Datenprojekte wie OpenStreetMap weitergegeben werden darf. Pflicht bei wrong und missing; bei inappropriate ohne Wirkung.
Request
curl -X POST "https://api.centra.dbpg.io/v1/metron/places/corrections" \
-H "Authorization: Bearer sk_your_api_key" \
-H "Content-Type: application/json" \
-d '{
"kind": "wrong",
"id": "osm:n123456",
"text": "Opening hours are outdated.",
"donation_consent": false
}'Response
{ "id": "0b7f6a8e-5d3c-4c0a-9a55-3f1c2f7d1e11" }const res = await fetch("https://api.centra.dbpg.io/v1/metron/places/nearby?lat=52.5163&lon=13.3777&limit=50", {
headers: { Authorization: "Bearer sk_your_api_key" },
});
const { features, next_cursor } = await res.json();Ladesäulen
Öffentliche Ladestationen in Deutschland mit Betreiber, Adresse, Steckertypen und Ladeleistung, auf Wunsch mit dem aktuellen Status jedes Ladepunkts. Die Suche funktioniert im Umkreis eines Punkts und entlang einer Strecke, etwa für Ladestopps auf einer Route. Die Stufe wählen Sie je Anfrage mit tier:
- Basis: Standort, Betreiber, Adresse, Steckertypen, höchste Ladeleistung, Zahl der Ladepunkte, durchgehende Öffnung.
- Pro: zusätzlich der aktuelle Status jedes Ladepunkts (frei, belegt, außer Betrieb) mit Stand der Daten; der Filter available ist nur hier und in Enterprise möglich.
- Enterprise: zusätzlich eine Verfügbarkeitsübersicht je Standort (frei, belegt, gestört, Anteil frei, Schnellladen) und das Alter jedes Status.
Der Status wird alle fünf Minuten aktualisiert. Ist er älter als 20 Minuten, liefern Pro und Enterprise die Standorte weiter, aber mit live: false und ohne Status. Ladepunkte aus dem Ladesäulenregister haben keinen Live-Status (no_live_status).
Jeder Standort trägt license und attribution seiner Quelle. Zeigen Sie die Namensnennung bei jedem angezeigten Standort an.
/v1/metron/places/charging/nearbyLadestandorte im Umkreis, nächste zuerst. Abgerechnet je Seite nach Stufe.
Parameter
latfloatJaBreitengrad, −90 bis 90. Bei der Vervollständigung zusammen mit lon als Standortbezug.
lonfloatJaLängengrad, −180 bis 180.
radius_mfloat 1–50000OptionalStandard:5000Radius in Metern.
tier"basis" | "pro" | "enterprise"OptionalStandard:basisStufe der Antwort: basis, pro (mit Live-Status) oder enterprise (mit Verfügbarkeitsübersicht). Bestimmt den Preis.
min_kwfloatOptionalNur Standorte mit mindestens einem Ladepunkt dieser Leistung (kW).
plugstringOptionalNur Standorte mit diesem Steckertyp, z. B. IEC_62196_T2_COMBO (CCS), IEC_62196_T2, CHADEMO.
availablebooleanOptionalStandard:falseNur Standorte mit mindestens einem passenden freien Ladepunkt. Nur mit tier=pro oder enterprise.
limitinteger 1–50OptionalStandard:20Anzahl Treffer.
keystringOptionalNur für pk_-Schlüssel: der öffentliche Schlüssel als Parameter.
Request
curl -G "https://api.centra.dbpg.io/v1/metron/places/charging/nearby" \
-H "Authorization: Bearer sk_your_api_key" \
-d "lat=48.1374" -d "lon=11.5755" -d "radius_m=3000" \
-d "tier=pro" -d "min_kw=50" -d "available=true"Response
{
"type": "FeatureCollection",
"live": true,
"as_of": "2026-10-30T10:22:00+00:00",
"features": [
{ "type": "Feature", "geometry": { "type": "Point", "coordinates": [11.5712, 48.1401] },
"properties": {
"id": "charging:123456", "category": "charging_station",
"operator": "Stadtwerke München", "max_kw": 150, "plugs": ["IEC_62196_T2_COMBO"],
"charge_points": 2, "distance_m": 420,
"evses": [ { "evse_id": "DE*SWM*E1", "status": "available", "max_kw": 150, "plugs": ["IEC_62196_T2_COMBO"] } ],
"license": "CC BY 4.0", "attribution": "Bundesnetzagentur" } }
]
}/v1/metron/places/charging/corridorLadestandorte entlang einer Linie, in Fahrtrichtung sortiert (along_m: Meter ab Linienanfang, distance_m: Abstand zur Linie). Abgerechnet je Seite nach Stufe.
Parameter
lineobjectJaGeoJSON-LineString mit [lon, lat] oder {"polyline": "…", "precision": 5 | 6}.
width_mfloat 1–5000JaBreite des Korridors in Metern, 1 bis 5.000.
tier"basis" | "pro" | "enterprise"OptionalStandard:basisStufe der Antwort: basis, pro (mit Live-Status) oder enterprise (mit Verfügbarkeitsübersicht). Bestimmt den Preis.
min_kwfloatOptionalNur Standorte mit mindestens einem Ladepunkt dieser Leistung (kW).
plugstringOptionalNur Standorte mit diesem Steckertyp, z. B. IEC_62196_T2_COMBO (CCS), IEC_62196_T2, CHADEMO.
availablebooleanOptionalStandard:falseNur Standorte mit mindestens einem passenden freien Ladepunkt. Nur mit tier=pro oder enterprise.
limitinteger 1–50OptionalStandard:20Anzahl Treffer.
Request
curl -X POST "https://api.centra.dbpg.io/v1/metron/places/charging/corridor" \
-H "Authorization: Bearer sk_your_api_key" \
-H "Content-Type: application/json" \
-d '{
"line": { "type": "LineString", "coordinates": [[11.58, 48.14], [9.18, 48.78]] },
"width_m": 2000,
"tier": "enterprise",
"min_kw": 150
}'Response
{
"type": "FeatureCollection",
"live": true,
"features": [
{ "type": "Feature", "geometry": { ... },
"properties": { "id": "charging:98765", "along_m": 61240, "distance_m": 380,
"availability": { "available": 3, "occupied": 1, "out_of_order": 0,
"available_share": 0.75, "fast_charging": true }, ... } }
]
}/v1/metron/places/charging/{id}Ein Ladestandort mit allen Ladepunkten. Abgerechnet je Abfrage nach Stufe.
Parameter
idstring (path)JaKennung aus einem Suchergebnis (charging:…).
tier"basis" | "pro" | "enterprise"OptionalStandard:basisStufe der Antwort: basis, pro (mit Live-Status) oder enterprise (mit Verfügbarkeitsübersicht). Bestimmt den Preis.
keystringOptionalNur für pk_-Schlüssel: der öffentliche Schlüssel als Parameter.
Request
curl "https://api.centra.dbpg.io/v1/metron/places/charging/charging:123456?tier=pro" \
-H "Authorization: Bearer sk_your_api_key"Response
{ "type": "Feature", "geometry": { ... }, "properties": { "id": "charging:123456", "live": true, "evses": [ ... ], ... } }Korrekturen
Mit einer Korrektur melden Sie, dass ein Ort falsch ist (kind wrong), dass er fehlt (kind missing) oder dass seine Daten rechtswidrige oder anstößige Inhalte enthalten (kind inappropriate), jeweils mit Freitext und entweder einer ID oder einer Koordinate. Gespeichert werden die Meldung, ID oder Koordinate, das Konto und der Zeitpunkt, keine Angaben zur Person. Das Feld donation_consent gibt bei wrong und missing an, ob die Meldung an offene Datenprojekte wie OpenStreetMap weitergegeben werden darf. Die Einwilligung dazu holen Sie bei Ihren Nutzern ein. Meldungen mit kind inappropriate prüfen wir selbst; sie werden nie automatisch weitergegeben, donation_consent wird dafür nicht ausgewertet und als false gespeichert. Die Meldungen werden bei uns unbefristet aufbewahrt. Die Antwort enthält die Kennung der Meldung (Status 201).
Abfahrten
stop ist die ID eines Ortes aus METRON Places, etwa aus der Suche oder einem Klick auf die Karte. Wir ordnen ihm die Haltestellen des Fahrplans in der Nähe zu, deren Name passt, mit allen Gleisen und Steigen. Liegt keine Haltestelle vor, ist stations leer. Zeiten stehen in Europe/Berlin. Liegt der Zeitpunkt außerhalb der Gültigkeit des Fahrplans, ist schedule.stale gesetzt.
Basis: die Haltestelle selbst als Ort (Ortsabruf). Pro: dazu die Abfahrten nach Sollfahrplan (diese Anfrage). Enterprise: Sollfahrplan kombiniert mit Echtzeitdaten über realtime=true. Echtzeitdaten sind noch nicht angebunden; bis dahin liefert die Anfrage den Sollfahrplan mit realtime.available=false und wird als Pro berechnet.
Lizenz und Nennung
Die Daten stammen aus OpenStreetMap und stehen unter der Open Database License (ODbL 1.0). Nennen Sie in Ihrer Anwendung sichtbar „© OpenStreetMap contributors“. Jeder Treffer trägt die Felder source und license, jede Antwort das Feld attribution. Den Hinweis auf die Quelle haben Sie auch dann anzuzeigen, wenn Sie Treffer in eigene Datenbestände übernehmen.
Die Fahrplandaten stammen von DELFI e.V. und stehen unter CC BY 4.0. Nennen Sie in Ihrer Anwendung sichtbar „DELFI e.V.“, wenn Sie Abfahrten anzeigen; jede Antwort trägt die Felder attribution und license.
Das Feld attribution enthält „© OpenStreetMap-Mitwirkende“. Die englische Fassung „© OpenStreetMap contributors“ ist gleichwertig; Sie dürfen eine der beiden anzeigen.
In dieser Ausbaustufe beruhen alle Treffer ausschließlich auf OpenStreetMap-Daten. Die Abdeckung folgt der Karte von METRON Maps; Orte in Regionen, die dort noch nicht aufgebaut sind, werden noch nicht gefunden. Die Daten werden monatlich erneuert.
Datenschutz
Suchbegriffe und Positionen werden nicht gespeichert. Das Nutzungsprotokoll hält nur den Endpunkt, die Credits und den Status fest. Antworten werden höchstens 24 Stunden zwischengespeichert, und zwar unter einem Hash der Anfrage als Schlüssel. Ausgenommen sind Korrekturmeldungen, die Sie bewusst einreichen.
Fehler
Fehler kommen als JSON mit dem Feld error. Sie kosten nichts.
bad_requestParameter fehlen oder sind ungültig, bei der Vervollständigung auch eine fehlende oder ungültige session.query_too_longDer Suchbegriff ist länger als 200 Zeichen.too_many_resultsDie Suche mit sort=relevance trifft zu viele Orte; verkleinern Sie den Umkreis.corridor_too_largeDie Linie ist zu lang, zu komplex oder quert den Antimeridian (line_too_long, line_too_complex, line_crosses_antimeridian, corridor_too_large).not_foundZu dieser ID liegen keine Angaben vor (404, Code not_found), etwa bei Adressen mit Hausnummer. Berechnet wird nichts.removedVorgesehen für entfernte Orte (404, Code removed); derzeit wird er nicht vergeben. Berechnet wird nichts.request_timeoutDer Dienst hat nach 15 Sekunden nicht geantwortet (504, Code request_timeout). Wiederholen Sie die Anfrage; berechnet wird nichts.- 401 und 403 bei fehlendem Schlüssel oder Scope, 402 bei zu geringem Guthaben, 429 bei Überschreitung des Limits, 503 wenn der Dienst nicht erreichbar ist.