geoOpen()

The function opens a geo source.

Synopsis

int geoOpen(string source = "");

Parameters

Parameter Description
source Name of the geosource.

Return value

Returns 0 when a source could be opened, else -1

Description

If given an empty string or no argument, it opens a position source that reads from the system's default sources of location data, or the plugin with the highest available priority. If a source name is given, that source will be opened (it will be one of geoSources()). An opened source will start to request updates.

VORSICHT:

Only one source can be open at any given time.

The function will use location tracking. The time required to open a geo source and get the update of the current position does depend on the device connection to a satellite in case the satellite-based positioning method is used (GPS or GLONASS) or on the device internet connection in case the non-satellite based positioning method is used (3GPP cell identifier or WiFi based positioning).

Assignment

Mobile UI control functions

Availability

UI

See also

geoSources(), geoClose()