ZSDK-Android

NextNav’s Altitude SDK (called ZSDK) for Android platforms generates industry leading high accuracy Altitude (Z dimension) Location data for a given 2D data location on Android devices equipped with modern barometric pressure sensors.

The ZSDK is available as an AAR file for integration into Android Apps.  Access to the Altitude data from the ZSDK is enabled via the use of a Developer-KEY. A unique Developer-KEY is needed for each App bundle ID/name. 

The Host-App needs to initialize the ZSDK and then start the ZSDK by requesting Altitude data in one of 4 supported modes. The ZSDK performs the requisite actions to generate the Altitude data and provides it to the Host-App via a defined interface along with status and/or error messages. The ZSDK also supports interfaces for

The ZSDK Altitude generation modes are:

ZSDK AAR File Specification:

  • File size = ~145KB
  • Android Platform Support = Android 8, 9 & 10
  • Access and Permissions Needed
    • Location Data
    • Pressure Data
    • Storage
    • Network Access
  1. One-Time Mode
    1. Outputs Altitude data only once per request
  2. Once per Second
    1. Outputs Altitude data once per second till Host-App stops ZSDK
  3. Once per 30sec
  4. Once per minute

Altitude Data is reported in meters HAE (based on the WGS-84 geodetic system) and in HAT (Height Above Terrain)

public class AltitudeContextNotification { 
    private String height;    //Height in Meters
    private String heightUncertainty;    //Height Uncertainty in Meters
    private String floorNumber;    //Floor Number if in Known Building
    private String floorConfidence;    //Floor Confidence
    private String address;    //Address of Current Location
    private String addressConfidence;    //Address Confidence
    private String statusCode;    //Altitude Service Status Code
    private String errorMessage;  // Additional error message if applicable
    private long epochTimestamp; // epoch timestamp of altitude data
} 

 

ZSDK status and error information summary :

Altitude Service Status Code

Altitude Service Error Messages

SDK Status Messages

200        Successful Assistance Data Delivery

400        General Server Failure

600        2D location is out of  Service Area

610-640 Unable to calculate Altitude Data

 

Phone Pressure Data is Stale

Reference Data is Stale

Phone Location Data is Stale

NN Cloud Connection Timeout

SDK Not Initialized

Invalid Mode

Location Permission Not Granted

Storage Permission Not Granted

Waiting for Phone Pressure

Waiting for Phone Location

Android ZSDK Documentation link : https://app.box.com/s/35rdypv60mkyrmyisbfi4stfv9d3evrt

Please contact your NextNav representative for additional information on using ZSDK in your application.

© 2016 NextNav LLC. All Rights Reserved.