Korzystanie z wersji beta pakietu SDK Map na Androida 3.1.0

Powiadomienie o wycofaniu pakietu SDK w wersji beta:

Wersja beta pakietu SDK została wycofana i jest przeznaczona do likwidacji. Nie można jej już używać. Funkcje opisane w tym artykule są obecnie dostępne w wersji beta pakietu SDK. W przyszłej wersji pakietu SDK będzie dostępna podobna obsługa tych funkcji.

Więcej informacji znajdziesz w informacjach o wersji. Aby ułatwić sobie przejście z wycofanej wersji beta na obsługiwaną wersję, skorzystaj z narzędzia do migracji z Map Google w wersji 3 BETA.

Wersja 3.1.0 beta pakietu Maps SDK na Androida to nowa implementacja z takim samym interfejsem API jak poprzednia wersja (wszystkie klasy i metody pozostają takie same) oraz z kilkoma nowymi funkcjami, które możesz wypróbować:

• Dostosowywanie map
• Obsługa kolizji znaczników
• Dostosowywanie linii łamanej

Z tego przewodnika dowiesz się, jak korzystać z nowych funkcji.

Dostosowywanie map (beta)

Definiowanie stylów map w Google Cloud udostępnia różne narzędzia i funkcje, które umożliwiają dostosowywanie stylu map i zarządzanie nim. Zamiast definiować styl mapy w kodzie za pomocą interfejsów API i pakietów SDK Map Google, możesz zarządzać mapami i definiować ich styl w konsoli Google Cloud. Więcej informacji znajdziesz w artykule Omówienie dostosowywania map w Androidzie.

Obsługa kolizji znaczników (beta)

Możesz określić, czy znaczniki niestandardowe mają zastępować domyślne etykiety mapy podstawowej w przypadku kolizji, oraz wskazać względny priorytet między znacznikami niestandardowymi. Więcej informacji znajdziesz w artykule Marker Collision Handling (Android).

Dostosowywanie linii łamanych (beta)

Wygląd polilinii możesz teraz dostosowywać na kilka nowych sposobów:

• Wielokolorowe linie łamane umożliwiają ustawienie różnych kolorów dla segmentów linii łamanej.
• Polilinie gradientowe kolorują polilinię za pomocą gradientu dwóch kolorów.
• Stylowe linie łamane to linie łamane, które są stylizowane za pomocą powtarzających się bitmap.

Tworzenie wielokolorowej linii łamanej

Za pomocą zakresów możesz indywidualnie kolorować segmenty linii łamanej, tworząc obiekty StyleSpan i dodając je do PolylineOptions za pomocą metod addSpan() lub addSpans(). Domyślnie każdy element w tablicy ustawia kolor odpowiedniego segmentu linii.

Tworzenie linii łamanej z gradientem

Możesz zdefiniować gradient, podając 2 32-bitowe liczby całkowite w formacie ARGB (alfa-czerwony-zielony-niebieski), aby określić kolor początkowy i końcowy kreski. Ustaw tę właściwość w obiekcie opcji kształtu, wywołując funkcję PolylineOptions.addSpan().

Tworzenie linii łamanej z pieczątką

Możesz ustawić wygląd linii łamanej na powtarzającą się teksturę bitmapową. Aby to zrobić, utwórz StampStyle typu TextureStyle, a następnie ustaw tę właściwość w obiekcie opcji kształtu, wywołując PolylineOptions.addSpan().

Zaimportuj bibliotekę narzędzi zgodną z wersją beta

Jeśli używasz biblioteki narzędziowej interfejsu Google Maps Android API, musisz też zaktualizować zależności projektu, aby zastąpić dotychczasową wersję wersją zgodną z wersją beta. Aby to zrobić, wykonaj te czynności:

1. Zaimportuj bibliotekę narzędziową zgodną z wersją beta w pliku build.gradle:

   implementation 'com.google.maps.android:android-maps-utils-v3:1.3.1'

2. Usuń z build.gradle te elementy, aby usunąć bibliotekę narzędzi niezgodną z wersją beta:

   implementation 'com.google.maps.android:android-maps-utils:1.3.1'