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ć w nowych projektach. 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 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 SDK Map Google na Androida to nowa implementacja z takim samym interfejsem API jak poprzednia wersja (wszystkie klasy i metody pozostają takie same). Zawiera ona też kilka nowych funkcji, 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 (wersja beta)

Definiowanie stylów map w Google Cloud udostępnia różne narzędzia i funkcje, które pozwalają dostosowywać style map i nimi zarządzać. 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 na Androidzie.

Obsługa kolizji znaczników (beta)

Możesz określić, czy niestandardowe znaczniki mają zastępować domyślne etykiety mapy bazowej w przypadku kolizji, oraz wskazać względny priorytet między niestandardowymi znacznikami. Więcej informacji znajdziesz w artykule Obsługa kolizji znaczników (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.
• Polilinie z wzorami umożliwiają określanie stylu polilinii za pomocą powtarzających się bitmap.

Tworzenie wielokolorowej linii łamanej

Za pomocą zakresów możesz indywidualnie kolorować segmenty polilinii, 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 polilinii 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'