implementuje interfejs Parcelable
Określa opcje warstwy na powierzchni.
Stałe podsumowanie
float | NO_DIMENSION | Flaga, gdy dla wysokości nie określono wymiaru. |
Dziedziczone podsumowanie stałych
Publiczne podsumowanie konstruktora
GroundOverlayOptions()
Tworzy nowy zestaw opcji warstwy naziemnej.
|
Podsumowanie metod publicznych
GroundOverlayOptions |
kotwica(zmiennoprzecinkowa u, zmiennoprzecinkowa v)
Określa kotwicę.
|
GroundOverlayOptions |
bearing(łożysko swobodne)
Określa przesuwanie warstwy nad powierzchnią w stopniach w prawo, względem północy.
|
GroundOverlayOptions |
clickable(wartość logiczna)
Określa, czy obraz nad powierzchnią ma być klikalny.
|
float |
getAnchorU(),
Pozioma kotwica względna; elementy
0.0 i 1.0 oznaczają odpowiednio lewą i prawą krawędź. |
float |
getAnchorV(),
Kotwica pionowa – wartości
0.0 i 1.0 oznaczają odpowiednio górną i dolną krawędź. |
float |
getBearing(),
Pobiera ustawienie kierunku tego obiektu
GroundOverlayOptions . |
LatLngBounds |
getBounds(),
Pobiera granice tego obiektu
GroundOverlayOptions . |
float |
getHeight()
Pobiera wysokość ustawioną dla tego obiektu
GroundOverlayOptions . |
BitmapDescriptor |
getImage()
Pobiera deskryptor obrazu ustawiony dla tego obiektu
GroundOverlayOptions . |
LatLng |
getLocation()
Pobiera lokalizację ustawioną dla tego obiektu
GroundOverlayOptions . |
float |
getTransparency(),
Pobiera ustawienie przezroczystości dla tego obiektu
GroundOverlayOptions . |
float |
getWidth()
Pobiera szerokość ustawioną dla tego obiektu
GroundOverlayOptions . |
float |
getZIndex(),
Pobiera wartość zIndex ustawioną dla tego obiektu
GroundOverlayOptions . |
GroundOverlayOptions | |
boolean |
isClickable()
Pobiera ustawienie klikalności tego obiektu
GroundOverlayOptions . |
boolean |
isVisible(),
Pobiera ustawienie widoczności tego obiektu
GroundOverlayOptions . |
GroundOverlayOptions | |
GroundOverlayOptions | |
GroundOverlayOptions | |
GroundOverlayOptions |
przezroczystość(przejrzystość zmiennoprzecinkowa),
Określa przezroczystość warstwy nad powierzchnią.
|
GroundOverlayOptions |
visible(widoczna wartość logiczna)
Określa widoczność warstwy nad powierzchnią.
|
GroundOverlayOptions |
zIndex(zIndex z wykorzystaniem zmiennoprzecinkowego)
Określa wartość ZIndex dla obrazu nad powierzchnią, tj. w kolejności, w jakiej zostanie on narysowany.
|
Podsumowanie metod dziedziczonych
Stałe
publiczna statyczna końcowy liczba zmiennoprzecinkowa NO_DIMENSION
Flaga, gdy dla wysokości nie określono wymiaru.
Publiczne konstruktorzy
public GroundOverlayOptions ()
Tworzy nowy zestaw opcji warstwy naziemnej.
Metody publiczne
public GroundOverlayOptions kotwica (float u, float v)
Określa kotwicę.
Kotwica jest wyrównana do położenia nakładki na ziemi.
Punkt zakotwiczenia jest określony w ciągłej przestrzeni 2D, gdzie (0,0), (1,0), (0,1) i (1,1) oznaczają odpowiednio lewy górny, prawy górny, lewy dolny róg i prawy dolny róg.
*-----+-----+-----+-----* | | | | | | | | | | +-----+-----+-----+-----+ | | | X | | (U, V) = (0.7, 0.6) | | | | | *-----+-----+-----+-----*
Parametry
U | współrzędna u kotwicy |
---|---|
v | współrzędna V kotwicy |
Akcje powrotne
- ten obiekt
GroundOverlayOptions
z nowym zestawem kotwic.
public GroundOverlayOptions bearing (łożysko pływające)
Określa przesuwanie warstwy nad powierzchnią w stopniach w prawo, względem północy. Rotacja jest wykonywana względem punktu zakotwiczenia. Jeśli nie podasz żadnej wartości, zostanie użyte ustawienie domyślne 0 (tzn. obraz jest skierowany na północ).
Pamiętaj, że przed rotacją obowiązuje ograniczenie szerokości i długości geograficznej.
Parametry
dźwigając | przesunięcie w stopniach w kierunku zgodnym z ruchem wskazówek zegara, z północy. Wartości spoza zakresu [0–360) zostaną znormalizowane. |
---|
Akcje powrotne
- tym obiektem
GroundOverlayOptions
z nowym zestawem kierunkowym.
public GroundOverlayOptions klikalny (wartość logiczna)
Określa, czy obraz nad powierzchnią ma być klikalny. Domyślna klikalność to false
.
Parametry
możliwe kliknięcie | Nowe ustawienie klikalności. |
---|
Akcje powrotne
- ten obiekt
GroundOverlayOptions
z nowym ustawieniem klikalności.
publiczna float getAnchorU ()
Pozioma kotwica względna; elementy 0.0
i 1.0
oznaczają odpowiednio lewą i prawą krawędź. Inne wartości zakotwiczenia są odpowiednio interpolowane.
Akcje powrotne
- poziome położenie zakotwiczenia względem krawędzi.
publiczna float getAnchorV ()
Kotwica pionowa – wartości 0.0
i 1.0
oznaczają odpowiednio górną i dolną krawędź.
Inne wartości zakotwiczenia są odpowiednio interpolowane.
Akcje powrotne
- lokalizacja zakotwiczenia względem pionowej krawędzi.
public float getBearing ()
Pobiera ustawienie kierunku tego obiektu GroundOverlayOptions
.
Akcje powrotne
- przesuwania się warstwy podłoża.
public LatLngBounds getBounds ()
Pobiera granice tego obiektu GroundOverlayOptions
.
Akcje powrotne
- granic warstwy nałożonej na powierzchnię. Jeśli pozycja została ustawiona za pomocą parametru
position(LatLng, float)
lubposition(LatLng, float, float)
, będzie tonull
public float getHeight ()
Pobiera wysokość ustawioną dla tego obiektu GroundOverlayOptions
.
Akcje powrotne
- wysokości warstwy nad powierzchnią.
public BitmapDescriptor getImage ()
Pobiera deskryptor obrazu ustawiony dla tego obiektu GroundOverlayOptions
.
Akcje powrotne
- Element
BitmapDescriptor
reprezentujący obraz obrazu nad powierzchnią.
publiczna LatLng getLocation ()
Pobiera lokalizację ustawioną dla tego obiektu GroundOverlayOptions
.
Akcje powrotne
- lokalizację, w której ma zostać umieszczony kotwica nakładki na powierzchnię ziemi. Jeśli pozycja została ustawiona za pomocą parametru
positionFromBounds(LatLngBounds)
, wartość będzienull
.
public float getTransparency ()
Pobiera ustawienie przezroczystości dla tego obiektu GroundOverlayOptions
.
Akcje powrotne
- przezroczystość warstwy.
public float getWidth ()
Pobiera szerokość ustawioną dla tego obiektu GroundOverlayOptions
.
Akcje powrotne
- szerokości warstwy nad powierzchnią.
public float getZIndex ()
Pobiera wartość zIndex ustawioną dla tego obiektu GroundOverlayOptions
.
Akcje powrotne
- wartość zIndex dla obrazu nad powierzchnią.
public GroundOverlayOptions image (BitmapDescriptor imageDescriptor)
Określa obraz do nałożenia na powierzchnię terenu.
Aby wczytać obraz jako teksturę (służącą do jego rysowania na mapie), trzeba go przekonwertować na obraz o bokach o boku dwóch potęg. Można to zrobić, aby utworzyć mipmmapę na potrzeby renderowania tekstury przy różnych poziomach powiększenia. Więcej informacji znajdziesz na stronie Mipmap (Wikipedia). Z tego względu, aby oszczędzać pamięć, unikając tej konwersji, zalecamy, aby wymiary obrazu były potęgą 2.
Parametry
imageDescriptor | BitmapDescriptor , który ma być używany w przypadku obrazu nad powierzchnią |
---|
Akcje powrotne
- ten obiekt
GroundOverlayOptions
z nowym zestawem obrazów.
public boolean isClickable ()
Pobiera ustawienie klikalności tego obiektu GroundOverlayOptions
.
Akcje powrotne
true
, jeśli obraz nad powierzchnią jest klikalny;false
, jeśli nie jest.
public boolean isVisible ()
Pobiera ustawienie widoczności tego obiektu GroundOverlayOptions
.
Akcje powrotne
true
, jeśli jest widoczna nakładka podłoża;false
, jeśli nie jest widoczna.
public GroundOverlayOptions position (LatLng location, float width)
Określa pozycję tego obrazu nad powierzchnią za pomocą punktu zakotwiczenia (LatLng
) i szerokości (w metrach). Wysokość zostanie odpowiednio dostosowana, by zachować współczynnik proporcji.
Parametry
lokalizacji | lokalizacja na mapie LatLng , w której punkt zakotwiczenia na danym obrazie pozostanie niezmieniony. Po zastosowaniu przekształceń (np. setDimensions, setBearing itp.) zakotwiczona pozostaje w tym położeniu na poziomie ziemi. |
---|---|
szerokość | szerokość nakładki (w metrach). Wysokość jest określana automatycznie na podstawie współczynnika proporcji obrazu. |
Akcje powrotne
- ten obiekt
GroundOverlayOptions
z nowym ustawieniem pozycji.
Rzuty
IllegalArgumentException | jeśli kotwica to null |
---|---|
IllegalArgumentException | jeśli szerokość jest ujemna |
IllegalStateException | jeśli pozycja została już ustawiona za pomocą parametru positionFromBounds(LatLngBounds)
|
public GroundOverlayOptions position (LatLng location, float width, float height)
Określa pozycję tego obrazu nad powierzchnią za pomocą punktu zakotwiczenia (LatLng
), szerokości i wysokości (w metrach). Po wyrenderowaniu obraz zostanie przeskalowany tak, by pasował do określonych wymiarów.
Parametry
lokalizacji | lokalizacja na mapie LatLng , w której punkt zakotwiczenia na danym obrazie pozostanie niezmieniony. Po zastosowaniu przekształceń (np. setDimensions, setBearing itp.) zakotwiczona pozostaje w tym położeniu na poziomie ziemi. |
---|---|
szerokość | szerokość nakładki (w metrach) |
wysokość | wysokość obrazu nad powierzchnią (w metrach) |
Akcje powrotne
- ten obiekt
GroundOverlayOptions
z nowym ustawieniem pozycji.
Rzuty
IllegalArgumentException | jeśli kotwica to null |
---|---|
IllegalArgumentException | jeśli szerokość lub wysokość jest ujemna |
IllegalStateException | jeśli pozycja została już ustawiona za pomocą parametru positionFromBounds(LatLngBounds)
|
public GroundOverlayOptions positionFromBounds (granica LatLngBounds)
Określa pozycję obrazu nad powierzchnią.
Parametry
granice | LatLngBounds , w którym umieścić nakładkę na powierzchni ziemi |
---|
Akcje powrotne
- ten obiekt
GroundOverlayOptions
z nowym ustawieniem pozycji.
Rzuty
IllegalStateException | jeśli pozycja została już ustawiona za pomocą parametru position(LatLng, float) lub position(LatLng, float, float)
|
---|
public GroundOverlayOptions transparency (float transparency)
Określa przezroczystość warstwy nad powierzchnią. Domyślna przezroczystość to 0
(nieprzezroczysta).
Parametry
przejrzystość | wartość zmiennoprzecinkowa w zakresie [0..1] , gdzie 0 oznacza nieprzezroczystość nakładu na powierzchni, a 1 oznacza, że nakładka na powierzchni jest przezroczysta. |
---|
Akcje powrotne
- z nowym ustawieniem przezroczystości dla tego obiektu
GroundOverlayOptions
.
Rzuty
IllegalArgumentException | jeśli przezroczystość jest poza zakresem [0..1]. |
---|
public GroundOverlayOptions widoczny (boolean visible)
Określa widoczność warstwy nad powierzchnią. Domyślna widoczność to true
.
Parametry
widoczna |
---|
Akcje powrotne
- ten obiekt
GroundOverlayOptions
z nowym ustawieniem widoczności.
public GroundOverlayOptions zIndex (float zIndex)
Określa wartość ZIndex dla obrazu nad powierzchnią, tj. w kolejności, w jakiej zostanie on narysowany. Więcej informacji o zIndex znajdziesz w dokumentacji na początku tej klasy.
Parametry
zIndex |
---|
Akcje powrotne
- ten obiekt
GroundOverlayOptions
z nowym ustawieniem zIndex.