one/src/platform/specs/OneLocation.nitro.ts

One is a React framework for web, iOS, and Android apps.

import type { HybridObject } from 'react-native-nitro-modules'

export type LocationPermissionStatus =
  | 'notDetermined'
  | 'restricted'
  | 'denied'
  | 'whenInUse'
  | 'always'

export interface LocationPosition {
  latitude: number
  longitude: number
  accuracy: number
  altitude: number
  altitudeAccuracy: number
  course: number
  speed: number
  timestamp: number
}

export interface LocationPlace {
  latitude: number
  longitude: number
  name?: string
  street?: string
  houseNumber?: string
  city?: string
  region?: string
  postalCode?: string
  country?: string
  isoCountryCode?: string
}

// region monitoring mirrors Core Location: RegionCenter is
// CLLocationCoordinate2D's composition, LocationRegion is CLCircularRegion's
// (identifier, center, radius, notifyOnEntry, notifyOnExit), and RegionState
// is CLRegionState. the verbs are CLLocationManager's; the delegate becomes
// two listener subscriptions, which is the only JS adaptation.
export interface RegionCenter {
  latitude: number
  longitude: number
}

export type RegionState = 'unknown' | 'inside' | 'outside'

export interface LocationRegion {
  identifier: string
  center: RegionCenter
  radius: number
  notifyOnEntry?: boolean
  notifyOnExit?: boolean
  state?: RegionState
}

export interface OneLocation extends HybridObject<{ ios: 'swift'; android: 'kotlin' }> {
  getPermissionStatus(): LocationPermissionStatus
  requestWhenInUsePermission(): Promise<LocationPermissionStatus>
  requestAlwaysAuthorization(): Promise<LocationPermissionStatus>
  getCurrentPosition(): Promise<LocationPosition>
  addPositionListener(
    onPosition: (position: LocationPosition) => void,
    onError: (code: string, message: string) => void,
    background: boolean
  ): () => void
  geocodeAddress(address: string): Promise<LocationPlace[]>
  reverseGeocode(latitude: number, longitude: number): Promise<LocationPlace[]>
  startMonitoring(region: LocationRegion): Promise<void>
  stopMonitoring(identifier: string): Promise<void>
  monitoredRegions(): LocationRegion[]
  requestState(identifier: string): Promise<RegionState>
  addDidEnterRegionListener(listener: (region: LocationRegion) => void): () => void
  addDidExitRegionListener(listener: (region: LocationRegion) => void): () => void
}