- Created by YellowFox R&D on Oct 21, 2015
You are viewing an old version of this page. View the current version.
Compare with Current View Page History
Version 1 Next »
You have English selected as language but this page has not been translated yet. Translate the page or view the content in the default space language below.
Display defaultGibt die Positionsdaten eines Fahrzeuges oder einer Fahrzeuggruppe zurück.
Beschreibung
get_pos.php?company=COMPANY_RTIKEY&vehicle=VEHICLE_RTIKEY&start=YYYYMMDDHHMM&end=YYYYMMDDHHMM&format=csv
Parameter
Parameter | Beschreibung | Typ | Hinweis | Pflicht |
---|---|---|---|---|
company | RTI Firmenschlüssel | string | ja | |
vehicle | RTI Fahrzeugschlüssel | string | entweder vehicle oder group Parameter | (ja) |
group | RTI Gruppenschlüssel | string | entweder vehicle oder group Parameter | (ja) |
start | Anfang des Abfragezeitraum | datestring | Format: YYYYMMDDHHMM es wird das Datum der Meldungsverarbeitung(insertdate) verwendet | nein |
end | Ende des Abfragezeitraum | datestring | Format: YYYYMMDDHHMM es wird das Datum der Meldungsverarbeitung(insertdate) verwendet | nein |
format | Rückgabeformat | string | csv (Standard) oder xml | nein |
Rückgabewerte
Es wird ein string zurückgegeben. Im Fehlerfall wird "ERROR_Beschreibung" zurückgegeben.
CSV Format
Metainformationen
Trennzeichen | Semikolon ( ; ) |
---|---|
Textbegrenzer | Doppeltes Hochkomma ( " ) |
Zeilenende | 0x0D 0x0A (CarriageReturn LineFeed) |
Header | Zeile 1 |
Spalten
Spalte | Beschreibung | |
---|---|---|
VEHICLE | Fahrzeugkennzeichen | |
DATE | GPS Datum wann die Meldung erzeugt wurde | Format: YYYY-MM-DD HH:MM:SS |
LAT | Latitude | Bsp.: 51.03659 |
LON | Longitude | Bsp.: 13.59967 |
POS | Adresse | |
DIR | Richtung in ganzen Grad | 0=Nord, 90=Ost |
SAT | Anzahl Satelliten | |
SPEED | Geschwindigkeit in ganzen km/h | |
IGN | Zündungsstatus | 0 = Aus, 1 = An |
REASON | Grund der Meldung | |
KM | Kilometerstand in ganzen km | |
INSERTDATE | Datum wann die Meldung im Rechenzentrum verarbeitet wurde | Format: YYYY-MM-DD HH:MM:SS |
UTCDATE | UTC Datum wann die Meldung erzeugt wurde | Format: YYYY-MM-DD HH:MM:SS |
DRIVER | Name des angemeldeten Fahrer | |
CUSTOMER | Kundenname | falls sich die Position einer Kundenadresse zuordnen lässt |
ETA_TIME | Erwartete Ankunftszeit am Navigationsziel | Format: YYYY-MM-DD HH:MM:SS |
ETA_DIST | Erwartete Distanz bis zum Navigationsziel in Kilometer | |
ETA_DUR | Erwartete Dauer bis zum Navigationsziel in Sekunden | |
ETA_LAT | Latitute Koordinate des Navigationsziels | Bsp.: 51.03659 |
ETA_LON | Longitude Koordinate des Navigationsziels | Bsp.: 13.59967 |
ETA_DESC | Kundenadresszuordnung des Navigationsziels | falls sich die Position einer Kundenadresse zuordnen lässt |
Beispiel
"VEHICLE";"DATE";"LAT";"LON";"POS";"DIR";"SAT";"SPEED";"IGN";"REASON";"KM";"INSERTDATE";"UTCDATE";"DRIVER";"CUSTOMER";"ETA_TIME";"ETA_DIST";"ETA_DUR";"ETA_LAT";"ETA_LON";"ETA_DESC" "353234024326181";"2015-04-15 08:52:42";"51.03669";"13.59925";"D-01723 Wilsdruff Am Wüsteberg 3";"207";"10";"0";"0";"Nachrichtstatus aktualisiert";"52469";"2015-04-15 08:52:57";"2015-04-15 06:52:42";"Herr Mueller";"YellowFox GmbH";"2015-04-15 09:52:42";"12.33";"3600";"50.862247";"12.908245";"Kunde Mueller"
XML Format
<?xml version="1.0" encoding="ISO-8859-1" standalone="no"?> <!DOCTYPE yfrtiout SYSTEM "http://map.yellowfox.de/rti/dtd/yfrtiout-1.2.dtd"> <yfrtiout> <message> <vehsign>353234024326181</vehsign> <date>2015-04-15 08:52:42</date> <lat>51.03669</lat> <lon>13.59925</lon> <pos>D-01723 Wilsdruff Am Wüsteberg 3</pos> <dir>207</dir> <sat>10</sat> <speed>0</speed> <ign>0</ign> <reason>Nachrichtstatus aktualisiert</reason> <km>52469</km> <insertdate>2015-04-15 08:52:57</insertdate> <utcdate>2015-04-15 06:52:42</utcdate> <driver>Herr Mueller</driver> <customer>YellowFox GmbH</customer> <eta_time>2015-04-15 09:52:42</eta_time> <eta_dist>12.33</eta_dist> <eta_dur>3600</eta_dur> <eta_lat>50.862247</eta_lat> <eta_lon>12.908245</eta_lon> <eta_desc>Kunde Mueller</eta_desc> </message> </yfrtiout>
Beispielaufrufe
http://map.yellowfox.de/rti/get_pos.php?company=COMPANY_RTIKEY&vehicle=VEHICLE_RTIKEY
http://map.yellowfox.de/rti/get_pos.php?company=COMPANY_RTIKEY&vehicle=VEHICLE_RTIKEY&start=20150401000000&end=20150401235959&format=xml
- No labels