Skip to content

AndreasFischer1985/eco-visio-api

 
 

Repository files navigation

Eco-Visio API

API zum Eco-Visio-Dashboard von Eco-Counter.

Eco-Counter ist ein Technologieunternehmen mit Hauptsitz in Lannion, in der Bretagne. Zum Unternehmen zählen Filialen in Montreal (Kanada) und in Köln. Das Untenehmen betreibt u.a. Fahrrad- und Fußgängerzähler in unterschiedlichen Ländern, die in zahlreichen deutschen Städten z.B. Angaben wie "Radfahrende heute" oder "Radfahrende dieses Jahr" ausweisen. Teilweise sind die Zähler auch vollständig unterirdisch verlegt worden (z.B. zahlreiche Fahrradzählstellen in Hessen, vgl. https://data.eco-counter.com/ParcPublic/?id=8080).

Generell findet man in Deutschland überwiegend Fahrradzähler. In Rostock gibt es daneben auch Fußgängerzähler (https://data.eco-counter.com/ParcPublic/?id=888), ebenso in Schwerin (https://data.eco-counter.com/ParcPublic/?id=6116), in Greifswald (https://data.eco-counter.com/ParcPublic/?id=6997) oder in Böblingen (https://data.eco-counter.com/ParcPublic/?id=6811). In Ludwigsburg gibt es sogar separat ausgewiesene Autozähler von Eco-Counter (https://data.eco-counter.com/ParcPublic/?id=6011).

Eco-Visio ist ein Analysetool zur Auswertung der Daten. Die Daten zahlreicher (aber nicht aller) Zähler sind öffentlich einsehbar (Option 'publicwebpage'), teilweise gruppiert nach Träger/Organisation/Domäne (Option 'publicwebpageplus').

Der Zugriff auf nicht-öffentlich einsehbare Zähler erfolgt über die Eco-Counter API auf die auf https://developers.eco-counter.com/ beschriebene Weise (oder nach einem Login auf https://www.eco-visio.net/v5/login/).

Fahrradzzähler Nürnberg

Publicwebpageplus

URL: https://www.eco-visio.net/api/aladdin/1.0.0/pbl/publicwebpageplus/{idOrganisme}

Alle Zähler eines Trägers mit ID idOrganisme (z.B. 4586, 20 oder 8080). Eine Übersicht über gültige Ausprägungen des Parameters idOrganisme und deren Bedeutung gibt die Tabelle hier (Stand: 18.05.2023). Neben Zählern, die im Rahmen einer Publicwebpageplus einer idOrganisme zugeordnet sind, gibt es weitere Zähler (siehe Publicwebpage, unten). Eine Sammlung aller aktuell bekannten Zähler findet sich in der Tabelle hier

Einige idOrganisme sind deutschen Bundesländern und Städten zugeordnet:

8080=Hessen, 6365=Mecklenburg-Vorpommern, 4728=Berlin, 677=Köln, 4701=Bonn, 6011=Ludwigsburg, 4206=Heidelberg, 607=Stuttgart, 4702=Rhein-Sieg-Kreis, 857=Düsseldorf, 888=Rostock, 5417=Augsburg, 5972=Leipzig, 7119=Bielefeld, 4197=Mannheim, 7581=Reutlingen, 7224=Hürth, 4729=Würzburg, 7241=Norderstedt, 751=Freiburg, 6109=Oberbergischer Kreis und Rheinisch-Bergischer Kreis, 4699=Rheinisch-Bergischer Kreis und Oberbergischer Kreis, 6076=Oberhausen, 6116=Schwerin, 7642=Leverkusen, 6135=Goslar, 6997=Greifswald, 6471=Ludwigshafen, 7058=Siegen, 4626=Essen, 6603=Bochum, 6481=Aschaffenburg, 6811=Böblingen, 6150=Dortmund.

Außerdem sind Zähler in deutschen Städten ausgewiesen unter idOrganisme 4586 (="Bike Count Display Interactive Map") und 5024 (="National Database Demo").

Parameter

Parameter: withNull

Parameter ohne bekannten/dokumentierten Effekt.

Parameter: end (optional)

Spätestes interessierendes Datum (z.B. "26/05/2022").

Parameter: begin (optional)

Frühestes interessierendes Datum (z.B. "01/01/2021").

Parameter: pratique (optional)

"pratique" i.S.v. Beschränkung auf interessierende Zählerart (z.B. 1=Fußgänger, 2=Fahrräder, 4=Autos, oder 12=Sternchen).

URL: https://www.eco-visio.net/api/aladdin/1.0.0/pbl/publicwebpageplus/data/1

Werte für einen spezifischen Zähler mit ID idPdc (z.B. 100125116) der als GET-Parameter zu spezifizieren ist (optional auch ergänzend als Pfad-Parameter statt der 1).

Parameter

Parameter: idOrganisme (mandatory)

ID des Trägers (z.B. 4586, 20 oder 8080)

Parameter: idPdc (mandatory)

ID des Zählers (z.B. 100125116)

Parameter: interval (mandatory)

  • 1
  • 2
  • 3
  • 4
  • 5
  • 6

Aggregationsintervall (6=Monate, 5=Wochen, 4=Tage, 3=Stunden, 2=Viertelstunden, 1=Viertelstunden?).

Parameter: flowIds (mandatory)

pratique-ID, ggf. mehrere mit Semikolon getrennt' (z.B. 101125116;102125116;353247560;353247561).

Parameter: fin (optional)

Spätestes interessierendes Datum (z.B. 26/05/2022).

Parameter: debut (optional)

Frühestes interessierendes Datum (z.B. 01/01/2021).

Beispiel

counters=$(curl -m 60 https://www.eco-visio.net/api/aladdin/1.0.0/pbl/publicwebpageplus/4586)
data=$(curl -m 60 "https://www.eco-visio.net/api/aladdin/1.0.0/pbl/publicwebpageplus/data/100125116?idOrganisme=4586&idPdc=100125116&interval=4&flowIds=101125116%3B102125116%3B353247560%3B353247561")

Publicwebpage

URL: https://www.eco-visio.net/api/aladdin/1.0.0/pbl/publicwebpage/{idPdc}

Metadaten zu ausgewählten Zählern auf Basis der idPdc (z.B. 100063085).

Parameter: withNull

Anzeige unspezifizierter Werte (z.B.true)

URL: https://www.eco-visio.net/api/aladdin/1.0.0/pbl/publicwebpage/data/{idPdc}

Zählerdaten zu ausgewählten Zählern auf Basis der idPdc (z.B. 100063085). Eine Liste aller idPdc-Einträge (Stand: 21.05.2023) findet sich hier.

Parameter: begin

Frühestes interessierendes Datum (z.B. 20201001)

Parameter: end

Spätestes interessierendes Datum (z.B. 20221027)

Parameter: step

Interval (z.B. 4).

Parameter: domain

idOrganisme (z.B. 7242).

Parameter: withNull

Anzeige unspezifizierter Werte (z.B.true)

Parameter: t

Token (z.B. 81ee145d681ec7d08a28a037257117634ff718053a5e6f639948583cf3fb0f8b)

URL: https://www.eco-visio.net/api/aladdin/1.0.0/pbl/publicwebpage/stats/{idPdc}

Statistiken zu ausgewählten Zählern auf Basis der idPdc (z.B. 100063085). Eine Liste aller idPdc-Einträge (Stand: 21.05.2023) findet sich hier.

Parameter: begin

Frühestes interessierendes Datum (z.B. "20201001")

Parameter: end

Spätestes interessierendes Datum (z.B. 20221027)

Parameter: step

Interval (z.B. 4).

Parameter: domain

idOrganisme (z.B. 7242).

Parameter: withNull

Anzeige unspezifizierter Werte (z.B.true)

Parameter: t

Token (z.B. 81ee145d681ec7d08a28a037257117634ff718053a5e6f639948583cf3fb0f8b)

Beispiel

counter=$(curl https://www.eco-visio.net/api/aladdin/1.0.0/pbl/publicwebpage/100063085)
data=$(curl https://www.eco-visio.net/api/aladdin/1.0.0/pbl/publicwebpage/data/100063085?begin=20201001&end=20221027&step=4&domain=7242&withNull=true&t=81ee145d681ec7d08a28a037257117634ff718053a5e6f639948583cf3fb0f8b)
stats=$(curl https://www.eco-visio.net/api/aladdin/1.0.0/pbl/publicwebpage/stats/100063085?begin=1640991600000&end=1666821540000&domain=7242&t=81ee145d681ec7d08a28a037257117634ff718053a5e6f639948583cf3fb0f8b&siteId=100063085)

About

API zum Eco-Visio-Dashboard von Eco-Counter

Resources

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published

Languages

  • Python 97.4%
  • R 1.6%
  • Other 1.0%