GPS & Lokasi
Mengapa Lokasi Penting
Nexus Telemetry menggunakan lokasi Anda untuk menampilkan posisi terminal, menyediakan data cuaca lokal, mencocokkan satelit di Starlink Viewer (Pro), dan merekam rute GPS selama sesi (Pro).
Sumber GPS
Nexus Telemetry mendukung lima sumber lokasi. Anda dapat mengonfigurasi satu atau lebih, dan aplikasi akan secara otomatis beralih ke sumber lain jika salah satu tidak tersedia.
Buka Settings → Geolocation untuk mengelola sumber lokasi Anda.

Menambahkan Sumber GPS
Klik + Add Source untuk menambahkan sumber GPS baru. Beri nama dan pilih jenis sumber.

Jenis sumber yang tersedia adalah:
- Serial (USB Dongle) : menghubungkan USB GPS receiver secara langsung
- NMEA / TCP : menerima NMEA sentences melalui koneksi TCP
- NMEA / UDP : mendengarkan NMEA sentences yang disiarkan melalui UDP
- gpsd : menghubungkan ke instance gpsd yang sudah ada
- Starlink gRPC : membaca GPS dari dish Starlink (akan dihentikan)
Setiap jenis sumber memiliki opsi konfigurasi tersendiri, yang dijelaskan di bawah ini.
Lokasi Manual
Untuk instalasi tetap di mana dish Anda tidak berpindah. Cari alamat atau nama tempat, klik peta untuk menempatkan pin, atau masukkan koordinat secara langsung. Klik Save Location untuk menyimpan. Koordinat Anda disimpan secara lokal dan bertahan antar sesi. Anda hanya perlu mengaturnya satu kali.

Lokasi manual selalu tersedia sebagai cadangan jika tidak ada sumber GPS yang terhubung.
Serial GPS (USB Dongle)
Untuk pengaturan mobile. Colokkan USB GPS receiver ke mesin yang menjalankan Nexus Telemetry dan tambahkan sumber Serial (USB Dongle). Pilih serial port dari dropdown dan atur baud rate sesuai perangkat Anda (nilai umum adalah 4800, 9600, dan 921600).
Nexus Telemetry membaca NMEA 0183 sentences standar langsung dari perangkat. Mendukung prefix sentence $GP (GPS saja) dan $GN (multi-konstelasi). Tidak diperlukan perangkat lunak tambahan.
Untuk rekomendasi USB GPS receiver, lihat perbandingan GPS receiver.
NMEA over TCP
Untuk pengaturan di mana GPS receiver terhubung ke mesin lain di jaringan. Tambahkan sumber NMEA / TCP dan masukkan host serta port perangkat yang meneruskan NMEA sentences. Nexus Telemetry terhubung sebagai TCP client dan membaca data NMEA dari stream.
Pengaturan umum adalah Raspberry Pi dengan USB GPS dongle yang meneruskan sentences menggunakan socat:
socat /dev/ttyUSB0,b9600,raw TCP-LISTEN:10110,reuseaddr,fork
NMEA over UDP
Untuk pengaturan GPS broadcast. Tambahkan sumber NMEA / UDP dan masukkan port yang akan didengarkan. Nexus Telemetry mendengarkan NMEA sentences yang disiarkan melalui UDP pada port yang ditentukan. Ini berguna ketika beberapa perangkat perlu menerima data GPS dari satu sumber.
gpsd
Untuk pengguna yang sudah menjalankan gpsd di sistem mereka. Tambahkan sumber gpsd dan masukkan host serta port instance gpsd (default: localhost:2947). Nexus Telemetry terhubung ke gpsd JSON protocol dan berlangganan pembaruan posisi.
Starlink gRPC
Sumber GPS asli. Tambahkan sumber Starlink gRPC dan masukkan alamat dish (default: 192.168.100.1:9200). Nexus Telemetry membaca koordinat GPS dari gRPC endpoint lokal dish.
Catatan: Sumber ini memerlukan toggle berbagi GPS diaktifkan di aplikasi Starlink. Pada perangkat keras yang lebih baru (V4, Mini), toggle ini sudah dihapus, dan SpaceX akan menonaktifkan endpoint sepenuhnya pada 20 Mei 2026. Jika Anda saat ini menggunakan sumber ini, konfigurasikan alternatif sebelum tanggal tersebut.
Cara mengaktifkan toggle GPS (jika masih tersedia)
Di aplikasi Starlink resmi (iOS atau Android):
- Ketuk menu hamburger (tiga garis horizontal) di pojok kiri atas
- Ketuk tombol info (huruf “i” dalam lingkaran) di pojok kanan bawah
- Gulir ke bawah dan ketuk Debug data
- Gulir ke Starlink location dan aktifkan “Allow access on local network”

Fallback Otomatis
Ketika Auto-fallback diaktifkan (toggle di bagian atas bagian GPS Sources), Nexus Telemetry secara otomatis beralih ke sumber berikutnya yang tersedia jika sumber aktif Anda berhenti merespons. Misalnya, jika USB dongle dicabut, aplikasi beralih ke sumber berikutnya dalam daftar tanpa gangguan.
Anda mengontrol urutan prioritas dengan mengurutkan ulang sumber dalam daftar. Nexus Telemetry bekerja dari atas ke bawah, menggunakan sumber pertama yang tersedia. Lokasi manual selalu digunakan sebagai cadangan terakhir.
Dashboard menampilkan sumber mana yang sedang aktif dan, untuk sumber GPS, berapa banyak satelit yang sedang dilacak.
Fitur yang Tersedia
Setelah lokasi Anda diatur (melalui sumber apa pun), Anda akan melihat:
- Location card: Lintang dan bujur dengan peta mini
- Weather card: Kondisi cuaca lokal berdasarkan posisi Anda
- Starlink Viewer (Pro): Globe yang berpusat pada dish Anda dengan pencocokan satelit
- Session recording (Pro): Pemetaan rute pada sesi yang direkam
Pemecahan Masalah
Jika data lokasi tidak muncul di Nexus Telemetry:
- Periksa status sumber: Buka Settings → Geolocation dan verifikasi bahwa sumber Anda menampilkan status Connected. Jika menampilkan error, periksa konfigurasi.
- Sumber serial: Pastikan USB receiver terpasang dan serial port serta baud rate yang benar telah dipilih. Coba cabut dan pasang kembali perangkat.
- NMEA over TCP/UDP: Verifikasi bahwa layanan penerusan berjalan di mesin remote dan bahwa host serta port sudah benar. Periksa apakah firewall memblokir koneksi.
- gpsd: Konfirmasi bahwa gpsd berjalan (
systemctl status gpsd) dan memiliki GPS fix. Periksa host dan port di konfigurasi sumber. - Starlink gRPC: Verifikasi bahwa toggle GPS diaktifkan di aplikasi Starlink (jika masih tersedia di perangkat keras Anda). Pastikan Nexus Telemetry dapat menjangkau dish di
192.168.100.1(lihat Masalah Koneksi). - Lokasi manual: Jika tidak ada sumber GPS yang tersedia, atur lokasi Anda secara manual menggunakan peta di bagian Your Location di bagian atas halaman pengaturan Geolocation.
- Mulai ulang Nexus Telemetry: Tutup dan buka kembali aplikasi untuk mereset semua koneksi.
Untuk detail teknis tentang cara kerja sumber GPS di Nexus Telemetry, lihat posting blog kami tentang membangun GPS multi-sumber.