ILocationProvider | iOS SDK | 2GIS Documentation
iOS SDK
Maps
Search
Navigation
On-Premise
Urbi Pro

ILocationProvider

The geoposition source interface that the platform implements.

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

Sets 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, then geoposition update tracking must be disabled.

Parameters
locationCallback
LocationCallback?

Callback function to update the current geo-position. If provider is available (call availabilityCallback with value true), this source always delivers 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 geo-positioning 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 methor:).

func setDesiredAccuracy(_ accuracy: DesiredAccuracy)

Sets the desired accuracy of the location. If the device cannot return a location with the desired accuracy, it can return a location with less accuracy. If the platform does not provide a method similar in functionality, this method should 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 not accurate enough. If the platform API does not provide a similarly functional method, this method should always return nil.