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)

120Credits

Ortsabruf

120Credits

Umgebungssuche (Seite)

200Credits

Routenkorridor (Seite)

200Credits

Umkehrsuche

40Credits

Ladesäulen-Suche Basis

200Credits

Ladesäulen-Suche Pro (Live-Status)

350Credits

Ladesäulen-Suche Enterprise

450Credits

Ladesäule Details Basis

120Credits

Ladesäule Details Pro (Live-Status)

200Credits

Ladesäule Details Enterprise

250Credits

Abfahrten an einer Haltestelle (Sollfahrplan)

150Credits

Abfahrten mit Echtzeit (Enterprise, sobald Echtzeitdaten angebunden sind)

300Credits

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

GET/v1/metron/places/autocomplete

Schlä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

  • qstring
    Ja

    Suchbegriff, höchstens 200 Zeichen.

  • sessionstring
    Ja

    Sitzungskennung, 16 bis 64 Zeichen aus A–Z, a–z, 0–9, _ und -. Pflicht.

  • langstringOptional

    Sprache der Kategoriebezeichnungen und Ortsnamen, zum Beispiel de oder en.

  • lat, lonfloatOptional

    Breitengrad, −90 bis 90. Bei der Vervollständigung zusammen mit lon als Standortbezug.

  • bboxstringOptional

    Suchfenster als minLon,minLat,maxLon,maxLat.

  • countrystringOptional

    Länder als ISO-Codes, kommagetrennt, zum Beispiel DE,AT.

  • limitinteger 1–10OptionalStandard: 5

    Anzahl Treffer.

  • keystringOptional

    Nur 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"
}
GET/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)
    Ja

    Ort-ID (osm:n123) oder Feature-ID aus der Karte.

  • sessionstringOptional

    Sitzungskennung, 16 bis 64 Zeichen aus A–Z, a–z, 0–9, _ und -. Pflicht.

  • langstringOptional

    Sprache der Kategoriebezeichnungen und Ortsnamen, zum Beispiel de oder en.

  • keystringOptional

    Nur 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"
}
GET/v1/metron/places/reverse

Liefert zu einer Koordinate den nächsten Ort oder die nächste Adresse.

Parameter

  • latfloat
    Ja

    Breitengrad, −90 bis 90. Bei der Vervollständigung zusammen mit lon als Standortbezug.

  • lonfloat
    Ja

    Längengrad, −180 bis 180.

  • radius_mfloat 1–1000OptionalStandard: 100

    Radius in Metern.

  • limitinteger 1–5OptionalStandard: 1

    Anzahl Treffer.

  • langstringOptional

    Sprache der Kategoriebezeichnungen und Ortsnamen, zum Beispiel de oder en.

  • keystringOptional

    Nur 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"
}
GET/v1/metron/places/departures

Nächste Abfahrten an einer Haltestelle oder einem Bahnhof nach dem Sollfahrplan: Linie, Verkehrsmittel, Ziel, Gleis bzw. Steig und Verkehrsunternehmen. Deutschland, alle Verkehrsmittel.

Parameter

  • stopstring
    Ja

    ID eines Ortes (osm:n123 oder Karten-ID), in der Regel eine Haltestelle oder ein Bahnhof.

  • timestring (RFC 3339)Optional

    Beginn des Zeitfensters, z. B. 2026-10-30T08:00:00+01:00. Ohne Angabe: jetzt.

  • durationinteger 1–720OptionalStandard: 60

    Länge des Zeitfensters in Minuten.

  • limitinteger 1–50OptionalStandard: 10

    Anzahl Treffer.

  • modesstringOptional

    Kommagetrennte Auswahl: train, suburban, subway, tram, bus, coach, ferry, cable, monorail, taxi, other.

  • realtimebooleanOptionalStandard: false

    true fordert Echtzeitdaten an (Enterprise). Noch nicht verfügbar, siehe Abfahrten.

  • langstringOptional

    Sprache der Kategoriebezeichnungen und Ortsnamen, zum Beispiel de oder en.

  • keystringOptional

    Nur 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"
}
GET/v1/metron/places/nearby

Orte 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

  • latfloat
    Ja

    Breitengrad, −90 bis 90. Bei der Vervollständigung zusammen mit lon als Standortbezug.

  • lonfloat
    Ja

    Längengrad, −180 bis 180.

  • radius_mfloat 1–50000OptionalStandard: 1000

    Radius in Metern.

  • qstringOptional

    Suchbegriff, höchstens 200 Zeichen.

  • categorystringOptional

    Kategorie-Schlüssel; ein unbekannter Schlüssel ergibt 400.

  • operatorstringOptional

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

  • brandstringOptional

    Nur Orte dieser Marke: Wikidata-ID (Q125054) oder Name (Aldi, Burger King), wie operator.

  • sortstringOptionalStandard: distance

    distance (Standard) oder relevance; relevance ordnet mit q nach Namenstreffer.

  • cursorstringOptional

    next_cursor der vorigen Seite.

  • limitinteger 1–50OptionalStandard: 20

    Anzahl Treffer.

  • langstringOptional

    Sprache der Kategoriebezeichnungen und Ortsnamen, zum Beispiel de oder en.

  • keystringOptional

    Nur 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"
}
POST/v1/metron/places/corridor

Orte 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

  • lineobject
    Ja

    GeoJSON-LineString mit [lon, lat] oder {"polyline": "…", "precision": 5 | 6}.

  • width_mfloat 1–5000
    Ja

    Breite des Korridors in Metern, 1 bis 5.000.

  • qstringOptional

    Suchbegriff, höchstens 200 Zeichen.

  • categorystringOptional

    Kategorie-Schlüssel; ein unbekannter Schlüssel ergibt 400.

  • sortstringOptionalStandard: distance

    distance (Standard) oder relevance; relevance ordnet mit q nach Namenstreffer.

  • cursorstringOptional

    next_cursor der vorigen Seite.

  • limitinteger 1–50OptionalStandard: 20

    Anzahl Treffer.

  • langstringOptional

    Sprache 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"
}
POST/v1/metron/places/corrections

Meldet einen falschen oder fehlenden Ort oder unzulässige Inhalte in den Daten eines Orts. Die Meldung ist kostenlos.

Parameter

  • kind"wrong" | "missing" | "inappropriate"
    Ja

    wrong (Ort falsch), missing (Ort fehlt) oder inappropriate (rechtswidrige oder anstößige Inhalte).

  • idstring | integerAlternative

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

  • textstring
    Ja

    Freitext, höchstens 2.000 Zeichen.

  • donation_consentbooleanOptional

    true, 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.

GET/v1/metron/places/charging/nearby

Ladestandorte im Umkreis, nächste zuerst. Abgerechnet je Seite nach Stufe.

Parameter

  • latfloat
    Ja

    Breitengrad, −90 bis 90. Bei der Vervollständigung zusammen mit lon als Standortbezug.

  • lonfloat
    Ja

    Längengrad, −180 bis 180.

  • radius_mfloat 1–50000OptionalStandard: 5000

    Radius in Metern.

  • tier"basis" | "pro" | "enterprise"OptionalStandard: basis

    Stufe der Antwort: basis, pro (mit Live-Status) oder enterprise (mit Verfügbarkeitsübersicht). Bestimmt den Preis.

  • min_kwfloatOptional

    Nur Standorte mit mindestens einem Ladepunkt dieser Leistung (kW).

  • plugstringOptional

    Nur Standorte mit diesem Steckertyp, z. B. IEC_62196_T2_COMBO (CCS), IEC_62196_T2, CHADEMO.

  • availablebooleanOptionalStandard: false

    Nur Standorte mit mindestens einem passenden freien Ladepunkt. Nur mit tier=pro oder enterprise.

  • limitinteger 1–50OptionalStandard: 20

    Anzahl Treffer.

  • keystringOptional

    Nur 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" } }
  ]
}
POST/v1/metron/places/charging/corridor

Ladestandorte entlang einer Linie, in Fahrtrichtung sortiert (along_m: Meter ab Linienanfang, distance_m: Abstand zur Linie). Abgerechnet je Seite nach Stufe.

Parameter

  • lineobject
    Ja

    GeoJSON-LineString mit [lon, lat] oder {"polyline": "…", "precision": 5 | 6}.

  • width_mfloat 1–5000
    Ja

    Breite des Korridors in Metern, 1 bis 5.000.

  • tier"basis" | "pro" | "enterprise"OptionalStandard: basis

    Stufe der Antwort: basis, pro (mit Live-Status) oder enterprise (mit Verfügbarkeitsübersicht). Bestimmt den Preis.

  • min_kwfloatOptional

    Nur Standorte mit mindestens einem Ladepunkt dieser Leistung (kW).

  • plugstringOptional

    Nur Standorte mit diesem Steckertyp, z. B. IEC_62196_T2_COMBO (CCS), IEC_62196_T2, CHADEMO.

  • availablebooleanOptionalStandard: false

    Nur Standorte mit mindestens einem passenden freien Ladepunkt. Nur mit tier=pro oder enterprise.

  • limitinteger 1–50OptionalStandard: 20

    Anzahl 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 }, ... } }
  ]
}
GET/v1/metron/places/charging/{id}

Ein Ladestandort mit allen Ladepunkten. Abgerechnet je Abfrage nach Stufe.

Parameter

  • idstring (path)
    Ja

    Kennung aus einem Suchergebnis (charging:…).

  • tier"basis" | "pro" | "enterprise"OptionalStandard: basis

    Stufe der Antwort: basis, pro (mit Live-Status) oder enterprise (mit Verfügbarkeitsübersicht). Bestimmt den Preis.

  • keystringOptional

    Nur 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_request Parameter fehlen oder sind ungültig, bei der Vervollständigung auch eine fehlende oder ungültige session.
  • query_too_long Der Suchbegriff ist länger als 200 Zeichen.
  • too_many_results Die Suche mit sort=relevance trifft zu viele Orte; verkleinern Sie den Umkreis.
  • corridor_too_large Die Linie ist zu lang, zu komplex oder quert den Antimeridian (line_too_long, line_too_complex, line_crosses_antimeridian, corridor_too_large).
  • not_found Zu dieser ID liegen keine Angaben vor (404, Code not_found), etwa bei Adressen mit Hausnummer. Berechnet wird nichts.
  • removed Vorgesehen für entfernte Orte (404, Code removed); derzeit wird er nicht vergeben. Berechnet wird nichts.
  • request_timeout Der 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.