Enum AprsIsFilter 

pub enum AprsIsFilter {
    Range {
        lat: f64,
        lon: f64,
        distance_km: f64,
    },
    Area {
        lat1: f64,
        lon1: f64,
        lat2: f64,
        lon2: f64,
    },
    Prefix(Vec<String>),
    Budlist(Vec<String>),
    Object(Vec<String>),
    Type(String),
    Symbol(String),
    Friend {
        callsign: String,
        distance_km: f64,
    },
    Group(String),
    Raw(String),
}

Structured APRS-IS filter expression.

Per http://www.aprs-is.net/javAPRSFilter.aspx, APRS-IS servers accept a small query language for selecting which packets to deliver to a client connection. Each filter is one or more tokens separated by spaces. This enum covers the commonly-used forms; use AprsIsFilter::raw to drop in any literal filter string for advanced cases.

Variants

Range

Range filter r/lat/lon/distance_km — packets from stations within the given radius.

Fields

lat: f64

Centre latitude in degrees (positive = North).

lon: f64

Centre longitude in degrees (positive = East).

distance_km: f64

Radius in kilometres.

Area

Area / box filter a/lat1/lon1/lat2/lon2 — packets within a lat/lon bounding box (NW and SE corners).

Fields

lat1: f64

Northwest latitude.

lon1: f64

Northwest longitude.

lat2: f64

Southeast latitude.

lon2: f64

Southeast longitude.

Prefix(Vec<String>)

Prefix filter p/aa/bb/cc — packets whose source callsign begins with any of the given prefixes.

Budlist(Vec<String>)

Budlist filter b/call1/call2 — packets from exactly these stations.

Object(Vec<String>)

Object filter o/obj1/obj2 — object reports with these names.

Type(String)

Type filter t/poimntqsu — characters select which frame types are wanted (p=position, o=object, i=item, m=message, n=nws, t=telemetry, q=query, s=status, u=user-defined).

Symbol(String)

Symbol filter s/sym1sym2/... — symbols to include.

Friend

“Friend” / range-around-station filter f/call/distance_km.

Fields

callsign: String

Station to centre on.

distance_km: f64

Distance in km.

Group(String)

Group message filter g/name — bulletins addressed to this group.

Raw(String)

Raw literal filter string for advanced / uncommon cases.

Implementations

impl AprsIsFilter

pub fn raw(s: impl Into<String>) -> Self

Build a raw literal filter expression.

pub fn as_wire(&self) -> String

Format this filter as the exact wire-format string APRS-IS servers expect after the filter keyword in the login line.

pub fn join(filters: &[Self]) -> String

Combine multiple filter clauses into a single filter string by joining with spaces — APRS-IS allows an OR of any number of clauses in a single filter directive.

Trait Implementations

impl Clone for AprsIsFilter

fn clone(&self) -> AprsIsFilter

Returns a duplicate of the value.

fn clone_from(&mut self, source: &Self)

Performs copy-assignment from source.

impl Debug for AprsIsFilter

fn fmt(&self, f: &mut Formatter<'_>) -> Result

Formats the value using the given formatter.

impl PartialEq for AprsIsFilter

fn eq(&self, other: &AprsIsFilter) -> bool

Tests for self and other values to be equal, and is used by ==.

fn ne(&self, other: &Rhs) -> bool

Tests for !=. The default implementation is almost always sufficient, and should not be overridden without very good reason.

impl StructuralPartialEq for AprsIsFilter