AYUDA EN LÍNEA
 WINDEVWEBDEV 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
  • Casos especiales
  • Permisos necesarios
  • Funcionalidad de aplicación requerida
WINDEV
WindowsLinuxUniversal Windows 10 AppJavaReportes y ConsultasCódigo de Usuario (UMC)
WEBDEV
WindowsLinuxPHPWEBDEV - Código Navegador
WINDEV Mobile
AndroidWidget Android iPhone/iPadIOS WidgetApple WatchMac CatalystUniversal Windows 10 App
Otros
Procedimientos almacenados
Pide ser notificado cuando el dispositivo se acerca a una ubicación determinada.
Ejemplo
// Enable the notification request
GPSDetectPosition(DetectionProc, 1.145258, 30.968745)
// Procedure called during the notification
PROCÉDURE DetectionProc(Enter is boolean)
IF Enter = True THEN
Info("You have reached your destination.")
END
Sintaxis
<Result> = GPSDetectPosition(<WLanguage procedure> , <Latitude> , <Longitude> [, <Radius> [, <Timeout>]])
<Result>: Integro
Identificador de detección.
Este identificador se utiliza en los siguientes casos:
  • para detener el mecanismo de Notification. Basta con pasar este identificador como parámetro a GPSStopDetection.
  • para identificar la ubicación Process ed en el procedimiento WLanguage llamado (caso en el que el mismo procedimiento WLanguage se utiliza para Process varias ubicaciones).
<WLanguage procedure>: Nombre de Procedure
Nombre del WLanguage Procedure ("callback" Procedure) llamado cuando el dispositivo entra o sale de la región delimitada por los parámetros especificados.
Para obtener más información sobre este procedimiento, consulte Parámetros del procedimiento utilizado por la función GPSDetectPosition.
<Latitude>: Real
Latitud del lugar de proximidad.
<Longitude>: Real
Longitud del lugar de proximidad.
<Radius>: Real opcional
Radio (en metros), alrededor del lugar de proximidad, a partir del cual se generará la Notification.
Si no se especifica este parámetro, el radio alrededor de la ubicación será set a 50 metros.
<Timeout>: Entero o duración opcional
Tiempo de espera (en centésimas de segundo) de la alerta de proximidad. Este tiempo de espera comienza desde la llamada a la función.
  • No se definirá ningún tiempo de espera si este parámetro es set a -1 o si no se especifica.
  • Si se especifica este tiempo de espera, el mecanismo de Notification se detendrá automáticamente al final del tiempo de espera.
Este parámetro puede corresponder a:
  • un número entero que corresponde al número de centésimas de segundo,
  • una variable de tipo Duration,
  • la duración en un formato legible (por ejemplo, 1 s o 10 ms).
Observaciones

Casos especiales

  • Para dejar de recibir notificaciones, utilice GPSEnd.
  • Para dejar de detectar la proximidad de un lugar específico;
    • devuelve False en el lenguaje WL asociado Procedure,
    • utilice la función GPSStopDetection.
  • Se puede detectar la proximidad a varios lugares llamando a GPSDetectPosition para cada lugar. Si se llama al mismo procedimiento para varias ubicaciones, es posible diferenciar dichas ubicaciones en el procedimiento WLanguage con el parámetro <Identificador de detección>. Este parámetro corresponde al resultado de GPSDetectPosition.
  • Las medidas de localización pueden ser más o menos precisas en función de los parámetros del proveedor de la localización. Por lo tanto, puede ocurrir que no se envíe ningún Notification si el aparato pasa brevemente cerca de la zona vigilada. Del mismo modo, un Notification puede ser recibido si el dispositivo se acerca mucho a la zona vigilada sin entrar en ella.
AndroidWidget Android

Permisos necesarios

La llamada a esta función modifica los permisos requeridos por la aplicación.
Requerido Permission: ACCESS_FINE_LOCATION.
Caso específico de Android 11: Esta función requiere la Permission ACCESS_BACKGROUND_LOCATION para acceder a la ubicación del dispositivo.
Esta Permission permite utilizar la función cuando la aplicación está en la Background.
Si la aplicación necesita utilizar la ubicación de Background:
  • Agregar manualmente el permiso "ACCESS_BACKGROUND_LOCATION" en el asistente de generación de la aplicación Android.
  • Solicitar explícitamente la ubicación de fondo Permission con PermissionRequest. Por ejemplo:
    PermissionRequest(permBackgroundLocation, Callback)
    INTERNAL PROCEDURE Callback(p is Permission)
    IF p.Granted THEN
    // Functions that require background location access can be used
    END
    END
Una ventana permite a los usuarios:
  • permitir el acceso a la ubicación del dispositivo mientras la aplicación está en la Background,
  • permitir el acceso a la ubicación sólo mientras la aplicación está en uso,
  • negar el acceso a la ubicación. El usuario puede cambiar estos permisos en cualquier momento en la configuración de Android.

Observaciones:
  • Siga las directrices de Google para las aplicaciones que requieren acceso a la ubicación de Background. Para obtener más información, consulte https://support.google.com/googleplay/android-developer/answer/9799150. Si no se cumplen estas condiciones (especialmente los requisitos de información del usuario), es posible que no se acepte la publicación de las aplicaciones en Google Play.
  • La ubicación de fondo Permission sólo debe solicitarse si se ha concedido la ubicación Permission. De lo contrario, PermissionRequest fallará.
  • Si la opción elegida por el usuario para la solicitud de acceso a la localización de Background es más restrictiva que la opción elegida para la solicitud de acceso a la localización, la aplicación se reiniciará automáticamente.
  • En los dispositivos con Android 10 o anterior, si se ha concedido la ubicación Permission a la aplicación, se concederá la ubicación de fondo Permission sin mostrar una ventana.
Universal Windows 10 App

Funcionalidad de aplicación requerida

Cuando se utiliza esta función, se debe declarar una funcionalidad de la aplicación en el asistente de generación de aplicaciones.
Característica necesaria: Geolocalización
Esta característica permite a las aplicaciones acceder a las características de geolocalización que se encuentran en el dispositivo o en el equipo.
Clasificación Lógica de negocio / UI: Lógica de negocio
Componente: wd290java.dll
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/05/2022

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