feature-map/org.meshtastic.feature.map

Package-level declarations

Types

open class BaseMapViewModel(mapPrefs: MapPrefs, nodeRepository: NodeRepository, packetRepository: PacketRepository, radioController: RadioController, radioConfigRepository: RadioConfigRepository, notificationPrefs: NotificationPrefs, localeUnitsProvider: LocaleUnitsProvider, networkRepository: NetworkRepository) : ViewModel

Shared base ViewModel for the map feature, providing node data, waypoints, map filter preferences, and traceroute overlay state.

LastHeardFilter

enum LastHeardFilter : Enum<LastHeardFilter>

MapBounds

data class MapBounds(val south: Double, val west: Double, val north: Double, val east: Double)

A latitude/longitude box, in degrees.

MapNodePolicy

object MapNodePolicy

Which nodes a map shows, and which of them draws on top.

MapPoint

data class MapPoint(val latitude: Double, val longitude: Double)

A point on the map, in degrees. Deliberately not either renderer's type — see MapBounds.

SharedMapViewModel

class SharedMapViewModel(mapPrefs: MapPrefs, nodeRepository: NodeRepository, packetRepository: PacketRepository, radioController: RadioController, radioConfigRepository: RadioConfigRepository, notificationPrefs: NotificationPrefs, localeUnitsProvider: LocaleUnitsProvider, networkRepository: NetworkRepository) : BaseMapViewModel

TracerouteNodeSelection

data class TracerouteNodeSelection(val overlayNodeNums: Set<Int>, val nodesForMarkers: List<Node>, val nodeLookup: Map<Int, Node>)

Result of resolving a TracerouteOverlay's node nums into displayable Node instances.

TrackRun

data class TrackRun(val position: Position, val firstTime: Int)

Consecutive fixes drawn as one point: the newest fix of the run, and the time the run began.

Properties

RECENTLY_HEARD_SECONDS

const val RECENTLY_HEARD_SECONDS: Long = 5

How recently a node must have been heard for the map to pulse it.

TRACK_STOP_RADIUS_METERS

const val TRACK_STOP_RADIUS_METERS: Double = 25.0

Wider than a stationary fix's GPS jitter, narrower than a walked block.

Functions

decodeExcludedRoles

fun decodeExcludedRoles(names: Set<String>): Set<Config.DeviceConfig.Role>

Resolves persisted role names back to roles, dropping any the current protobufs no longer define.

heardJustNow

fun heardJustNow(lastHeard: Int, nowSeconds: Long): Boolean

Whether lastHeard is recent enough to pulse.

includes

fun LastHeardFilter.includes(recordedAtSeconds: Int, nowSeconds: Long): Boolean

Whether a recorded moment falls inside this filter's window.

MapScreen

@Composable

fun MapScreen(onClickNodeChip: (Int) -> Unit, navigateToNodeDetails: (Int) -> Unit, modifier: Modifier = Modifier, viewModel: SharedMapViewModel, waypointId: Int? = null, sitePlannerNodeNum: Int? = null)

mergeStationaryRuns

fun mergeStationaryRuns(positions: List<Position>, radiusMeters: Double = TRACK_STOP_RADIUS_METERS): List<TrackRun>

Collapses each run of consecutive fixes that stays within radiusMeters of the run's first fix into one TrackRun. positions must be oldest-first, and so is the result.

shouldAutoUseOfflineBasemap

fun shouldAutoUseOfflineBasemap(networkAvailable: Boolean, hasOfflineBasemap: Boolean): Boolean

Whether the map should switch itself onto an offline-capable basemap right now, with no toggle for the user to remember to flip.

tracerouteNodeSelection

fun tracerouteNodeSelection(tracerouteOverlay: TracerouteOverlay?, tracerouteNodePositions: Map<Int, Position>, nodes: List<Node>, getNodeOrFallback: (Int) -> Node): TracerouteNodeSelection

Resolves traceroute overlay node nums into displayable Node instances. Snapshot positions (recorded at traceroute time) take priority over live positions from the node database.

tracerouteNodeSelection

fun BaseMapViewModel.tracerouteNodeSelection(tracerouteOverlay: TracerouteOverlay?, tracerouteNodePositions: Map<Int, Position>, nodes: List<Node>): TracerouteNodeSelection

Convenience extension that delegates to tracerouteNodeSelection using the VM's getNodeOrFallback.