Wiki-Quellcode von positions/get_border_crossings.php
Version 3.1 von YellowFox_RD am 2026/05/11 10:34
Zeige letzte Bearbeiter
| author | version | line-number | content |
|---|---|---|---|
| 1 | {{toc/}} | ||
| 2 | |||
| 3 | |||
| 4 | = Beschreibung = | ||
| 5 | |||
| 6 | (% class="green mark" %)**GET**(%%)** ** positions/get_border_crossings.php?company**=//COMPANY_RTIKEY//**&vehicle**=//VEHICLE_RTIKEY//**&start**=//YYYY-MM-DDTHH:MM:SS+HH:mm//**//&end//**=//YYYY-MM-DDTHH:MM:SS+HH:mm//** | ||
| 7 | |||
| 8 | = Parameter = | ||
| 9 | |||
| 10 | |=Parameter|=Beschreibung|=Typ|=Hinweis|=Pflicht | ||
| 11 | |company|RTI Firmenschlüssel|string| |ja | ||
| 12 | |vehicle|RTI Fahrzeugschlüssel|string|(% colspan="1" rowspan="3" %)Es muss vehicle, group oder import angegeben werden.|(ja) | ||
| 13 | |group|RTI Gruppenschlüssel|string|(ja) | ||
| 14 | |import|RTI Importschlüssel|string|(ja) | ||
| 15 | |start|Anfang des Abfragezeitraum|datestring|Format: ISO 8601 (//YYYY-MM-DDTHH:MM:SS+HH:mm//)|ja | ||
| 16 | |end|Ende des Abfragezeitraum|datestring|Format: ISO 8601 (//YYYY-MM-DDTHH:MM:SS+HH:mm//)|((( | ||
| 17 | ja | ||
| 18 | ))) | ||
| 19 | |offset|Die Anfrage liefert maximal 1000 Datensätze zurück. Durch ein Offset können Sie den nächsten Block anfragen.|int|Standard: 0|nein | ||
| 20 | |||
| 21 | = Rückgabe = | ||
| 22 | |||
| 23 | Es wird ein **string** zurückgegeben. Im Fehlerfall wird "**ERROR:Beschreibung**" zurückgegeben. | ||
| 24 | |||
| 25 | |||
| 26 | == JSON == | ||
| 27 | |||
| 28 | {{code language="json"}} | ||
| 29 | { | ||
| 30 | "_date": { | ||
| 31 | "query_date": "2026-05-11T08:33:10+02:00", | ||
| 32 | "start": "2026-04-04T02:00:00+02:00", | ||
| 33 | "end": "2026-05-04T23:15:00+02:00" | ||
| 34 | }, | ||
| 35 | "_links": { | ||
| 36 | "next": { | ||
| 37 | "href": null | ||
| 38 | } | ||
| 39 | }, | ||
| 40 | "has_more": false, | ||
| 41 | "items": [ | ||
| 42 | { | ||
| 43 | "gpsDate": "2026-04-21T07:22:25+02:00", | ||
| 44 | "unit": { | ||
| 45 | "licensePlate": "FTL YF 123", | ||
| 46 | "rtiIdent": "U123" | ||
| 47 | }, | ||
| 48 | "driver": { | ||
| 49 | "name": "Max Mustermann", | ||
| 50 | "key": "123456789", | ||
| 51 | "employeeNumber": "1" | ||
| 52 | }, | ||
| 53 | "from": { | ||
| 54 | "countryCode": "D" | ||
| 55 | }, | ||
| 56 | "to": { | ||
| 57 | "countryCode": "NL" | ||
| 58 | }, | ||
| 59 | "position": { | ||
| 60 | "text": "NL-9057 Jelsum Aldlânsdyk", | ||
| 61 | "lat": 53.234474, | ||
| 62 | "lon": 5.7904854 | ||
| 63 | } | ||
| 64 | } | ||
| 65 | ] | ||
| 66 | } | ||
| 67 | {{/code}} | ||
| 68 | |||
| 69 | == Beispielaufrufe == | ||
| 70 | |||
| 71 | === Abfrage für ein einzelnes Fahrzeug === | ||
| 72 | |||
| 73 | {{code language="javascript"}} | ||
| 74 | https://map.yellowfox.de/rti/positions/get_border_crossings.php?company=COMPANY_RTIKEY&vehicle=VEHICLE_RTIKEY&start=2022-09-22T13:23:00%2B00:00:00&end=2022-09-25T13:23:00%2B00:00:00 | ||
| 75 | {{/code}} | ||
| 76 | |||
| 77 | === Abfrage mit RTI Ident === | ||
| 78 | |||
| 79 | {{code language="javascript"}} | ||
| 80 | https://map.yellowfox.de/rti/positions/get_border_crossings.php?company=COMPANY_RTIKEY&vehicle={"type":"car_ident","groupKey":"GROUP_RTIKEY","ident":"VEHICLE_IDENT"}&start=2022-09-22T13:23:00%2B00:00:00&end=2022-09-25T13:23:00%2B00:00:00 | ||
| 81 | {{/code}} |