wigle

type BoundingBox struct {
	MinLatitude  float64 `json:"min_latitude"`
	MinLongitude float64 `json:"min_longitude"`
	MaxLatitude  float64 `json:"max_latitude"`
	MaxLongitude float64 `json:"max_longitude"`
	CenterLat    float64 `json:"center_latitude"`
	CenterLon    float64 `json:"center_longitude"`
}

type MergeResult struct {
	// Observations is the deduplicated set, one per BSSID, sorted by BSSID
	// for deterministic, diffable output.
	Observations []Observation
	// InputCount is the total observations seen before merging.
	InputCount int
	// Duplicates is how many observations were folded away
	// (InputCount - len(Observations)).
	Duplicates int
}

type Metadata struct {
	AppRelease string
	Model      string
	Release    string
	Device     string
	Display    string
	Board      string
	Brand      string
}

type Observation struct {
	// BSSID is the AP hardware address. It is accepted in any case and with
	// ':', '-', '.' or no separators, and is normalised to the canonical
	// upper-case colon form (AA:BB:CC:DD:EE:FF) on encode.
	BSSID string
	// SSID is the network name. It may be empty (hidden network) and may
	// contain CSV metacharacters — those are escaped, not stripped.
	SSID string
	// AuthMode is the WiGLE capability string, e.g. "[WPA2-PSK-CCMP][ESS]".
	// Empty is allowed (auth unknown) — Marauder scans don't always report it.
	AuthMode string
	// Channel is the 802.11 channel (0 = unknown).
	Channel int
	// RSSI is signal strength in dBm (negative for a real measurement).
	RSSI int
	// Latitude / Longitude are decimal degrees from the GPS fix.
	Latitude  float64
	Longitude float64
	// AltitudeM is altitude in metres; AccuracyM is the fix's horizontal
	// accuracy in metres (0 = unknown).
	AltitudeM float64
	AccuracyM float64
	// FirstSeen is when the AP was observed; encoded as UTC. Required — a
	// wardrive row without a timestamp is not useful to WiGLE.
	FirstSeen time.Time
}

type ParseResult struct {
	Observations []Observation
	// SkippedRows is data rows dropped because they were malformed (bad MAC
	// or unparseable coordinates) or non-WiFi (a BT/BLE/GSM Type row).
	SkippedRows int
	// DataRows is the total number of data rows seen (excludes the header
	// and the optional WigleWifi pre-header line).
	DataRows int
}

type SSIDCount struct {
	SSID  string `json:"ssid"`
	Count int    `json:"count"`
}

type Summary struct {
	AccessPoints int `json:"access_points"` // total WiFi observations summarised
	UniqueBSSIDs int `json:"unique_bssids"` // distinct hardware addresses
	HiddenSSIDs  int `json:"hidden_ssids"`  // observations with an empty SSID

	// Encryption is the count per coarse bucket (open/wep/wpa/wpa2/wpa3/unknown).
	Encryption map[string]int `json:"encryption"`
	// SoftTargets is open + WEP — the networks worth a reviewer's first look.
	SoftTargets int `json:"soft_targets"`

	// Channels is observation count per 802.11 channel.
	Channels map[int]int `json:"channels"`

	// WithFix / NoFix split observations by whether they carry a real GPS
	// position (NoFix = 0,0, a "no lock" sentinel common in wardrive files).
	WithFix int `json:"with_fix"`
	NoFix   int `json:"no_fix"`
	// BBox is the extent over WithFix observations; nil when none have a fix.
	BBox *BoundingBox `json:"bounding_box,omitempty"`

	// TopSSIDs is the most frequently-seen non-empty SSIDs, highest first.
	TopSSIDs []SSIDCount `json:"top_ssids,omitempty"`
}