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ż
GoogleMapbędzie dostępny w aplikacjiMapFragmentlubMapViewdodanej do Twojej aplikacji. Możesz uzyskaćGoogleMapprzez wywołaniegetMapAsync()i oczekiwanie na połączenie zwrotneonMapReady(GoogleMap map). - Zadzwoń do firmy
initialize(Context). Dopóki klasaGooglePlayServicesNotAvailableExceptionnie 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
CameraUpdatezawierają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
CameraUpdatezawierają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
CameraUpdatezawierają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
CameraUpdatezawierają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
CameraUpdatezawierają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
CameraUpdatezawierają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
CameraUpdatezawierają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
CameraUpdatezawierają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
CameraUpdatezawierają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
CameraUpdatezawierają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. |
|---|