Geokoder

Element Geokoder służy do wyświetlania adresu użytkownika na podstawie jego fizycznej lokalizacji.

Ponadto można podać szerokość i długość geograficzną, ponieważ element sterujący Geokoder może je przekształcić w adres. Ten element sterujący jest używany w połączeniu z elementami sterującymi Mapa, Interfejs OpenLayers API i Położenie geograficzne.

Podobnie jak element sterujący Położenie geograficzne, element sterujący Geokoder dodaje kolejną warstwę informacji, która pozwala użytkownikom zobaczyć ich położenie na mapie. Można go użyć, aby udostępnić punkt odniesienia. W celu zwiększenia efektywności najpierw należy umieścić element sterujący Interfejs OpenLayers API u góry strony lub przynajmniej przed elementem sterującym Mapa. Więcej informacji na ten temat zawierają sekcje Mapa i Interfejs OpenLayers API.

Przykład

W tym przykładzie zostanie wybrany klucz API dla mapy, zostanie znaleziony i wyświetlony adres oraz zostanie dostosowany aspekt mapy, a następnie do mapy zostanie przekazana informacja o położeniu.

Użyj elementu sterującego Interfejs OpenLayers API, aby podać klucz API.
Użyj elementu sterującego Położenie geograficzne, aby znaleźć położenie użytkownika i wyświetlić je na mapie.
Użyj elementu sterującego Geokoder, aby wyświetlić adres fizyczny w tekstowym elemencie sterującym, (takim jak Uwaga, Tekst wyjściowy, Tekst itp.).
Dodaj element sterujący Mapa do formatki, a następnie odpowiednio dostosuj właściwości wyglądu.

Dodaj element sterujący Niestandardowy kod HTML, aby element sterujący Mapa przekazywał współrzędne do mapy.

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

     //Ustawianie środka mapy i dodawanie znacznika
     map.setCenter(location.latitude, location.longitude);
     map.addMarker();

     //Pobieranie adresu fizycznego użytkownika

     var geoCoder = page.ui.get("Geo_Coder1");
     geoCoder.requestAddressLookup(location.latitude, location.longitude);
  }
</script>

Poniżej znajduje się objaśnienie tego kodu HTML.

function updateLocation(me, location): Ta funkcja jest wywoływana przez element sterujący Położenie geograficzne. Parametr me odwołuje się do elementu Geo_Location1 i przekazuje informacje o położeniu.
var map = page.ui.get("Map1"): Ta funkcja wyszukuje mapę, aby umożliwić komunikację z nią.
map.setCenter(location.latitude, location.longitude): Ta funkcja korzysta z informacji o położeniu, które zostały do niej przekazane, aby ustawić środek mapy na podstawie wartości parametrów location.latitude i location.longitude.
map.addMarker(): Ta funkcja dodaje znacznik w wyśrodkowanym położeniu.
var geoCoder = page.ui.get("Geo_Coder1"): Ta funkcja znajduje położenie geograficzne, aby umożliwić z nim komunikację.
geoCoder.requestAddressLookup(location.latitude, location.longitude): Ta funkcja używa metody requestAddressLookup do ustalania adresu użytkownika na podstawie wartości parametrów location.latitude i location.longitude.

W wyniku działania tego przykładu jest pokazywane położenie użytkownika, tak jak to pokazano na poniższej mapie.

Zdarzenia

Na karcie Zdarzenia można ustawiać i modyfikować procedury obsługi zdarzeń elementu sterującego. Zdarzenia mogą być uruchamiane w sposób programowy lub w wyniku interakcji użytkownika z elementem sterującym. Informacje na temat definiowania i kodowania zdarzeń można znaleźć w sekcji Zdarzenia definiowane przez użytkownika.

W przypadku elementu sterującego Geokoder można aktywować następujące procedury obsługi zdarzeń:

Przy ładowaniu: aktywowana przy ładowaniu strony. Na przykład: me.requestAddressLookup(${Geolocation}.getData().latitude, ${GeoLocation}.getData().longitude).
Przy żądaniu adresu: aktywowana przy żądaniu informacji o położeniu. Na przykład: console.log("Zażądano adresu").
Przy określaniu adresu: aktywowana przy określaniu położenia. Na przykład: ${Location}.setText(address.formatted);.
Przy wystąpieniu błędu adresu: aktywowana przy wystąpieniu błędu podczas pobierania informacji o położeniu. Na przykład: ${LocationErrorText}.setVisible(true).

Metody

Szczegółowe informacje o metodach dostępnych w elemencie Geokoder znajdują się w opisie interfejsu JavaScript API Geokoder.

Dodatkowe zasoby

Informacje na temat tworzenia formatki zawiera sekcja Budowanie formatek.
Informacje o standardowych właściwościach (Ogólne, Konfiguracja, Pozycjonowanie, Widoczność i Atrybuty HTML) zawiera sekcja Właściwości widoku formatki.

Informacje o powiązanych geograficznych elementach sterujących zawierają sekcje Położenie geograficzne, Mapa i Interfejs OpenLayers API.