Obraz na powierzchni

publiczna klasa ostatnia GroundNakładka rozszerza obiekt

Nakładka na podłożę to obraz, który jest stały na mapie. Nakładka naziemna ma następujące właściwości:

Pozycja
Pozycja nakładki na powierzchnię możesz określić na 2 sposoby:
  • Użycie lokalizacji: musisz przesłać obraz nakładki na powierzchnię (LatLng), do którego kotwica zostanie umieszczona na stronie i jej szerokość (w metrach). Reklama zakotwiczona domyślnie znajduje się w 50% od góry obrazu i 50% od lewej krawędzi. To ustawienie można zmienić. Opcjonalnie możesz podać wysokość nakładki (w metrach). Jeśli nie podasz wysokości nakładki, zostanie ona automatycznie obliczona, aby zachować proporcje obrazu.
  • Za pomocą ograniczeń: podaj LatLngBounds, który będzie zawierać obraz.
Przed dodaniem do mapy musisz określić jego pozycję. W przeciwnym razie po dodaniu do mapy pojawi się właściwość IllegalArgumentException. Poza tym pozycję możesz określić tylko za pomocą jednej z tych metod w obiekcie GroundOverlayOptions. W przeciwnym razie podczas wywoływania metody za pomocą drugiej metody wywoływany jest element IllegalStateException.
Obraz
Obraz (jako BitmapDescriptor), który zostanie użyty w tej nakładce. Obraz zostanie przeskalowany tak, aby pasował do podanej pozycji. Musisz określić obraz, zanim dodasz do mapy nakładkę z ziemią. Jeśli nie, IllegalArgumentException zostanie dodany do mapy.
Łożysko
Liczba obrazów, które powinny zostać obrócone w prawo. Punktem centralnym rotacji będzie punkt zakotwiczenia obrazu. Jest to opcjonalne, a wskaźnikiem domyślnym jest 0, np. obraz jest wyrównany do północy.
Kolejność nakładania elementów
Kolejność, w której jest wyświetlana ta nakładka w porównaniu z innymi nakładkami (w tym Polyline, TileOverlay, ale nie Marker). Nakładka o większym kolejności nakładania elementów jest zastępowana nakładkami o mniejszym rozmiarze. Kolejność nakładek o tej samej wartości zIndex jest dowolna. Jest opcjonalna, a domyślna wartość zIndex wynosi 0.
Przejrzystość
Przejrzystość nakładki na obszar w zakresie [0..1], gdzie 0 oznacza, że nakładka jest nieprzezroczysta, a 1 oznacza, że jest ona całkowicie przezroczysta. Jeśli określona bitmapa jest już częściowo przezroczysta, przezroczystość każdego piksela będzie odpowiednio przeskalowana (jeśli na przykład piksel w bitmapie ma wartość alfa 200, a przezroczystość nakładki powierzchni to 0,25, to piksel zostanie wyrenderowany na ekranie o wartości 150). Specyfikacja tej właściwości jest opcjonalna, a przejrzystość domyślna to 0 (nieprzezroczysta).
Widoczność
Wskazuje, czy nawierzchnia jest widoczna, czy też niewidoczna na mapie. Nie wyświetla się niewidoczna nakładka z podłożem, ale zachowuje wszystkie pozostałe właściwości. Jest opcjonalna, a widoczność domyślna to true.
Możliwość kliknięcia
Jeśli chcesz obsługiwać zdarzenia wywoływane, gdy użytkownik kliknie nakładkę Ziemi, ustaw tę właściwość na true. Możesz ją zmienić w każdej chwili. Wartość domyślna to false. Jeśli ta właściwość jest ustawiona na true, Twoja aplikacja będzie otrzymywać powiadomienia na adres GoogleMap.OnGroundOverlayClickListener zarejestrowane za pomocą setOnGroundOverlayClickListener(GoogleMap.OnGroundOverlayClickListener).
Tag
Element Object powiązany z nakładką naziemną. Object może na przykład zawierać dane o tym, co reprezentuje nakładka z ziemią. To łatwiejsze niż przechowywanie osobnego pliku Map<GroundOverlay, Object>. Możesz też powiązać identyfikator String odpowiadający identyfikatorowi ze zbioru danych. Google Maps SDK na Androida nie odczytuje ani nie zapisuje tej właściwości.

Metody w tej klasie muszą być wywoływane w wątku UI Androida. Jeśli nie, w trakcie działania zostanie wywołany IllegalStateException.

Przykład

GoogleMap map = ...; // get a map.
 BitmapDescriptor imageDescriptor = ...; // get an image.
 LatLngBounds bounds = ...; // get a bounds
 // Adds a ground overlay with 50% transparency.
 GroundOverlay groundOverlay = map.addGroundOverlay(new GroundOverlayOptions()
     .image(imageDescriptor)
     .positionFromBounds(bounds)
     .transparency(0.5));
 

Podsumowanie metody publicznej

wartość logiczna
równa się(inny obiekt)
Sprawdza, czy to GroundOverlay ma wartość inną.
liczba zmiennoprzecinkowa
getBearing()
Pobiera ukształtowanie powierzchni ziemi pod kątem stopni od północy z kierunku wskazówek zegara.
Budki-wielkokątne
getBounds()
Pobiera granice dla nakładki gruntu.
liczba zmiennoprzecinkowa
getHeight()
Pobiera wysokość nakładki na powierzchnię.
Ciąg znaków
getId()
Pobiera ten identyfikator powierzchni.
LatLng
getPosition()
Pobiera lokalizację punktu zakotwiczenia.
Obiekt
getTag()
Pobiera tag dla koła.
liczba zmiennoprzecinkowa
getTransparency()
Pobiera przezroczystość tej nakładki naziemnej.
liczba zmiennoprzecinkowa
getWidth()
Pobiera szerokość nakładki na powierzchnię.
liczba zmiennoprzecinkowa
getZIndex
Pobiera zindex tej nakładki naziemnej.
int,
wartość logiczna
isClickable()
Pobiera klikalność nawierzchni.
wartość logiczna
isVisible()
Pobiera widoczność tej nakładki naziemnej.
nieważne
usuń()
Usuwa tę warstwę z mapy.
nieważne
setBaar (łożysko pływające)
Ustawia położenie nakładki powierzchni (czyli kierunek pionowy osi nakładki ziemi) w kierunkach wskazówek zegara od północy.
nieważne
setClickable (wartość logiczna klikalna)
Ustawia klikalność nakładki ziemi.
nieważne
setDimensions(szerokość zmiennoprzecinkowa, wysokość zmiennoprzecinkowa)
Ustawia wymiary nakładki na powierzchnię.
nieważne
setDimensions(szerokość zmiennoprzecinkowa)
Ustawia szerokość nakładki na powierzchnię.
nieważne
setImage (deskryptor obrazów BitmapDescriptor)
Ustawia obraz dla nakładki naziemnej.
nieważne
setPosition(LatLng LaLng)
Ustawia pozycję na powierzchni ziemi, zmieniając lokalizację punktu zakotwiczenia.
nieważne
setPositionFromBounds(granice LatLngBound)
Ustawia pozycję nakładki ziemi, dopasowując ją do danego elementu LatLngBounds.
nieważne
setTag(tag obiektu)
Ustawia tag dla nawierzchni.
nieważne
setTransparency(przejrzystość zmiennoprzecinkowa)
Ustawia przezroczystość tej nakładki naziemnej.
nieważne
setVisible(wartość logiczna)
Ustawia widoczność tej nakładki na powierzchnię.
nieważne
setZIndex (liczba zmiennoprzecinkowa)
Ustawia wartość zindex tej nakładki naziemnej.

Podsumowanie metody dziedziczonej

Metody publiczne

publiczna wartość logiczna równa się(inny obiekt)

Sprawdza, czy to GroundOverlay ma wartość inną.

Parametry
inne Object.
Zwraca
  • true (prawda), jeśli oba obiekty są tym samym obiektem (to jest wartość == other).

liczba pływająca getBearing ()

Pobiera ukształtowanie powierzchni ziemi pod kątem stopni od północy z kierunku wskazówek zegara.

Zwraca
  • ukształtowania podłoża.

publiczne LatLngBounds getBounds ()

Pobiera granice dla nakładki gruntu. Ignoruje to obrót nakładki powierzchni.

Zwraca

publiczna pływająca getHeight ()

Pobiera wysokość nakładki na powierzchnię.

Zwraca
  • wysokość powierzchni ziemi w metrach.

publiczny Ciąg getId ()

Pobiera ten identyfikator powierzchni. Ten identyfikator będzie unikalny wśród wszystkich elementów GroundNakładka na mapie.

Zwraca
  • identyfikator na powierzchni ziemi.

publiczne LatLng getPosition ()

Pobiera lokalizację punktu zakotwiczenia.

Zwraca

obiekt publiczny getTag ()

Pobiera tag dla koła.

Zwraca
  • tag, jeśli tag został ustawiony na setTag. Jeśli nie został on ustawiony, null.

publiczna zmiennoprzecinkowa getTransparency()

Pobiera przezroczystość tej nakładki naziemnej.

Zwraca
  • przezroczystość tej nawierzchni.

publiczna liczba zmiennoprzecinkowa getWidth()

Pobiera szerokość nakładki na powierzchnię.

Zwraca
  • szerokość warstwy powierzchni w metrach.

publiczna liczba zmiennoprzecinkowa getZIndex()

Pobiera zindex tej nakładki naziemnej.

Zwraca
  • wartość kolejności nakładania nawierzchni.

public int hashCode ()

publiczna wartość logiczna isClickable()

Pobiera klikalność nawierzchni. Jeśli można ją kliknąć, aplikacja otrzyma powiadomienie na adres GoogleMap.OnGroundOverlayClickListener, gdy użytkownik kliknie tę nakładkę. Detektor zdarzeń jest zarejestrowany w: setOnGroundOverlayClickListener(GoogleMap.OnGroundOverlayClickListener).

Zwraca
  • true, jeśli nakładkę naziemną można kliknąć. W przeciwnym razie zwraca false.

publiczna wartość logiczna isVisible ()

Pobiera widoczność tej nakładki naziemnej. Nie powoduje wyświetlenia informacji o tym, czy nakładka z ziemią faktycznie jest na ekranie, ale czy została narysowana, jeśli znajduje się w widocznym obszarze kamery.

Zwraca
  • i nakładania na poziomie ziemi.

void usuń ()

Usuwa tę warstwę z mapy. Po usunięciu nakładki powierzchni zachowanie wszystkich metod tej funkcji jest nieokreślone.

nieważny setBaar (łoże zmiennoprzecinkowe)

Ustawia położenie nakładki powierzchni (czyli kierunek pionowy osi nakładki ziemi) w kierunkach wskazówek zegara od północy. Rotacja jest przeprowadzana wokół punktu zakotwiczenia.

Parametry
łożysko w kierunku stopniowym w kierunku północnym

void void setClickable (wartość logiczna klikalna)

Ustawia klikalność nakładki ziemi. Jeśli można ją kliknąć, aplikacja otrzyma powiadomienie na adres GoogleMap.OnGroundOverlayClickListener, gdy użytkownik kliknie tę nakładkę. Detektor zdarzeń jest zarejestrowany w: setOnGroundOverlayClickListener(GoogleMap.OnGroundOverlayClickListener).

Parametry
możliwe kliknięcie Nowe ustawienie klikalności na powierzchni.

void void setDimensions (szerokość zmiennoprzecinkowa, wysokość zmiennoprzecinkowa)

Ustawia wymiary nakładki na powierzchnię. Obraz zostanie rozciągnięty, aby pasował do wymiarów.

Parametry
szerokość szerokość w metrach
wysokość wysokość w metrach

void void setDimensions (szerokość zmiennoprzecinkowa)

Ustawia szerokość nakładki na powierzchnię. Wysokość nawierzchni będzie dostosowywać się tak, by zachować współczynnik proporcji.

Parametry
szerokość szerokość w metrach

void void setImage (BitmapDescriptor imageDescriptor)

Ustawia obraz dla nakładki naziemnej. Nowy obraz będzie zajmować te same granice co stary obraz.

Parametry
Deskryptor obrazu BitmapDescriptor, który zostanie użyty w tej nawierzchni.

void void setPosition (LatLng latLng)

Ustawia pozycję na powierzchni ziemi, zmieniając lokalizację punktu zakotwiczenia. Zachowaj wszystkie pozostałe właściwości obrazu.

Parametry
Długość LatLng, który jest nową lokalizacją do umieszczenia punktu zakotwiczenia.

nieważny setPositionFromBounds (granice LatLngBound)

Ustawia pozycję nakładki ziemi, dopasowując ją do danego elementu LatLngBounds. Ta metoda ignoruje zignorujenie obrotu (podglądu) nakładki na ziemię podczas jej umieszczania, ale łożysko będzie nadal używane podczas rysowania.

Parametry
granice LatLngBounds, w którym należy umieścić warstwę Ziemi

void void setTag (tag obiektu)

Ustawia tag dla nawierzchni.

Możesz użyć tej właściwości, aby powiązać dowolną właściwość Object z nakładką naziemną. Object może na przykład zawierać dane o tym, co reprezentuje nakładka z ziemią. To łatwiejsze niż przechowywanie osobnego pliku Map<GroundOverlay, Object>. Możesz też powiązać identyfikator String odpowiadający identyfikatorowi ze zbioru danych. Google Maps SDK na Androida nie odczytuje ani nie zapisuje tej właściwości. Twoim obowiązkiem jest wywoływanie tagu setTag(null), gdy nie potrzebujesz go już, aby zapobiec wyciekom pamięci w aplikacji.

Parametry
tag Jeśli jest null, tag zostanie usunięty.

nieważny setTransparency (przejrzystość pływająca)

Ustawia przezroczystość tej nakładki naziemnej. Więcej informacji znajdziesz w dokumentacji na górze tej klasy.

Parametry
przejrzystość liczba zmiennoprzecinkowa w zakresie [0..1], gdzie 0 oznacza, że nawierzchnia jest nieprzezroczysta, a 1 oznacza, że nawierzchnia jest przezroczysta.

void void setVisible (wartość logiczna widoczna)

Ustawia widoczność tej nakładki na powierzchnię. Gdy nie jest widoczna, nakładka na powierzchni nie jest rysowana, ale zachowuje wszystkie pozostałe właściwości.

Parametry
widoczna w przypadku wartości true oznacza to, że jest wyświetlana nawierzchnia. Jeśli pole false jest puste

void void setZIndex (float zIndex)

Ustawia wartość zindex tej nakładki naziemnej. Więcej informacji znajdziesz w dokumentacji na górze tej klasy.

Parametry
Kolejność nakładania elementów zKolejność nakładania tej powierzchni