ILocationProvider | iOS SDK | Urbi Documentation
iOS SDK
Maps
Search
Navigation
Urbi Pro
CityLens
On‑Premise
Account

ILocationProvider

The geoposition source interface that the platform implements.

Methods
func setCallbacks(
	locationCallback: LocationCallback?,
	availabilityCallback: AvailabilityCallback?
)

Set the callback functions to update the current geoposition and change the availability of the geoposition source. Calling this method again overwrites the previously set callback functions. If both parameters are nil, geoposition update tracking must be disabled.

Parameters
locationCallback
LocationCallback?

Callback function to update the current geoposition. If the provider is available (call availabilityCallback with value true), this source always delivers a valid geoposition. A valid geoposition is a geoposition in which all fields have a valid value at the time it was sent to this channel (i.e. if the geoposition accuracy >= half the length of the Earth's equator, then the geoposition is valid for any of the correct coordinates specified in it). If the precision value <= 0, the position is considered invalid even if isAvailable == true. See the CLLocationManagerDelegate.locationManager(didUpdateLocations:) method.

availabilityCallback
AvailabilityCallback?

Callback function to change the availability of the geoposition source. If this function is called with the value true, all subsequent calls to locationCallback will contain a valid (up-to-date) geoposition. Even if geoposition tracking is not available, the ILocationProvider implementation can send a new geoposition, but it will be considered invalid. See the CLLocationManagerDelegate.locationManager(didFailWithError:) method.

func setDesiredAccuracy(_ accuracy: DesiredAccuracy)

Set the desired location accuracy. If the device cannot return a location with the desired accuracy, it can return a location with lower accuracy. If the platform does not provide a method similar in functionality, then this method must have an empty implementation.

Parameters
accuracy
Properties
var lastLocation

The best currently known geoposition. If there is no currently known geoposition, nil is returned. The geoposition returned by this method may be invalid (see setCallbacks). This method should query the system for the best currently known geoposition and return it even if it is out of date and/or does not meet the required accuracy. If the platform API does not provide a method similar in functionality, this method should always return nil.