API dostępowe - dane online

    System monitorowania NaviCar umożliwia dostęp do danych online za pomocą dedykowanego interfejsu działającego w protokole ATLAS.

    Protokół ATLAS umożliwia integrację naszego systemu z zewnętrznymi usługami, takimi jak giełdy transportowe czy systemy wizualizacji danych, zapewniając im dostęp do kluczowych danych przewoźnika, takich jak aktualne pozycje GPS pojazdów czy lista dostępnych pojazdów. Dostęp do tych informacji odbywa się poprzez proces uwierzytelnienia z użyciem dedykowanego adresu URL, loginu i hasła, które są przekazywane w poniższych linkach jako [URL], [LOGIN] i [PASSWORD]. Okres ważności dostępu do danych może być ograniczony czasowo i jest ustalany podczas zakładania konta.

Użytkownik systemu NaviCar może samodzielnie tworzyć i edytować konta z poziomu aplikacji - instrukcja znajduje się tutaj.

Typowo dla użytkownika dostępne są w polecenia - dostęp do listy pojazdów i danych online, istnieje możliwość dodania dodatkowych niestandardowtych poleceń wg ustaleń z klientem.

Dostępne polecenia w API

Lista dostępnych urządzeń klienta

Adres URL: https://[API]/[LOGIN]/devices?password=[PASSWORD]

Zapytanie zwraca tablicę obiektów zawierających informacje o urządzeniu:

• deviceId (integer) - identyfikator urządzenia
• deviceName (string) - opis, nazwa, nr rejestracyjny urządzenia

Przykładowa odpowiedź w formacie JSON:

Bieżące pozycje (dane online)

Adres URL: https://[API]/[LOGIN]/positions?password=[PASSWORD]

Zapytanie zwraca tablicę obiektów zawierających pojedyncze ostatnie (najświeższe dostępne) informacje o statusie urządzenia:

• deviceID (integer) - identyfikator urządzenia
• coordinate (obiekt) - zawiera współrzędne geograficzne (latitude, longitude) w układzie współrzędnych WGS84
• heading (integer) - kierunek jazdy w stopniach, kąt liczony jest zgodnie z kierunkiem ruchu wskazówek zegara (0 - północ, 90 - wschód, 180 - południe - 270 zachód)
• speed (integer) - prędkość w km/h
• ignitionState (string) - stan zapłonu (ON/OFF)
• dateTime (obiekt) - zawiera datę i czas zarejestrowania próbki danych

Przykładowa odpowiedź w formacie JSON:

Ze względu na specyfikę działania rejestratorów GPS (wysyłka danych w określonych interwałach czasu) zalecamy, aby odpytania o dane online odbywały się nie częściej niż co 1 minutę. W przypadku konieczności dostępu do danych archiwalnych za pomocą dedykowanego API,  istnieje także możliwość dodania dedykowanych poleceń - prosimy o kontakt z naszym działem wsparcia technicznego.

Udostępnij stronę innym