AYUDA EN LÍNEA
 WINDEV, WEBDEV Y WINDEV MOBILE
Este contenido se ha traducido automáticamente.  Haga clic aquí  para ver la versión en inglés.
Ayuda / WLanguage / Funciones WLanguage / Funciones estándar / Funciones de geolocalización
  • Special cases
  • Required permissions
WINDEV
WindowsLinuxJavaReportes y ConsultasCódigo de Usuario (UMC)
WEBDEV
WindowsLinuxPHPWEBDEV - Código Navegador
WINDEV Mobile
AndroidWidget Android iPhone/iPadIOS WidgetApple WatchMac Catalyst
Otros
Procedimientos almacenados
Returns the information about the location provider used by the application for geolocation functions.
Ejemplo
AndroidWidget Android 
// Check the type of provider used
IF GPSInfo(gpsType) = gpsSatellite THEN
	Info("The phone geolocation uses the GPS system.")
END
IF GPSInfo(gpsSpeed) = False THEN
	Error("The speed regarding the move of the phone cannot be defined.")
END
Sintaxis
<Result> = GPSInfo(<Information>)
<Result>: Variant
Requested information according to <Information>.
<Information>: Integer constant
Type of information requested.
gpsAltitudeAltitude of available device.<Result> will correspond to:
  • True if the location provider can be used to define the device altitude,
  • False otherwise or if no location provider was found.
gpsDirectionDirection of the move performed by the device.<Result> will correspond to:
  • True if the location provider can be used to define the direction of the move performed by the device,
  • False otherwise or if no location provider was found.
gpsEnergyEnergy consumption required by the provider.<Result> will correspond to:
  • gpsLowEnergy: The supplier must require a low amount of energy.
  • gpsEnergyAverage The supplier can request an average amount of energy.
  • gpsHighEnergy: The supplier may require a high amount of energy.
gpsPrecisionPrecision of the position measurement performed by the provider.<Result> will correspond to:
  • gpsHigh precision: position calculation with high precision.
  • gpsLow precision: position calculation with low precision.
gpsSpeedSpeed of the move performed by the device.<Result> will correspond to:
  • True if the location provider can be used to define the speed of the move performed by the device,
  • False otherwise or if no location provider was found.
gpsTypeType of location provider.<Result> will correspond to:
  • gpsSatellite: GPS satellite network location provider.
  • gpsNetwork: location provider using mobile antennas or Wi-Fi.
  • 0 if the type of location provider was not defined.
WINDEV This constant is not available.
Observaciones

Special cases

  • It is recommended to initialize the location provider settings with GPSInitParameter before retrieving information from that provider.
  • The activation status of the location provider is returned by GPSStatus.
AndroidWidget Android

Required permissions

This function changes the permissions required by the application.
Permission required: ACCESS_FINE_LOCATION.
Android 11 specific case: This function requires the ACCESS_BACKGROUND_LOCATION permission to access the device's location.
This permission allows using the function when the application is in the background.
If the application needs to use background location:
  • Manually add the "ACCESS_BACKGROUND_LOCATION" permission in the Android application generation wizard.
  • Explicitly request background location permission with PermissionRequest. For example: 
    PermissionRequest(permBackgroundLocation, Callback)
INTERNAL PROCEDURE Callback(p is Permission)
	IF p.Granted THEN
		// Functions that require background location access can be used
	END
END
A window allows users to:
  • allow access to the device location while the application is in the background,
  • allow access to the location only while the application is in use,
  • deny access to the location. The user can also change these permissions at any time in the Android settings.

Remarks:
  • Follow Google's guidelines for applications that require background location access. For more details, see https://support.google.com/googleplay/android-developer/answer/9799150. If these conditions are not met (especially user information requirements), applications may not be accepted for publication on Google Play.
  • The background location permission should only be requested if the location permission has been granted. Otherwise, PermissionRequest will fail.
  • If the option chosen by the user for the background location access request is more restrictive than the option chosen for the location access request, the application will be automatically restarted.
  • On devices running Android 10 or earlier, if location permission has been granted to the application, the background location permission will be granted without displaying a window.
Componente: wd300java.dll
Ver también
Versión mínima requerida
  • Versión 15
Esta página también está disponible para…
Comentarios
Haga clic en [Agregar] para publicar un comentario

Última modificación: 27/03/2025

Señalar un error o enviar una sugerencia | Ayuda local