API de geolocalización HTML5
Active la geolocalización HTML5 en su aplicación Android WebView y solicite correctamente los permisos de ubicación.
La API de geolocalización de HTML5 permite a los usuarios compartir su ubicación con su app, mejorando funciones como el contenido basado en la ubicación. En WebViewGold, la API de geolocalización es compatible de forma predeterminada una vez integrada en su contenido web. A continuación se explica cómo implementar el seguimiento de geolocalización en su app Android basada en WebView:
Configurar la geolocalización de HTML5:
Para la configuración básica de la geolocalización, consulte la guía de geolocalización de Mozilla para obtener detalles sobre cómo implementar esta función en su sitio web o app web.
Para ver una demostración, visite esta demo de geolocalización de W3Schools.
Activar el seguimiento de ubicación en segundo plano (solo Android):
Para activar el seguimiento de ubicación en segundo plano en su app Android basada en WebView, siga estos pasos:
- Establezca los permisos en Config.java:
- Establezca
requireBackgroundLocationentruesi necesita el seguimiento de ubicación en segundo plano. - Asegúrese de que
requireLocationtambién esté establecido entruepara activar cualquier servicio de ubicación.
- Establezca
- Ajuste los permisos en AndroidManifest.xml:
- Descomente los bloques de permisos de
android.permission.FOREGROUND_SERVICE_LOCATIONyGPSService. - Busque estos términos dentro del archivo para asegurarse de que se establezcan los permisos correctos.
- Descomente los bloques de permisos de
Activar y desactivar el seguimiento de ubicación en segundo plano con esquemas de URL:
Utilice los siguientes esquemas de URL para activar o desactivar el seguimiento de ubicación en segundo plano en su app Android basada en WebView:
Para activar el seguimiento de ubicación en segundo plano, redirija al usuario a la siguiente URL:
<script>window.location.href = "backgroundlocationon://"; </script>
Para desactivar el seguimiento de ubicación en segundo plano, redirija al usuario a la siguiente URL:
<script>window.location.href = "backgroundlocationoff://"; </script>
Nota: estos esquemas de URL son específicos de WebViewGold para Android y es posible que no funcionen en navegadores web estándar. Para asegurarse de que estas redirecciones solo se apliquen a los usuarios de la app de Android, considere detectar el User-Agent.
Notas de implementación estilo SDK
Trate esta función como una capacidad nativa expuesta a su capa web: mantenga su sitio web de producción o PWA como fuente de verdad y, a continuación, utilice los indicadores de configuración de WebViewGold, los comandos de URL y las llamadas del puente de JavaScript documentados para activar el comportamiento nativo de Android solo donde aporte valor. Este enfoque mantiene su código fácil de mantener, porque la misma aplicación web puede servir a los navegadores, a WebViewGold para Android y a las demás plataformas de WebViewGold con una lógica condicional mínima.
Para obtener resultados fiables, opte por puntos de conexión HTTPS, nombres de ruta estables, estados de éxito/error explícitos en su interfaz y pequeñas funciones auxiliares de JavaScript que envuelvan las llamadas nativas. Por ejemplo, una aplicación web creada con jQuery Mobile, Lovable, Base44, Bolt, WordPress, Bubble, una pila propia de React/Vue/Angular o HTML estático puede exponer un único botón o controlador de eventos que active la API nativa de WebViewGold y, aun así, muestre una alternativa elegante en el navegador.
- Patrón de integración recomendado: detecte el contexto de la app, llame a la API de WebViewGold y luego actualice su interfaz web tras la devolución de llamada nativa o el cambio de ruta.
- Lista de comprobación de pruebas: valide la función en un dispositivo real o en una compilación empaquetada, verifique los permisos y el texto de revisión de la tienda, y confirme que los usuarios que solo usan el navegador siguen recibiendo una alternativa útil.
- Ventaja para el SEO: mantenga las páginas de funciones, los títulos de ruta y el contenido estructurado indexables en su sitio web, mientras WebViewGold ofrece la carcasa nativa de la app para los usuarios de Android.