Migracja do interfejsów API lokalizacji i kontekstu w Usługach Google Play

Zalecamy korzystanie z interfejsów API lokalizacji i kontekstu w Usługach Google Play w aplikacjach, które wymagają usług lokalizacyjnych. Jeśli Twoja aplikacja używa interfejsów API lokalizacji platformy, pamiętaj, aby przejść na Usługi Google Play, aby móc korzystać z najnowszych funkcji Google.

Zaleca się korzystanie z Usług Google Play w przypadku dostępu do usług lokalizacyjnych w aplikacji z tych powodów:

  1. Usługi Google Play mają prosty interfejs i przejrzyste środowisko API.
  2. Określasz żądaną jakość usługi, a interfejsy API zarządzają używanymi technologiami za Ciebie.
  3. Interfejsy API Usług Google Play są zoptymalizowane pod kątem wydajności i wykorzystania baterii.
  4. Interfejsy API Usług Google Play są aktywnie utrzymywane. Google nieustannie doskonali algorytmy i dodaje kolejne funkcje.

Zaktualizuj aplikację

Poniżej znajdziesz opis procesu aktualizowania aplikacji, tak aby używała interfejsów API lokalizacji i kontekstu:

  1. Skonfiguruj Usługi Google Play w swoim projekcie.
  2. Użyj interfejsu Location settings API, aby sprawdzić bieżące ustawienia lokalizacji.
  3. korzystanie z Usług Google Play w przypadku złożonych funkcji, takich jak geofencing, rozpoznawanie aktywności i rozpoznawanie aktywności;
  4. Zastąp użycie interfejsu API lokalizacji platformy interfejsem API dostawcy uśrednionej lokalizacji.
  5. Usuń odwołania do interfejsu API lokalizacji platformy.

Skonfiguruj Usługi Google Play w swoim projekcie

Aby udostępnić w projekcie interfejsy API lokalizacji i kontekstu, musisz dodać odwołanie do repozytorium Google Maven i zadeklarować zależność do wymaganych interfejsów API. Więcej informacji znajdziesz w artykule Konfigurowanie Usług Google Play.

Użyj interfejsu API ustawień lokalizacji

Dzięki interfejsowi API ustawień lokalizacji aplikacje zapewniają odpowiedni poziom QoS, a interfejs API żąda od użytkownika odpowiednich zmian w ustawieniach systemu. Aby użyć w swojej aplikacji interfejsu API ustawień lokalizacji, wykonaj te czynności:

  1. Poproś o dostęp do lokalizacji w manifeście aplikacji.
  2. Skonfiguruj obiekt LocationRequest, który określa wymagany poziom QoS.
  3. Użyj interfejsu API ustawień lokalizacji, aby sprawdzić bieżące ustawienia.

Więcej informacji znajdziesz w sekcji Zmienianie ustawień lokalizacji. Możesz też zapoznać się z przykładowymi informacjami o lokalizacji w Google Play (przykładowy kod).

Używanie Usług Google Play do obsługi złożonych funkcji

Biblioteki Usług Google Play pomagają wdrażać nowatorskie rozwiązania dla użytkowników związane z kontekstem i rozpoznawaniem otoczenia. Różne biblioteki lokalizacji i kontekstu korzystają z dodatkowych czujników (poza lokalizacją) i robią to w sposób energooszczędny, dostarczając aplikacji dokładniejsze dane i ograniczając jednocześnie czas pracy na baterii.

Dodaj te biblioteki do swojej aplikacji, zamiast tworzyć własne rozwiązania:

Zastąp interfejs API lokalizacji platformy interfejsem API dostawcy uśrednionej lokalizacji

Możesz użyć interfejsu API dostawcy uśrednionej lokalizacji, aby uzyskać dane o lokalizacji, takie jak szerokość i długość geograficzna. Interfejs API dostawcy uśrednionej lokalizacji używa obiektu Location (tak samo jak interfejs API platformy lokalizacji) do reprezentowania lokalizacji geograficznej. Interfejs API udostępnia funkcje umożliwiające nasłuchiwanie aktualizacji lokalizacji oraz pobieranie ostatniej znanej lokalizacji. Wszystkie te funkcje sprawiają, że interfejs API dostawcy uśrednionej lokalizacji jest dobrym kandydatem do zastąpienia komponentów korzystających z interfejsu API lokalizacji platformy przy minimalnych zmianach w pozostałej części aplikacji.

Uzyskanie ostatniej znanej lokalizacji to dobry punkt wyjścia w wielu sytuacjach, ponieważ jest to szybka operacja, która wykorzystuje dane o lokalizacji żądane przez dowolnego klienta na urządzeniu. Aby okresowo śledzić lokalizację, możesz zasubskrybować aktualizacje lokalizacji, które udostępniają aktualne dane i sprawiają, że funkcje są bardziej złożone.

Usuwanie odwołań do interfejsu API lokalizacji platformy

Zastąp odwołania do klas w pakiecie com.google.android.location klasami z pakietu com.google.android.gms.location, z wyjątkiem odwołań do klasy Location, której używa interfejs API dostawcy lokalizacji. Zazwyczaj możesz usunąć z aplikacji komponenty, które zarządzają różnymi dostawcami, takie jak GPS i Wi-Fi. Interfejsy API lokalizacji i kontekstu automatycznie zarządzają tymi dostawcami.

Testowanie aplikacji

Aby uruchomić aplikację, która używa najnowszej wersji Usług Google Play, potrzebujesz urządzenia z zainstalowaną aplikacją Sklep Play i zalogowaniem się na konto Google. Do celów programistycznych możesz użyć tych opcji:

  • Urządzenie fizyczne podłączone do środowiska programistycznego za pomocą kabla USB.
  • Emulator z zainstalowaną aplikacją Sklep Play.

Więcej informacji o podłączaniu urządzenia fizycznego do środowiska programistycznego znajdziesz w artykule Uruchamianie aplikacji na urządzeniu sprzętowym. Aby dowiedzieć się, jak utworzyć emulator zawierający aplikację Sklep Play, przeczytaj sekcję Tworzenie urządzeń wirtualnych i zarządzanie nimi.