Repository files navigation

The Android Views SDK is used for getting live location and movement data for devices and trips directly to your Android app. This module subscribes to HyperTrack's GraphQL server end points to get data streams and then renders it in useful callbacks for app developers to build beautiful tracking experiences. This helps developers creating live location views go serverless. Their app users can directly get data securely and privately from the HyperTrack servers.

• Integrate the Views SDK
• FAQ

Check theIntegration Guide

• What API levels (Android versions) are supported
• How do I get the DeviceID
• The views SDK doesn't give me views!
• How to manage multiple devices?
• How do I subscribe to a specific Trip via onTripUpdateReceived?Will I get an update for creation, re-calculation, and delay of Trips?
• What does 0BatteryState means?

Currently we do support all of the Android versions starting from API 19 (Android 4.4 Kit Kat)

Device id is a way to reference particular device, that is tracked by HyperTrack SDK.Generally, it's your application logic which devices should be displayed and how to filter/prioritize/selectthe one you need to track. If you have doubts regarding how to integrate HyperTrack SDK - look intocorrespondingquickstart section.Once integration is done, device id can be obtained viaHyperTrack.getDevcieid() call on initialized SDK.

Although view is associated with something, that should be visual, here it means view on data, thatyou retrieve fromHyperTrack SDK. Tricky part isthat application success nowadays is highly dependends on quality of user experience, that is hardlyachievable without fine-grained tuning of UI elements. So using real-time data pushed to your device,you can build exactly the same views you really want. Anyway, ready to use UI elements will be addedto upcoming library releases.

You can subscribe to more than one device by executingsubscribeToDeviceUpdates multiple times withdifferent device ids. Subscription updates consumer can be the same (e.g. map fragment), since eachupdate has device id field for identification.

Each trip has a device id, for which it was created, pass that id tosubscribeToDeviceUpdates andyou'll receive all the trip recalculations and delays intoonTripUpdateReceived callback.

Using enums in Android isdiscouraged,so we're using numerical values to represent BatteryState. Check outreferencefor exact values meaning.