GeoLocationAPI external object (GeneXus X Evolution 3 or prior)

 

This API enables users to provide several Location Services on their Smart Devices Applications by interacting with the GPS on the device where the app is running.

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.

Properties

• AuthorizationStatus
  • 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).

Methods

• General
  • GetMyLocation* - Get the device location.
  • GetDistance - Get the distance between two geolocations.
  • GetLocation - Get the geolocation of an address.
  • GetAddress - Get the address of a geolocation.
  • GetLatitude* - Get the device location latitude.
  • GetLongitude* - Get the device location longitude.
  • Authorized* - Check if the application is authorized to use the geolocation information.
  • Enabled* - Check if the device gps is enabled.
• Tracking
  • StartTracking* - Start tracking the device locations.
  • EndTracking* - Finish tracking the device locations.
  • GetLocationHistory - Get the list of tracked locations.
  • ClearLocationHistory* - Clear the tracked locations list.
• Proximity Alerts
  • SetProximityAlerts* - Set a proximity alert.
  • GetProximityAlerts* - Get the list of proximity alerts set.
  • GetCurrentProximityAlert* - Get the information of the current proximity alert.
  • ClearProximityAlerts* - Clear the list of proximity alerts set.

*Methods marked with an asterisk only work on the device.

NOTES:

• In iOS the Tracking and Proximity Alerts methods need permissions to work in background mode. In order to allow the GeoLocation API to be working in background (when the application is closed or the device locked), the string "App registers for location updates" should be added to the Required Backgroung modes in the info .plist file.

• In iOS 8.0 or later, a value for Location Always Usage Description or Location When In Use Usage Description properties is required when you use location services.
   

Videos

 Work With for Smart Devices – Behavior through Events

Availability

Proximity Alerts methods are only available for iOS since GeneXus X Evolution 3 RC (codename: Tilo).