NativeScript/Location/location.d.ts

export declare enum DesiredAccuracy {
    // in meters
    ANY,
    HIGH,
}

export declare class LocationRegion {
    public latitude: number;
    public longitude: number;

    public raduis: number; // radius in meters
}

export declare class Location {
    latitude: number;
    longitude: number;

    altitude: number; // in meters

    horizontalAccuracy: number; // in meters
    verticalAccuracy: number; // in meters

    speed: number; // in m/s

    direction: number; // in degrees

    timestamp: Date;

    public androidNative: any;  // android Location
    public iosNative: any;      // iOS CLLocation
}

export declare class RegionChangeListener {
    onRegionEnter(region: LocationRegion);
    onRegionExit(region: LocationRegion);
}

export declare class LocationManager {
    /**
    * Report are location services switched ON for this device (on Android) or application (iOS)
    */
    static isLocationEnabled(): boolean;

    /**
    * Measure distance in meters between two locations
    */
    static distanceInMeters(loc1: Location, loc2: Location): number;

    /**
    * Specifies desired accuracy in meters. Defaults to DesiredAccuracy.HIGH
    */
    desiredAccuracy: number;

    /**
    * Update distance filter in meters. Specifies how often to update. Default on iOS is no filter, on Android it is 0 meters
    */
    updateDistance: number;

    /**
    * Minimum time interval between location updates, in milliseconds (android only)
    */
    minimumUpdateTime: number;

    /**
    * True if location listener is already started. In this case all other start requests will be ignored
    */
    isStarted: boolean;

    // monitoring

    /**
    * Starts location monitoring. 
    */
    startLocationMonitoring(onLocation: (location: Location) => any, onError?: (error: Error) => any);

    /**
    * Stops location monitoring
    */
    stopLocationMonitoring();

    // other

    /**
    * Returns last known location from device's location services or null of no known last location
    */
    getLastKnownLocation(): Location;
}