Wiki-Quellcode von get_rs232.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. | ||
| 6 | = Beschreibung = | ||
| 7 | **(% class="green mark" %)GET(%%) get_rs232.php****?company**=//COMPANY_RTIKEY//**&vehicle**=//VEHICLE_RTIKEY//**&start**=//YYYYMMDDHHMMSS//**&end**=//YYYYMMDDHHMMSS**&format**=csv// | ||
| 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 (begin) und (end) dürfen maximal sieben Tage liegen.|ja | ||
| 14 | |end|Ende des Abfragezeitraum|datestring|Format: YYYYMMDDHHMMSS | ||
| 15 | Zwischen (begin) und (end) dürfen maximal sieben Tage liegen.|ja | ||
| 16 | |format|Rückgabeformat|string|csv (Standard), xml, json|nein | ||
| 17 | |||
| 18 | = Rückgabe = | ||
| 19 | (% class="error" %) (%%) Es wird ein **string** zurückgegeben. Im Fehlerfall wird "(% class="error" %)**ERROR:Beschreibung**(%%)" zurückgegeben. | ||
| 20 | |||
| 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 | |||
| 34 | === Beispiel === | ||
| 35 | == CSV Format == | ||
| 36 | **Rückgabe CSV** | ||
| 37 | {{code language="java"}}"DATE";"CAR";"SERIALOUTPUT" | ||
| 38 | "2016-05-19 14:30:02";"DD-ABC 123";"PNA|0|000014A5DE88|52|425884|2|*" | ||
| 39 | "2016-05-19 14:30:05";"DD-ABC 123";"PNA|0|000014A5DE88|52|425884|1|*" | ||
| 40 | "2016-05-19 14:30:06";"DD-ABC 123";"PNA|0|000014A5DE88|52|425885|2|*"{{/code}} | ||
| 41 | |||
| 42 | == XML Format == | ||
| 43 | **Rückgabe XML** | ||
| 44 | {{code language="java"}}<?xml version="1.0" encoding="ISO-8859-1" standalone="no"?><!DOCTYPE yfrtiout SYSTEM "https://map.yellowfox.de/rti/dtd/yf_getrs232.dtd"> | ||
| 45 | <yf_getrs232> | ||
| 46 | <message> | ||
| 47 | <date>2016-05-19 14:30:02</date> | ||
| 48 | <car>DD-ABC 123</car> | ||
| 49 | <serialoutput>PNA|0|000014A5DE88|52|425884|2|*</serialoutput> | ||
| 50 | </message> | ||
| 51 | <message> | ||
| 52 | <date>2016-05-19 14:30:05</date> | ||
| 53 | <car>DD-ABC 123</car> | ||
| 54 | <serialoutput>PNA|0|000014A5DE88|52|425884|1|*</serialoutput> | ||
| 55 | </message> | ||
| 56 | <message> | ||
| 57 | <date>2016-05-19 14:30:06</date> | ||
| 58 | <car>DD-ABC 123</car> | ||
| 59 | <serialoutput>PNA|0|000014A5DE88|52|425885|2|*</serialoutput> | ||
| 60 | </message> | ||
| 61 | </yf_getrs232>{{/code}} | ||
| 62 | |||
| 63 | == JSON Format (RFC 4627) == | ||
| 64 | **Rückgabe JSON** | ||
| 65 | {{code language="java"}}[{"date":"2016-05-19 14:30:02","car":"DD-ABC 123","serialoutput":"PNA|0|000014A5DE88|52|425884|2|*"},{"date":"2016-05-19 14:30:05","car":"DD-ABC 123","serialoutput":"PNA|0|000014A5DE88|52|425884|1|*"},{"date":"2016-05-19 14:30:06","car":"DD-ABC 123","serialoutput":"PNA|0|000014A5DE88|52|425885|2|*"}]{{/code}} | ||
| 66 | |||
| 67 | = Beispielaufrufe = | ||
| 68 | **Liefert per RS-232 übertragene Daten im CSV-Format** | ||
| 69 | {{code language="java"}}https://map.yellowfox.de/rti/get_rs232.php?company=COMPANY_RTIKEY&vehicle=VEHICLE_RTIKEY&start=20160519000101&end=20160520130001&format=csv | ||
| 70 | |||
| 71 | https://map.yellowfox.de/rti/get_rs232.php?company=COMPANY_RTIKEY&vehicle={"type":"car_ident","groupKey":"GROUP_RTIKEY","ident":"VEHICLE_IDENT"}&start=20160519000101&end=20160520130001&format=csv{{/code}} | ||
| 72 | |||
| 73 | **Liefert per RS-232 übertragene Daten im XML-Format** | ||
| 74 | {{code language="java"}}https://map.yellowfox.de/rti/get_rs232.php?company=COMPANY_RTIKEY&vehicle=VEHICLE_RTIKEY&start=20160519000101&end=20160520130001&format=xml | ||
| 75 | |||
| 76 | https://map.yellowfox.de/rti/get_rs232.php?company=COMPANY_RTIKEY&vehicle={"type":"car_ident","groupKey":"GROUP_RTIKEY","ident":"VEHICLE_IDENT"}&start=20160519000101&end=20160520130001&format=xml{{/code}} | ||
| 77 | |||
| 78 | **Liefert per RS-232 übertragene Daten im JSON-Format** | ||
| 79 | {{code language="java"}}https://map.yellowfox.de/rti/get_rs232.php?company=COMPANY_RTIKEY&vehicle=VEHICLE_RTIKEY&start=20160519000101&end=20160520130001&format=json | ||
| 80 | |||
| 81 | https://map.yellowfox.de/rti/get_rs232.php?company=COMPANY_RTIKEY&vehicle={"type":"car_ident","groupKey":"GROUP_RTIKEY","ident":"VEHICLE_IDENT"}&start=20160519000101&end=20160520130001&format=json{{/code}} | ||
| 82 |