Schnittstellen zur Personenzählung: so kommen die Daten heraus

Die Schnittstellen von Vicodis laufen auf der Kamera selbst: Live-Schnittstellen für Anzeigen und Ihre eigenen Systeme, Export als CSV und PDF und zeitgesteuerte Berichte über Ihren eigenen Mailserver statt über unseren.

Live-Zahl als JSON oder reiner Text
CSV-Export und PDF-Berichte für jeden Zeitraum
Berichte per E-Mail und Übertragung an Ihre Server

GET /local/vicodis/api/live
{
  "occupied": 83,
  "capacity": 120,
  "free": 37,
  "state": "ok",
  "today": { "in": 412, "out": 329 }
}
GET /local/vicodis/api/live.txt?value=free
37

Live

Die Live-Schnittstelle

Eine Adresse liefert alle aktuellen Zahlen als JSON: Personen oder Fahrzeuge vor Ort, Kapazität, freie Plätze, den Zustand der Ampel und die Eintritte und Austritte des Tages. Eine zweite Adresse liefert einen einzelnen Wert als reinen Text – für Anzeigen, die kein JSON lesen können.

Angemeldet wird mit einem normalen Kamerakonto, Betrachterrechte genügen. Ein Abfrageabstand von 2 bis 10 Sekunden reicht völlig, weil sich die Zahlen nur ändern, wenn jemand die Linie überquert.

Felder für eine Anzeige

occupiedjetzt anwesend

freefreie Plätze

stateok · warn · full

todayEintritte und Austritte heute

zonesje Zone, mit Zone

Anzeigen

Anbindung an Digital Signage

Die Zählwerte funktionieren mit fast jedem Player – ohne Plugin, ohne Middleware.

Text-Widget

Ein Text- oder Web-Widget auf live.txt?value=free zeigt die Zahl der freien Plätze.

Farbe nach Zustand

Das Feld state wechselt zwischen ok, warn und full, der Player kann also die Farbe wechseln, ohne etwas zu rechnen.

Eine Zone je Bildschirm

Mit mehreren Kameras zeigt jeder Bildschirm über den Parameter zone seine eigene Zone oder Ebene.

Browserzugriff auf Wunsch

Der Zugriff von fremden Webseiten ist ab Werk aus und wird nur eingeschaltet, wenn ein Widget ihn braucht.

Nach außen, wenn Sie es wollen

Zahlen an Ihren eigenen Server übertragen

Für eine öffentliche Website wollen Sie nicht, dass Besucher ins Kameranetz greifen. Stattdessen kann Vicodis die Live-Zahl alle 30 Sekunden an einen kleinen Empfänger auf Ihrem eigenen Webserver übertragen – und sofort, wenn die Ampel wechselt. Die Anfrage ist mit einem Token geschützt, das Sie festlegen.

Für Berichtssysteme kann Vicodis außerdem die Zählwerte des ganzen Tages an eine Adresse Ihrer Wahl senden, in einem Abstand zwischen 5 Minuten und einem Tag – etwa für die Fahrgastzählung über viele Haltestellen.

Live-Übertragung

RichtungKamera → Ihr Server

Abstand30 s, einstellbar 10–300 s

SchutzToken über HTTPS

Inhaltnur Zählwerte

Dateien

Export als CSV und PDF

Der CSV-Export liefert die Zählwerte für jeden Zeitraum, den Sie wählen, je Stunde, Tag oder Monat. Die Dateien sind UTF-8 mit Semikolon, sie öffnen sich also direkt in Excel und lassen sich sauber in Power BI importieren. Derselbe Bericht lässt sich aus der Druckansicht als PDF speichern.

Der Kopf des Berichts nennt Standort, Geräte-ID, Zeitraum und was gezählt wurde – nützlich, wenn die Zahlen in einen Förderbericht gehen.

Berichtsexport

Zeitraumfrei wählbar

RasterStunde, Tag, Monat

CSVUTF-8, Semikolon

PDFaus der Druckansicht

KopfStandort, Geräte-ID, Zeitraum

E-Mail

Berichte über Ihren eigenen Mailserver

Vicodis kann zu einer festen Zeit einen täglichen, wöchentlichen oder monatlichen Bericht senden: eine kurze Zusammenfassung in der E-Mail und die Zahlen als CSV-Anhang. Alles läuft über Ihren Mailserver, mit STARTTLS oder SSL – bei uns gibt es kein Relay.

Täglich, wöchentlich oder monatlich, zur festen Zeit
Zusammenfassung plus CSV-Anhang
Versand über Ihren Mailserver, nicht unseren

Bestehende Systeme

Kompatible Datenabholung für bestehende Auswertungen

Vicodis antwortet auch in den Datenformaten der klassischen Zähl-Apps – CSV, JSON, XML und .cnt –, sodass dafür gebaute Auswertungen es lesen können. Einzelheiten beim Nachfolger für Cognimatics-Zähler.

Warum nichts davon eine Cloud braucht: Personenzähler ohne Cloud. Alle Schnittstellen gehören zum Vicodis Besucherzähler. Die vollständige Schnittstellendokumentation mit jedem Endpunkt und Feld erhalten Sie auf Anfrage über unser Kontaktformular.

FAQ

Fragen zu den Schnittstellen

Wie kommt eine Anzeige an die Live-Zahl?

Sie liest die Live-Schnittstelle auf der Kamera. Eine Textadresse liefert einen einzelnen Wert wie die Zahl der freien Plätze, den fast jeder Signage-Player anzeigen kann; die JSON-Adresse liefert alle Zahlen einschließlich des Ampelzustands. Für die Anmeldung genügt ein Kamerakonto mit Betrachterrechten.

Können wir die Zahl auf unserer öffentlichen Website zeigen?

Ja, ohne das Kameranetz zum Internet zu öffnen. Vicodis überträgt die Live-Zahl alle 30 Sekunden an einen kleinen Empfänger auf Ihrem eigenen Webserver, geschützt mit einem Token. Ihre Website liest die Zahl dann von ihrem eigenen Server. Übertragen werden nur Zählwerte, nie Bilder, und nur an die Adresse, die Sie festlegen.

Welches Format hat der CSV-Export?

UTF-8 mit Semikolon als Trennzeichen, er öffnet sich also mit deutschen Einstellungen direkt in Excel und lässt sich sauber in Power BI oder andere Werkzeuge importieren. Sie wählen Zeitraum und Raster – Stunde, Tag oder Monat –, und der Kopf nennt Standort, Geräte-ID und Zeitraum.

Wie viele Besucher hat Ihr Eingang wirklich?

Nennen Sie uns Ihr Kameramodell oder Ihr Projekt – wir prüfen die Eignung und melden uns mit einem konkreten Vorschlag.

Projekt schildern