sdrangel/plugins/feature/map/readme.md

1.9 KiB

Map Feature Plugin

Introduction

The Map Feature plugin displays a world map. On top of this, it can plot data from other plugins, such as APRS symbols from the APRS Feature, aircraft from the ADS-B Demodulator or the Sun, Moon and Stars from the Star Tracker.

Interface

Map feature plugin GUI

1: Source Channels

This displays the list of channels the Map is displaying data from.

2: Find

To centre the map on an object or location, enter:

  • An object name.
  • Latitude and longitude. This can be in decimal degrees (E.g: -23.666413, -46.573550) or degrees, minutes and seconds (E.g: 50°40'46.461"N 95°48'26.533"W or 33d51m54.5148sS 151d12m35.6400sE).
  • A Maidenhead locator (E.g: IO86av).

3: Display Names

When checked, names of objects are displayed in a bubble next to each object.

4: Delete

When clicked, all items will be deleted from the map.

Map

The map displays objects reported by other SDRangel channels and features.

  • The antenna location is placed according to My Position set under the Preferences > My Position menu. The position is only updated when the Map plugin is first opened.
  • To pan around the map, click the left mouse button and drag. To zoom in or out, use the mouse scroll wheel.
  • Clicking on an object in the map will display a text bubble with additional information about the object.

API

Full details of the API can be found in the Swagger documentation. Here is a quick example of how to centre the map on an object from the command line:

curl -X POST "http://127.0.0.1:8091/sdrangel/featureset/0/feature/0/actions" -d '{"featureType": "Map",  "MapActions": { "find": "M7RCE" }}'

And to centre the map at a particular latitude and longitude:

curl -X POST "http://127.0.0.1:8091/sdrangel/featureset/0/feature/0/actions" -d '{"featureType": "Map", "MapActions": { "find": "51.2 0.0" }}'