Klasa zawierająca metody tworzenia obiektów CameraUpdate
, które zmieniają kamerę mapy.
Aby zmodyfikować kamerę mapy, wywołaj animateCamera(CameraUpdate)
, animateCamera(CameraUpdate, GoogleMap.CancelableCallback)
lub moveCamera(CameraUpdate)
, używając obiektu CameraUpdate
utworzonego z tą klasą.
Aby powiększyć np. mapę, możesz użyć następującego kodu:
GoogleMap map = ...;
map.animateCamera(CameraUpdateFactory.zoomIn());
Przed użyciem metod z tej klasy musisz wykonać jedną z poniższych czynności, aby mieć pewność, że ta klasa została zainicjowana:
- Poczekaj, aż
GoogleMap
będzie dostępny w aplikacjiMapFragment
lubMapView
dodanej do Twojej aplikacji. Możesz uzyskaćGoogleMap
przez wywołaniegetMapAsync()
i oczekiwanie na połączenie zwrotneonMapReady(GoogleMap map)
. - Zadzwoń do firmy
initialize(Context)
. Dopóki klasaGooglePlayServicesNotAvailableException
nie zostanie zgłoszona, ta klasa będzie poprawna zainicjowano.
Przewodnik dla programistów
Więcej informacji znajdziesz w artykule Aparat i widok przewodnik dla programistów.
Podsumowanie metody publicznej
statyczny CameraUpdate |
newCameraPosition(CameraPosition)
Zwraca funkcję
CameraUpdate , która przenosi kamerę do określonego zakresu (CameraPosition ). |
statyczny CameraUpdate |
newLatLng(dł. geogr.LatLng)
Zwraca wartość
CameraUpdate , która przesuwa środek ekranu do szerokości i długości geograficznej
określona przez obiekt LatLng . |
statyczny CameraUpdate |
newLatLngBounds(granice LatLngBounds, szerokość całkowita, wysokość całkowita, dopełnienie pełne)
Zwraca funkcję
CameraUpdate , która przekształca kamerę w taki sposób, że określony
granice szerokości i długości geograficznej są wyśrodkowane na ekranie w ramce o określonych wymiarach
przy największym możliwym powiększeniu. |
statyczny CameraUpdate |
newLatLngBounds(granice LatLngBounds, dopełnienie int)
Zwraca funkcję
CameraUpdate , która przekształca kamerę w taki sposób, że określony
granice szerokości i długości geograficznej są wyśrodkowane na ekranie przy największym możliwym poziomie powiększenia. |
statyczny CameraUpdate |
newLatLngZoom(LatLngdługość geograficzna, powiększenie pływające)
Zwraca wartość
CameraUpdate , która przesuwa środek ekranu do szerokości i długości geograficznej
określony przez obiekt LatLng i przechodzi do wybranego poziomu powiększenia. |
statyczny CameraUpdate |
scrollBy(liczba zmiennoprzecinkowa xPixel, float, yPixel)
Zwraca wartość
CameraUpdate , która przesuwa kamerę nad mapą, przesuwając środek
określoną liczbę pikseli w kierunkach x i y. |
statyczny CameraUpdate |
zoomBy(liczba zmiennoprzecinkowa, ostrość punktu)
Zwraca wartość
CameraUpdate , która zmienia poziom powiększenia bieżącego punktu widzenia kamery. |
statyczny CameraUpdate |
zoomBy(liczba zmiennoprzecinkowa)
Zwraca wartość
CameraUpdate , która zmienia poziom powiększenia bieżącego punktu widzenia kamery. |
statyczny CameraUpdate |
zoomIn()
Zwraca wartość
CameraUpdate , która powiększa mapę, przybliżając wysokość punktu obserwacyjnego
na powierzchnię Ziemi. |
statyczny CameraUpdate |
zoomOut()
Zwraca wartość
CameraUpdate , która pomniejsza mapę przez przesunięcie wysokości punktu obserwacyjnego.
znajdujący się w większej odległości od powierzchni Ziemi. |
statyczny CameraUpdate |
zoomTo(powiększenie pływające)
Zwraca wartość
CameraUpdate , która przenosi punkt obserwacyjny kamery na określony poziom powiększenia. |
Podsumowanie metody dziedziczonej
Metody publiczne
publiczne statyczny CameraUpdate newCameraPosition (CameraPosition – pozycja kamery)
Zwraca funkcję CameraUpdate
, która przenosi kamerę do określonego zakresu (CameraPosition
). W
efektem jest przekształcenie z szerokości geograficznej obiektu CameraPosition
,
długość geograficzną, poziom powiększenia, pochylenie i pochylenie mapy.
Parametry
cameraPosition |
---|
Zwroty
- obiekt
CameraUpdate
zawierający przekształcenie.
publiczne statyczny CameraUpdate newLatLng (LatLng szerokości geograficznej)
Zwraca wartość CameraUpdate
, która przesuwa środek ekranu do szerokości i długości geograficznej
określona przez obiekt LatLng
. Spowoduje to wyśrodkowanie kamery na obiekcie LatLng
.
Parametry
latLng | obiekt LatLng zawierający odpowiednią szerokość i długość geograficzną. |
---|
Zwroty
- obiekt
CameraUpdate
zawierający przekształcenie.
publiczne statyczny CameraUpdate newLatLngBounds (LatLngBounds, szerokość całkowita, wysokość całkowita, dopełnienie)
Zwraca funkcję CameraUpdate
, która przekształca kamerę w taki sposób, że określony
granice szerokości i długości geograficznej są wyśrodkowane na ekranie w ramce o określonych wymiarach
przy największym możliwym powiększeniu. Możesz określić dodatkowe dopełnienie, aby jeszcze bardziej ograniczyć
do rozmiaru ramki ograniczającej. Zwrócony obiekt CameraUpdate
ma położenie 0 i przechylenie
z 0.
W przeciwieństwie do newLatLngBounds(LatLngBounds, int)
, możesz używać CameraUpdate
zwracaną przez tę metodę, aby zmienić kamerę przed etapem układu mapy, ponieważ
argumentów określa żądany rozmiar ramki ograniczającej.
Parametry
granice | region, który ma się mieścić w ramce ograniczającej |
---|---|
szerokość | szerokość ramki ograniczającej w pikselach (piks.) |
wysokość | wysokość ramki ograniczającej w pikselach (piks.) |
padding | dodatkowe ograniczenie rozmiaru ramki ograniczającej (w pikselach) |
Zwroty
- obiekt
CameraUpdate
zawierający przekształcenie.
publiczne statyczny CameraUpdate newLatLngBounds (LatLngBounds – granice, pełne dopełnienie)
Zwraca funkcję CameraUpdate
, która przekształca kamerę w taki sposób, że określony
granice szerokości i długości geograficznej są wyśrodkowane na ekranie przy największym możliwym poziomie powiększenia. Dostępne opcje
określ dopełnienie, by ustawić ramkę ograniczającą od krawędzi widoku mapy. Zwrócone wartości
Położenie CameraUpdate
ma wartość 0, a pochylenie wynosi 0.
Nie zmieniaj kamery przy tej aktualizacji, dopóki mapa nie zostanie zmieniona (w
aby ta metoda poprawnie określała ramkę ograniczającą i poziom powiększenia,
mapa musi mieć określony rozmiar). W przeciwnym razie zostanie zgłoszony IllegalStateException
. NIE jest
wystarczająca, aby była dostępna mapa; widok z mapą musiał zostać wcześniej
układ, by określić wymiary. Jeśli nie masz pewności, czy
użyj parametru newLatLngBounds(LatLngBounds, int, int, int)
i podaj w nim
wymiary mapy.
Parametry
granice | obszar w celu dopasowania do ekranu |
---|---|
padding | odstępu (w pikselach) między krawędziami ramki ograniczającej a krawędziami widoku. Ten jest stosowana do wszystkich czterech stron ramki ograniczającej. |
Zwroty
- obiekt
CameraUpdate
zawierający przekształcenie.
publiczne statyczny CameraUpdate newLatLngZoom (LatLng, szerokość geograficzna, powiększenie pływające)
Zwraca wartość CameraUpdate
, która przesuwa środek ekranu do szerokości i długości geograficznej
określony przez obiekt LatLng
i przechodzi do wybranego poziomu powiększenia.
Parametry
latLng | obiekt LatLng zawierający odpowiednią szerokość i długość geograficzną. |
---|---|
zoom | wybierz poziom powiększenia w zakresie od 2,0 do 21,0. Wartości poniżej tego zakresu to jest ustawiona na 2,0, a wartości powyżej – 21,0. Zwiększ wartość, aby powiększyć. Nie wszystkie W przypadku obszarów z największym poziomem powiększenia kafelki. |
Zwroty
- obiekt
CameraUpdate
zawierający przekształcenie.
publiczne statyczny CameraUpdate scrollBy (liczba zmiennoprzecinkowa xPixel, float, yPixel)
Zwraca wartość CameraUpdate
, która przesuwa kamerę nad mapą, przesuwając środek
określoną liczbę pikseli w kierunkach x i y.
Przykłady:
- Jeśli xPixel = 5, a yPixel = 0, system przewija się w prawo, przesuwając aparat tak, aby przesunięto mapę o 5 pikseli w lewo.
- Jeśli xPixel = 0, a yPixel = 5, system przewija ekran w dół, przesuwając aparat tak, aby przesunięto się o 5 pikseli w górę.
Przewijanie zależy od bieżącej orientacji kamery. Jeśli na przykład kamera jest odchylenie do 90 stopni i wschód jest „na górze” lub przewinięcie w prawo spowoduje przesunięcie kamery na południe.
Parametry
xPixel | czyli liczbę pikseli do przewinięcia w poziomie. Wartość dodatnia przesuwa kamerę w stronę w stosunku do jego bieżącej orientacji. Wartość ujemna przenosi kamerę do: w lewo względem jego bieżącej orientacji. |
---|---|
yPixel | czyli liczbę pikseli do przewinięcia w pionie. Wartość dodatnia przenosi kamerę w dół zgodnie z jej bieżącą orientacją. Wartość ujemna przenosi kamerę w górę zgodnie z jej bieżącą orientacją. |
Zwroty
- obiekt
CameraUpdate
zawierający przekształcenie.
publiczne statyczny CameraUpdate zoomBy (liczba zmiennoprzecinkowa, ostrość punktowa)
Zwraca wartość CameraUpdate
, która zmienia poziom powiększenia bieżącego punktu widzenia kamery.
Punkt określony przez zaznaczenie pozostanie stały (tj. odpowiada tej samej szerokości i długości geograficznej zarówno przed i po powiększaniu).
Ta metoda różni się od metody zoomTo(float)
, ponieważ powiększenie jest zależne od bieżącego
aparat fotograficzny.
Jeśli na przykład LatLng
(11.11; 22.22) znajduje się obecnie w lokalizacji ekranu (23,
45). Po wywołaniu tej metody z określonym powiększeniem i tą wartością LatLng
lokalizacja ekranu
LatLng
nadal będzie wynosić (23, 45).
Parametry
kwota | aby zmienić poziom powiększenia. Wartości dodatnie oznaczają powiększenie powierzchni Ziemi, a ujemne wartości oznaczają oddalanie się od powierzchni Ziemi Ziemię. |
---|---|
ostrość | lokalizacja piksela na ekranie, która ma pozostać stała po powiększeniu. Szerokość i długość geograficzna, które znajdowały się w położeniu piksela przed przesunięciem kamery, pozostaną bez zmian. po przesunięciu kamery. |
Zwroty
- obiekt
CameraUpdate
zawierający przekształcenie.
publiczne statyczny CameraUpdate zoomBy (liczba zmiennoprzecinkowa)
Zwraca wartość CameraUpdate
, która zmienia poziom powiększenia bieżącego punktu widzenia kamery.
Ta metoda różni się od metody zoomTo(float)
, ponieważ powiększenie jest zależne od bieżącego
aparat fotograficzny.
Parametry
kwota | aby zmienić poziom powiększenia. Wartości dodatnie oznaczają powiększenie powierzchni Ziemi, a ujemne wartości oznaczają oddalanie się od powierzchni Ziemi Ziemię. |
---|
Zwroty
- obiekt
CameraUpdate
zawierający przekształcenie.
publiczne statyczny CameraUpdate zoomIn ()
Zwraca wartość CameraUpdate
, która powiększa mapę, przybliżając wysokość punktu obserwacyjnego
na powierzchnię Ziemi. Powiększenie jest zwiększane o 1,0.
Zwroty
- obiekt
CameraUpdate
zawierający przekształcenie.
publiczne statyczny CameraUpdate zoomOut ()
Zwraca wartość CameraUpdate
, która pomniejsza mapę przez przesunięcie wysokości punktu obserwacyjnego.
znajdujący się w większej odległości od powierzchni Ziemi. Powiększenie jest większe –1,0.
Zwroty
- obiekt
CameraUpdate
zawierający przekształcenie.
publiczne statyczny CameraUpdate zoomTo (powiększenie pływające)
Zwraca wartość CameraUpdate
, która przenosi punkt obserwacyjny kamery na określony poziom powiększenia.
Parametry
zoom | wybierz poziom powiększenia w zakresie od 2,0 do 21,0. Wartości poniżej tego zakresu to jest ustawiona na 2,0, a wartości powyżej – 21,0. Zwiększ wartość, aby powiększyć. Nie wszystkie W przypadku obszarów z największym poziomem powiększenia kafelki. |
---|