Skip to content

2001105254-netizen/RacePulsePH / .agents/skills/racepulse-gps-precision

racepulse-gps-precision

Verified

Calibrate 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.

FileKindSize
SKILL.mdskill md4.8 KB
references/filter-tuning.mdmarkdown2.3 KB
references/gnss-calibration.mdmarkdown2.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.
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: 198kUpdated Claude CodeCodexVerifiedInstall
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: 196kUpdated Claude CodeCodexVerifiedInstall
ponytail-debtDietrichGebert/ponytailHarvest every shortcut: comment into one debt ledger, so deferrals get tracked instead of forgotten. One-shot report.Stars: 196kUpdated Claude CodeCodexVerifiedInstall
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: 196kUpdated Claude CodeCodexVerifiedInstall