MQTT-Schnittstelle
Bestenfalls werden die validierten Schnittstellen der GPSoverIP GmbH von Entwicklern in ihrer dokumentierten Form unverändert genutzt. Die Dokumentation ist im Entwickler-Portal der GPSoverIP (dieser Internetseite) in mehreren Programmiersprachen (z.B. PHP, Java, Delphi, Obj. C, ASP.net, AutoIT, C++, C#, Perl, python, Ruby, VB.net, Access) unter dem Punkt API-Referenzen einsehbar.
Darüber hinaus besteht die Möglichkeit, diverse Daten auch mit anderen API’s/Tools (wie z.B. den HLD) abzurufen/auszutauschen. Eine weitere Möglichkeit hierfür ist MQTT (Message Queuing Telemetry Transport).
Die GPSoverIP GmbH bietet ihren Kunden mit der MQTT-Schnittstelle zusätzlich zur herkömmlichen API die Möglichkeit, die aktuell gesendeten Positionsdaten ihrer Fahrzeuge via TCP/IP Verbindung abzugreifen. Zur Verwendung der Schnittstelle benötigen Sie einen MQTT-Client, der eine verschlüsselte, authentifizierte Verbindung zum MQTT-Broker der GPSoverIP GmbH herstellt.
Adresse: mqtt.gpsoverip.de
Port: 1883
Benutzername: Kontaktieren Sie hierfür bitte den GPSoverIP Customer Support
Passwort: Kontaktieren Sie hierfür bitte den GPSoverIP Customer Support
Sobald eine erfolgreiche Verbindung zum MQTT-Broker der GPSoverIP GmbH besteht, können Sie auf unterschiedliche Datenströme zugreifen
- Zum Abrufen der GPS-Daten Ihrer Fahrzeuge abonnieren Sie folgendes Thema: accounts/[Benutzername]/devices/[+|Gerätenummer]/gps
- Auf die CAN/FMS-Daten Ihrer Fahrzeuge greifen Sie über folgendes Thema zu: accounts/[Benutzername]/devices/[+|Gerätenummer]/fms/[+|Feldname]
Nachdem Sie ein Thema abonniert haben und Ihre Fahrzeuge aktuell in Bewegung sind, treffen die ersten Nachrichten ein.
Der Abruf der GPS-Daten hat immer folgendes Format:
{
"device_id":899994,
"ts":"2019-01-24 08:48:02",
"altitude":230,
"customizable_data":0,
"heading":12,
"latitude":50.0398,
"longitude":10.2084,
"mileage":1104990,
"satellite_count":8,
"speed":101.9
}
Die Nachrichten der FMS-Daten sind hingegen immer wie folgt aufgebaut:
{
"device_id": "899994", // Gerätenummer
"id": "91899103", // FMS Feld Id
"name": "acc_ped_pos", // FMS Feld Name
"timestamp": "2019-05-13 09:20:15", // UTC Zeitstempel
"value": "0" // Wert
}
Sofern Sie über den Ortungsdaten hinaus weitere Daten mittels MQTT benötigen, wie z.B. Telemetriedaten (Reifendruck, Drehzahl, Kraftstoffverbrauch etc.), zögern Sie nicht den Customer Support der GPSoverIP zu kontaktieren.
