get_messages_pnd.asp

Zuletzt geändert von YellowFox_RD am 2025/01/20 15:37

Inhaltsverzeichnis

Beschreibung
Parameter
Rückgabe
- CSV Format
Beispielaufruf

DEPRECATED

Gibt alle vom Fahrzeug an das Portal gesendeten Nachrichten zurück, welche sich im Abfragezeitraum befinden

Beschreibung

get_messages_pnd.asp?company=RTI_COMPANYKEY&vehicle=RTI_VEHICLEKEY&mode=CSV&time=m

Parameter

Parameter	Beschreibung	Typ	Hinweis	Pflicht
company	RTI Firmenschlüssel	string		ja
vehicle	RTI Fahrzeugschlüssel	string	vehicle oder group muss gesetzt sein	ja
group	RTI Gruppenschlüssel	string	vehicle oder group muss gesetzt sein	ja
time	Angabe aller Nachrichten der letzen x Minuten	integer	Die Angabe muss im Bereich 5-60 liegen	ja
mode	Das ausgabeformat der zurück zu gebenden Daten	string	Es wird nur "CSV" als Augabeformat unterstützt. Wenn nichts angegeben wurde wird austomatisch der CSV-Modus genutzt.	nein

Rückgabe

Es werden Daten als Zeichenkette gegeben. Ansonsten wird bei einem Fehler ein "ERROR:Beschreibung" zurückgegeben

CSV Format

Bei einer korrekten Anfrage werden die Daten im CSV (Comma Separated Value) Format ausgeliefert wobei die erste
Anwortzeile immer die Kopfzeile ist, die die Feld-/Spalten Namen festlegt. Dannach folgen dann die Daten

Metainformationen

Trennzeichen	Semikolon ( ; )
Textbegrenzer	Doppeltes Hochkomma ( " )
Zeilenende	0x0D 0x0A (CarriageReturn LineFeed)
Header	Zeile 1
Kodierung	UTF-8

Spalten

Spalte	Beschreibung
DATE	Nachrichtenersrstellungsdatum (Format TT.MM.JJJJ HH:MM:SS)
TEXT	Empfangener Nachrichtentext
CAR	Kennzeichen des Fahrzeuges

Beispiel

"DATE";"TEXT";"CAR";
04.08.2010 09:44:19;"Komme später";"Fahrzeug1";
04.08.2010 09:57:51;"Bin gleich da";"Fahrzeug1";

Beispielaufruf

Alle Nachrichten des ausgewählten Fahrzeuges innerhalb der letzten 2 Minuten
https://map.yellowfox.de/rti/get_messages_pnd.asp?company=COMPANY_RTIKEY&vehicle=VEHICLE_RTIKEY&mode=CSV&time=2