Położenie geograficzne

Za pomocą elementu Położenie geograficzne można wyświetlić położenie użytkownika na mapie zamiast położenia statycznego.

Tego elementu sterującego można używać w połączeniu z elementami sterującymi Mapa oraz Interfejs OpenLayers API. Jednak element sterujący Interfejs OpenLayers API może nie być konieczny (w zależności od urządzenia). Zawartość obiektu położenia oraz dokładność tych pomiarów zależą od urządzenia, na którym działa interfejs użytkownika. Niezależnie od urządzenia, szerokość i długość geograficzna muszą być dostępne za pośrednictwem tego obiektu. Położenie jest zmienną kontekstową, która jest dostępna w ramach zdarzenia Przy określaniu lokalizacji tego elementu sterującego.

Aby ten element sterujący działał, musi mieć połączenie z jakąś siecią danych (np. sieć komórkowa, sieć Wi-Fi, Ethernet itp.). Bez połączenia element sterujący nie działa. Z powodu wbudowanej funkcji zabezpieczeń przeglądarki strona żąda uprawnienia, aby móc uzyskać dostęp do informacji o położeniu użytkownika.

Podobnie jak element sterujący Geokoder, element sterujący Położenie geograficzne 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.

Właściwości konfiguracyjne

Właściwości konfiguracyjne elementu sterującego Położenie geograficzne znajdują się w poniższej tabeli:

Tabela 1. Właściwości konfiguracyjne elementu Położenie geograficzne
Właściwość konfiguracyjna	Opis	Typ danych
Tryb monitorowania	Tryby monitorowania elementu sterującego: Raz podczas ładowania, Ciągłe oraz Początkowo zatrzymane.	`GeoMonitoringMode`
Duża dokładność	Jeśli zostanie wybrana ta opcja, wykrywanie położenia jest dokładniejsze, ale powoduje większe zużycie akumulatora.	`Wartość boolowska`
Limit czasu	Służy do podawania czasu (w milisekundach), po upływie którego urządzenie przestanie podejmować próby wykrycia podanego położenia. Wartością domyślną jest 6000 ms.	`Liczba całkowita`
Maksymalny wiek danych	Służy do podawania wieku (w milisekundach) najstarszych akceptowalnych danych położenia geograficznego. Wartością domyślną jest 0 ms.	`Liczba całkowita`

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();

     // <opcjonalnie> Wyświetlanie współrzędnych w polu Współrzędne 
     var coordinates= page.ui.get("Współrzędne");
     coordinates.setText("Szerokość geograficzna: " + location.latitude +" "+"Długość geograficzna: "+

     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 coordinates= page.ui.get("Współrzędne"): Ta funkcja pobiera pole tekstowe Współrzędne.
coordinates.setText("Szerokość geograficzna: " + location.latitude +" "+"Długość geograficzna: "+ location.longitude ): Ta funkcja ustawia pole tekstowe na znalezione współrzędne.

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

Metody

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

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.