Mapa Google

publiczna klasa końcowy GoogleMap rozszerza obiekt

Jest to główna klasa pakietu SDK Map Google na Androida i punkt wejścia wszystkich metod związanych z mapą. Nie możesz utworzyć instancji obiektu GoogleMap bezpośrednio. Musisz go uzyskać z metody getMapAsync() w obiekcie MapFragment lub MapView dodanym do aplikacji.

Uwaga: podobnie jak w przypadku obiektu View, obiekt GoogleMap można odczytywać i modyfikować tylko w wątku interfejsu Androida. Wywołanie metod GoogleMap z innego wątku spowoduje wystąpienie wyjątku.

Punkt widzenia możesz dostosować, zmieniając pozycję kamery (a nie przesuwając mapę). Za pomocą kamery mapy możesz ustawić takie parametry jak lokalizacja, poziom powiększenia, kąt nachylenia i kierunek. Więcej informacji znajdziesz w sekcji Aparat i widok.

Przewodnik dla programistów

Na początek przeczytaj przewodnik dla programistów dotyczący pakietu SDK Map Google na Androida .

Podsumowanie zagnieżdżonych zajęć

interfejs, GoogleMap.CancelableCallback Interfejs wywołania zwrotnego do raportowania zakończenia lub anulowania zadania. 
interfejs, GoogleMap.InfoWindowAdapter Udostępnia widoki umożliwiające niestandardowe renderowanie okien informacyjnych. 
interfejs, GoogleMap.OnCameraChangeListener Ten interfejs został wycofany. Zastąpione przez GoogleMap.OnCameraMoveStartedListener, GoogleMap.OnCameraMoveListener i GoogleMap.OnCameraIdleListener. Kolejność wywoływania wycofanej metody onCameraChange w odniesieniu do metod w nowych odbiornikach zmian kamery jest niezdefiniowana.  
interfejs, GoogleMap.OnCameraIdleListener Interfejs wywołania zwrotnego po zakończeniu ruchu kamery. 
interfejs, GoogleMap.OnCameraMoveCanceledListener Interfejs wywołania zwrotnego, gdy ruch kamery został zatrzymany lub gdy kamera zaczęła się poruszać z nowego powodu. 
interfejs, GoogleMap.OnCameraMoveListener Interfejs wywołania zwrotnego, gdy kamera zmieni pozycję. 
interfejs, GoogleMap.OnCameraMoveStartedListener Interfejs wywołania zwrotnego po rozpoczęciu ruchu kamery. 
interfejs, GoogleMap.OnCircleClickListener Interfejs wywołania zwrotnego po kliknięciu kręgu. 
interfejs, GoogleMap.OnGroundOverlayClickListener Interfejs wywołania zwrotnego po kliknięciu nakładki na ziemi. 
interfejs, GoogleMap.OnIndoorStateChangeListener Detektor zmian stanu pomieszczenia. 
interfejs, GoogleMap.OnInfoWindowClickListener Interfejs wywołania zwrotnego dla zdarzeń kliknięcia lub dotknięcia w oknie informacyjnym znacznika. 
interfejs, GoogleMap.OnInfoWindowCloseListener Interfejs wywołania zwrotnego dla zdarzeń zamknięcia w oknie informacyjnym znacznika. 
interfejs, GoogleMap.OnInfoWindowLongClickListener Interfejs wywołania zwrotnego, gdy użytkownik długo naciśnie okno informacyjne znacznika. 
interfejs, GoogleMap.OnMapClickListener Interfejs wywołania zwrotnego, który ma być wyświetlany, gdy użytkownik kliknie mapę. 
interfejs, GoogleMap.OnMapLoadedCallback Interfejs wywołania zwrotnego po zakończeniu renderowania mapy. 
interfejs, GoogleMap.OnMapLongClickListener Interfejs wywołania zwrotnego, który jest wyświetlany, gdy użytkownik przytrzyma mapę. 
interfejs, GoogleMap.OnMarkerClickListener Definiuje podpisy metod wywoływanych po kliknięciu znacznika. 
interfejs, GoogleMap.OnMarkerDragListener Interfejs wywołania zwrotnego dla zdarzeń przeciągania w znacznikach. 
interfejs, GoogleMap.OnMyLocationButtonClickListener Interfejs wywołania zwrotnego po kliknięciu przycisku Moja lokalizacja. 
interfejs, GoogleMap.OnMyLocationChangeListener Ten interfejs został wycofany. Zamiast tego użyj com.google.android.gms.location.FusedLocationProviderApi. Interfejs FusedLocationProviderApi usprawnia znajdowanie lokalizacji i zużycie energii. Wskazuje na to niebieski punkt „Moja lokalizacja”. Zapoznaj się z samouczkiem Wybierz bieżące miejsce, który korzysta z interfejsu FusedLocationProviderApi lub Przewodnika dla programistów lokalizacji.  
interfejs, GoogleMap.OnMyLocationClickListener Interfejs wywołania zwrotnego po kliknięciu kropki Moja lokalizacja (oznaczającej lokalizację użytkownika).
interfejs, GoogleMap.OnPoiClickListener Nasłuchiwanie kliknięć ciekawych miejsc. 
interfejs, GoogleMap.OnPolygonClickListener Interfejs wywołania zwrotnego po kliknięciu wielokąta. 
interfejs, GoogleMap.OnPolylineClickListener Interfejs wywołania zwrotnego po kliknięciu linii łamanej. 
interfejs, GoogleMap.SnapshotReadyCallback Interfejs wywołania zwrotnego do powiadamiania o wykonaniu migawki. 

Stałe podsumowanie

int MAP_TYPE_HYBRID Mapy satelitarne z przezroczystą warstwą głównych ulic.
int MAP_TYPE_NONE Brak fragmentów mapy podstawowej.
int MAP_TYPE_NORMAL Podstawowe mapy.
int MAP_TYPE_SATELLITE Mapy satelitarne bez etykiet.
int MAP_TYPE_TERRAIN Mapy terenu.

Podsumowanie metod publicznych

Krąg
addCircle(opcje CircleOptions)
Dodaj okrąg do tej mapy.
GroundOverlay
addGroundOverlay(opcje GroundOverlayOptions)
Dodaje obraz do tej mapy.
Znacznik
addMarker(opcje MarkerOptions)
Dodaje znacznik do tej mapy.
Wielokąt
addPolygon(opcje PolygonOptions)
Dodaje wielokąt do tej mapy.
Linia łamana
addPolyline(opcje PolylineOptions)
Dodaje do mapy linię łamaną.
TileOverlay
addTileOverlay(opcje TileOverlayOptions)
Dodaje do mapy nakładkę z kafelkami.
void
animateCamera(aktualizacja CameraUpdate)
Powoduje, że ruch kamery jest przesuwany z bieżącej pozycji do pozycji zdefiniowanej w aktualizacji.
void
animateCamera(aktualizacja CameraUpdate, GoogleMap.CancelableCallback)
Animuje ruch kamery z bieżącej pozycji do pozycji zdefiniowanej w aktualizacji oraz wywołuje opcjonalne wywołanie zwrotne po zakończeniu.
void
animateCamera(aktualizacja CameraUpdate, intDurationMs, wywołanie zwrotne GoogleMap.CancelableCallback)
Przenosi mapę zgodnie z aktualizacją za pomocą animacji przez określony czas, a po zakończeniu wywołuje opcjonalne wywołanie zwrotne.
void
wyczyść()
Usuwa z mapy wszystkie znaczniki, linie łamane, wielokąty, warstwy itp.
CameraPosition
getCameraPosition().
Pobiera bieżącą pozycję kamery.
IndoorBuilding
getFocusedBuilding()
Pobiera obecnie wybrany budynek.
int
getMapType(),
Pobiera typ mapy, która jest obecnie wyświetlana.
float
getMaxZoomLevel()
Zwraca maksymalny poziom powiększenia dla bieżącej pozycji kamery.
float
getMinZoomLevel()
Zwraca minimalny poziom powiększenia.
Lokalizacja
getMyLocation()
Ta metoda została wycofana. use com.google.android.gms.location.FusedLocationProviderApi instead. Interfejs FusedLocationProviderApi usprawnia znajdowanie lokalizacji i zużycie energii. Wskazuje na to niebieski punkt „Moja lokalizacja”. Przykładowy kod znajdziesz w folderze MyLocationDemoActivity w folderze z przykładowymi aplikacjami lub w Przewodniku dla programistów lokalizacji.
Odwzorowanie
getProjection(),
Zwraca obiekt Projection, którego można użyć do konwertowania współrzędnych ekranu na współrzędne szerokości i długości geograficznej.
UiSettings
getUiSettings()
Pobiera ustawienia interfejsu użytkownika mapy.
boolean
isBuildingsEnabled()
Zwraca, czy warstwa budynków 3D jest włączona.
boolean
isIndoorEnabled()
Wskazuje, czy mapy obiektów są obecnie włączone.
boolean
isMyLocationEnabled()
Pobiera stan warstwy Moja lokalizacja.
boolean
isTrafficEnabled()
Sprawdza, czy mapa przedstawia dane o natężeniu ruchu.
void
moveCamera(aktualizacja CameraUpdate)
Zmienia położenie kamery zgodnie z instrukcjami określonymi w aktualizacji.
void
resetMinMaxZoomPreference().
Usuwa wcześniej określone górne i dolne granice powiększenia.
void
setBuildingsEnabled(wartość logiczna włączona)
Włącza lub wyłącza warstwę budynków 3D.
void
setContentDescription(opis ciągu znaków)
Ustawia atrybut contentDescription mapy.
boolean
setIndoorEnabled(wartość logiczna włączona)
Określa, czy mapy obiektów mają być włączone.
void
setInfoWindowAdapter(adapter GoogleMap.InfoWindowAdapter)
Ustawianie niestandardowego mechanizmu renderowania zawartości okien informacyjnych.
void
setLatLngBoundsForCameraTarget(granice LatLngBounds)
Określa granice lokalizacji geograficznej, by ograniczyć cel kamery. Dzięki temu podczas przewijania i przesuwania mapy cel kamery nie wykracza poza te granice.
void
setLocationSource(źródło LocationSource)
Zastępuje źródło lokalizacji w warstwie Moja-lokalizacja.
boolean
setMapStyle(styl MapStyleOptions)
Ustawia styl mapy podstawowej.
void
setMapType(typ int)
Ustawia typ kafelków mapy, które mają być wyświetlane.
void
setMaxZoomPreference(zmiennoprzecinkowy maxZoomPreference)
Ustawia preferowaną górną granicę powiększenia kamery.
void
setMinZoomPreference(zmiennoprzecinkowy minZoomPreference)
Ustawia preferowaną dolną granicę powiększenia kamery.
void
setMyLocationEnabled(wartość logiczna włączona)
Włącza lub wyłącza warstwę Moja lokalizacja.
void
void
setOnCameraIdleListener(detektor GoogleMap.OnCameraIdleListener)
Ustawia wywołanie zwrotne, które jest wywoływane po zakończeniu ruchu kamery.
void
setOnCameraMoveCanceledListener(detektor GoogleMap.OnCameraMoveCanceledListener)
Ustawia wywołanie zwrotne, które jest wywoływane, gdy ruch kamery zostanie zatrzymany lub przerwany przez nowy typ animacji.
void
setOnCameraMoveListener(detektor GoogleMap.OnCameraMoveListener)
Ustawia wywołanie zwrotne, które jest wywoływane wielokrotnie, gdy kamera jest w ruchu.
void
setOnCameraMoveStartedListener(detektor GoogleMap.OnCameraMoveStartedListener)
Ustawia wywołanie zwrotne, które jest wywoływane, gdy kamera zacznie się poruszać lub zmieni się powód jej ruchu.
void
setOnCircleClickListener(detektor GoogleMap.OnCircleClickListener)
Ustawia wywołanie zwrotne, które jest wywoływane po kliknięciu kręgu.
void
setOnGroundOverlayClickListener(detektor GoogleMap.OnGroundOverlayClickListener)
Ustawia wywołanie zwrotne, które jest wywoływane po kliknięciu nakładki na ziemi.
void
setOnIndoorStateChangeListener(detektor GoogleMap.OnIndoorStateChangeListener)
Ustawia lub usuwa odbiornik zdarzeń wewnętrznych.
void
setOnInfoWindowClickListener(detektor GoogleMap.OnInfoWindowClickListener)
Ustawia wywołanie zwrotne, które jest wywoływane po kliknięciu okna informacyjnego znacznika.
void
setOnInfoWindowCloseListener(detektor GoogleMap.OnInfoWindowCloseListener)
Ustawia wywołanie zwrotne, które jest wywoływane, gdy okno informacyjne znacznika jest zamknięte.
void
setOnInfoWindowLongClickListener(detektor GoogleMap.OnInfoWindowLongClickListener)
Ustawia wywołanie zwrotne, które jest wywoływane po długim naciśnięciu okna informacyjnego znacznika.
void
setOnMapClickListener(detektor GoogleMap.OnMapClickListener)
Ustawia wywołanie zwrotne, które jest wywoływane po dotknięciu mapy.
void
setOnMapLoadedCallback(wywołanie zwrotne GoogleMap.OnMapLoadedCallback)
Ustawia wywołanie zwrotne, które jest wywoływane po zakończeniu renderowania mapy.
void
setOnMapLongClickListener(detektor GoogleMap.OnMapLongClickListener)
Ustawia wywołanie zwrotne, które jest wywoływane po długim naciśnięciu mapy.
void
setOnMarkerClickListener(detektor GoogleMap.OnMarkerClickListener)
Ustawia wywołanie zwrotne, które jest wywoływane po kliknięciu znacznika.
void
setOnMarkerDragListener(detektor GoogleMap.OnMarkerDragListener)
Ustawia wywołanie zwrotne, które jest wywoływane po przeciągnięciu znacznika.
void
setOnMyLocationButtonClickListener(detektor GoogleMap.OnMyLocationButtonClickListener)
Ustawia wywołanie zwrotne, które jest wywoływane po kliknięciu przycisku Moja lokalizacja.
void
setOnMyLocationChangeListener(detektor GoogleMap.OnMyLocationChangeListener)
Ta metoda została wycofana. use com.google.android.gms.location.FusedLocationProviderApi instead. Interfejs FusedLocationProviderApi usprawnia znajdowanie lokalizacji i zużycie energii. Wskazuje na to niebieski punkt „Moja lokalizacja”. Przykładowy kod znajdziesz w folderze MyLocationDemoActivity w folderze z przykładowymi aplikacjami lub w Przewodniku dla programistów lokalizacji.
void
setOnMyLocationClickListener(detektor GoogleMap.OnMyLocationClickListener)
Ustawia wywołanie zwrotne, które jest wywoływane po kliknięciu kropki Moja lokalizacja (oznaczającej lokalizację użytkownika).
void
setOnPoiClickListener(detektor GoogleMap.OnPoiClickListener)
Konfiguruje detektor, który będzie aktywowany po kliknięciu lub dotknięciu ważnego miejsca.
void
setOnPolygonClickListener(detektor GoogleMap.OnPolygonClickListener)
Ustawia wywołanie zwrotne, które jest wywoływane po kliknięciu wielokąta.
void
setOnPolylineClickListener(detektor GoogleMap.OnPolylineClickListener)
Ustawia wywołanie zwrotne, które jest wywoływane po kliknięciu linii łamanej.
void
setPadding(int left, int top, int right, int bottom)
Ustawia dopełnienie na mapie.
void
setTrafficEnabled(wartość logiczna włączona)
Włącza lub wyłącza warstwę natężenia ruchu.
void
zrzut(wywołanie zwrotne GoogleMap.SnapshotReadyCallback)
Robi zrzut mapy.
void
zrzut(wywołanie zwrotne GoogleMap.SnapshotReadyCallback, bitmapa bitma)
Robi zrzut mapy.
void
stopAnimation()
Zatrzymuje animację kamery, jeśli trwa.

Podsumowanie metod dziedziczonych

Stałe

public static final int MAP_TYPE_HYBRID

Mapy satelitarne z przezroczystą warstwą głównych ulic.

Wartość stała: 4

public static final final int MAP_TYPE_NONE

Brak fragmentów mapy podstawowej.

Wartość stała: 0

public static final int MAP_TYPE_NORMAL

Podstawowe mapy.

Wartość stała: 1

public static final final MAP_TYPE_SATELLITE

Mapy satelitarne bez etykiet.

Wartość stała: 2

public static final final MAP_TYPE_TERRAIN

Mapy terenu.

Wartość stała: 3

Metody publiczne

publiczny Krąg addCircle (opcje CircleOptions)

Dodaj okrąg do tej mapy.

Parametry
Opcje Obiekt opcji kręgu określający sposób renderowania okręgu
Akcje powrotne
  • Obiekt Circle dodany do mapy

public GroundOverlay addGroundOverlay (opcje GroundOverlayOptions)

Dodaje obraz do tej mapy.

Parametry
Opcje Obiekt opcji warstwy nakładek, który określa sposób renderowania nakładki. Opcje muszą mieć określony obraz (AnchoredBitmap) i pozycję.
Akcje powrotne
Rzuty
IllegalArgumentException jeśli obraz lub pozycja nie są określone w opcjach.

public Marker addMarker (opcje MarkerOptions)

Dodaje znacznik do tej mapy.

Ikona znacznika jest wyświetlana na mapie w pozycji Znacznik lokalizacji. Kliknięcie znacznika wyśrodkowuje aparat na znaczniku. Jeśli zdefiniowano znaczniki znacznika.title, na mapie pojawi się pole informacyjne z tytułem i krótkim opisem znacznika. Jeśli znacznik można przeciągnąć, przytrzymaj go, a następnie przeciągnij, aby go przenieść.

Parametry
Opcje Obiekt opcji znacznika, który określa sposób renderowania znacznika.
Akcje powrotne
  • Marker, który został dodany do mapy.

public Polygon addPolygon (opcje PolygonOptions)

Dodaje wielokąt do tej mapy.

Parametry
Opcje Obiekt opcji wielokąta określający sposób renderowania wielokąta.
Akcje powrotne
  • Obiekt Polygon dodany do mapy.

publiczna Polyline addPolyline (opcje PolylineOptions)

Dodaje do mapy linię łamaną.

Parametry
Opcje Obiekt opcji linii łamanej, który określa sposób renderowania linii łamanej.
Akcje powrotne
  • Obiekt Polyline, który został dodany do mapy.

public TileOverlay addTileOverlay (opcje TileOverlayOptions)

Dodaje do mapy nakładkę z kafelkami. Aby dowiedzieć się więcej, przeczytaj TileOverlay.

W przeciwieństwie do innych nakładek, jeśli mapa zostanie odtworzona, nakładki z kafelkami nie są przywracane automatycznie i trzeba je ponownie dodać ręcznie.

Parametry
Opcje Obiekt opcji nakładki kafelków określający sposób renderowania nakładki. Opcje muszą mieć określoną wartość TileProvider. W przeciwnym razie zostanie zwrócony błąd IllegalArgumentException.
Akcje powrotne
Rzuty
IllegalArgumentException jeśli TileProvider nie jest określony w opcjach.

public void animateCamera (aktualizacja CameraUpdate)

Powoduje, że ruch kamery jest przesuwany z bieżącej pozycji do pozycji zdefiniowanej w aktualizacji. Podczas animacji wywołanie getCameraPosition() zwraca pośrednią lokalizację kamery.

Szczegółowe informacje znajdziesz na stronie CameraUpdateFactory.

Parametry
aktualizować Zmiana, która powinna zostać zastosowana do kamery.

public void animateCamera (aktualizacja CameraUpdate, GoogleMap.CancelableCallback – wywołanie zwrotne)

Animuje ruch kamery z bieżącej pozycji do pozycji zdefiniowanej w aktualizacji oraz wywołuje opcjonalne wywołanie zwrotne po zakończeniu. Zbiór aktualizacji znajdziesz na CameraUpdateFactory.

Podczas animacji wywołanie getCameraPosition() zwraca pośrednią lokalizację kamery.

Parametry
aktualizować Zmiana, która powinna zostać zastosowana do kamery.
wywołanie zwrotne Wywołanie zwrotne do wywołania z wątku interfejsu Androida po zatrzymaniu animacji. Jeśli animacja zakończy się w zwykły sposób, wywoływana jest metoda onFinish(). W przeciwnym razie obiekt onCancel() jest wywoływany. Nie aktualizuj ani nie animuj kamery z poziomu onCancel().

public void animateCamera (CameraUpdate – aktualizacja, intDurationMs, GoogleMap.CancelableCallback – wywołanie zwrotne)

Przenosi mapę zgodnie z aktualizacją za pomocą animacji przez określony czas, a po zakończeniu wywołuje opcjonalne wywołanie zwrotne. Szczegółowe informacje znajdziesz na stronie CameraUpdateFactory.

Jeśli funkcja getCameraPosition() zostanie wywołana podczas animacji, zwróci bieżącą lokalizację kamery w locie.

Parametry
aktualizować
durationMs Czas trwania animacji w milisekundach. Ta wartość musi być bezpośrednio dodatnia. W przeciwnym razie zostanie wywołana IllegalArgumentException.
wywołanie zwrotne Opcjonalne wywołanie zwrotne, które otrzymuje powiadomienie z wątku interfejsu Androida, gdy animacja się zatrzyma. Jeśli animacja zostanie zatrzymana ze względu na naturalne zakończenie, wywołanie zwrotne zostanie wysłane za pomocą funkcji onFinish(). Jeśli animacja zostanie zatrzymana z powodu późniejszego ruchu kamery lub gestu użytkownika, wywołana zostanie właściwość onCancel(). Wywołanie zwrotne nie powinno próbować przesuwać ani animować kamery za pomocą metody anulowania. Jeśli wywołanie zwrotne nie jest wymagane, pozostaw je null.

public void clear ()

Usuwa z mapy wszystkie znaczniki, linie łamane, wielokąty, warstwy itp.

public CameraPosition getCameraPosition ()

Pobiera bieżącą pozycję kamery.

Zwrócony wynik CameraPosition przedstawia bieżącą pozycję i nie jest automatycznie aktualizowany, gdy kamera się porusza.

Więcej informacji o zmienianiu pozycji kamery znajdziesz w sekcji Kamera i widok.

Akcje powrotne
  • Aktualne położenie kamery.

public IndoorBuilding getFocusedBuilding ()

Pobiera obecnie wybrany budynek.

Akcje powrotne
  • Aktualnie wybrany budynek lub null, jeśli żaden budynek nie jest aktywny.

public int getMapType ()

Pobiera typ mapy, która jest obecnie wyświetlana. Możliwe wartości znajdziesz w sekcjach MAP_TYPE_NORMAL, MAP_TYPE_SATELLITE oraz MAP_TYPE_TERRAIN.

Akcje powrotne
  • Typ mapy.

public float getMaxZoomLevel ()

Zwraca maksymalny poziom powiększenia dla bieżącej pozycji kamery. Uwzględniany jest obecnie typ mapy, np. widok satelitarny lub teren może mieć niższy maksymalny poziom powiększenia niż elementy mapy podstawowej.

Więcej informacji o zmienianiu poziomu powiększenia kamery znajdziesz w sekcji Kamera i widok.

Akcje powrotne
  • Maksymalny dostępny poziom powiększenia w bieżącym położeniu kamery.

public float getMinZoomLevel ()

Zwraca minimalny poziom powiększenia. Jest tak samo w przypadku każdej lokalizacji (w przeciwieństwie do maksymalnego poziomu powiększenia), ale może się różnić w zależności od urządzenia i rozmiaru mapy.

Więcej informacji o zmienianiu poziomu powiększenia kamery znajdziesz w sekcji Kamera i widok.

Akcje powrotne
  • Minimalny dostępny poziom powiększenia.

public Location getMyLocation ()

Ta metoda została wycofana.
zamiast niej użyj com.google.android.gms.location.FusedLocationProviderApi. Interfejs FusedLocationProviderApi usprawnia znajdowanie lokalizacji i zużycie energii. Wskazuje na to niebieski punkt „Moja lokalizacja”. Przykładowy kod znajdziesz w folderze MyLocationDemoActivity w folderze z przykładowymi aplikacjami lub w Przewodniku dla programistów lokalizacji.

Zwraca obecnie wyświetlaną lokalizację użytkownika lub zwraca wartość null, jeśli dane o lokalizacji są niedostępne.

Akcje powrotne
Rzuty
IllegalStateException jeśli warstwa Moja lokalizacja jest wyłączona.

public Projekcja getProjection ()

Zwraca obiekt Projection, którego można użyć do konwertowania współrzędnych ekranu na współrzędne szerokości i długości geograficznej.

Zwrócony wynik Projection stanowi zrzut bieżącej projekcji i nie jest automatycznie aktualizowany, gdy kamera się porusza. Jest to kosztowna operacja, dlatego projekcję należy wyświetlić tylko raz na każdy ekran. Mapy Google wykorzystują odwzorowanie Merkatora do tworzenia map na podstawie danych geograficznych i przekształcania punktów na mapie na współrzędne geograficzne.

Akcje powrotne

publiczne UiSettings getUiSettings ()

Pobiera ustawienia interfejsu użytkownika mapy.

Akcje powrotne

public boolean isBuildingsEnabled ()

Zwraca, czy warstwa budynków 3D jest włączona.

Akcje powrotne
  • true, jeśli są włączone budynki, lub false, jeśli jest inaczej.

public boolean isIndoorEnabled ()

Wskazuje, czy mapy obiektów są obecnie włączone.

Akcje powrotne
  • true, jeśli są włączone mapy obiektów; false, gdy mapy obiektów są wyłączone;

public boolean isMyLocationEnabled ()

Pobiera stan warstwy Moja lokalizacja.

Akcje powrotne
  • true, jeśli włączona jest warstwa Moja lokalizacja; false w przeciwnym razie;

public boolean isTrafficEnabled ()

Sprawdza, czy mapa przedstawia dane o natężeniu ruchu. Zależy to od dostępności danych o ruchu.

Akcje powrotne
  • true, jeśli włączone są dane o ruchu; false w przeciwnym razie.

public void moveCamera (aktualizacja CameraUpdate)

Zmienia położenie kamery zgodnie z instrukcjami określonymi w aktualizacji. Przeniesienie jest natychmiastowe, a kolejne getCameraPosition() odzwierciedla nową pozycję. Zbiór aktualizacji znajdziesz na stronie CameraUpdateFactory.

Parametry
aktualizować Zmiana, która powinna zostać zastosowana do kamery.

public void resetMinMaxZoomPreference ()

Usuwa wcześniej określone górne i dolne granice powiększenia.

public void setBuildingsEnabled (boolean enabled)

Włącza lub wyłącza warstwę budynków 3D.

Parametry
włączone true, aby włączyć warstwę budynków 3D, lub false, aby wyłączyć budynki 3D.

public void setContentDescription (Opis ciągu)

Ustawia atrybut contentDescription mapy.

Ta funkcja służy do odczytywania głosowego opisu mapy w trybie ułatwień dostępu. Wartością domyślną jest „Mapa Google”.

Parametry
opis który ma służyć jako opis.

public boolean setIndoorEnabled (boolean enabled)

Określa, czy mapy obiektów mają być włączone. Obecnie mapy obiektów mogą być wyświetlane tylko na 1 mapie naraz i domyślnie jest to pierwsza mapa dodana do aplikacji. Aby włączyć mapy obiektu na innej mapie, musisz najpierw wyłączyć mapy obiektów na oryginalnej mapie. Próba włączenia map obiektów, gdy jest włączona na innej mapie, nic się nie wydarzy i zwróci wartość false. Gdy ta opcja nie jest włączona dla mapy, wszystkie metody powiązane z obiektem zwrócą wartość null lub false.

Parametry
włączone true, aby spróbować włączyć mapy obiektu, false, aby wyłączyć mapy obiektu.
Akcje powrotne
  • czy można było włączyć mapy obiektów.

public void setInfoWindowAdapter (adapter GoogleMap.InfoWindowAdapter)

Ustawianie niestandardowego mechanizmu renderowania zawartości okien informacyjnych.

Podobnie jak w przypadku detektorów zdarzeń mapy, ten stan nie jest zserializowany na mapie. Jeśli mapa zostanie utworzona ponownie (np. z powodu zmiany konfiguracji), musisz wywołać tę metodę jeszcze raz, aby zachować dostosowanie.

Parametry
adapter Adapter używany do wyświetlania zawartości okna informacyjnego lub null, aby używać domyślnego renderowania treści w oknach informacyjnych.

public void setLatLngBoundsForCameraTarget (LatLngBounds zakres)

Określa granice lokalizacji geograficznej, by ograniczyć cel kamery. Dzięki temu podczas przewijania i przesuwania mapy cel kamery nie wykracza poza te granice.

Aby całkowicie wyczyścić ramkę ograniczającą, ustaw wartość null. Nowe granice zastępują wszystkie wcześniej określone ramki ograniczające.

Gdy zmieni się parametr LatLngBounds, pakiet SDK będzie w miarę możliwości dostosowywać wszystkie późniejsze aktualizacje kamery do tych wartości. Istnieją pewne kwestie techniczne, które mogą uniemożliwić pakietowi SDK utrzymanie kierowania kamery w ściśle poza granicami. Mogą to być na przykład błędy zaokrąglania liczby zmiennoprzecinkowej lub bardzo niski poziom powiększenia.

Parametry
granice Granice, w których można zablokować cel kamery.

public void setLocationSource (źródło: LocationSource)

Zastępuje źródło lokalizacji w warstwie Moja-lokalizacja.

Parametry
source Źródło lokalizacji do użycia w warstwie Moja-lokalizacja. Ustaw jako null, aby używać domyślnego źródła lokalizacji.

public boolean setMapStyle (styl MapStyleOptions)

Ustawia styl mapy podstawowej.

Korzystając z opcji stylu, możesz stosować style niestandardowe do obiektów i elementów na mapie. Na stronie MapStyleOptions znajdziesz szczegółowe informacje o definicji stylu.

Aby usunąć poprzedni styl niestandardowy, ustaw wartość null.

Parametry
styl
Akcje powrotne
  • true, jeśli styl został przeanalizowany; false, jeśli zostały wykryte problemy z MapStyleOptions, w tym niemożliwy do przeanalizowania styl JSON, nierozpoznany typ funkcji, nierozpoznany typ elementu lub nieprawidłowe klucze stylura. Jeśli zwracana wartość to false, bieżący styl pozostaje bez zmian.

public void setMapType (typ int)

Ustawia typ kafelków mapy, które mają być wyświetlane. Dozwolone wartości to:

Parametry
typ Typ mapy do wyświetlenia.

public void setMaxZoomPreference (float maxZoomPreference)

Ustawia preferowaną górną granicę powiększenia kamery.

Gdy zmieni się maksymalne powiększenie, pakiet SDK w miarę możliwości dostosowuje wszystkie późniejsze aktualizacje kamery. Ze względu na wymagania techniczne mogące uniemożliwić użytkownikom zbyt głębsze powiększanie mapy przez pakiet SDK. Na przykład widok satelitarny lub teren może mieć mniejsze maksymalne powiększenie niż fragmenty mapy podstawowej.

Pakiet SDK rozwiązuje wszystkie konflikty wartości minimalnych i maksymalnych. Jeśli ustawisz minimalne powiększenie na wyższy poziom niż bieżący maksymalny, pakiet SDK będzie używać nowej wartości minimalnej zarówno dla wartości minimalnego, jak i maksymalnego. Jeśli ustawisz maksymalny zoom na mniejszy niż minimalny, pakiet SDK użyje nowej wartości maksymalnej zarówno dla wartości minimalnego, jak i maksymalnego. Załóżmy na przykład, że obecne minimalne powiększenie to 8, a maksimum 14. Następnie ustawiasz maksymalne powiększenie na 6. Pakiet SDK używa minimalnego powiększenia na poziomie 6, a maksymalnym – 6.

Parametry
maxZoomPreference Preferowana górna granica.

public void setMinZoomPreference (float minZoomPreference)

Ustawia preferowaną dolną granicę powiększenia kamery.

Gdy minimalne powiększenie ulegnie zmianie, pakiet SDK będzie w miarę możliwości dostosowywać wszystkie późniejsze aktualizacje kamery. Pamiętaj, że istnieją kwestie techniczne, które mogą uniemożliwiać SDK użytkownikom zbyt małe powiększanie.

Pakiet SDK rozwiązuje wszystkie konflikty wartości minimalnych i maksymalnych. Jeśli ustawisz minimalne powiększenie na wyższy poziom niż bieżący maksymalny, pakiet SDK będzie używać nowej wartości minimalnej zarówno dla wartości minimalnego, jak i maksymalnego. Jeśli ustawisz maksymalny zoom na mniejszy niż minimalny, pakiet SDK użyje nowej wartości maksymalnej zarówno dla wartości minimalnego, jak i maksymalnego. Załóżmy na przykład, że obecne minimalne powiększenie to 8, a maksimum 14. Następnie ustawiasz minimalne powiększenie na 16. Pakiet SDK korzysta z powiększenia o minimalnej wartości 16, a maksymalnego do 16.

Parametry
minZoomPreference Preferowana dolna granica.

public void setMyLocationEnabled (boolean enabled)

Włącza lub wyłącza warstwę Moja lokalizacja.

Gdy ta opcja jest włączona, a lokalizacja jest dostępna, warstwa moja lokalizacja stale czerpie informacje o bieżącej lokalizacji użytkownika oraz wyświetla elementy sterujące interfejsu, które umożliwiają użytkownikowi interakcję z jego lokalizacją (np. włączanie lub wyłączanie śledzenia lokalizacji i położenia użytkownika).

Aby używać funkcji warstwy mojej lokalizacji, musisz poprosić o uprawnienia do zasobu ACCESS_COARSE_LOCATION lub ACCESS_FINE_LOCATION, chyba że masz ustawione niestandardowe źródło lokalizacji.

Jeśli niestandardowe źródło lokalizacji ustawisz za pomocą setLocationSource(LocationSource), pakiet SDK Map Google na Androida nie sprawdzi, czy te uprawnienia zostały przyznane. Musisz jednak sprawdzić, czy użytkownik przyznał wszystkie uprawnienia wymagane dla Twojego niestandardowego źródła lokalizacji.

Parametry
włączone true, aby włączyć, lub false, aby wyłączyć.
Rzuty
SecurityException jeśli nie przyznasz dostępu do lokalizacji.

public void setOnCameraChangeListener (detektor GoogleMap.OnCameraChangeListener)

Ta metoda została wycofana.
Zastąpione przez setOnCameraMoveStartedListener(GoogleMap.OnCameraMoveStartedListener), setOnCameraMoveListener(GoogleMap.OnCameraMoveListener), setOnCameraMoveCanceledListener(GoogleMap.OnCameraMoveCanceledListener) i setOnCameraIdleListener(GoogleMap.OnCameraIdleListener).

Ustawia wywołanie zwrotne, które jest wywoływane, gdy zmienia się kamera.

Parametry
detektor Wywołanie zwrotne, które jest wywoływane, gdy zmienia się kamera. Aby anulować wywołanie zwrotne, użyj null.

public void setOnCameraIdleListener (detektor GoogleMap.OnCameraIdleListener)

Ustawia wywołanie zwrotne, które jest wywoływane po zakończeniu ruchu kamery.

Parametry
detektor Wywołane wywołanie zwrotne. Aby anulować wywołanie zwrotne, wpisz null.

public void setOnCameraMoveCanceledListener (detektor GoogleMap.OnCameraMoveCanceledListener)

Ustawia wywołanie zwrotne, które jest wywoływane, gdy ruch kamery zostanie zatrzymany lub przerwany przez nowy typ animacji.

Parametry
detektor Wywołane wywołanie zwrotne. Aby anulować wywołanie zwrotne, wpisz null. Nie aktualizuj ani nie animuj kamery z poziomu onCameraMoveCanceled().

public void setOnCameraMoveListener (detektor GoogleMap.OnCameraMoveListener)

Ustawia wywołanie zwrotne, które jest wywoływane wielokrotnie, gdy kamera jest w ruchu. Wywołanie zwrotne może być wywoływane tak często, jak każda ramka, i nie powinno wykonywać kosztownych operacji.

Parametry
detektor Wywołane wywołanie zwrotne. Aby anulować wywołanie zwrotne, wpisz null.

public void setOnCameraMoveStartedListener (detektor GoogleMap.OnCameraMoveStartedListener)

Ustawia wywołanie zwrotne, które jest wywoływane, gdy kamera zacznie się poruszać lub zmieni się powód jej ruchu.

Parametry
detektor Wywołane wywołanie zwrotne. Aby anulować wywołanie zwrotne, wpisz null. Nie aktualizuj ani nie animuj kamery z poziomu onCameraMoveStarted().

public void setOnCircleClickListener (detektor GoogleMap.OnCircleClickListener)

Ustawia wywołanie zwrotne, które jest wywoływane po kliknięciu kręgu.

Parametry
detektor Wywołanie zwrotne wywoływane po kliknięciu kręgu. Aby anulować wywołanie zwrotne, użyj null.

public void setOnGroundOverlayClickListener (detektor GoogleMap.OnGroundOverlayClickListener)

Ustawia wywołanie zwrotne, które jest wywoływane po kliknięciu nakładki na ziemi.

Parametry
detektor Wywołanie zwrotne wywoływane po kliknięciu nakładki na ziemi. Aby anulować wywołanie zwrotne, użyj null.

public void setOnIndoorStateChangeListener (detektor GoogleMap.OnIndoorStateChangeListener)

Ustawia lub usuwa odbiornik zdarzeń wewnętrznych. Można ustawić tylko 1 detektor. Ustawienie nowego detektora spowoduje usunięcie poprzedniego.

Parametry
detektor detektor zdarzeń wewnątrz, jeśli nie ma wartości null; w przeciwnym razie kasuje detektor.

public void setOnInfoWindowClickListener (detektor GoogleMap.OnInfoWindowClickListener)

Ustawia wywołanie zwrotne, które jest wywoływane po kliknięciu okna informacyjnego znacznika.

Parametry
detektor Wywołanie zwrotne wywoływane po kliknięciu okna informacyjnego znacznika. Aby anulować wywołanie zwrotne, użyj null.

public void setOnInfoWindowCloseListener (detektor GoogleMap.OnInfoWindowCloseListener)

Ustawia wywołanie zwrotne, które jest wywoływane, gdy okno informacyjne znacznika jest zamknięte.

Parametry
detektor Wywołanie zwrotne wywoływane, gdy okno informacyjne znacznika jest zamknięte. Aby anulować wywołanie zwrotne, użyj null.

public void setOnInfoWindowLongClickListener (detektor GoogleMap.OnInfoWindowLongClickListener)

Ustawia wywołanie zwrotne, które jest wywoływane po długim naciśnięciu okna informacyjnego znacznika.

Parametry
detektor Wywołanie zwrotne wywoływane po długim naciśnięciu okna informacyjnego znacznika. Aby anulować wywołanie zwrotne, użyj null.

public void setOnMapClickListener (detektor GoogleMap.OnMapClickListener)

Ustawia wywołanie zwrotne, które jest wywoływane po dotknięciu mapy.

Parametry
detektor Wywołanie zwrotne, które jest wywoływane po kliknięciu mapy. Aby anulować wywołanie zwrotne, użyj null.

public void setOnMapLoadedCallback (wywołanie zwrotne GoogleMap.OnMapLoadedCallback)

Ustawia wywołanie zwrotne, które jest wywoływane po zakończeniu renderowania mapy. Wywołanie zwrotne zostanie wywołane tylko raz.

Jeśli ta metoda zostanie wywołana po pełnym wyrenderowaniu mapy, wywołanie zwrotne zostanie wykonane natychmiast. Zdarzenie to nie zostanie uruchomione, jeśli mapa nie zostanie wczytana z powodu problemów z połączeniem lub jeśli mapa stale się zmienia i nigdy się nie kończy z powodu ciągłej interakcji użytkownika z mapą.

Parametry
wywołanie zwrotne Wywołanie zwrotne jest wywoływane po zakończeniu renderowania mapy. Aby anulować wywołanie zwrotne, użyj null.

public void setOnMapLongClickListener (detektor GoogleMap.OnMapLongClickListener)

Ustawia wywołanie zwrotne, które jest wywoływane po długim naciśnięciu mapy.

Parametry
detektor Wywołanie zwrotne wywoływane po długim naciśnięciu mapy. Aby anulować wywołanie zwrotne, użyj null.

public void setOnMarkerClickListener (detektor GoogleMap.OnMarkerClickListener)

Ustawia wywołanie zwrotne, które jest wywoływane po kliknięciu znacznika.

Parametry
detektor Wywołanie zwrotne wywoływane po kliknięciu znacznika. Aby anulować wywołanie zwrotne, użyj null.

public void setOnMarkerDragListener (detektor GoogleMap.OnMarkerDragListener)

Ustawia wywołanie zwrotne, które jest wywoływane po przeciągnięciu znacznika.

Parametry
detektor Wywołanie zwrotne wywoływane po zdarzeniach przeciągania znaczników. Aby anulować wywołanie zwrotne, użyj null.

public void setOnMyLocationButtonClickListener (detektor GoogleMap.OnMyLocationButtonClickListener)

Ustawia wywołanie zwrotne, które jest wywoływane po kliknięciu przycisku Moja lokalizacja.

Jeśli listener zwraca wartość true, zdarzenie jest wykorzystywane i nie występuje domyślne zachowanie. Jeśli zwróci wartość false, nastąpi działanie domyślne (tzn. kamera zostanie wyśrodkowana na lokalizacji użytkownika).

Parametry
detektor Wywołanie zwrotne wywoływane po kliknięciu przycisku Moja lokalizacja.

public void setOnMyLocationChangeListener (detektor GoogleMap.OnMyLocationChangeListener)

Ta metoda została wycofana.
zamiast niej użyj com.google.android.gms.location.FusedLocationProviderApi. Interfejs FusedLocationProviderApi usprawnia znajdowanie lokalizacji i zużycie energii. Wskazuje na to niebieski punkt „Moja lokalizacja”. Przykładowy kod znajdziesz w folderze MyLocationDemoActivity w folderze z przykładowymi aplikacjami lub w Przewodniku dla programistów lokalizacji.

Ustawia wywołanie zwrotne, które jest wywoływane, gdy kropka Moja lokalizacja zmienia lokalizację.

Parametry
detektor Wywołanie zwrotne wywoływane po zmianie kropki Moja lokalizacja.

public void setOnMyLocationClickListener (detektor GoogleMap.OnMyLocationClickListener)

Ustawia wywołanie zwrotne, które jest wywoływane po kliknięciu kropki Moja lokalizacja (oznaczającej lokalizację użytkownika).

Parametry
detektor Wywołanie zwrotne wywoływane po kliknięciu kropki Moja lokalizacja.

public void setOnPoiClickListener (detektor GoogleMap.OnPoiClickListener)

Konfiguruje detektor, który będzie aktywowany po kliknięciu lub dotknięciu ważnego miejsca.

Podaj null, aby wyczyścić słuchawkę.

Parametry
detektor

public void setOnPolygonClickListener (detektor GoogleMap.OnPolygonClickListener)

Ustawia wywołanie zwrotne, które jest wywoływane po kliknięciu wielokąta.

Parametry
detektor Wywołanie zwrotne wywoływane po kliknięciu wielokąta. Aby anulować wywołanie zwrotne, użyj null.

public void setOnPolylineClickListener (detektor GoogleMap.OnPolylineClickListener)

Ustawia wywołanie zwrotne, które jest wywoływane po kliknięciu linii łamanej.

Parametry
detektor Wywołanie zwrotne wywoływane po kliknięciu linii łamanej. Aby anulować wywołanie zwrotne, użyj null.

public void setPadding (int left, int top, int right, int bottom)

Ustawia dopełnienie na mapie.

Ta metoda pozwala zdefiniować widoczny obszar na mapie, aby zasygnalizować mapę, że fragmenty mapy wokół krawędzi mogą być zasłonięte, ustawiając dopełnienie na każdej z 4 krawędzi mapy. Funkcje mapy zostaną dostosowane do dopełnienia. Na przykład elementy sterujące powiększeniem, kompas, informacje o prawach autorskich i logo Google zostaną przeniesione, aby zmieściły się w określonym regionie, a ruch kamery będzie się ustalał względem środka widocznego obszaru itp.

Parametry
lewa liczba pikseli dopełnienia, które mają zostać dodane od lewej strony mapy.
góra liczba pikseli dopełnienia, które mają zostać dodane na górze mapy.
prawa liczba pikseli dopełnienia, które mają zostać dodane z prawej strony mapy.
dół liczba pikseli dopełnienia, które mają zostać dodane na dole mapy.

public void setTrafficEnabled (boolean enabled)

Włącza lub wyłącza warstwę natężenia ruchu.

Parametry
włączone

public void migawka (wywołanie zwrotne GoogleMap.SnapshotReadyCallback)

Robi zrzut mapy.

Zrzutów w aplikacji możesz używać, gdy korzystanie z interaktywnej mapy byłoby trudne lub niemożliwe. Na przykład obrazy wygenerowane metodą snapshot() mogą służyć do wyświetlania miniatury mapy w aplikacji lub migawki w centrum powiadomień.

Uwaga: obrazów mapy nie można przesyłać na serwery ani w inny sposób używać poza aplikacją. Jeśli musisz wysłać mapę do innej aplikacji lub użytkownika, wyślij dane, które pozwolą im zrekonstruować mapę dla nowego użytkownika zamiast zrzutu.

Parametry
wywołanie zwrotne Metoda wywołania zwrotnego jest wywoływana podczas tworzenia zrzutu.

public void migawka (wywołanie zwrotne GoogleMap.SnapshotReadyCallback, bitmapa bitowa)

Robi zrzut mapy.

Ta metoda jest odpowiednikiem metody snapshot(SnapshotReadyCallback), ale umożliwia podanie wstępnie przydzielonej metody Bitmap. Jeśli bitmapa nie pasuje do bieżących wymiarów mapy, przydzielona jest inna bitmapa pasująca do wymiarów mapy.

Mimo że w większości przypadków obiekt przekazywany przez metodę wywołania zwrotnego jest taki sam jak obiekt podany w parametrze tej metody, w niektórych przypadkach zwrócony obiekt może być inny (np. jeśli wymiary widoku zmienią się w momencie wykonania zrzutu). Z tego względu należy ufać tylko zawartości bitmapy przekazanej przez metodę wywołania zwrotnego.

Parametry
wywołanie zwrotne Metoda wywołania zwrotnego jest wywoływana podczas tworzenia zrzutu.
bitmapa Wstępnie przydzielona mapa bitowa. Jeśli null działa jak snapshot(SnapshotReadyCallback).

public void stopAnimation ()

Zatrzymuje animację kamery, jeśli trwa. Po wywołaniu metody kamera natychmiast przestaje się poruszać i pozostaje w tym położeniu.