SitePoint Java Example App for Android

To help getting started with a SitePoint app, this example provides code for:

• Managing connections to SitePoints
• Aiding SitePoints via NTRIP
• Displaying realtime location and status information

To keep the focus on the required functional code, we've opted to provide additional information in the form of detailed comments where applicable. This approach keeps functional code separate from implementation code, allowing you to see recommendations, tips, and options for implementation where applicable.

Getting Started

1. Clone this repo on your development machine.
2. Load and compile the project using Android Studio

This app was developed and tested using:

• Android Studio Iguana (2023.2.1 Patch 2)
• Gradle v8.4
• Android Gradle Plugin v8.3.2
• compileSdk = 34, targetSdk = 32, minSdk = 30

Connecting to the SitePoint

1. To ensure that your SitePoint has a sufficient charge, please connect the USB charger. You can verify the charge level once connected in the following steps.
2. From Android Studio, build and run the app to a physical device. The Android Studio simulator for Android devices does not support Bluetooth, which is required.
3. When the app loads, find your SitePoint in the scan results and click the Connect button.
4. Once connected, spin down the Status and Location sections.
5. The data in the Status section will update around once per second.
6. The data in the Location section will begin to improve in accuracy once the SitePoint acquires satellites and progresses with determining its location.

• Note: For best results, we recommend placing your SitePoint in a location with open sky view. Placing in a window will take much longer to get an accurate location compared to placement with an open sky view, and may not be able to get into RTK Fixed mode when aided by NTRIP as described below.

Connect to NTRIP for high-accuracy location

This process requires you to have an active account with an NTRIP provider (RTK network with an NTRIP caster).

For a list of NTRIP providers in US states, please refer to this GPS World article.

1. With the SitePoint still connected, spin down the NTRIP section.
2. Fill in your NTRIP server address, port, username, password, and mountpoint.
3. Click the Connect button to begin receiving RTCM aiding data and relaying them to the SitePoint.
4. View the success of the last 8 RTCM messages by observing the aidingQuality values at the bottom of the Status section.

• The aidingQuality is an array of boolean values.
• True (1) indicates that the message was successfully used, while False (0) indicates that a message was received but could not be used.
• Occasional False values are not uncommon, which is dependent upon the RTCM message formatting from your NTRIP service provider.
• SignalQuest's NTRIP parsing complies with all RTCM standards, but we include some additional handling measures for common deviations from the standard.

Integrate with your app

Using the SitePoint demo app code as a reference, you can begin to add the functionality to your existing app.

If you need any assistance, please submit a request through the SignalQuest contact page.

Be sure to check out the SitePoint Java Getting Started Guide for additional information.