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
TileProviderzawiera 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,PolylineiPolygon, ale nieMarker). 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], gdzie0oznacza nakładka jest nieprzezroczysta, a1oznacza, ż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.
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, |
hashCode()
|
| 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. |
|---|