2001105254-netizen/RacePulsePH / .agents/skills/racepulse-gps-precision
racepulse-gps-precision
VerifiedCalibrate and harden GPS and GNSS tracking across browser geolocation, Capacitor Android FusedLocationProviderClient, Kalman smoothing, and course map-matching. Use when GPS is inaccurate, drifting, lagging, jumping, or failing field capture.
| File | Kind | Size |
|---|---|---|
| SKILL.md | skill md | 4.8 KB |
| references/filter-tuning.md | markdown | 2.3 KB |
| references/gnss-calibration.md | markdown | 2.2 KB |
references/gnss-calibration.md
View on GitHub# GNSS and Geolocation Calibration Reference
## 1. Platform Positioning Providers
### Desktop Browsers (Windows, macOS, Linux)
Desktop operating systems typically lack dedicated GNSS/GPS baseband processors. The browser Geolocation API (`navigator.geolocation`) relies on:
- Wi-Fi Access Point BSSID mapping against Google or Apple location databases.
- Public IP address routing tables from internet service providers.
In the Philippines, major ISPs (PLDT, Globe Telecom, Converge ICT, DITO, Starlink) route traffic through regional centralized gateways. Desktop IP-based geolocation commonly places users in Metro Manila, Cebu, or hundreds of kilometers away from their actual physical location, often reporting artificial accuracy radii of ±25km to ±50km.
### Native Android via Capacitor
Capacitor applications running on mobile devices have direct access to Google Play Services `FusedLocationProviderClient`. This provider aggregates:
- Dual-frequency GNSS (GPS L1/L5, Galileo E1/E5a, GLONASS, BeiDou).
- Cellular cell-tower multilateration.
- Wi-Fi RTT (Round Trip Time) fine indoor positioning.
- Device inertial measurement units (accelerometer, gyroscope, barometer).
Under open sky, native GNSS provides sub-3 meter accuracy with real-time Doppler speed and true heading.
## 2. API Options Specification
When requesting high-accuracy live tracking:
```typescript
const GNSS_TRACKING_OPTIONS: PositionOptions = {
enableHighAccuracy: true,
timeout: 12000,
maximumAge: 0, // Force fresh satellite epoch; never accept stale cached cell tower fixes
};
```
When falling back for quick initial map centering:
```typescript
const COARSE_FALLBACK_OPTIONS: PositionOptions = {
enableHighAccuracy: false,
timeout: 6000,
maximumAge: 15000, // Accept reasonably recent fix for instant initial camera pan
};
```
## 3. Honest UI Status Conventions
- Never label an unverified map center coordinate as a "GPS pinpoint".
- If coordinates are derived from a manual user click or map center, label the state: `Manual map anchor (no GPS lock)`.
- If satellite lock fails on desktop, prompt the user with clear instructions to either drop a manual pin on the map or enter coordinates directly.
Related skills
| Skill | Stars | Updated | Works with | Status | Install |
|---|---|---|---|---|---|
| slack-gif-creatoranthropics/skillsKnowledge and utilities for creating animated GIFs optimized for Slack. Provides constraints, validation tools, and animation concepts. Use when users request animated GIFs for Slack like "make me a GIF of X doing Y for Slack." | Stars: 198k | Updated | Claude CodeCodex | Verified | Install |
| ponytailDietrichGebert/ponytailLazy senior dev mode for any coding task: the smallest change that fully solves it, and a reply a busy human understands in one read. | Stars: 196k | Updated | Claude CodeCodex | Verified | Install |
| ponytail-debtDietrichGebert/ponytailHarvest every shortcut: comment into one debt ledger, so deferrals get tracked instead of forgotten. One-shot report. | Stars: 196k | Updated | Claude CodeCodex | Verified | Install |
| ponytail-debtDietrichGebert/ponytailList every `shortcut:` comment (and older `ponytail:` ones) as a debt ledger. One-shot report, changes nothing. Use for "ponytail debt", "what did ponytail defer", "list the shortcuts", /ponytail-debt. | Stars: 196k | Updated | Claude CodeCodex | Verified | Install |