Mapa

Umożliwia umieszczenie mapy na stronie, ustawienie lokalizacji statycznej lub użycie innych informacji o lokalizacji uzyskanych przy użyciu widoku Położenie geograficzne.

Wygląd i zachowanie mapy można skonfigurować przy użyciu właściwości konfiguracyjnych.

Właściwości konfiguracyjne

W obszarze Konfiguracja można ustawić lub zmodyfikować właściwości wyglądu i zachowania widoku.

Wielkość ekranu
Właściwość konfiguracyjna, na której znajduje się ikona Rozmiarów ekranu Ikona wielkości ekranu obok nazwy właściwości, może mieć różne wartości dla każdej wielkości ekranu. Jeśli nie zostanie ustawiona wartość, wielkość ekranu dziedziczy wartość następnej większej wielkości ekranu jako swoją wartość domyślną.
Definicje kompozycji
Definicje kompozycji służą do podawania kolorów i stylów widoku oraz do określania jego wyglądu. W edytorze kompozycji można wyświetlić podgląd wyglądu i zachowania widoku. Patrz Kompozycje.
Właściwości konfiguracyjne wyglądu widoku Mapa znajdują się w poniższej tabeli:
Tabela 1. Właściwości konfiguracyjne wyglądu elementu Mapa
Właściwość konfiguracyjna wyglądu Opis Typ danych
Typ mapy Typ mapy. MapType
Poziom powiększenia Poziom powiększenia: od 0 (cały świat) do 20 (szczegóły – np. pojedyncze budynki, jeśli istnieją). Integer
Szerokość Ikona wielkości ekranu Szerokość mapy wyrażana w pikselach (px), jako wartość procentowa pierwotnych wymiarów mapy (%) lub w firetach (em). Na przykład: 50 px, 20% lub 4 em. Jednostką domyślną są piksele. String
Wysokość Ikona wielkości ekranu Wysokość mapy wyrażana w pikselach (px) lub w firetach (em). Na przykład: 50 px lub 4 em. Jednostką domyślną są piksele. String
Właściwości konfiguracyjne zachowania widoku Mapa znajdują się w poniższej tabeli. Domyślnie właściwości konfiguracyjne zachowania nie są ustawione.
Wskazówka: Aby uzyskać lokalizację użytkownika, należy użyć widoku Położenie geograficzne. Patrz położenie geograficzne (Geo location).
Tabela 2. Właściwości konfiguracyjne zachowania elementu Mapa
Właściwość konfiguracyjna zachowania Opis Typ danych
Wyłącz przesuwanie Uniemożliwia użytkownikom przesuwanie mapy, co powoduje, że położenie mapy jest stałe. Boolean
Ukryj element sterujący Powiększenie Uniemożliwia użytkownikom powiększanie i pomniejszanie. Boolean
Ukryj element sterujący Typ mapy Uniemożliwia użytkownikom zmianę typu mapy. Boolean
Ukryj element sterujący Skala Uniemożliwia użytkownikom skalowanie mapy. Boolean
Ukryj element sterujący służący do obracania Uniemożliwia użytkownikom obracanie mapy. Boolean
Pokaż znacznik Służy do pokazywania lub ukrywania znacznika. Wymaga ustawienia właściwości konfiguracyjnych Szerokość geograficzna i Długość geograficzna. Boolean
Szerokość geograficzna Służy do podawania szerokości geograficznej, na której ma zostać wyśrodkowana mapa. Decimal
Długość geograficzna Służy do podawania długości geograficznej, na której ma zostać wyśrodkowana mapa. Decimal
Źródło mapy Służy do podawania dostawcy mapy: OpenStreetMap lub Mapy Bing. String

Zdarzenia

W przypadku widoku Mapa można aktywować następujące typy procedur obsługi zdarzeń:
  • On load podczas ładowania strony, na przykład me.setWidth("100%")
  • On click po kliknięciu mapy, na przykład ${Map}.addMarker(latLng)
  • On marker click po kliknięciu znacznika, na przykład console.log(marker.lng, marker.lat)

Przykład

Aby ustawić mapę na konkretną lokalizację, wykonaj poniższe kroki:
  1. Przeciągnij widok Interfejs OpenLayers API na stronę. Więcej informacji na temat tego widoku zawiera sekcja Interfejs APIOpenLayers.
  2. Przeciągnij widok Mapa na stronę.
  3. We właściwościach konfiguracyjnych w obszarze Zachowanie podaj szerokość i długość geograficzną.
  4. Jako źródło map ustaw wartość OpenStreetMap.
    Wskazówka: szerokość geograficzna i długość geograficzna lokalizacji można znaleźć w jeden z następujących sposobów:
    • Uruchom wyszukiwanie w serwisie WWW Google.
    • Użyj specjalistycznego serwisu WWW, takiego jak http://www.latlong.net/ .
    • Użyj widoku Położenie geograficzne zgodnie z wyjaśnieniami w sekcji Lokalizacja geo.
  5. Ustaw właściwości Wygląd . Na przykład wybierz typ Mapa drogowa i jako poziom powiększenia ustaw wartość 16.

    Dostawca OpenStreetMap oferuje tylko widok mapy drogowej. Dostawca Mapy Bing udostępnia także widoki satelitarny i hybrydowy.

Masz teraz mapę ustawioną w konkretnym miejscu.

metody

Więcej informacji na temat dostępnych metod można znaleźć w sekcji Odwzoruj interfejs JavaScript API.

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.