Quick Start

Prerequisites

• curl and jq are installed.

• You have a valid GEODNET PPK username and password.

• Examples use Bash syntax; adjust for PowerShell as needed.

(1) Sign in to obtain token

TOKEN=$(curl -s -X POST "https://ppk.geodnet.com/api/user/signin" \
  -H "Content-Type: application/json" \
  -d '{"username":"geoduser","password":"geodpass"}' | jq -r '.data.token')

(2) Create download order

ORDER=$(curl -s -X POST "https://ppk.geodnet.com/api/user/download" \
  -H "Content-Type: application/json" \
  -H "token: $TOKEN" \
  -d '{"startYear":2024,"startMonth":6,"startDay":22,"startHour":0,"endYear":2024,"endMonth":6,"endDay":23,"endHour":0,"stations":["G001"],"type":2}' \
  | jq -r '.data.orderId')

Note

Steps are identical for NRCAN results, except step 2 uses /api/user/estimation/download with startDate, endDate, station.

(3) Poll status until completed

while true; do
  STATUS=$(curl -s "https://ppk.geodnet.com/api/download/status/$ORDER" -H "token: $TOKEN" | jq -r '.data.status')
  if [ "$STATUS" = "2" ]; then
    echo "Completed"
    break
  elif [ "$STATUS" = "3" ]; then
    echo "Failed"
    exit 1
  else
    echo "Processing..."
    sleep 5
  fi
done

Status values: 1 = Processing, 2 = Completed, 3 = Failed.

(4) Download file

curl -L "https://ppk.geodnet.com/api/download/$ORDER" -H "token: $TOKEN" -o "geodnet_${ORDER}.zip"

(5) Convert to RINEX

Download the open-source convert tool: rtklib_lte. The Windows binary includes convbin.exe; build the project for Linux or macOS.

Note

year, mon, day, hour, min, sec are the approximate time of the RTCM log file (not the time you download the file). use -v 2.11 to output rinex 2.11 legacy version.

convbin.exe -r rtcm3 -tr year/mon/day hour:min:sec unziped_rtcm_file