Mapa Google

publiczna klasa końcowa GoogleMap rozszerza obiekt

To jest główna klasa pakietu Android Maps SDK na Androida, która służy jako punkt wejścia dla wszystkich metod powiązanych z mapą. Nie możesz bezpośrednio utworzyć obiektu GoogleMap, ale musisz go uzyskać przy użyciu metody getMapAsync() dodanej do aplikacji MapFragment lub MapView do aplikacji.

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

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

Przewodnik dla programistów

Na początek przeczytaj przewodnik dla programistów pakietu Mapy Google na Androida (w języku angielskim).

Podsumowanie zagnieżdżonych zajęć

interfejs GoogleMap.CancelableCallback Interfejs wywołania zwrotnego zgłaszania po ukończeniu lub anulowaniu zadania. 
interfejs AdapterGoogleMap.InfoWindow Udostępnia widoki dostosowane do renderowania 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 detektorach zmian aparatu jest nieokreślona.  
interfejs GoogleMap.OnCameraIdleListener Interfejs wywołania zwrotnego po zakończeniu ruchu kamery. 
interfejs GoogleMap.OnCameraMoveededListener Interfejs wywołania zwrotnego dla ruchu, po którym kamera została zatrzymana lub gdy kamera zaczęła poruszać się z nowego powodu. 
interfejs GoogleMap.OnCameraMoveListener Interfejs wywołania zwrotnego zmiany pozycji kamery. 
interfejs GoogleMap.OnCameraTransferStartedListener Interfejs wywołania zwrotnego dla ruchu kamery. 
interfejs GoogleMap.OnCircleClickListener Interfejs wywołania zwrotnego kliknięcia okręgu. 
interfejs GoogleMap.OnGroundNakładkaClickListener Interfejs wywołania zwrotnego po kliknięciu nakładki powierzchni. 
interfejs GoogleMap.OnIndoorStateChangeListener Detektor, gdy zmienia się stan wewnątrz. 
interfejs GoogleMap.OnInfoWindowClickListener Interfejs wywołania zwrotnego zdarzeń kliknięcia i znacznika w oknie informacyjnym znacznika. 
interfejs GoogleMap.OnInfoWindowCloseListener Interfejs wywołania zwrotnego zamknięcia w oknie informacyjnym znacznika. 
interfejs GoogleMap.OnInfoWindowLongClickListener Interfejs wywołania zwrotnego pokazujący, kiedy użytkownik naciśnie i przytrzyma znacznik w oknie informacyjnym. 
interfejs GoogleMap.OnMapClickListener Interfejs oddzwonień pokazujący, kiedy użytkownik kliknie mapę. 
interfejs GoogleMap.OnMapLoadedCallback Interfejs wywołania zwrotnego po zakończeniu renderowania mapy. 
interfejs GoogleMap.OnMapLongClickListener Interfejs wywołania zwrotnego pokazujący, kiedy użytkownik naciśnie mapę. 
interfejs GoogleMap.OnMarkerClickListener Określa podpisy powiązane z metodami, które są wywoływane po kliknięciu lub kliknięciu znacznika. 
interfejs GoogleMap.OnMarker DragListener Interfejs wywołania zwrotnego zdarzeń przeciągania na znaczniki. 
interfejs GoogleMap.OnMyLocationButtonButtonListener Interfejs wywołania zwrotnego kliknięcia przycisku Moja lokalizacja. 
interfejs GoogleMap.OnMyLocationChangeListener Ten interfejs został wycofany. Zamiast tego użyj com.google.android.gms.location.FusedLocationProviderApi. FusedLocationProviderApi zapewnia lepsze wykrywanie lokalizacji i zużycie energii i jest wykorzystywane przez niebieski punkt. Zobacz samouczek dotyczący wybierania bieżącego miejsca, który korzysta z interfejsu FusedLocationProviderApi, lub przewodnik dla programistów lokalizacji.  
interfejs GoogleMap.OnMyLocationClickListener Interfejs wywołania zwrotnego po kliknięciu kropki w Mojej lokalizacji (która wskazuje lokalizację użytkownika).
interfejs GoogleMap.OnPoiClickListener Detektor do ważnych kliknięć. 
interfejs MapaGoogle.OnPolygonClickListener Interfejs wywołania zwrotnego po kliknięciu wielokąta. 
interfejs MapaGoogle.OnPolylineClickListener Interfejs wywołania zwrotnego po kliknięciu linii łamanej. 
interfejs GoogleMap.SnapshotReadyCallback Interfejs wywołania zwrotnego powiadamiający o wykonaniu zrzutu. 

Stałe podsumowanie

int, MAP_TYP_HYBRYD Mapy satelitarne z przezroczystą warstwą głównych ulic.
int, MAP_TYPE_NONE Brak kafelków mapy podstawowej.
int, MAP_TYP_NORMALU Mapy podstawowe.
int, MAP_TYP_SATELLITE Mapy satelitarne bez etykiet.
int, MAP_TYPE_TERRAIN Mapy terenu.

Podsumowanie metody publicznej

Okrąg
addCircle(opcje CircleOptions)
Dodaj kółko do tej mapy.
Nakładka Ziemi
addGroundNakładka (opcje GroundNakładkaOptions)
Dodaje obraz do tej mapy.
Znacznik
addMarker(opcje MarkerOptions)
Dodaje znacznik do tej mapy.
Wielokąt
addPolygon(opcje PolygonOptions)
Dodaje do mapy wielokąt.
Linia
addPolyline(opcje PolylineOptions)
Dodaje do tej linii linię.
Nakładka z fragmentem mapy
addTileNakładka (opcje TileNakładkaOptions)
Dodaje do mapy nakładkę z kafelkami.
nieważne
animateCamera (aktualizacja kamery)
Animuje ruch kamery od bieżącej pozycji do określonej w aktualizacji.
nieważne
animateCamera(aktualizacja CameraUpdate, wywołanie zwrotne GoogleMap.CancelableCallback)
Animuje ruch kamery od bieżącej pozycji do pozycji określonej w aktualizacji i po zakończeniu wywołuje opcjonalne wywołanie zwrotne.
nieważne
animateCamera(aktualizacja CameraUpdate, intdurationMs, GoogleMap.CancelableCallback)
Przeniesienie mapy zgodnie z aktualizacją za pomocą animacji o określonym czasie i po wywołaniu opcjonalnego wywołania zwrotnego.
nieważne
clear()
Usuwa z mapy wszystkie znaczniki, linie łamane, wielokąty, nakładki itp.
Pozycja kamery
getCameraPosition()
Pobiera bieżącą pozycję kamery.
Tworzenie budynków
getfocusedBuilding()
Pobiera aktualnie skoncentrowany budynek.
int,
getMapType()
Pobiera typ mapy aktualnie wyświetlany.
liczba zmiennoprzecinkowa
getMaxZoomLevel()
Zwraca maksymalny poziom powiększenia dla bieżącego położenia kamery.
liczba zmiennoprzecinkowa
getMinZoomLevel()
Zwraca minimalny poziom powiększenia.
Lokalizacja
getMyLocation
Ta metoda została wycofana. Użyj zamiast tego com.google.android.gms.location.FusedLocationProviderApi. FusedLocationProviderApi zapewnia lepsze wykrywanie lokalizacji i zużycie energii i jest wykorzystywane przez niebieski punkt. Przykładowy kod znajdziesz w przykładzie MyLocationDemoActivity w folderze aplikacji lub w Przewodniku dla programistów lokalizacji.
Projekcja
getProjection()
Zwraca obiekt Projection, którego można używać do przełączania między współrzędnymi ekranu i współrzędnymi szerokości i długości geograficznej.
Ustawienia
getUiSettings()
Pobiera ustawienia interfejsu mapy na mapie.
wartość logiczna
isBuildingsEnabled()
Zwraca ustawienie, czy warstwa budynków 3D jest włączona.
wartość logiczna
isIndoorEnabled()
Określa, czy mapy obiektów są obecnie włączone.
wartość logiczna
isMyLocationEnabled()
Pobiera stan warstwy Moja lokalizacja.
wartość logiczna
istrafficEnabled()
Sprawdza, czy mapa gromadzi dane o ruchu.
nieważne
moveCamera(aktualizacja aparatu)
Umożliwia zmianę pozycji kamery zgodnie z instrukcjami określonymi w aktualizacji.
nieważne
resetMinMaxZoomPreferences()
Usuwa wszystkie wcześniej zdefiniowane górne i dolne granice powiększenia.
nieważne
setBuildingsEnabled(wartość logiczna włączona)
Włącza lub wyłącza warstwę budynków 3D.
nieważne
setContentDescription(opis ciągu znaków)
Ustawia atrybut contentDescription dla mapy.
wartość logiczna
setIndoorEnabled(wartość logiczna włączona)
Określa, czy mapy obiektów mają być włączone.
nieważne
setInfoWindowAdapter(adapter GoogleMap.InfoWindowAdapter)
Ustawia niestandardowy mechanizm renderowania zawartości okien informacyjnych.
nieważne
setLatLngBoundsForCameraTarget(granice LatLngBound)
Określa ograniczenia długości geograficznej kamery, tak aby użytkownik, który przewija i przesuwa mapę, nie przesuwa się poza te granice.
nieważne
setLocationSource(źródło: LocationSource)
Zastępuje źródło lokalizacji w warstwie my-location.
wartość logiczna
setMapStyle (styl MapStyleOptions)
Ustawia styl mapy podstawowej.
nieważne
setMapType(typ int)
Określa typ kafelków, które mają być wyświetlane.
nieważne
setMaxZoomPreferences(liczba zmiennoprzecinkowa maxZoomPreferences)
Ustawia preferowaną granicę powiększenia kamery.
nieważne
setMinZoomPreferences (liczba min. w pływaniu)
Ustawia preferowaną dolną granicę powiększenia kamery.
nieważne
setMyLocationEnabled (wartość logiczna włączona).
Włącza lub wyłącza warstwę Moja lokalizacja.
nieważne
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).
nieważne
setOnCameraIdleListener(detektor GoogleMap.OnCameraIdleListener)
Ustawia wywołanie zwrotne, które jest wywoływane po zakończeniu ruchu kamery.
nieważne
setOnCameraMoveCanceledListener(GoogleMap.OnCameraMoveCanceledListener detektor)
Ustawia wywołanie zwrotne, które jest wywoływane, gdy ruch kamery zostanie zatrzymany lub przerwany przez nowy typ animacji.
nieważne
setOnCameraMoveListener(detektor GoogleMap.OnCameraMoveListener)
Ustawia wywołanie zwrotne, które jest wykonywane wielokrotnie, gdy kamera jest w ruchu.
nieważne
setOnCameraMoveStartedListener (detektor GoogleMap.OnCameraMoveStartedListener)
Ustawia wywołanie zwrotne, które jest wywoływane, gdy kamera zacznie się przemieszczać lub zmieni się powód ruchu.
nieważne
setOnCircleClickListener(detektor GoogleMap.OnCircleClickListener)
Ustawia wywołanie zwrotne, które jest wywoływane po kliknięciu kółka.
nieważne
setOnGroundNakładkaClickListener (detektor GoogleMap.OnGroundNakładkaClickListener)
Ustawia wywołanie zwrotne, które jest wywoływane po kliknięciu nakładki z powierzchnią.
nieważne
setOnIndoorStateChangeListener (detektor GoogleMap.OnIndoorStateChangeListener)
Ustawia lub usuwa detektor dla zdarzeń wewnątrz.
nieważne
setOnInfoOkClickListener (detektor GoogleMap.OnInfoWindowClickListener)
Ustawia wywołanie zwrotne, które jest wywoływane po kliknięciu okna informacji o znaczniku.
nieważne
setOnInfoWindowCloseListener (detektor GoogleMap.OnInfoWindowCloseListener)
Ustawia wywołanie zwrotne, które jest wywoływane po zamknięciu okna informacyjnego znacznika.
nieważne
setOnInfoWindowLongClickListener (detektor GoogleMap.OnInfoWindowLongClickListener)
Ustawia wywołanie zwrotne, które jest wywoływane po naciśnięciu i przytrzymaniu okna informacyjnego znacznika.
nieważne
setOnMapClickListener(detektor GoogleMap.OnMapClickListener)
Ustawia wywołanie zwrotne, które jest wywoływane po kliknięciu mapy.
nieważne
setOnMapLoadedCallback (wywołanie zwrotne GoogleMap.OnMapLoadedCallback)
Ustawia wywołanie zwrotne, które jest wywoływane po zakończeniu renderowania mapy.
nieważne
setOnMapLongClickListener(detektor GoogleMap.OnMapLongClickListener)
Ustawia wywołanie zwrotne, które jest wywoływane po naciśnięciu i przytrzymaniu mapy.
nieważne
setOnMarkerClickListener(detektor GoogleMap.OnMarkerClickListener)
Ustawia wywołanie zwrotne, które jest wywoływane po kliknięciu znacznika.
nieważne
setOnMarker DragListener(detektor GoogleMap.OnMarker DragListener)
Ustawia wywołanie zwrotne, które jest wywoływane po przeciągnięciu znacznika.
nieważne
setOnMyLocationButtonClickListener(detektor GoogleMap.OnMyLocationButtonClickListener)
Ustawia wywołanie zwrotne, które jest wywoływane po kliknięciu przycisku „Moja lokalizacja”.
nieważne
setOnMyLocationChangeListener(detektor GoogleMap.OnMyLocationChangeListener)
Ta metoda została wycofana. Użyj zamiast tego com.google.android.gms.location.FusedLocationProviderApi. FusedLocationProviderApi zapewnia lepsze wykrywanie lokalizacji i zużycie energii i jest wykorzystywane przez niebieski punkt. Przykładowy kod znajdziesz w przykładzie MyLocationDemoActivity w folderze aplikacji lub w Przewodniku dla programistów lokalizacji.
nieważne
setOnMyLocationClickListener(detektor GoogleMap.OnMyLocationClickListener)
Ustawia wywołanie zwrotne, które jest wywoływane po kliknięciu mojej lokalizacji (która wskazuje lokalizację użytkownika).
nieważne
setOnPoiClickListener(detektor GoogleMap.OnPoiClickListener)
Ustawia detektor, który zostanie aktywowany po kliknięciu lub kliknięciu ważnego miejsca.
nieważne
setOnPolygonClickListener(detektor GoogleMap.OnPolygonClickListener)
Ustawia wywołanie zwrotne, które jest wywoływane po kliknięciu wielokąta.
nieważne
setOnPolylineClickListener(detektor GoogleMap.OnPolylineClickListener)
Ustawia wywołanie zwrotne, które jest wywoływane po kliknięciu linii łamanej.
nieważne
setPadded (int left, int top, int right, intbottom)
Ustawia dopełnienie na mapie.
nieważne
settrafficEnabled (wartość logiczna włączona)
Włącza lub wyłącza warstwę ruchu.
nieważne
zrzut ekranu(GoogleMap.SnapshotReadyCallbackoddzwonienie)
Robi zrzut mapy.
nieważne
snapshot(wywołanie zwrotne GoogleMap.SnapshotReadyCallback, bitmapa bitmap)
Robi zrzut mapy.
nieważne
stopAnimacja()
Zatrzymuje animację aparatu, jeśli jest włączona.

Podsumowanie metody dziedziczonej

Stałe

publiczny profil statyczny statyczny MAP_TYPE_HYBRID

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

Wartość stała: 4

publiczny statyczny identyfikator końcowy statyczny MAP_TYPE_NONE

Brak kafelków mapy podstawowej.

Wartość stała: 0

publiczny profil statyczny statyczny MAP_TYPE_NORMAL

Mapy podstawowe.

Wartość stała: 1

publiczny profil statyczny statyczny MAP_TYPE_SATELLITE

Mapy satelitarne bez etykiet.

Wartość stała: 2

publiczny profil statyczny statyczny MAP_TYPE_TERRAIN

Mapy terenu.

Wartość stała: 3

Metody publiczne

publiczne Kręgi addCircle (CircleOptions opcje)

Dodaj kółko do tej mapy.

Parametry
Opcje Obiekt opcji opcji, który określa sposób renderowania koła
Zwraca
  • Obiekt Circle dodany do mapy

publiczne GroundNakładka addGroundNakładka (GroundNakładkaOptions))

Dodaje obraz do tej mapy.

Parametry
Opcje Obiekt opcji nakładki naziemnej, który określa sposób renderowania nakładki. Opcje muszą mieć określony obraz (Mapa-zakotwiczona) i pozycję.
Zwraca
Narzuty
Wyjątek związany z nielegalnym zabezpieczeniem jeśli w opcjach nie określono obrazu lub pozycji.

Marker addMarker (Opcje Marker))

Dodaje znacznik do tej mapy.

Ikona znacznika jest renderowana na mapie w lokalizacji znacznika.position. Kliknięcie znacznika wyśrodkuje kamerę na znaczniku. Jeśli znacznik schema.title jest zdefiniowany, na mapie widać pole z informacjami o nazwie znacznika i krótkim opisie. Jeśli znacznik można przeciągnąć, kliknij go i przytrzymaj, a następnie przeciągnij.

Parametry
Opcje Obiekt opcji znacznika, który określa sposób renderowania znacznika.
Zwraca
  • Urządzenie Marker dodane do mapy.

publiczna wielokąt addPolygon (PolygonOptions))

Dodaje do mapy wielokąt.

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

Poliline addPolyline (Opcje Polyline)

Dodaje do tej linii linię.

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

TileNakładka addTileNakładka (TileNakładkaOptions))

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

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

Parametry
Opcje Obiekt opcji nakładki, który określa sposób renderowania nakładki. Opcje muszą mieć właściwość TileProvider. W przeciwnym razie zostanie wywołana właściwość IllegalArgumentException.
Zwraca
Narzuty
Wyjątek związany z nielegalnym zabezpieczeniem jeśli TileProvider nie jest określony w opcjach.

void void animateCamera (aktualizacja aparatu)

Animuje ruch kamery od bieżącej pozycji do określonej w aktualizacji. Podczas animacji wywołanie metody getCameraPosition() zwraca pośrednią lokalizację kamery.

Zestaw aktualizacji znajdziesz na stronie CameraUpdateFactory.

Parametry
aktualizacja Zmiana, którą trzeba zastosować w aparacie.

void voidanimateCamera(aktualizacja aparatu, wywołanie zwrotne GoogleGoogleMap.CancelableCallback)

Animuje ruch kamery od bieżącej pozycji do pozycji określonej w aktualizacji i po zakończeniu wywołuje opcjonalne wywołanie zwrotne. Zestaw aktualizacji znajdziesz tutaj: CameraUpdateFactory.

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

Parametry
aktualizacja Zmiana, którą trzeba zastosować w aparacie.
wywołanie zwrotne Wywołanie zwrotne z wątku interfejsu Androida, gdy animacja się zatrzyma. Jeśli animacja zakończy się normalnie, wywoływana jest właściwość onFinish(). W przeciwnym razie wywoływana jest właściwość onCancel(). Nie aktualizuj ani nie animuj kamery w zakresie onCancel().

void void animateCamera (aktualizacja aparatu, czas trwania w mS, GoogleMap.CancelableCallback)

Przeniesienie mapy zgodnie z aktualizacją za pomocą animacji o określonym czasie i po wywołaniu opcjonalnego wywołania zwrotnego. Zestaw aktualizacji znajdziesz na stronie CameraUpdateFactory.

Jeśli podczas wywoływania animacji właściwość getCameraPosition() zostanie zwrócona bieżąca lokalizacja kamery, podczas lotu będzie ona zwracana.

Parametry
aktualizacja
czas trwania Czas trwania animacji w milisekundach. Musi to być dodatnie. W przeciwnym razie zwracana jest wartość IllegalArgumentException.
wywołanie zwrotne Opcjonalne wywołanie zwrotne, które będzie wyświetlane w wątku UI Androida, gdy animacja się zatrzyma. Jeśli animacja zostanie zatrzymana w wyniku naturalnego zakończenia, wywołanie zwrotne otrzyma powiadomienie w onFinish(). Jeśli animacja zostanie zatrzymana z powodu przerwy w działaniu późniejszego ruchu kamery lub gestu użytkownika, wywołana zostanie właściwość onCancel(). Wywołanie zwrotne nie powinno podejmować prób ruchu ani animacji przy użyciu metody anulowania. Jeśli wywołanie zwrotne nie jest wymagane, pozostaw je jako null.

public void clear ()

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

publiczne CameraPosition getCameraPosition ()

Pobiera bieżącą pozycję kamery.

Zwrócone dane (CameraPosition) to podsumowanie aktualnej pozycji, która nie jest automatycznie aktualizowana po przesunięciu kamery.

Więcej informacji o zmienianiu położenia kamery znajdziesz w artykule Kamera i widok.

Zwraca
  • Bieżąca pozycja Aparatu.

IndoorBuilding getfocusedBuilding ()

Pobiera aktualnie skoncentrowany budynek.

Zwraca
  • Bieżący główny budynek lub null, jeśli nie jest zaznaczony żaden budynek.

publiczne int getMapType ()

Pobiera typ mapy aktualnie wyświetlany. Możliwe wartości znajdziesz na stronach MAP_TYPE_NORMAL, MAP_TYPE_SATELLITE i MAP_TYPE_TERRAIN.

Zwraca
  • Typ mapy.

publiczna liczba zmiennoprzecinkowa getMaxZoomLevel()

Zwraca maksymalny poziom powiększenia dla bieżącego położenia kamery. Uwzględnia to typ aktualnie używanej mapy, np. satelita lub teren mogą mieć niższy poziom powiększenia niż kafelki mapy podstawowej.

Więcej informacji o zmianie poziomu powiększenia w aparacie znajdziesz w artykule Aparat i widok.

Zwraca
  • Maksymalny poziom powiększenia dostępny w bieżącej pozycji kamery.

liczba pływająca getMinZoomLevel ()

Zwraca minimalny poziom powiększenia. To samo dotyczy 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 zmianie poziomu powiększenia w aparacie znajdziesz w artykule Aparat i widok.

Zwraca
  • Minimalny dostępny poziom powiększenia.

lokalizacja publiczna getMyLocation ()

Ta metoda została wycofana.
Użyj com.google.android.gms.location.FusedLocationProviderApi. FusedLocationProviderApi zapewnia lepsze wykrywanie lokalizacji i zużycie energii i jest wykorzystywane przez niebieski punkt. Przykładowy kod znajdziesz w przykładzie MyLocationDemoActivity w folderze aplikacji lub w Przewodniku dla programistów lokalizacji.

Zwraca obecnie wyświetlaną lokalizację użytkownika lub null, jeśli nie są dostępne żadne dane o lokalizacji.

Zwraca
Narzuty
DisallowStateException (Niedozwolony stan) jeśli moja lokalizacja nie jest włączona.

publiczny Projekt getProjection ()

Zwraca obiekt Projection, którego można używać do przełączania między współrzędnymi ekranu i współrzędnymi szerokości i długości geograficznej.

Zwrócony obiekt Projection to zrzut bieżącego projekcji, który nie będzie automatycznie aktualizowany po przesunięciu kamery. Ta operacja jest kosztowna, więc prognoza powinna być widoczna tylko raz na ekranie. Mapy Google wykorzystują odwzorowanie Mercator do tworzenia map na podstawie danych geograficznych i przekształcania punktów na mapie w współrzędne geograficzne.

Zwraca

publiczne UiSettings getUiSettings ()

Pobiera ustawienia interfejsu mapy na mapie.

Zwraca

publiczna wartość logiczna isBuildingsEnabled()

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

Zwraca
  • true, jeśli są włączone budynki; false w innym przypadku.

publiczna wartość logiczna isIndoorEnabled()

Określa, czy mapy obiektów są obecnie włączone.

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

publiczna wartość logiczna isMyLocationEnabled ()

Pobiera stan warstwy Moja lokalizacja.

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

publiczna wartość logiczna istrafficEnabled ()

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

Zwraca
  • true, jeśli dane o ruchu są włączone; false w innym przypadku.

publiczne void moveCamera (aktualizacja aparatu))

Umożliwia zmianę pozycji kamery zgodnie z instrukcjami określonymi w aktualizacji. Przeniesienie jest natychmiastowe, a kolejny getCameraPosition() będzie odzwierciedlać nową pozycję. Zestaw aktualizacji znajdziesz tutaj: CameraUpdateFactory.

Parametry
aktualizacja Zmiana, którą trzeba zastosować w aparacie.

void voidresetMinMaxMaxPreferences()

Usuwa wszystkie wcześniej zdefiniowane górne i dolne granice powiększenia.

void voidsetBuildingsEnabled(wartość logiczna włączona)

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

Parametry
włączono true, aby włączyć warstwę budynków 3D; oraz false, aby wyłączyć budynki 3D.

void void setContentDescription (ciąg znaków)

Ustawia atrybut contentDescription dla mapy.

Służy do przedstawiania opisu mapy w trybie ułatwień dostępu. Wartość domyślna to &mapa Google.

Parametry
opis ciąg znaków, który ma być używany jako opis.

publiczna wartość logiczna setIndoorEnabled(wartość logiczna włączona)

Określa, czy mapy obiektów mają być włączone. Obecnie mapy obiektów mogą być wyświetlane tylko na jednej mapie naraz. Domyślnie jest to pierwsza mapa dodana do Twojej aplikacji. Aby włączyć mapy obiektów na innej mapie, musisz najpierw wyłączyć mapy obiektów na pierwotnej mapie. Jeśli spróbujesz włączyć mapy obiektów, gdy jest włączona na innej mapie, nic się nie stanie i zwróci false. Jeśli obiekt nie jest włączony na mapie, wszystkie metody związane z tym obiektem będą zwracać wartość null lub false.

Parametry
włączono true, aby spróbować włączyć mapy obiektu; false, aby wyłączyć mapy obiektów.
Zwraca
  • czy było możliwe włączenie map obiektów.

void void setInfoWindowAdapter (GoogleMap.InfoWindowAdapter))

Ustawia niestandardowy mechanizm renderowania zawartości okien informacyjnych.

Podobnie jak detektory zdarzeń map, ten stan nie jest zserializowany z mapą. Jeśli mapa zostanie utworzona ponownie (np. z powodu zmiany konfiguracji), musisz ją wywołać ponownie w celu zachowania dostosowania.

Parametry
adapter Adapter, którego należy używać w przypadku zawartości okna informacyjnego, lub null, aby użyć domyślnego renderowania treści w oknach informacyjnych.

nieważny setLatLngBoundsForCameraTarget (granice LatLngBounds)

Określa ograniczenia długości geograficznej kamery, tak aby użytkownik, który przewija i przesuwa mapę, nie przesuwa się poza te granice.

Ustaw wartość null, aby wyczyścić całą granicę ograniczenia. Nowe limity zastępują wszystkie wcześniej określone ramki graniczne.

W przypadku zmiany LatLngBound SDK w miarę możliwości dostosowuje wszystkie późniejsze aktualizacje kamery. Istnieją kwestie techniczne, które mogą uniemożliwić pakietowi SDK ścisłe trzymanie się kamery poza tymi granicami. Dotyczy to na przykład błędów zaokrąglania precyzji zmiennoprzecinkowej lub bardzo niskiego poziomu powiększenia.

Parametry
granice Granice ograniczające cel kamery.

void void setLocationSource (LocationSource))

Zastępuje źródło lokalizacji w warstwie my-location.

Parametry
źródło Źródło lokalizacji, które zostanie użyte w warstwie Moja lokalizacja. Ustaw jako null, aby używać domyślnego źródła lokalizacji.

publiczna wartość logiczna setMapStyle (StylStylMap)

Ustawia styl mapy podstawowej.

Za pomocą opcji stylów możesz stosować style niestandardowe do funkcji i elementów na mapie. Szczegółowe informacje o definicji stylu znajdziesz w sekcji MapStyleOptions.

Ustaw wartość „null”, aby usunąć wszystkie wcześniejsze style niestandardowe.

Parametry
styl
Zwraca
  • Wartość true została przeanalizowana, a false wskazuje na problemy w MapStyleOptions, np. niemożliwy do przeanalizowania kod JSON stylu, nierozpoznany typ elementu, nierozpoznany typ elementu lub nieprawidłowe klucze stylu. Jeśli zwracana wartość to false, bieżący styl pozostaje niezmieniony.

void void setMapType (typ typu)

Określa typ kafelków, które mają być wyświetlane. Dozwolone wartości:

Parametry
Typ Typ mapy do wyświetlenia.

void void setMaxZoomPreferences (float maxZoomPreferences)

Ustawia preferowaną granicę powiększenia kamery.

W przypadku zmiany maksymalnego powiększenia pakiet SDK dostosowuje wszystkie późniejsze aktualizacje kamery, aby w miarę możliwości zachowywać maksymalną wartość. Istnieją kwestie techniczne, które mogą uniemożliwiać pakietowi SDK użytkowników zbyt szczegółowe powiększanie mapy. Na przykład satelita lub teren mogą mieć niższe maksymalne powiększenie niż kafelki mapy podstawowej.

Pakiet SDK rozwiązuje wszelkie konflikty wartości minimalnych i maksymalnych. Jeśli ustawisz powiększenie na minimalnym poziomie niż bieżący, pakiet SDK zastosuje nową wartość minimalną. Jeśli ustawisz maksymalną wartość powiększenia na poziomie niższym niż minimalny, pakiet SDK zastosuje nową wartość maksymalną. Załóżmy, że bieżące minimalne powiększenie to 8, a maksymalne – 14. Następnie ustawisz maksymalną wartość powiększenia na 6. Minimalny CPC to 6, a maksymalna – 6.

Parametry
maxZoomPreferences Preferowana górna granica.

void void setMinZoomPreferences (float minZoomPreferences)

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

Gdy minimalne powiększenie ulegnie zmianie, pakiet SDK dostosowuje wszystkie kolejne aktualizacje kamery do tej wartości, jeśli jest to możliwe. Istnieją kwestie techniczne, które mogą uniemożliwiać pakietowi SDK zbyt małą wartość powiększenia.

Pakiet SDK rozwiązuje wszelkie konflikty wartości minimalnych i maksymalnych. Jeśli ustawisz powiększenie na minimalnym poziomie niż bieżący, pakiet SDK zastosuje nową wartość minimalną. Jeśli ustawisz maksymalną wartość powiększenia na poziomie niższym niż minimalny, pakiet SDK zastosuje nową wartość maksymalną. Załóżmy, że bieżące minimalne powiększenie to 8, a maksymalne – 14. Następnie ustawisz minimalną wartość powiększenia na 16. Minimalny CPC to 16, a maksymalny – 16.

Parametry
MinimumZoom Preferowana dolna granica.

void voidsetMyLocationEnabled(wartość logiczna włączona)

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

Przy włączonej opcji „Lokalizacja” i określonej lokalizacji obszar „Moja lokalizacja” stale wyświetla informację o bieżącej lokalizacji użytkownika i wskaźniku oraz wyświetla opcje interfejsu, które pozwalają użytkownikowi na interakcję z jego lokalizacją (na przykład po to, by włączyć lub wyłączyć śledzenie jego lokalizacji i położenia).

Aby korzystać z funkcji moja lokalizacja, musisz poprosić o uprawnienia dla znaczników ACCESS_COARSE_LOCATION lub ACCESS_FINE_LOCATION, chyba że masz ustawione niestandardowe źródło lokalizacji.

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

Parametry
włączono true, aby włączyć, lub false, aby wyłączyć.
Narzuty
Wyjątek zabezpieczeń jeśli dostęp do lokalizacji nie zostanie przyznany.

void void setOnCameraChangeListener (GoogleMap.OnCameraChangeListener))

Ta metoda została wycofana.
. Zastąpiły je zasady setOnCameraMoveStartedListener(GoogleMap.OnCameraMoveStartedListener), setOnCameraMoveListener(GoogleMap.OnCameraMoveListener), setOnCameraMoveCanceledListener(GoogleMap.OnCameraMoveCanceledListener) i setOnCameraIdleListener(GoogleMap.OnCameraIdleListener).

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

Parametry
detektor Wywołanie zwrotne wywoływane przy zmianie kamery. Aby cofnąć wywołanie zwrotne, użyj wywołania null.

void void setOnCameraIdleListener (GoogleMap.OnCameraIdleListener))

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

Parametry
detektor Wywołane wywołanie zwrotne. Aby cofnąć wywołanie zwrotne, użyj wartości null.

void void setOnCameraMoveCanceledListener (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 cofnąć wywołanie zwrotne, użyj wartości null. Nie aktualizuj ani nie animuj kamery w obszarze onCameraMoveCanceled().

void void setOnCameraMoveListener (GoogleMap.OnCameraMoveListener)

Ustawia wywołanie zwrotne, które jest wykonywane wielokrotnie, gdy kamera jest w ruchu. Wywołanie zwrotne musi być wykonywane tak często jak raz na każdą klatkę i nie powinno być kosztowne.

Parametry
detektor Wywołane wywołanie zwrotne. Aby cofnąć wywołanie zwrotne, użyj wartości null.

void void setOnCameraMoveStartedListener (GoogleMap.OnCameraMoveStartedListener))

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

Parametry
detektor Wywołane wywołanie zwrotne. Aby cofnąć wywołanie zwrotne, użyj wartości null. Nie aktualizuj ani nie animuj kamery w obszarze onCameraMoveStarted().

void void setOnCircleClickListener (GoogleMap.OnCircleClickListener detektor)

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

Parametry
detektor Wywołanie zwrotne wywoływane po kliknięciu koła. Aby cofnąć wywołanie zwrotne, użyj wywołania null.

void void setOnGroundNakładkaClickListener (GoogleMap.OnGroundNakładkaClickListener)

Ustawia wywołanie zwrotne, które jest wywoływane po kliknięciu nakładki z powierzchnią.

Parametry
detektor Wywołanie zwrotne wywoływane po kliknięciu nakładki powierzchni. Aby cofnąć ustawienie wywołania zwrotnego, użyj metody null.

void void-setOnIndoorStateChangeListener(GoogleMap.OnIndoorStateChangeListener)

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

Parametry
detektor jeśli detektor zdarzeń wewnętrznych nie ma wartości null, w przeciwnym razie usuwa słuchacz.

void void setOnInfoWindowClickListener (GoogleMap.OnInfoWindowClickListener))

Ustawia wywołanie zwrotne, które jest wywoływane po kliknięciu okna informacji o znaczniku.

Parametry
detektor Wywołanie zwrotne wywoływane po kliknięciu okna informacji o znaczniku. Aby cofnąć ustawienie wywołania zwrotnego, użyj metody null.

void void setOnInfoWindowCloseListener (GoogleMap.OnInfoWindowCloseListener))

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

Parametry
detektor Wywołanie zwrotne wywoływane po zamknięciu okna informacyjnego znacznika. Aby cofnąć ustawienie wywołania zwrotnego, użyj metody null.

void void setOnInfoWindowLongClickListener (GoogleMap.OnInfoWindowLongClickListener detektor)

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

Parametry
detektor Wywołanie zwrotne wywoływane po naciśnięciu i przytrzymaniu okna informacyjnego znacznika. Aby cofnąć wywołanie zwrotne, użyj wywołania null.

void void setOnMapClickListener (GoogleMap.OnMapClickListener – detektor)

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

Parametry
detektor Wywołanie zwrotne, które następuje po kliknięciu mapy. Aby cofnąć wywołanie zwrotne, użyj wywołania null.

unieważnione publiczne setOnMapLoadedCallback (Wywołanie zwrotne GoogleGoogle.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 wywołane natychmiast. To zdarzenie nie jest uruchamiane, jeśli mapa nigdy nie jest wczytywana z powodu problemów z łącznością lub jeśli mapa stale się zmienia i nigdy nie jest wczytywana z powodu trwającej interakcji użytkownika z mapą.

Parametry
wywołanie zwrotne Wywołanie zwrotne po zakończeniu renderowania mapy. Aby cofnąć ustawienie wywołania zwrotnego, użyj metody null.

void void setOnMapLongClickListener (GoogleMap.OnMapLongClickListener detektor)

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

Parametry
detektor Wywołanie zwrotne wywoływane po długim naciśnięciu mapy. Aby cofnąć ustawienie wywołania zwrotnego, użyj metody null.

void void setOnMarkerClickListener (GoogleMap.OnMarkerClickListener detektor)

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 cofnąć wywołanie zwrotne, użyj wywołania null.

void voidsetOnMarker DragListener(GoogleMap.OnMarker DragListener)

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

Parametry
detektor Wywołanie zwrotne wywoływane przez zdarzenia przeciągania znacznika. Aby cofnąć wywołanie zwrotne, użyj wywołania null.

void voidsetOnMyLocationButtonClickListener(GoogleMap.OnMyLocationButtonClickListener)

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

Jeśli listener zwróci true, zdarzenie zostanie użyte i domyślne działanie nie zostanie wykonane. W przypadku zwrócenia wartości false wystąpi domyślne zachowanie (np. kamera zostanie przesunięta tak, by była wyśrodkowana na lokalizacji użytkownika).

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

void void setOnMyLocationChangeListener (GoogleMap.OnMyLocationChangeListener)

Ta metoda została wycofana.
Użyj com.google.android.gms.location.FusedLocationProviderApi. FusedLocationProviderApi zapewnia lepsze wykrywanie lokalizacji i zużycie energii i jest wykorzystywane przez niebieski punkt. Przykładowy kod znajdziesz w przykładzie MyLocationDemoActivity w folderze aplikacji lub w Przewodniku dla programistów lokalizacji.

Ustawia wywołanie zwrotne, które powoduje zmianę lokalizacji w miejscu Moja lokalizacja.

Parametry
detektor Wywołanie zwrotne, które jest wywoływane, kiedy zmieni się moja lokalizacja.

void void setOnMyLocationClickListener (GoogleMap.OnMyLocationClickListener detektor)

Ustawia wywołanie zwrotne, które jest wywoływane po kliknięciu mojej lokalizacji (która wskazuje lokalizację użytkownika).

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

void void setOnPoiClickListener (GoogleMap.OnPoiClickListener detektor)

Ustawia detektor, który zostanie aktywowany po kliknięciu lub kliknięciu ważnego miejsca.

Naciśnij null, aby wyczyścić słuchacz.

Parametry
detektor

void void setOnPolygonClickListener (GoogleMap.OnPolygonClickListener detektor)

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 cofnąć wywołanie zwrotne, użyj wywołania null.

void void setOnPolylineClickListener (GoogleMap.OnPolylineClickListener detektor)

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 cofnąć wywołanie zwrotne, użyj wywołania null.

void void setPadded (int left, int top, int right, intbottom)

Ustawia dopełnienie na mapie.

Ta metoda pozwala zdefiniować widoczny obszar na mapie, aby zasygnalizować Mapie, że jego części wokół krawędzi mogą być niewidoczne, 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, kompasem, informacjami o prawach autorskich i logo Google zostaną przeniesione tak, aby mieściły się w określonym regionie, ruchy kamery będą ustalane względem środka widocznego obszaru itp.

Parametry
opuścił(a) pokój liczbę pikseli dopełnienia, które mają zostać dodane po lewej stronie mapy.
runda gości liczbę pikseli dopełnienia, które zostaną dodane na górze mapy.
Strzałka w prawo liczbę pikseli dopełnienia po prawej stronie mapy.
runda gospodarzy liczbę pikseli dopełnienia u dołu mapy.

void voidsettrafficEnabled(wartość logiczna włączona)

Włącza lub wyłącza warstwę ruchu.

Parametry
włączono

unieważniony publiczny zrzut (wywołanie zwrotne GoogleMap.SnapshotReadyCall)

Robi zrzut mapy.

W aplikacji możesz używać zrzutów, gdy korzystanie z interaktywnej mapy jest trudne lub niemożliwe. Na przykład obrazy wygenerowane metodą snapshot() mogą wyświetlać miniaturę mapy w Twojej aplikacji lub zrzut w Centrum powiadomień.

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

Parametry
wywołanie zwrotne Metoda wywołania zwrotnego wywoływana po wykonaniu zrzutu.

unieważniony publiczny zrzut (wywołanie zwrotne GoogleMap.SnapshotReadyCall, bitmapa bit)

Robi zrzut mapy.

Ta metoda jest odpowiednikiem snapshot(SnapshotReadyCallback), ale pozwala podać wstępnie Bitmap. Jeśli bitmapa nie odpowiada bieżącym rozmiarom mapy, zostanie przydzielona inna bitmapa zgodna z wymiarami mapy.

W większości przypadków obiekt przekazany za pomocą metody wywołania zwrotnego jest taki sam jak obiekt podany w parametrze tej metody, ale w niektórych przypadkach zwrócony obiekt może się różnić (np. jeśli wymiary widoku danych uległy zmianie w momencie wykonania zrzutu). Dlatego należy ufać tylko treści bitmapy przekazanej za pomocą metody wywołania zwrotnego.

Parametry
wywołanie zwrotne Metoda wywołania zwrotnego wywoływana po wykonaniu zrzutu.
bitmapa Wstępny bitmapa. Jeśli null, działa jak snapshot(SnapshotReadyCallback).

void stopAnimacja ()

Zatrzymuje animację aparatu, jeśli jest włączona. Po wywołaniu metody kamera przestaje się ruszać i pozostaje w tej pozycji.