Obraz na powierzchni

Zadbaj o dobrą organizację dzięki kolekcji Zapisuj i kategoryzuj treści zgodnie ze swoimi preferencjami.

Nakładka na powierzchni to obraz na stałe umieszczony na mapie. Oto, jak wygląda nakładka na ziemi właściwości:

Pozycja

Możesz określić położenie nakładki na ziemię na 2 sposoby:

• Za pomocą lokalizacji: musisz przesłać zdjęcie nakładki na ziemię, LatLng z których zostanie zakotwiczona reklama zakotwiczona, oraz szerokość nakładki (w metrach). znajduje się domyślnie 50% od góry obrazu i 50% od lewej krawędzi obrazu . Można to zmienić. Opcjonalnie możesz podać wysokość nakładki (w m). Jeśli nie podasz wysokości nakładki, zostanie ona automatycznie obliczone w celu zachowania proporcji obrazu.
• Użycie granic: musisz podać atrybut LatLngBounds, który będzie zawierał obraz.

. Przed dodaniem nakładki do mapy musisz określić jej położenie. w przeciwnym razie, gdy zostanie nałożona nakładka na ziemię, zostanie wybrany element IllegalArgumentException. które zostały dodane do mapy. Ponadto można określić pozycję wyłącznie za pomocą jednego z tych elementów w obiekcie GroundOverlayOptions; w przeciwnym razie podczas określania drugiej metody zostanie zgłoszony IllegalStateException.

Obraz

Obraz (jako BitmapDescriptor), który zostanie użyty w tej nakładce. Obraz zostanie do dostępnego miejsca. Przed dodaniem terenu musisz określić obraz nałożyć na mapę; jeśli nie, to IllegalArgumentException jest zgłaszany, gdy jest które zostały dodane do mapy.

Łożysko

Stopnia obrotu obrazu w kierunku zgodnym z ruchem wskazówek zegara. W centrum zakotwiczenia obrazu. Jest ona opcjonalna, a wartość domyślna to 0, tj. obraz jest wyrównany tak, że północ na górze

zIndex

Kolejność rysowania nakładki na powierzchnię względem innych nakładek (w tym Polyline i TileOverlay, ale nie Marker). Nakładka z atrybutem Większy wskaźnik zIndex jest rysowany na nakładkach o mniejszych wartościach zIndex. Kolejność nakładek wraz z ta sama wartość zIndex jest dowolna. Ta wartość jest opcjonalna, a domyślna wartość zIndex wynosi 0.

Przejrzystość

Przezroczystość obrazu nad powierzchnią 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ść obrazu nad powierzchnią jako 0,25, wówczas piksel będzie renderowany 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 na ziemi jest widoczna czy niewidoczna (tzn. czy jest narysowana na mapy. Niewidoczna nakładka na powierzchnia nie jest rysowana, ale zachowuje wszystkie swoje pozostałe właściwości. Ta opcja jest opcjonalna, a domyślna widoczność to true, czyli widoczna.

Klikalność

Jeśli chcesz obsługiwać zdarzenia wywoływane po kliknięciu nakładki przez użytkownika, ustaw tę opcję usłudze na true. W każdej chwili możesz zmienić tę wartość. Wartość domyślna to false. Jeśli ta właściwość ma wartość true, aplikacja będzie otrzymywać powiadomienia do GoogleMap.OnGroundOverlayClickListener zarejestrowane u setOnGroundOverlayClickListener(GoogleMap.OnGroundOverlayClickListener).

Tag

Element Object powiązany z nakładką naziemną. Na przykład Object może zawierają dane dotyczące tego, co przedstawia powierzchnia. To łatwiejsze niż przechowywanie oddziel: Map<GroundOverlay, Object>. Możesz też powiązać identyfikator String odpowiadający identyfikatorowi ze zbioru danych. Google Maps SDK for Android: brak odczytuje ani zapisuje tę właściwość.

Metody z tej klasy muszą być wywoływane w wątku interfejsu Androida. W przeciwnym razie w czasie działania zostanie zgłoszone żądanie 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));