📍
View DocsGeolocation
SensorsAccess device GPS for current position and location tracking
gpslocationpositiontrackingcoordinates
Demo
Status
Permission: unknown
Watching: Inactive
Current Position
No position data. Click "Get Location" to start.
Note: On web browsers, location accuracy depends on available sensors. WiFi and cellular triangulation typically provide accuracy of 20-100m. GPS (when available) provides higher accuracy of 3-10m.
Usage
import { useGeolocation } from '@classic-homes/native/svelte';
// or for React:
import { useGeolocation } from '@classic-homes/native/react';API Reference
| Property | Type | Description |
|---|---|---|
| position | Position | null | Current GPS position with coordinates and accuracy |
| isLoading | boolean | Whether a location request is in progress |
| isWatching | boolean | Whether actively watching position changes |
| error | Error | null | Current error if any |
| permissionState | PermissionState | null | Current permission state ('granted', 'denied', 'prompt') |
| getCurrentPosition | (options?) => Promise<Position> | Get current position once |
| startWatching | (options?) => Promise<void> | Start continuous position updates |
| stopWatching | () => Promise<void> | Stop position watching |
| requestPermissions | () => Promise<PermissionState> | Request location permissions |