This API enables you to provide several Location Services on their Smart Devices Applications by interacting with the GPS on the device where the app is running.
Important : Many of the methods and properties provided by this API are similar to those provided by the Maps external object. The difference is given by the use of the geographic data type (in Maps EObject) instead of the geolocation domain (in Geolocation EObject). The use of the geographic data type and the external map object is highly recommended if possible
The scenarios that this API resolves are described in the following document. 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 that the one the user gave. We 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: 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.
| Platforms |
Smart Devices (iOS, Android) |
Events in Mobile Applications
Geolocation external object is available as of GeneXus X Evolution 3.