API

Kurz zum Anfangen

Alle Ladeeinrichtungen ab 50 kW im Umkreis von 5 km um Krefeld, lesbar eingerückt.

https://chargemyride.live/api.php?lat=51.3396&lon=6.5853&radius=5&minPower=50&pretty=1

ausprobieren

CCS-Ladepunkte in München, die gerade geöffnet haben – alle Treffer in einer Antwort.

https://chargemyride.live/api.php?lat=48.1372&lon=11.5756&radius=10&connectorType=CCS&openNow=open&full_load=true

ausprobieren

Was in einem Treffer steht

Gekürzt; Schlüsselangaben und Ladepunkte je nach Datenlage.

Rohwert und Beschriftung stehen nebeneinander. Felder wie currentType, status, parking, payment und connectorTypes liefern unverändert den deutschen Wert aus dem Register – darauf lässt sich weiter vergleichen. Die Felder mit dem Zusatz Label daneben tragen dieselbe Angabe in der Sprache der Anfrage (?lang= oder Cookie). Dasselbe gilt für details.openingHoursLabel, das es nur als Beschriftung gibt.

{
  "id": 1035432,                       // Ladeeinrichtungs-ID der Bundesnetzagentur
  "operator": "EWE Go GmbH",
  "address": "Dießemer Bruch 98, 47805 Krefeld",
  "latitude": 51.327954, "longitude": 6.5911,
  "distance": 1.36,                    // Luftlinie in km
  "power": 300,                        // stärkster Einzelstecker
  "powerTotal": 300,                   // Anschlussleistung der Ladeeinrichtung
  "chargingPoints": 2,
  "currentType": "Schnellladeeinrichtung",       // Rohwert, immer deutsch
  "currentTypeLabel": "Rapid charging station",  // in der Sprache der Anfrage
  "connectorTypes": ["CCS"],
  "connectorTypeLabels": ["CCS"],
  "payment": ["RFID-Karte"], "paymentLabels": ["RFID card"],
  "details": {
    "openingHoursLabel": "Rund um die Uhr",
    "openState": { "state": "always", "until": null, "next": null },
    "status": "In Betrieb", "statusLabel": "In operation",
    "parking": "Keine Beschränkung", "parkingLabel": "No restriction",
    "district": "…", "state": "Nordrhein-Westfalen"
  },
  "chargePoints": [ { "position": 1, "evseId": "DE*EWE*E…", "power": 300,
                      "key": { "verified": true, "curve": "prime256v1" } } ],
  "eichrecht": { "reported": 2, "usable": 2, "verified": 2 },
  "warnings": [ { "code": "key_shared", "level": "warn", "count": 1 } ],
  "livePoints": [ { "evseId": "DE*EWE*E…*1", "status": "available", "ts": 1791300646,
                    "perKwh": 0.49, "sessionFee": null, "position": 1, "power": 300 } ],
  "price": { "min": 0.49, "max": 0.59, "sessionFee": null, "blockingPerMinute": 0.1 },
  "outage": { "rate": 0.02, "samples": 84, "coverage": 0.9 },   // Ausfallquote der letzten 7 Tage
  "rating": { "score": 79, "grade": "top", "pros": ["price", "reliability"], "cons": [], "penalties": [],
              "factors": [ { "key": "price", "value": 100, "weight": 30, "known": true },
                           { "key": "community", "value": 88, "weight": 13, "known": true }, … ] },
  "community": { "worked": 3, "failed": 0.5,           // Rückmeldungen (älter als 6 Monate zählen halb)
                 "props": { "lit": 2, "barrier": 1 }, // angekreuzte Eigenschaften und wie oft
                 "sighted": true },                   // Ladevorgang belegt (letzte 120 Tage)
  "report": { "category": "Ladevorgang startet nicht", "ts_unix": 1791200000, "count": 1,
              "answer_state": null, "answer_ts": null },  // jüngste offene/kürzlich behobene Meldung
  "billing": { "checks": 3, "alerts": 0, "warns": 1, "kinds": { "tariff_mismatch": 1 }, "last": 1791000000 },
  "park": { "stations": 4, "chargingPoints": 12, "powerMax": 300, "members": [ … ] },  // nur mit group=park
  "source": "both"                     // arcgis | register | both
}

Felder ohne Angabe stehen mit null in der Antwort, statt zu fehlen: community, report und billing sind nur gesetzt, wenn es Rückmeldungen, eine Meldung oder Rechnungsprüfungen zu dieser Ladeeinrichtung gibt. Freitext von Besuchern gibt die Schnittstelle nie heraus.