Point One Navigation Documentation

Polaris NTRIP API

The Point One Navigation Polaris NTRIP API provides GNSS corrections over the NTRIP protocol. The service supports clients using both the NTRIP 1.0 and NTRIP 2.0 specifications.

System Overview

The NTRIP stream endpoints and corresponding messages support RTCM3 streams over HTTP using basic (username and password) authentication.

Connection Details

Endpoint Port Description
ntrip.polaris.pointonenav.com 2102 TLS Encrypted
ntrip.polaris.pointonenav.com 2101 plaintext, not recommended for production designs

Parameters

Field Description
Username The username field should be populated with a string that uniquely identifies the connection. There can not be two concurrent connections to the Point One NTRIP service with the same unique ID. The unique ID may only contain letters, numbers, dashes, or underscores and can be at most 32 characters.
Password The password field should be populate with an NTRIP password that will be provided by Point One Navigation.
Mountpoint The user should select POLARIS as the mount point.

Sending locations

In order to receive corrections, the client must send a location to the Polaris NTRIP service. Locations can either be sent in the initial request using a Ntrip-GGA header, or by sending GGA lines to the server after the initial connection. See the NMEA-0183 GPGGA message section for details on the format of GGA messages.

NMEA-0183 GPGGA message

The NMEA-0183 GPGGA message type is used to send locations, and has the following format:

$GPGGA,235317.000,4003.9039,N,10512.5793,W,1,08,1.6,1577.9,M,-20.7,M,,0000*5F

This example GPGGA sentence contains the following fields:

Where DD is degrees, and mm.mm is minutes.

Additional Details

NTRIP 1.0

For NTRIP 1.0 responses, clients should include the Ntrip-Version: ntrip/1.0 header. The service will respond with ICY 200 OK followed by a new line and then the binary RTCM stream.

NTRIP 2.0

For NTRIP 2.0 responses, clients should include the Ntrip-Version: ntrip/2.0 header. The service will respond with the standard HTTP/1.1 200 OK response followed by standard HTTP headers, followed by the binary RTCM stream. For NTRIP 2.0, the RTCM stream will be sent to the client using chunked encoding, as indicated by the Transfer-Encoding: chunked header.

Dynamic Credentials

The device submits the API key to receive a username:password pair for use in NTRIP based authentication.

The Dynamic Credential request endpoint is:

https://api.pointonenav.com/api/v1/auth/ntrip

 

Method : POST

Auth required : NO

Data constraints

{
    "grant_type": "authorization_code",
    "token_type": "bearer",
    "authorization_code": "[API Key]",
    "unique_id": "[Unique Id]"
}

Data example

{
    "grant_type": "authorization_code",
    "token_type": "bearer",
    "authorization_code": "a94fd3abd3a84o494273h28923dh38",
    "unique_id": "mydevice-14xfd3c"
}

Success Response

Code : 200 OK

Content example

{
    "username": "random_user_name",
    "password": "asjkfhlgfkfdl2"
}

Note: These credentials will expire approximately 24 hours after issuance. For longer lived credentials, do not use the dynamic credential endpoint.

Error Response