Wiki-Quellcode von get_messages_pnd.asp
Zuletzt geändert von YellowFox_RD am 2025/01/20 15:37
Zeige letzte Bearbeiter
| author | version | line-number | content |
|---|---|---|---|
| 1 | (% class="box" %) | ||
| 2 | (((Inhaltsverzeichnis))) | ||
| 3 | {{toc/}} | ||
| 4 | |||
| 5 | (% class="red mark" %)DEPRECATED(%%) | ||
| 6 | |||
| 7 | Gibt alle vom Fahrzeug an das Portal gesendeten Nachrichten zurück, welche sich im Abfragezeitraum befinden | ||
| 8 | = Beschreibung = | ||
| 9 | //**get_messages_pnd.asp?company**=RTI_COMPANYKEY**&vehicle**=RTI_VEHICLEKEY**&mode**=CSV**&time**=m// | ||
| 10 | = Parameter = | ||
| 11 | |||
| 12 | |=Parameter|=Beschreibung|=Typ|=Hinweis|=Pflicht | ||
| 13 | |company|RTI Firmenschlüssel|string||ja | ||
| 14 | |vehicle|RTI Fahrzeugschlüssel|string|vehicle oder group muss gesetzt sein|ja | ||
| 15 | |group|RTI Gruppenschlüssel|string|vehicle oder group muss gesetzt sein|ja | ||
| 16 | |time|Angabe aller Nachrichten der letzen x Minuten|integer|Die Angabe muss im Bereich 5-60 liegen|ja | ||
| 17 | |mode|Das ausgabeformat der zurück zu gebenden Daten|string|Es wird nur "CSV" als Augabeformat unterstützt. | ||
| 18 | Wenn nichts angegeben wurde wird austomatisch | ||
| 19 | der CSV-Modus genutzt.|nein | ||
| 20 | |||
| 21 | = Rückgabe = | ||
| 22 | Es werden Daten als **Zeichenkette** gegeben. Ansonsten wird bei einem Fehler ein "(% class="error" %)**ERROR:Beschreibung**(%%)" zurückgegeben | ||
| 23 | == CSV Format == | ||
| 24 | Bei einer korrekten Anfrage werden die Daten im CSV (Comma Separated Value) Format ausgeliefert wobei die erste | ||
| 25 | Anwortzeile immer die Kopfzeile ist, die die Feld-/Spalten Namen festlegt. Dannach folgen dann die Daten | ||
| 26 | === Metainformationen === | ||
| 27 | |=Trennzeichen|Semikolon ( ; ) | ||
| 28 | |=Textbegrenzer|Doppeltes Hochkomma ( " ) | ||
| 29 | |=Zeilenende|0x0D 0x0A (CarriageReturn LineFeed) | ||
| 30 | |=Header|Zeile 1 | ||
| 31 | |=Kodierung|UTF-8 | ||
| 32 | |||
| 33 | === Spalten === | ||
| 34 | |=Spalte|=Beschreibung | ||
| 35 | |DATE|Nachrichtenersrstellungsdatum (Format TT.MM.JJJJ HH:MM:SS) | ||
| 36 | |TEXT|Empfangener Nachrichtentext | ||
| 37 | |CAR|Kennzeichen des Fahrzeuges | ||
| 38 | |||
| 39 | === Beispiel === | ||
| 40 | |||
| 41 | {{code language="java"}}"DATE";"TEXT";"CAR"; | ||
| 42 | 04.08.2010 09:44:19;"Komme später";"Fahrzeug1"; | ||
| 43 | 04.08.2010 09:57:51;"Bin gleich da";"Fahrzeug1";{{/code}} | ||
| 44 | |||
| 45 | = Beispielaufruf = | ||
| 46 | **Alle Nachrichten des ausgewählten Fahrzeuges innerhalb der letzten 2 Minuten** | ||
| 47 | {{code language="java"}}https://map.yellowfox.de/rti/get_messages_pnd.asp?company=COMPANY_RTIKEY&vehicle=VEHICLE_RTIKEY&mode=CSV&time=2{{/code}} | ||
| 48 |