Geokoder

Edycja w trybie z połączeniem

Służy do wyświetlania adresu użytkownika na podstawie jego fizycznej lokalizacji lub przekształca długość i szerokość geograficzną w adres. Tego widoku należy używać z widokami Mapa, Interfejs OpenLayers API i Położenie geograficzne.

Podobnie jak widok Położenie geograficzne, widok 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ć widok Interfejs OpenLayers API u góry strony lub przynajmniej przed widokiem Mapa. Więcej informacji na ten temat zawiera sekcja Odwzorowanie i Interfejs APIOpenLayers.

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 widoku Interfejs OpenLayers API, aby podać klucz API.
Użyj widoku Położenie geograficzne, aby znaleźć położenie użytkownika i wyświetlić je na mapie.
Użyj widoku Geokoder, aby wyświetlić adres fizyczny w widoku tekstowym (takim jak Uwaga, Tekst wyjściowy, Tekst itp.).
Dodaj widok Mapa do strony, a następnie odpowiednio dostosuj właściwości wyglądu.

Dodaj widok Niestandardowy kod HTML, aby widok Mapa przekazywał współrzędne do mapy.

<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>

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

function updateLocation(me, location): Ta funkcja jest wywoływana przez widok 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.

Wynik pokazuje lokalizację użytkownika, jak pokazano na poniższej mapie.

Zdarzenia

We właściwościach Zdarzenia można ustawiać i modyfikować procedury obsługi zdarzeń widoku. Zdarzenia mogą być uruchamiane w sposób programowy lub w wyniku interakcji użytkownika z widokiem. Informacje na temat definiowania zdarzeń i kodu zdarzeń zawiera sekcja Zdarzenia zdefiniowane przez użytkownika.

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

w przypadku ładowania strony, na przykład
Jeśli wymagane jest położenie, na przykład:
gdy położenie jest rozstrzygane, na przykład
w przypadku wystąpienia błędu podczas pobierania położenia, na przykład

metody

Szczegółowe informacje na temat dostępnych metod dotyczących elementu Geokoder można znaleźć na interfejsie API w języku JavaScript dla elementu Geokoder.

Zasoby dodatkowe

Więcej informacji na temat sposobu tworzenia formatki lub strony zawiera sekcja Budowanie formatek.
Informacje na temat standardowych właściwości (Ogólne, Konfiguracja, Pozycjonowanie, Widocznośći Atrybuty HTML) można znaleźć w sekcji Właściwości widoku.

Informacje na temat powiązanych widoków geograficznych można znaleźć w sekcji Położenie geograficzne, Mapai Interfejs APIOpenLayers.