HTML5-Geolocation-API
Aktivieren Sie HTML5-Geolocation in Ihrer Android-WebView-App und fordern Sie Standortberechtigungen korrekt an.
Die HTML5 Geolocation API ermöglicht es Nutzern, ihren Standort mit Ihrer App zu teilen und Funktionen wie standortbasierte Inhalte zu verbessern. In WebViewGold wird die Geolocation API standardmäßig unterstützt, sobald sie in Ihre Webinhalte integriert ist. So implementieren Sie die Standortverfolgung in Ihre WebView-basierte Android-App:
Einrichten der HTML5-Geolocation:
Für die grundlegende Geolocation-Einrichtung finden Sie im Geolocation-Leitfaden von Mozilla Details dazu, wie Sie diese Funktion in Ihre Website oder Web-App implementieren.
Eine Demonstration finden Sie in dieser W3Schools Geolocation Demo.
Standortverfolgung im Hintergrund aktivieren (nur Android):
Um die Standortverfolgung im Hintergrund für Ihre WebView-basierte Android-App zu aktivieren, führen Sie die folgenden Schritte aus:
- Legen Sie die Berechtigungen in Config.java fest:
- Setzen Sie
requireBackgroundLocationauftrue, wenn die Standortverfolgung im Hintergrund benötigt wird. - Stellen Sie sicher, dass auch
requireLocationauftruegesetzt ist, um überhaupt Standortdienste zu aktivieren.
- Setzen Sie
- Passen Sie die Berechtigungen in AndroidManifest.xml an:
- Entfernen Sie die Kommentarzeichen bei den Berechtigungsblöcken für
android.permission.FOREGROUND_SERVICE_LOCATIONundGPSService. - Suchen Sie innerhalb der Datei nach diesen Begriffen, um sicherzustellen, dass die richtigen Berechtigungen gesetzt sind.
- Entfernen Sie die Kommentarzeichen bei den Berechtigungsblöcken für
Standortverfolgung im Hintergrund über URL-Schemata ein-/ausschalten:
Verwenden Sie die folgenden URL-Schemata, um die Standortverfolgung im Hintergrund innerhalb Ihrer WebView-basierten Android-App ein- oder auszuschalten:
Um die Standortverfolgung im Hintergrund einzuschalten, leiten Sie den Nutzer auf die folgende URL um:
<script>window.location.href = "backgroundlocationon://"; </script>
Um die Standortverfolgung im Hintergrund auszuschalten, leiten Sie den Nutzer auf die folgende URL um:
<script>window.location.href = "backgroundlocationoff://"; </script>
Hinweis: Diese URL-Schemata sind spezifisch für WebViewGold für Android und funktionieren möglicherweise nicht in herkömmlichen Webbrowsern. Um sicherzustellen, dass diese Weiterleitungen nur für Android-App-Nutzer angewendet werden, sollten Sie den User-Agent erkennen.
Implementierungshinweise im SDK-Stil
Betrachten Sie diese Funktion als native Fähigkeit, die Ihrer Web-Ebene bereitgestellt wird: Behalten Sie Ihre Produktivwebsite oder PWA als zentrale Quelle bei und nutzen Sie anschließend die dokumentierten WebViewGold-Konfigurationsflags, URL-Befehle und JavaScript-Bridge-Aufrufe, um natives Android-Verhalten nur dort zu aktivieren, wo es einen Mehrwert bietet. So bleibt Ihre Codebasis wartbar, da dieselbe Webanwendung mit minimaler Fallunterscheidung Browser, WebViewGold für Android und die übrigen WebViewGold-Plattformen bedienen kann.
Für zuverlässige Ergebnisse empfehlen sich HTTPS-Endpunkte, stabile Routennamen, explizite Erfolgs-/Fehlerzustände in Ihrer UI sowie kleine JavaScript-Hilfsfunktionen, die native Aufrufe kapseln. Beispielsweise kann eine mit jQuery Mobile, Lovable, Base44, Bolt, WordPress, Bubble, einem eigenen React-/Vue-/Angular-Stack oder statischem HTML erstellte Web-App eine einzelne Schaltfläche oder einen Event-Handler bereitstellen, der die native WebViewGold-API auslöst und dennoch einen sauberen Browser-Fallback zeigt.
- Empfohlenes Integrationsmuster: Erkennen Sie den App-Kontext, rufen Sie die WebViewGold-API auf und aktualisieren Sie anschließend Ihre Web-UI nach dem nativen Callback oder Routenwechsel.
- Test-Checkliste: Prüfen Sie die Funktion auf einem echten Gerät oder in einem paketierten Build, überprüfen Sie Berechtigungen und Store-Prüftexte und stellen Sie sicher, dass reine Browser-Nutzer weiterhin einen sinnvollen Fallback erhalten.
- SEO-Vorteil: Halten Sie Feature-Seiten, Routentitel und strukturierte Inhalte auf Ihrer Website indexierbar, während WebViewGold die native App-Hülle für Android-Nutzer bereitstellt.