# MapIt GIS

MapIt GIS is an Android GIS data collection and mapping application with a built-in NTRIP client for receiving real-time RTK corrections. The NTRIP functionality is provided through a companion app called **Mapit GIS - NTRIP Client**, which integrates directly with the main MapIt GIS data collector. Together, they connect to a Bluetooth GNSS receiver, stream corrections from an NTRIP caster like RTKdata.com, and enable centimeter-level data collection in the field.

**Download:**

* [MapIt GIS - Map Data Collector](https://play.google.com/store/apps/details?id=com.osedok.gisdatacollector) (Google Play Store — free tier available, Pro/Pro+ subscriptions for advanced features)
* [MapIt GIS - NTRIP Client](https://play.google.com/store/apps/details?id=com.osedok.ntripclient) (Google Play Store — free companion app, requires MapIt GIS 6.0.0+)

## Key capabilities

| Feature                 | Details                                                                                               |
| ----------------------- | ----------------------------------------------------------------------------------------------------- |
| **Platform**            | Android (phone or tablet); iOS version available                                                      |
| **Cost**                | Free tier available. NTRIP RTK corrections require **Pro+** subscription. 3-day free trial available. |
| **Receiver connection** | Bluetooth Classic, Bluetooth LE, TCP/Wi-Fi                                                            |
| **NTRIP support**       | Built-in via companion NTRIP Client app (NTRIP V1)                                                    |
| **Mock location relay** | No dedicated mock location feature — corrections are used within the MapIt GIS ecosystem              |
| **GIS features**        | Point/line/polygon collection, attribute forms, GeoJSON/KML/SHP/CSV export                            |
| **RTK processing**      | On-device RTK processing via RTKLIB engine — supports Single, DGPS, Float, and Fix modes              |

## Requirements

* Android phone or tablet running **MapIt GIS v6.0.0 or higher**
* **MapIt GIS - NTRIP Client** companion app installed (free from Play Store)
* **MapIt GIS Pro+** subscription (required for NTRIP RTK corrections)
* Multi-frequency (L1/L2) RTK-capable GNSS receiver with Bluetooth (e.g., ArduSimple, SparkFun RTK Facet, u-blox F9P board)
* Internet connection (cellular data or Wi-Fi)
* Active RTKdata.com account with RTK credentials

{% hint style="info" %}
Don't have an RTKdata.com account yet? [Start 30-day Free Trial](https://rtkdata.com/try-rtk-corrections-free-for-30-days/) or [View Pricing](https://rtkdata.com/pricing/)
{% endhint %}

## Step-by-step setup

{% stepper %}
{% step %}

#### Install both apps

1. Install **MapIt GIS - Map Data Collector** from the Google Play Store (v6.0.0 or higher).
2. Install **MapIt GIS - NTRIP Client** from the Google Play Store (free companion app).
3. Open MapIt GIS and verify the NTRIP Client option appears under settings.
   {% endstep %}

{% step %}

#### Enable the NTRIP Client in MapIt GIS

1. Open **MapIt GIS**.
2. Go to **Settings > External GNSS**.
3. Enable **NTRIP Client**. This activates the connection between the main app and the NTRIP Client companion app.
   {% endstep %}

{% step %}

#### Configure the Rover input stream

The NTRIP Client uses an RTKLIB-based architecture with separate Rover and Base input streams.

1. Open the **MapIt GIS - NTRIP Client** app.
2. Configure the **Rover (Input)** stream:
   * **Stream Type:** Bluetooth (or TCP, depending on your receiver connection)
   * Select your paired GNSS receiver from the device list
   * **Format:** RTCM3 or NMEA (match your receiver's output format)
3. Tap **Save** or confirm the rover stream settings.

{% hint style="warning" %}
Ensure your GNSS receiver is already paired in Android Bluetooth settings before configuring the Rover stream. The receiver must output NMEA data for position and accept RTCM3 corrections.
{% endhint %}
{% endstep %}

{% step %}

#### Configure the Base (NTRIP) input stream

1. In the NTRIP Client app, configure the **Base** input stream.
2. Set **Stream Type** to **NTRIP Client**.
3. Enter the NTRIP caster settings:

{% tabs %}
{% tab title="North America" %}

* **NTRIP Caster Host:** `rtk.rtkdata.com`
* **IP Fallback:** `13.56.117.10`
* **Port:** `2101`
* **Username / Password:** From *RTK Credentials* in the internal dashboard (not website login)
* **Mountpoint (ALL CAPS):** `AUTO` (recommended) — or `AUTO_WGS84`, `AUTO_ITRF2020`, `AUTO_ITRF2014`
  {% endtab %}

{% tab title="Europe" %}

* **NTRIP Caster Host:** `eu.rtkdata.com`
* **IP Fallback:** `3.73.41.96`
* **Port:** `2101`
* **Username / Password:** From *RTK Credentials* in the internal dashboard (not website login)
* **Mountpoint (ALL CAPS):** `AUTO` (recommended) — or `AUTO_WGS84`, `AUTO_ITRF2020`, `AUTO_ITRF2014`
  {% endtab %}

{% tab title="Australia" %}

* **NTRIP Caster Host:** `aus.rtkdata.com`
* **IP Fallback:** `54.206.56.130`
* **Port:** `2101`
* **Username / Password:** From *RTK Credentials* in the internal dashboard (not website login)
* **Mountpoint (ALL CAPS):** `AUTO` (recommended) — or `AUTO_WGS84`, `AUTO_ITRF2020`, `AUTO_ITRF2014`
  {% endtab %}
  {% endtabs %}

4. Leave **GGA sending enabled** (this is the default). RTKdata.com requires your approximate position via GGA to compute VRS corrections.

{% hint style="danger" %}
**GGA sending must stay enabled.** RTKdata.com uses your GGA position to generate corrections from the nearest Virtual Reference Station. Without GGA, the caster cannot compute corrections and you will remain stuck on Float indefinitely.
{% endhint %}
{% endstep %}

{% step %}

#### Set the positioning mode

1. In the NTRIP Client settings, find **Processing Options**.
2. Set the **Positioning Mode** to **Kinematic** (for RTK).
   * If set to **Single**, the app ignores corrections entirely — the Base input stream will not be used.
3. Save the settings.

{% hint style="warning" %}
**Positioning Mode must NOT be set to "Single."** In Single mode, the NTRIP Client does not use the Base (correction) stream at all, even if it is configured and connected. Set it to **Kinematic** for real-time RTK processing.
{% endhint %}
{% endstep %}

{% step %}

#### Start the RTK service and verify Fix

1. In the NTRIP Client app, open the navigation drawer and tap **Start Service**.
2. The app connects to your Bluetooth receiver (Rover) and to the RTKdata.com NTRIP caster (Base) simultaneously.
3. Monitor the RTK solution status: **Single > DGPS > Float > Fix**.
4. Once the status shows **Fix**, return to **MapIt GIS** — the corrected position is now available for data collection.

{% hint style="info" %}
The RTK service runs in the background. You can switch to MapIt GIS for data collection while the NTRIP Client maintains the correction stream. Fix typically takes 15–60 seconds under open sky.
{% endhint %}
{% endstep %}
{% endstepper %}

## Vertical reference (heights)

{% hint style="info" %}
Heights from RTKdata.com are **ellipsoidal**, not orthometric (mean sea level). If your project requires orthometric heights, apply a geoid model during post-processing or in your GIS software.
{% endhint %}

## Troubleshooting

| Problem                                  | Cause                                                         | Fix                                                                              |
| ---------------------------------------- | ------------------------------------------------------------- | -------------------------------------------------------------------------------- |
| NTRIP Client option missing in MapIt GIS | MapIt GIS version too old or NTRIP Client app not installed   | Update MapIt GIS to v6.0.0+ and install the companion NTRIP Client app           |
| Stuck on Single, never reaches Float     | Positioning Mode set to "Single"                              | Change Positioning Mode to **Kinematic** in Processing Options                   |
| Stuck on Float indefinitely              | GGA not being sent to caster                                  | Confirm GGA sending is enabled in the NTRIP Client settings                      |
| Bluetooth receiver not found             | Device not paired in Android settings                         | Pair the receiver in Android Bluetooth settings first, then select it in the app |
| Mountpoint error                         | Wrong capitalization                                          | Type `AUTO` in ALL CAPS                                                          |
| NTRIP connects but no corrections        | Port field left blank defaults to 2101, but host may be wrong | Verify the hostname spelling matches your region exactly                         |
| Pro+ subscription required message       | Free tier does not include NTRIP                              | Subscribe to MapIt GIS Pro+ or use the 3-day free trial to test                  |

## Tips for best results

* **The two-app architecture is unique to MapIt GIS.** You need both the main MapIt GIS app and the separate NTRIP Client companion app. Do not confuse them.
* **Test with the 3-day free trial** before subscribing. Verify that your receiver works correctly with the NTRIP Client before committing to Pro+.
* **Mountpoints can be browsed** — the NTRIP Client can fetch the source table and sort mountpoints by distance. For RTKdata.com, just type `AUTO`.
* **RTCM data stream monitoring** is available to verify incoming correction data is flowing.
* **Export formats** include GeoJSON, KML, Shapefile, and CSV — useful for post-processing in desktop GIS.
