Wiki-Quellcode von get_rs232ext.php
Zuletzt geändert von YellowFox_RD am 2025/01/20 15:36
Zeige letzte Bearbeiter
| author | version | line-number | content |
|---|---|---|---|
| 1 | (% class="box" %) | ||
| 2 | (((Inhaltsverzeichnis))) | ||
| 3 | {{toc/}} | ||
| 4 | |||
| 5 | Liefert per RS-232 übertragene Daten für YellowFox-Geräte mit aktivierter, erweiterter RS-232 Datenübertragung | ||
| 6 | = Beschreibung = | ||
| 7 | ****(% class="green mark" %)GET(%%) **get_rs232ext.php****?company**=//COMPANY_RTIKEY//**&vehicle**=//VEHICLE_RTIKEY//**&start**=//YYYYMMDDHHMMSS//**&end**=//YYYYMMDDHHMMSS//**&format**//=CSV//**&charset**//=ISO-8859-1// | ||
| 8 | = Parameter = | ||
| 9 | |=Parameter|=Beschreibung|=Typ|=Hinweis|=Pflicht | ||
| 10 | |company|RTI Firmenschlüssel|string||ja | ||
| 11 | |vehicle|RTI Fahrzeugschlüssel|string||ja | ||
| 12 | |start|Anfang des Abfragezeitraum|datestring|Format: YYYYMMDDHHMMSS | ||
| 13 | Zwischen (start) und (end) dürfen maximal sieben Tage liegen.|ja | ||
| 14 | |end|Ende des Abfragezeitraum|datestring|Format: YYYYMMDDHHMMSS | ||
| 15 | Zwischen (start) und (end) dürfen maximal sieben Tage liegen.|ja | ||
| 16 | |format|Rückgabeformat|string|CSV (Standard) oder CSV_B64|nein | ||
| 17 | |charset|Rückgabe Zeichensatz|string|Standard: ISO-8859-1 (ansonsten jeder beliebiger Charset Typ)|nein | ||
| 18 | |||
| 19 | = Rückgabe = | ||
| 20 | Es wird ein **string** zurückgegeben. Im Fehlerfall wird "(% class="error" %)**ERROR:Beschreibung**(%%)" zurückgegeben. | ||
| 21 | == CSV Format == | ||
| 22 | === Metainformationen === | ||
| 23 | |=Trennzeichen|Semikolon ( ; ) | ||
| 24 | |=Textbegrenzer|Doppeltes Hochkomma ( " ) | ||
| 25 | |=Zeilenende|0x0D 0x0A (CarriageReturn LineFeed) | ||
| 26 | |=Header|Zeile 1 | ||
| 27 | |||
| 28 | === Spalten === | ||
| 29 | |=Spalte|=Beschreibung|= | ||
| 30 | |DATE|GPS Datum wann die Meldung erzeugt wurde|YYYY-MM-DD HH:MM:SS | ||
| 31 | |CAR|Fahrzeugkennzeichen|string | ||
| 32 | |SERIALOUTPUT|per RS-232 übertragene Daten|string | ||
| 33 | |LAT|Latitude|Bsp.: 51.03659 | ||
| 34 | |LON|Longitude|Bsp.: 13.59967 | ||
| 35 | |||
| 36 | === Beispiel === | ||
| 37 | **Rückgabe SERIALOUTPUT** | ||
| 38 | {{code language="java"}}"DATE";"CAR";"SERIALOUTPUT";"LAT";"LON" | ||
| 39 | "2014-03-20 11:43:01";"FLT017 (T34118.0110)";"Prop.Skalning Av";"50.83012";"13.41215" | ||
| 40 | "2014-03-20 11:43:02";"FLT017 (T34118.0110)";"Oputput Portt 1 Text";"50.83012";"13.41215" | ||
| 41 | "2014-03-20 11:43:03";"FLT017 (T34118.0110)";"Farvald Tara Av";"50.83012";"13.41215"{{/code}} | ||
| 42 | |||
| 43 | == CSV Base 64 Format == | ||
| 44 | === Metainformationen === | ||
| 45 | |=Trennzeichen|Semikolon ( ; ) | ||
| 46 | |=Textbegrenzer|Doppeltes Hochkomma ( " ) | ||
| 47 | |=Zeilenende|0x0D 0x0A (CarriageReturn LineFeed) | ||
| 48 | |=Header|Zeile 1 | ||
| 49 | |||
| 50 | === Spalten === | ||
| 51 | |=Spalte|=Beschreibung|= | ||
| 52 | |DATE|GPS Datum wann die Meldung erzeugt wurde|YYYY-MM-DD HH:MM:SS | ||
| 53 | |CAR|Fahrzeugkennzeichen|string | ||
| 54 | |SERIALOUTPUT|per RS-232 übertragene Daten|string | ||
| 55 | |LAT|Latitude|Bsp.: 51.03659 | ||
| 56 | |LON|Longitude|Bsp.: 13.59967 | ||
| 57 | |||
| 58 | === Beispiel === | ||
| 59 | **Rückgabe SERIALOUTPUTB64** | ||
| 60 | {{code language="java"}}"DATE";"CAR";"SERIALOUTPUTB64";"LAT";"LON" | ||
| 61 | "2014-03-20 11:43:01";"FLT017 (T34118.0110)";"UHJvcC5Ta2FsbmluZyAgICAgQXY=";"50.83012";"13.41215" | ||
| 62 | "2014-03-20 11:43:02";"FLT017 (T34118.0110)";"T3B1dHB1dCBQb3J0dCAxICAgICAgICAgVGV4dA==";"50.83012";"13.41215" | ||
| 63 | "2014-03-20 11:43:03";"FLT017 (T34118.0110)";"RpRydmFsZCBUYXJhICBBdg==";"50.83012";"13.41215"{{/code}} | ||
| 64 | |||
| 65 | == JSON Format (RFC 4627) == | ||
| 66 | **Rückgabe JSON** | ||
| 67 | {{code language="java"}}[{ | ||
| 68 | "date":"2022-01-24 04:22:59" | ||
| 69 | ,"car":"FLT017 (T34118.0110)" | ||
| 70 | ,"serialoutput":"UHJvcC5Ta2FsbmluZyAgICAgQXY=" | ||
| 71 | ,"lat":"50.83012" | ||
| 72 | ,"lon":"13.41215" | ||
| 73 | }, | ||
| 74 | { | ||
| 75 | "date":"2022-01-24 04:23:01", | ||
| 76 | "car":"FLT017 (T34118.0110)", | ||
| 77 | "serialoutput":"T3B1dHB1dCBQb3J0dCAxICAgICAgICAgVGV4dA==", | ||
| 78 | "lat":"50.83012", | ||
| 79 | "lon":"13.41215" | ||
| 80 | }]{{/code}} | ||
| 81 | |||
| 82 | = Beispielaufrufe = | ||
| 83 | **Abfrage im Standard CSV mit Zeichensatz UTF-8** | ||
| 84 | {{code language="java"}}https://map.yellowfox.de/rti/get_rs232ext.php?company=COMPANY_RTIKEY&vehicle=VEHICLE_RTIKEY&start=20140320000000&end=20140321000000&charset=utf-8 | ||
| 85 | |||
| 86 | https://map.yellowfox.de/rti/get_rs232ext.php?company=COMPANY_RTIKEY&vehicle={"type":"car_ident","groupKey":"GROUP_RTIKEY","ident":"VEHICLE_IDENT"}&start=20140320000000&end=20140321000000&charset=utf-8{{/code}} | ||
| 87 | |||
| 88 | **Abfrage im Format CSV Base 64** | ||
| 89 | {{code language="java"}}https://map.yellowfox.de/rti/get_rs232ext.php?company=COMPANY_RTIKEY&vehicle=VEHICLE_RTIKEY&start=20140320000000&end=20140321000000&format=csv_b64 | ||
| 90 | |||
| 91 | https://map.yellowfox.de/rti/get_rs232ext.php?company=COMPANY_RTIKEY&vehicle={"type":"car_ident","groupKey":"GROUP_RTIKEY","ident":"VEHICLE_IDENT"}&start=20140320000000&end=20140321000000&format=csv_b64{{/code}} | ||
| 92 |