Nakładki z fragmentami mapy

publiczne zajęcia końcowe TileOverlay rozszerza obiekt

Nakładka z kafelkami to zestaw obrazów wyświetlanych na podstawowych kafelkach mapy. Te kafelki mogą być przejrzyste, co umożliwia dodawanie funkcji do istniejących map. Nakładka z kafelkami zawiera tych właściwości:

Dostawca kafelka
TileProvider zawiera obrazy używane w nakładce kafelków. Musisz określ dostawcę kafelków, zanim zostanie on dodany do mapy. Dostawcą kafelków nie może być została zmieniona po dodaniu; możesz jednak zmienić działanie dostawcy kafelków w celu wyświetlenia różnych obrazów dla określonych współrzędnych. Jeśli kafelki dostarczone przez kafelek zmiany dostawcy, musisz później wywołać funkcję clearTileCache(), aby upewnić się, że Poprzednie kafelki nie są już renderowane.
Kolejność nakładania elementów
Kolejność, w jakiej rysowana jest nakładka z kafelkami względem innych nakładek (w tym GroundOverlay, Circle, Polyline i Polygon, ale nie Marker). Nakładka o większej wartości z-index jest rysowana nad nakładkami o mniejszych indeksy z. Kolejność nakładek z tym samym ustawieniem kolejności nakładania elementów jest dowolna. Domyślna wartość zIndex to 0.
Przejrzystość
Przezroczystość nakładki z kafelkami w zakresie [0..1], gdzie 0 oznacza nakładka jest nieprzezroczysta, a 1 oznacza, że jest całkowicie przezroczysta. Jeśli określony bitmapa jest już częściowo przezroczysta, przezroczystość każdego piksela zostanie skalowana. (jeśli na przykład piksel na bitmapie ma wartość alfa 200, a ustaw przezroczystość nakładki kafelka na 0,25, wtedy piksel będzie renderowany na ekranu o wartości alfa 150). Specyfikacja tej właściwości jest opcjonalna, a domyślna przezroczystość wynosi 0 (nieprzezroczysta).
Widoczność
Wskazuje, czy nakładka z kafelkiem jest widoczna czy niewidoczna (czyli czy jest narysowana na mapy. Niewidoczna nakładka z kafelkami nie jest rysowana, ale zachowuje wszystkie pozostałe właściwości. domyślna to true, tj. widoczna.

Metody z tej klasy możesz wywoływać tylko w wątku głównym. Jeśli tego nie zrobisz, IllegalStateException.

Współrzędne kafelków

Pamiętaj, że świat jest rysowany w odwzorowaniu Merkatora (patrz Wikipedia) lewą (zachodnią) stroną. mapy odpowiadającej długości -180 stopni długości geograficznej i prawej stronie (wschód) mapy co odpowiada 180 stopniom długości geograficznej. Aby ustawić mapę jako kwadrat, górna (północna) strona odpowiada 85,0511 stopni szerokości geograficznej, a jej dolna (południe) strona do -85,0511 stopnia szerokości geograficznej. Obszary spoza tego zakresu szerokości geograficznej nie są renderowane.

Na każdym poziomie powiększenia mapa jest podzielona na kafelki i tylko te, które nakładają się na ekran. które są pobierane i renderowane. Każdy kafelek jest kwadratowy, a mapa jest podzielona na następujące kafelki:

  • Przy poziomie powiększenia 0 jeden kafelek reprezentuje cały świat. Współrzędne tego kafelka to (x, y) = (0, 0).
  • Na poziomie powiększenia 1 świat jest podzielony na 4 kafelki rozmieszczone na siatce 2 x 2.
  • Na poziomie powiększenia N świat jest podzielony na 4N kafelki rozmieszczone na 2N x 2N siatka.
. Pamiętaj, że minimalny poziom powiększenia obsługiwany przez aparat (zależy od różnych czynników). to GoogleMap.getMinZoomLevel i maksymalny poziom powiększenia to GoogleMap.getMaxZoomLevel.

Współrzędne kafelków są mierzone od lewego górnego rogu mapy (północno-zachodni róg). Na poziom powiększenia N, wartości x współrzędnych kafelka mieszczą się w zakresie od 0 do 2N – 1 wzrost z zachodu na wschód, a wartości y mieszczą się w zakresie od 0 do 2N – 1 z północy na południe.

Przykład

GoogleMap map; // ... get a map.
 TileProvider tileProvider; // ... create a tile provider.
 TileOverlay tileOverlay = map.addTileOverlay(
     new TileOverlayOptions().tileProvider(tileProvider));
 

Podsumowanie metody publicznej

nieważne
clearTileCache()
Czyści pamięć podręczną kafelków, dzięki czemu TileProvider będzie ponownie żądać wszystkich kafelków.
wartość logiczna
równa się(obiekt inny)
Sprawdza, czy ta wartość TileOverlay jest równa innej.
wartość logiczna
getFadeIn()
Określa, czy kafelki nakładki mają zanikać.
Ciąg znaków
getId()
Pobiera identyfikator tej nakładki.
liczba zmiennoprzecinkowa
getTransparency()
Pobiera przezroczystość tej nakładki kafelka.
liczba zmiennoprzecinkowa
getZIndex()
Pobiera wartość zIndex tej nakładki kafelka.
int,
wartość logiczna
isVisible()
Uzyskuje widoczność tej nakładki z kafelkami.
nieważne
remove()
Usuwa tę nakładkę z kafelkami z mapy.
nieważne
setFadeIn(boolean fadeIn)
Określa, czy kafelki nakładki mają zanikać.
nieważne
setTransparency(przejrzystość zmiennoprzecinkowa)
Ustawia przezroczystość tego nakładki kafelka.
nieważne
setVisible(boolean visible)
Ustawia widoczność tej nakładki z kafelkami.
nieważne
setZIndex(liczba zmiennoprzecinkowa zIndex)
Ustawia wartość zIndex tej nakładki z kafelkami.

Podsumowanie metody dziedziczonej

Metody publiczne

publiczne nieważne . clearTileCache ()

Czyści pamięć podręczną kafelków, dzięki czemu TileProvider będzie ponownie żądać wszystkich kafelków. Bieżące kafelki z tego nakładki zostaną również usunięte z mapy po wywołaniu tej nakładki . Interfejs API przechowuje w pamięci niewielką pamięć podręczną z kafelkami. Jeśli chcesz przechowywać kafelki w pamięci podręcznej należy wdrożyć pamięć podręczną na dysku.

publiczne Wartość logiczna . równa się (inny obiekt)

Sprawdza, czy ta wartość TileOverlay jest równa innej.

Parametry
inne Object.
Zwroty
  • true (prawda), jeśli oba obiekty są tym samym obiektem, czyli to == inny.

publiczne Wartość logiczna . getFadeIn ()

Określa, czy kafelki nakładki mają zanikać.

Zwroty
  • true, jeśli kafelki mają zanikać; false.

publiczne Ciąg znaków . getId ()

Pobiera identyfikator tej nakładki.

publiczne liczba zmiennoprzecinkowa . getTransparency ()

Pobiera przezroczystość tej nakładki kafelka.

Zwroty
  • przezroczystości tej nakładki.

publiczne liczba zmiennoprzecinkowa . getZIndex ()

Pobiera wartość zIndex tej nakładki kafelka.

Zwroty
  • zIndex (zIndex) nakładki z kafelkami.

publiczne int, . hashCode ()

publiczne Wartość logiczna . isVisible ()

Uzyskuje widoczność tej nakładki z kafelkami. Pamiętaj, że to nie zwraca, czy kafelek znajduje się w widocznym obszarze ekranu, ale czy zostanie narysowany, w widocznym obszarze ekranu.

Zwroty
  • widoczności nakładki z kafelkami.

publiczne nieważne . usuń ()

Usuwa tę nakładkę z kafelkami z mapy.

publiczne nieważne . setFadeIn (wartość logiczna fadeIn)

Określa, czy kafelki nakładki mają zanikać.

Parametry
fadeIn true, aby kafelki zaniknęły; false, by je natychmiast renderować.

publiczne nieważne . setTransparency (przezroczystość zmiennoprzecinkowa)

Ustawia przezroczystość tego nakładki kafelka. Zapoznaj się z dokumentacją u góry tych zajęć, aby: znajdziesz więcej informacji.

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

publiczne nieważne . setVisible (wartość logiczna widoczna)

Ustawia widoczność tej nakładki z kafelkami. Gdy nakładka z kafelkami nie jest widoczna, nie jest rysowana, zachowuje wszystkie pozostałe właściwości. Domyślnie nakładki z fragmentami mapy są widoczne.

Parametry
widoczna true, aby wyświetlić tę nakładkę; false, aby ukryć go.

publiczne nieważne . setZIndex (liczba zmiennoprzecinkowa zIndex)

Ustawia wartość zIndex tej nakładki z kafelkami. Aby dowiedzieć się więcej, zapoznaj się z dokumentacją u góry tych zajęć i informacjami o nich.

Parametry
zIndex parametru zIndex tej nakładki.