Geolocation
Qubes 10.0 Retrieves Geolocation data.
Properties
| Property | Description |
| Accuracy | Geolocation accuracy (low by default, can be se to high) |
| Enabled | Boolean indicating whether or not the component is enabled. |
| Format | Format of geolocation value (list by default). |
| Hint | Specifies the user hint string that will appear in the component's interactive help bubble. |
| Interval | Minimum interval between refreshes in msec. |
| MaxAge | Maximum age in msec of geolocation data. |
| ValueInitial | Determines the component's initial value when the screen opens and each time it is reset (see Reset Button). |
| Visible | Boolean indicating whether or not the component will be visible. |
Value
The Format option controls the format of the value of the component:
- list the default format, which returns a List(Latitude, Longitude, Accuracy)
- text returns a text as Latitude,Longitude
- json a raw Geolocation data will be returned (which can also include altitude, bearing, respective accuracies and timestamp)
Latitude and Longitude are expressed in decimal degrees, altitude and accuracies in meters, and speed in meters per second. The timestamp is a raw Epoch TimeStamp (see EpochTimeStamp function).
When the Geolocation is not available, the value will be a string with the error code and text of the error, as returned by the browser.
Remarks
The component allows retrieving geolocation information, which can be available if
- The Xforms is accessed over HTTPS (Geolocation API is disabled over unsecured connections)
- The device or browser supports Geolocation (Note that Qubes.exe client does not support it)
- The user has authorized geolocation in the browser
The Accuracy property when set to high will return more accurate location information, but will use more battery.
The MaxAge property allows the use of cached Geolocation information, by default it is zero, which means no cached information is used, and there can be a delay before then location becomes available.