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
  • Gestión de cierres
  • Propiedades recuperadas
  • Modo de funcionamiento en iPhone/iPad
  • 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
Recupera información sobre la posición actual del dispositivo.
Universal Windows 10 App GPSGetPosition debe ejecutarse en un thread.
Ejemplo
MyLocation is geoPosition
MyLocation = GPSGetPosition()
// Checks the position validity with ErrorOccurred
IF ErrorOccurred THEN RETURN
Info(" Latitude : " + MyLocation.Latitude) 
Info(" Longitude : " + MyLocation.Longitude)
Sintaxis
Universal Windows 10 AppAndroidWidget Android iPhone/iPadIOS WidgetMac Catalyst

Recuperar información sobre un dispositivo (móvil, ...) Ocultar los detalles

<Result> = GPSGetPosition([<Timeout> [, <Message>]])
<Result>: geoPosition Variable
geoPosition variable que contiene información sobre la posición del dispositivo. Si la ubicación no es válida, el valor de la variable ErrorOccurred es True y los detalles del error se pueden obtener con la función ErrorInfo.
Android El PositionValid Property del tipo geoPosition determina si la posición es válida.
<Timeout>: Entero o duración opcional
Tiempo máximo de espera (en centésimas de segundo) para actualizar la posición del dispositivo.
  • Se produce un error si el tiempo de espera finaliza antes de que se actualice la posición del dispositivo.. Este error puede ser detectado por el ErrorOccurred Variable y los detalles del error pueden ser devueltos por ErrorInfo.
  • Si no se especifica este parámetro, el tiempo de espera es de set a 1 minuto.
Observación: 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).
<Message>: Cadena de caracteres opcional
Mensaje de reloj de arena visualizado al actualizar la posición.
Observación: Este parámetro sólo se tiene en cuenta si la llamada se realiza en la aplicación principal Thread.
Universal Windows 10 App Este parámetro no se tiene en cuenta.
Observaciones

Gestión de cierres

GPSGetPosition bloquea la ejecución hasta que se recupere la ubicación actual del dispositivo o hasta que expire el tiempo de espera definido por el parámetro <Timeout>..
Si se llama a la función en el hilo principal de la aplicación, se mostrará un reloj de arena durante la ejecución de la función. El mensaje que muestra el reloj de arena se puede especificar mediante el parámetro <Mensaje>..
De lo contrario, la ejecución de la Thread secundaria se bloqueará durante la ejecución de la función y no se mostrará ningún reloj de arena.
Observación: Para conocer la última posición conocida del dispositivo sin que se agote el tiempo de espera, utilice GPSLastPosition. Atención, la información de posicionamiento recuperada puede no corresponderse con la posición actual del dispositivo si éste se ha movido mientras la señal GPS no era válida, por ejemplo.. Puede utilizar el MeasurementDate Property del geoPosition Variable para determinar la fecha y la hora en que se calculó la posición.
Universal Windows 10 AppAndroidWidget Android iPhone/iPadIOS WidgetMac Catalyst

Propiedades recuperadas

  • Para determinar si se asignó un valor a las propiedades Velocidad, Precisión, Dirección o Altitud de una variable geoPosition cuando se recuperó la ubicación, utilice las propiedades SpeedValid, AccuracyValid, DirectionValid y AltitudeValid.
  • Para reiniciar una geoPosition Variable, utilice VariableReset.
  • AndroidWidget Android iPhone/iPadIOS WidgetMac Catalyst Se recomienda restablecer los parámetros del proveedor de localización con GPSInitParameter antes de recuperar una localización.
  • La información de posicionamiento recuperada corresponde a la última ubicación conocida del dispositivo: por lo tanto, pueden no corresponder a la ubicación actual del dispositivo si éste se movió mientras la señal GPS no era válida, por ejemplo. Para determinar la fecha y la hora en la que se ha calculado la posición se puede utilizar el MeasurementDate Property del geoPosition Variable.
  • Velocidad, Precisión, Dirección y Altitud se especificarán sólo si el proveedor de la ubicación lo permite (en caso contrario, estas propiedades tomarán su valor default).
    AndroidWidget Android El proveedor de localización se puede configurar con GPSInitParameter.
iPhone/iPadIOS WidgetMac Catalyst

Modo de funcionamiento en iPhone/iPad

Cuando se ejecuta por primera vez una función GPS, el sistema solicita la geolocalización Permission al usuario. Si el usuario se niega, todas las funciones GPS utilizadas en el resto de la aplicación fallarán (error fatal)..
Para volver a permitir el uso de GPS para esta aplicación, se debe modificar la configuración del sistema de la aplicación..
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
Exemplo
https://forum.pcsoft.fr/fr-FR/pcsoft.br.windev/3701-trabalhando-com-gps/read.awp
Boller
13 03 2021
Video GpsGetPosition
https://youtu.be/4MqAx_qiFts

https://windevdesenvolvimento.blogspot.com/2019/01/dicas-1987-windev-mobile-dicas-14.html
amarildo
16 01 2019
GPS Functions
https://forum.pcsoft.fr/fr-FR/pcsoft.br.windev/519-busca-endereco-rota-endereco-das-coordendas-523/read.awp?hl=enderecodascoordenadas

https://forum.pcsoft.fr/fr-FR/pcsoft.br.windev/2875-informatica-exemplo-google-maps-com-json-retornando-distancia/read.awp?lastview
BOLLER
10 11 2018
Video Trajeto Mapa
https://youtu.be/bSk0ysOlacE
amarildo
03 11 2018

Última modificación: 27/05/2022

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