Metadata-Version: 2.3
Name: whitebox-plugin-map
Version: 0.1.35
Summary: A plugin for whitebox to render the map style contract and GPS data
License: GNU Affero General Public License v3
Author: avilabss
Author-email: contact@avilabs.net
Requires-Python: >=3.14.0
Classifier: License :: Other/Proprietary License
Classifier: Programming Language :: Python :: 3
Description-Content-Type: text/markdown

# Whitebox Plugin - Map

This is a plugin for [whitebox](https://gitlab.com/whitebox-aero) that renders the core map style contract and keeps GPS position updates in sync on the map surface.

## Installation

Simply install the plugin to whitebox:

```
poetry add whitebox-plugin-map
```

## Location recovery

The map can mount without the optional `location.data` store. With that store
present, it can recover `lastObservedLocation` in flight mode with no active
session. This is one usable socket observation already seen by this page, not
persisted history or proof of current GPS freshness. New socket observations and
mode/session changes take precedence; acquisition/status and playback rules
remain unchanged.

See the [Location plugin](https://gitlab.com/whitebox-aero/whitebox-plugin-location)
for the store contract and the shared
[offline preparation guidance](https://docs.whitebox.aero/development_guide/#prepared-offline-environments)
for local services and map assets.

## Additional Instructions

- [Plugin Development Guide](https://docs.whitebox.aero/plugin_guide/#plugin-development-workflow)
- [Plugin Testing Guide](https://docs.whitebox.aero/plugin_guide/#testing-plugins)
- [Contributing Guidelines](https://docs.whitebox.aero/development_guide/#contributing)

