Geografische Position

Verwenden Sie das Element 'Geografische Position', um die Position des Benutzers auf einer Karte anstelle einer statischen Position anzuzeigen.

Sie können dieses Steuerelement zusammen mit den Steuerelementen 'Map' und 'OpenLayers-API' verwenden. Abhängig von Ihrem Gerät können Sie unter Umständen auf die OpenLayers-API verzichten. Der Inhalt des Positionsobjekts und die Genauigkeit dieser Metriken hängt von dem Gerät ab, auf dem die Benutzerschnittstelle ausgeführt wird. Unabhängig vom Gerät müssen ein Breitengrad und ein Längengrad über dieses Objekt verfügbar sein. Die Position ist eine Kontextvariable, die innerhalb des Ereignisses Bei aufgelöster Position dieses Steuerelements verfügbar ist.

Damit dieses Steuerelement funktioniert, muss es mit einer Art Datennetz (entweder mobil, WiFi, Ethernet, etc.) verbunden werden. Falls keine Verbindung möglich ist, funktioniert dieses Steuerelement nicht. Als integrierte Sicherheitsfunktion des Browsers fordert die Seite Erlaubnis für den Zugriff auf die Positionsdaten des Benutzers an.

Wie das Steuerelement 'Geo-Codierer' fügt das Steuerelement 'Geografische Position' eine weitere Informationsebene hinzu, indem Benutzern die Möglichkeit gegeben wird, ihre jeweilige Position auf einer Karte anzuzeigen. Sie können damit einen Bezugspunkt bereitstellen. Dies ist besonders effizient, wenn Sie das Steuerelement 'OpenLayers-API' oben auf der Seite oder wenigstens vor dem Steuerelement 'Map' platzieren. Weitere Informationen hierzu finden Sie unter Map und OpenLayers-API.

Konfigurationseigenschaften

Die Konfigurationseigenschaften für das Steuerelement 'Geografische Position' werden in der folgenden Tabelle aufgeführt:

Tabelle 1. Konfigurationseigenschaften für das Element 'Geografische Position'
Konfigurationseigenschaft	Beschreibung	Datentyp
Überwachungsmodus	Überwachungsmodi für das Steuerelement: Einmal beim Laden, Fortlaufend, Anfänglich gestoppt.	`GeoMonitoringMode`
Hohe Genauigkeit	Wenn Sie diese Option auswählen, ist die Erkennung der Position genauer, verbraucht aber mehr Akkuleistung.	`Boolean`
Zeitlimit	Sie können die Anzahl von Millisekunden eingeben, nach denen das Gerät nicht mehr versucht, die angegebene Position zu ermitteln. Der Standardwert ist 6000 ms.	`Integer`
Maximales Datenalter	Sie können in Millisekunden die ältesten geografischen Positionsdaten angeben, die Sie akzeptieren. Der Standardwert ist 0 ms.	`Integer`

Beispiel

In diesem Beispiel wählen Sie einen API-Schlüssel für eine Landkarte aus, suchen und zeigen eine Adresse an, passen den Landkartenaspekt an und kommunizieren die Position an die Landkarte.

Verwenden Sie das Steuerelement 'OpenLayers-API', um einen API-Schlüssel anzugeben.
Verwenden Sie das Steuerelement 'Geografische Position', um die Position des Benutzers auf der Karte anzuzeigen.
Verwenden Sie das Steuerelement 'Geo-Codierer'. um eine physische Adresse in einem Textsteuerelement wie 'Hinweis', 'Ausgabetext', 'Text' usw. anzuzeigen.
Fügen Sie das Steuerelement 'Map' zum Coach hinzu und passen Sie die Darstellungseigenschaften nach Bedarf an.

Fügen Sie ein Steuerelement 'Benutzerdefinierter HTML-Code' hinzu, damit das Steuerelement 'Map' die Koordinaten an die Karte kommuniziert.

<script>
  function updateLocation(me, location){
     var map = page.ui.get("Map1");

     //Setting the center of the map and adding a marker
     map.setCenter(location.latitude, location.longitude);
     map.addMarker();

     // <optional> Printing the Coordinates to the Coordinates field 
     var coordinates= page.ui.get("Coordinates");
     coordinates.setText("Latitude: " + location.latitude +" "+"Longitude: "+

     location.longitude );
  }
</script>

Dieser HTML-Code liest sich wie folgt.

function updateLocation(me, location): Diese Funktion wird vom Steuerelement 'Geografische Position' aufgerufen. Der Parameter me referenziert Geo_Location1 und übergibt Positionsinformationen.
var map = page.ui.get("Map1"): Diese Funktion sucht nach der Karte, um die Kommunikation damit einzurichten.
map.setCenter(location.latitude, location.longitude): Diese Funktion verwendet die Positionsinformationen, die übergeben wurden, um die Kartenmitte anhand der Parameterwerte location.latitude und location.longitude festzulegen.
map.addMarker(): Diese Funktion setzt eine Markierung an der Kartenmitte.
var coordinates= page.ui.get("Coordinates"): Diese Funktion ruft das Textfeld Koordinaten ab.
coordinates.setText("Latitude: " + location.latitude +" "+"Longitude: "+ location.longitude ): Diese Funktion gibt im Textfeld die gefundenen Koordinaten an.

Das Ergebnis zeigt die Position des Benutzers wie in der folgenden Karte an.

Methoden

Ausführliche Informationen zu den verfügbaren Methoden für das Element 'Geografische Position' finden Sie unter Geografische Position - JavaScript-API.

Zusätzliche Ressourcen

Informationen zum Erstellen eines Coach finden Sie unter Coaches erstellen.
Informationen zu Standardeigenschaften (Allgemein, Konfiguration, Positionierung, Sichtbarkeit und HTML-Attribute) finden Sie unter Eigenschaften für Coach-Ansichten.

Informationen zu den zugehörigen Positionssteuerelementen finden Sie unter Geografische Position, Map und OpenLayers-API.