nobleo/rviz_satellite

Display internet satellite imagery in RViz

해결하는 문제

Rviz에서 연구원과 엔지니어는 로봇의 주변 상황을 파악하기 위해 로봇 위치 뒤에 위성 지도를 확인해야 하는 경우가 많습니다. 이 플러그인은 GPS 위치 정보(sensor_msgs/msg/NavSatFix)를 받아 해당 지도 타일을 배경 레이어로 그려주므로, 실제 지도상에서 로봇의 위치를 확인할 수 있습니다.

작동 방식

Rviz 설정에 AerialMap 디스플레이를 추가하고 GPS 좌표를 게시하는 토픽을 지정합니다. 그러면 플러그인이 제공된 URL에서 표준 OpenStreetMap 슬립 타일 명명 규칙({z}, {x}, {y} 플레이스홀더 사용)을 사용하여 지도 타일을 요청합니다. 다운로드된 타일은 로컬(~/.cache/rviz_satellite)에 캐시되어 반복 조회 시 더 빠르게 로드됩니다. 오프라인 사용을 위해 file:// 경로를 통해 로컬 타일 디렉토리를 설정할 수도 있습니다. 이 플러그인은 원격 및 로컬 타일 서버를 모두 지원하며, 투명도, 줌 레벨, 타일 블록 수, GPS 메시지 수신이 중단될 경우 지도를 페이드 아웃하는 타임아웃 설정 옵션을 제공합니다.

대상 사용자

Rviz를 사용하며 로봇에 지리적 컨텍스트가 필요한 ROS 2 사용자, 특히 GPS에 의존하는 야외 로봇(로버, 드론, 자율 주행 차량 등)을 다루는 분들에게 적합합니다. 또한 Rviz를 벗어나지 않고 실제 지도상에서 내비게이션 데이터를 시각화하려는 모든 분들에게 유용합니다.

주요 특징

  • NavSatFix 메시지를 구독하고 GPS 위치 변경에 따라 자동으로 지도 뷰를 업데이트
  • 널리 사용되는 OpenStreetMap 타일 규칙을 사용하여 많은 타일 서버(OpenStreetMap, TomTom, Mapbox 등)와 호환
  • 글로벌 타일 서버가 지원하지 않는 지역을 위한 로컬 맵 모드 지원, 원점 및 줌 배율 수동 보정 가능
  • URL 템플릿과 선택적 액세스 토큰을 제공하여 사용자 정의 타일 서버 지원
  • 설정을 테스트할 수 있도록 선택한 GPS 지점을 중심으로 Rviz가 회전하는 데모 런치 파일 포함
  • 구성 가능한 디스플레이 속성: 투명도, 뒤에 그리기 옵션, 줌 레벨(권장 16–19, 최대 22), 인접 타일 블록(최대 8), 페이드 아웃 타임아웃
  • 지도 타일을 로컬에 캐시하여 오프라인 재사용 가능; 필요 시 캐시 수동 삭제 가능

관련

  • 프로젝트
  • 프로젝트
  • 프로젝트
  • 프로젝트