Warning: The
Maps external object is newer than the Geolocation external object. Many of the methods and properties provided by both external objects are similar. The difference consists in the fact that the
Maps external object uses the
Geography data type while the Geolocation external object uses the Geolocation domain (which is deprecated). In addition, the Maps external object includes more functionalities. The use of the Maps external object and the Geography data type is highly recommended.
This API enables you to provide several Location Services on their Native Mobile Applications by interacting with the GPS on the device where the app is running.
The scenarios that this API resolves are described in the Geolocation API - Scenarios article. To enable the use of this API many methods, such as GetMyLocation, GetLatitude, GetAddress, etc have been defined and also a new Structure Data Type has been defined, the GeoLocationInfo.
Returns the current authorization status. This can be useful when you are using an API that requires a higher authorization level than the one the user gave. You can warn the user and ask him to go to the settings and add the necessary permission if he currently has a minor permission (WhenInUse or Denied). This property is based on APIAuthorizationStatus domain. Note: This value is not available for Android apps.
Note: Those methods marked with an asterisk (*) only work on the device (not simulator nor web environment).
Returns the current location of the device.
Indicates whether the application has been given permission to use location services.
Return value |
Boolean |
Parameters |
None |
Indicates whether location services are enabled in the device.
Return value |
Boolean |
Parameters |
None |
Starts generating tracking information. Check Tracking article.
Stops the generation of tracking information. Check Tracking article.
Return value |
None |
Parameters |
None |
Returns a collection of location information generated by the tracking methods. Check Tracking article.
Return value |
GeolocationInfo |
Parameters |
startTime:DateTime |
Removes all previous location information generated by the tracking methods. Check Tracking article.
Return value |
None |
Parameters |
None |
Returns the latitude of the given location.
Returns the longitude of the given location.
Returns the distance between the two locations given.
Returns a collection of addresses for the given location.
In order to work properly, you must configure a valid Google API Key in Google API Key property (at Environment level)
Returns a collection of locations for the given address.
In order to work properly, you must configure a valid Google API Key in Google API Key property (at Environment level)
Sets a set of proximity alerts and returns the success status of the operation. Check HowTo: Use Geolocation Proximity Alerts article.
Return value |
Boolean |
Parameters |
proximityAlerts: Collection(GeolocationProximityAlerts) |
Get the list of proximity alerts set. Check HowTo: Use Geolocation Proximity Alerts article.
Return value |
proximityAlerts: Collection( GeolocationProximityAlerts ) |
Parameters |
None |
Get the information of the current proximity alert. Check HowTo: Use Geolocation Proximity Alerts article.
Return value |
GeolocationProximityAlerts |
Parameters |
None |
Clear the list of proximity alerts set. Check HowTo: Use Geolocation Proximity Alerts article.
Return value |
None |
Parameters |
None |
Picks (or select) a location.
Return value |
None |
Parameters |
GeolocationPickerParameters:GeolocationPickerParameters |
It does not have any.
Detailed description in APIAuthorizationStatus domain.
Detailed description in GeolocationInfo Data Type article.
Detailed description in GeolocationProximityAlert Data Type article.
Detailed in GeolocationPickerParameters Data Type article.
Events in Mobile Applications