Mapa Google

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

Brak fragmentów mapy podstawowej.

Podstawowe mapy.

Mapy satelitarne bez etykiet.

Mapy terenu.

Dodaj okrąg do tej mapy.

Dodaje obraz do tej mapy.

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ść.

Dodaje wielokąt do tej mapy.

Dodaje do mapy linię łamaną.

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.

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.

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.

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.

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

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.

Pobiera obecnie wybrany budynek.

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.

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.

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.

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

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.

Pobiera ustawienia interfejsu użytkownika mapy.

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

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

Pobiera stan warstwy Moja lokalizacja.

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

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.

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

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

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”.

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.

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.

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.

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

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.

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

• MAP_TYPE_NORMAL: podstawowa mapa.
• MAP_TYPE_SATELLITE: zdjęcia satelitarne.
• MAP_TYPE_HYBRID: zdjęcia satelitarne z drogami i etykietami.
• MAP_TYPE_TERRAIN: dane topograficzne.
• MAP_TYPE_NONE: brak elementów mapy podstawowej.

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.

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.

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.

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

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

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

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.

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

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

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

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

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

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

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

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

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ą.

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

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

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

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).

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

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

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

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

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

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

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.

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

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.

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.

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