GPS 및 위치

⚠ Starlink GPS 지원 중단 안내 (2026년 5월 20일부터 적용) Starlink는 2026년 5월 20일부터 로컬 디바이스 gRPC API를 통한 디시 위치 정보를 더 이상 제공하지 않을 것이라고 발표했습니다. 대체 GPS 소스를 설정하거나 위치를 수동으로 설정하는 것을 권장합니다. 자세한 내용은 관련 기사를 참조하십시오.

위치가 중요한 이유

Nexus Telemetry는 위치 정보를 사용하여 터미널 위치를 표시하고, 지역 날씨 데이터를 제공하고, Starlink Viewer(Pro)에서 위성을 매칭하고, 세션 중 GPS 경로를 기록합니다(Pro).

GPS 소스

Nexus Telemetry는 5가지 위치 소스를 지원합니다. 하나 이상의 소스를 설정할 수 있으며, 하나가 사용할 수 없게 되면 앱이 자동으로 다른 소스로 폴백합니다.

Settings → Geolocation을 열어 위치 소스를 관리하십시오.

Nexus Telemetry Geolocation 설정 화면. GPS 소스 및 자동 폴백 표시

GPS 소스 추가

+ Add Source를 클릭하여 새 GPS 소스를 추가합니다. 이름을 입력하고 소스 유형을 선택하십시오.

GPS 소스 추가 대화상자. 사용 가능한 소스 유형 표시

사용 가능한 소스 유형은 다음과 같습니다.

  • Serial (USB Dongle) : USB GPS 수신기를 직접 연결합니다
  • NMEA / TCP : TCP 연결을 통해 NMEA 문장을 수신합니다
  • NMEA / UDP : UDP로 브로드캐스트되는 NMEA 문장을 수신합니다
  • gpsd : 기존 gpsd 인스턴스에 연결합니다
  • Starlink gRPC : Starlink 디시에서 GPS를 읽습니다 (지원 중단 예정)

각 소스 유형에는 고유한 설정 옵션이 있으며, 아래에서 설명합니다.

수동 위치 설정

디시가 이동하지 않는 고정 설치 환경용입니다. 주소나 장소 이름을 검색하거나, 지도를 클릭하여 핀을 놓거나, 좌표를 직접 입력하십시오. Save Location을 클릭하여 저장합니다. 좌표는 로컬에 저장되며 세션 간에 유지됩니다. 한 번만 설정하면 됩니다.

터미널 위치를 수동으로 설정

수동 위치는 GPS 소스가 연결되지 않은 경우 폴백으로 항상 사용할 수 있습니다.

시리얼 GPS (USB 동글)

이동 환경용입니다. Nexus Telemetry를 실행하는 머신에 USB GPS 수신기를 연결하고 Serial (USB Dongle) 소스를 추가하십시오. 드롭다운에서 시리얼 포트를 선택하고 디바이스에 맞는 보드레이트를 설정합니다(일반적인 값: 4800, 9600, 921600).

Nexus Telemetry는 디바이스에서 표준 NMEA 0183 문장을 직접 읽습니다. $GP(GPS 전용)와 $GN(다중 위성 시스템) 문장 접두사를 모두 지원합니다. 추가 소프트웨어가 필요하지 않습니다.

USB GPS 수신기 추천 정보는 GPS 수신기 비교를 참조하십시오.

NMEA over TCP

GPS 수신기가 네트워크상의 다른 머신에 연결된 환경용입니다. NMEA / TCP 소스를 추가하고 NMEA 문장을 전달하는 디바이스의 호스트와 포트를 입력하십시오. Nexus Telemetry는 TCP 클라이언트로 연결하여 스트림에서 NMEA 데이터를 읽습니다.

일반적인 구성은 USB GPS 동글이 연결된 Raspberry Pi에서 socat을 사용하여 문장을 전달하는 것입니다.

socat /dev/ttyUSB0,b9600,raw TCP-LISTEN:10110,reuseaddr,fork

NMEA over UDP

브로드캐스트 GPS 환경용입니다. NMEA / UDP 소스를 추가하고 수신할 포트를 입력하십시오. Nexus Telemetry는 지정된 포트에서 UDP로 브로드캐스트되는 NMEA 문장을 수신합니다. 여러 디바이스가 단일 소스에서 GPS 데이터를 수신해야 하는 경우에 유용합니다.

gpsd

이미 시스템에서 gpsd를 실행 중인 사용자용입니다. gpsd 소스를 추가하고 gpsd 인스턴스의 호스트와 포트를 입력하십시오(기본값: localhost:2947). Nexus Telemetry는 gpsd JSON 프로토콜에 연결하여 위치 업데이트를 구독합니다.

기존 GPS 소스입니다. Starlink gRPC 소스를 추가하고 디시 주소를 입력하십시오(기본값: 192.168.100.1:9200). Nexus Telemetry는 디시의 로컬 gRPC 엔드포인트에서 GPS 좌표를 읽습니다.

참고: 이 소스를 사용하려면 Starlink 앱에서 GPS 공유 토글을 활성화해야 합니다. 최신 하드웨어(V4, Mini)에서는 이 토글이 이미 제거되었으며, SpaceX는 2026년 5월 20일에 엔드포인트를 완전히 비활성화할 예정입니다. 현재 이 소스를 사용 중이라면 해당 날짜 전에 대체 수단을 설정하십시오.

GPS 토글 활성화 방법 (아직 사용 가능한 경우)

공식 Starlink 앱(iOS 또는 Android)에서 다음 단계를 따르십시오.

  1. 왼쪽 상단의 햄버거 메뉴(가로줄 세 개)를 탭합니다
  2. 오른쪽 하단의 정보 버튼(원 안의 “i”)을 탭합니다
  3. 하단까지 스크롤하여 Debug data를 탭합니다
  4. Starlink location까지 스크롤하여 **“Allow access on local network”**를 활성화합니다

1단계: 메뉴 열기 2단계: 정보 버튼 탭 3단계: Debug data 탭 4단계: Allow access on local network 활성화

자동 폴백

Auto-fallback이 활성화되어 있으면(GPS Sources 섹션 상단의 토글), 활성 소스가 응답을 중지할 때 Nexus Telemetry가 자동으로 다음 사용 가능한 소스로 전환합니다. 예를 들어, USB 동글이 분리되면 앱은 중단 없이 목록의 다음 소스로 폴백합니다.

목록에서 소스 순서를 변경하여 우선순위를 제어할 수 있습니다. Nexus Telemetry는 위에서 아래로 작동하며 첫 번째로 사용 가능한 소스를 사용합니다. 수동 위치는 항상 최종 폴백으로 사용됩니다.

대시보드에는 현재 활성 소스와 GPS 소스의 경우 추적 중인 위성 수가 표시됩니다.

사용 가능한 기능

위치가 설정되면(소스 종류에 관계없이) 다음 기능을 사용할 수 있습니다.

  • Location card: 미니 지도와 함께 위도 및 경도 표시
  • Weather card: 현재 위치 기반 지역 날씨 정보
  • Starlink Viewer (Pro): 디시를 중심으로 한 지구본과 위성 매칭
  • Session recording (Pro): 녹화된 세션의 경로 매핑

문제 해결

Nexus Telemetry에 위치 데이터가 표시되지 않는 경우 다음을 확인하십시오.

  1. 소스 상태 확인: Settings → Geolocation을 열고 소스가 Connected로 표시되는지 확인하십시오. 오류가 표시되면 설정을 확인하십시오.
  2. 시리얼 소스: USB 수신기가 연결되어 있고 올바른 시리얼 포트와 보드레이트가 선택되어 있는지 확인하십시오. 디바이스를 분리했다가 다시 연결해 보십시오.
  3. NMEA over TCP/UDP: 원격 머신에서 전달 서비스가 실행 중이고 호스트와 포트가 올바른지 확인하십시오. 방화벽이 연결을 차단하고 있지 않은지 확인하십시오.
  4. gpsd: gpsd가 실행 중이고(systemctl status gpsd) GPS 수신이 이루어지고 있는지 확인하십시오. 소스 설정의 호스트와 포트를 확인하십시오.
  5. Starlink gRPC: Starlink 앱에서 GPS 토글이 활성화되어 있는지 확인하십시오(하드웨어에서 아직 사용 가능한 경우). Nexus Telemetry가 192.168.100.1에서 디시에 연결할 수 있는지 확인하십시오(연결 문제 참조).
  6. 수동 위치: GPS 소스를 사용할 수 없는 경우 Geolocation 설정 페이지 상단의 Your Location 섹션에 있는 지도를 사용하여 위치를 수동으로 설정하십시오.
  7. Nexus Telemetry 재시작: 애플리케이션을 닫았다가 다시 열어 모든 연결을 재설정하십시오.

Nexus Telemetry에서 GPS 소스가 작동하는 방식에 대한 기술적 세부 사항은 블로그 게시물 멀티 소스 GPS 구축을 참조하십시오.

이전
연결 문제
다음
변경 이력