Geo-Codierer

Zeigt die Adresse eines Benutzers auf der Basis der physischen Position des Benutzers an oder konvertiert Koordinaten der Breiten- und Längengrade in eine Adresse. Muss mit den Ansichten 'Karte', 'OpenLayers-API' und 'Geografische Position' verwendet werden.

Wie die Ansicht 'Geografische Position' fügt die Ansicht 'Geo-Codierer' 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 die Ansicht 'OpenLayers-API' oben auf der Seite oder zumindest vor der Ansicht 'Karte' platzieren. Weitere Informationen finden Sie unter Karte und OpenLayers API.

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.
  1. Verwenden Sie die Ansicht 'OpenLayers-API', um einen API-Schlüssel anzugeben.
  2. Verwenden Sie die Ansicht 'Geografische Position', um die Position des Benutzers zu ermitteln und auf der Karte anzuzeigen.
  3. Verwenden Sie die Ansicht 'Geo-Codierer'. um eine physische Adresse in einer Textansicht wie 'Hinweis', 'Ausgabetext', 'Text' usw. anzuzeigen.
  4. Fügen Sie die Ansicht 'Karte' zur Seite hinzu und passen Sie die Darstellungseigenschaften nach Bedarf an.
  5. Fügen Sie eine Ansicht 'Benutzerdefinierter HTML-Code' hinzu, damit die Ansicht 'Karte' 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();

     //Get physical address of user

     var geoCoder = page.ui.get("Geo_Coder1");
     geoCoder.requestAddressLookup(location.latitude, location.longitude);
  }
</script>
Dieser HTML-Code liest sich wie folgt.
function updateLocation(me, location)
Diese Funktion wird von der Ansicht '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 geoCoder = page.ui.get("Geo_Coder1")
Diese Funktion sucht nach der Position, um die Kommunikation damit einzurichten.
geoCoder.requestAddressLookup(location.latitude, location.longitude)
Diese Funktion verwendet die Methode requestAddressLookup, um die Benutzeradresse anhand der Parameterwerte location.latitude und location.longitude abzuleiten.
Das Ergebnis zeigt die Position des Benutzers wie in der folgenden Karte dargestellt.

Ereignisse

Sie können die Ereignishandler für die Ansicht in den Eigenschaften für Ereignisse festlegen oder bearbeiten. Sie können Ereignisse festlegen, die programmgesteuert oder dann ausgelöst werden, wenn ein Benutzer mit der Ansicht interagiert. Informationen zum Definieren und Codieren von Ereignissen finden Sie unter Benutzerdefinierte Ereignisse.
Sie können für die Ansicht 'Geo-Codierer' die folgenden Ereignishandler aktivieren:
  • beim Laden der Seite, z. B.
  • wenn der Standort angefordert wird, z. B.
  • wenn die Position aufgelöst wird, z. B.
  • wenn beim Abrufen der Position ein Fehler auftritt, z. B.

Methoden

Ausführliche Informationen zu den verfügbaren Methoden für Geo-Codierer finden Sie im Geo-coder-JavaScript-API.

Weitere Ressourcen

Informationen zum Erstellen eines Coach oder einer Seite finden Sie unter Coaches erstellen.
Informationen zu Standardeigenschaften (Allgemein, Konfiguration, Positionierung, Sichtbarkeitund HTML-Attribute) finden Sie unter Eigenschaften anzeigen.

Informationen zu zugehörigen geografischen Ansichten finden Sie unter Geografische Position, Karteund APIOpenLayers.