Minimalny zakres: dostęp do lokalizacji na pierwszym planie i przycisk lokalizacji

Uwaga: ten artykuł pomocy dotyczący zasad zawiera wskazówki na temat lokalizacji urządzenia na pierwszym planie i przycisku lokalizacji. Informacje o lokalizacji urządzenia w tle znajdziesz w artykule pomocy poświęconym dostępowi do lokalizacji w tle.

Ustalenie jasnych wytycznych dotyczących dostępu do danych o lokalizacji urządzenia ma kluczowe znaczenie dla budowania zaufania użytkowników i utrzymywania bezpiecznego ekosystemu. W tym artykule znajdziesz szczegółowe informacje o wymaganiach dotyczących korzystania z nowego przycisku lokalizacji na Androidzie oraz standardowego używania lokalizacji urządzenia na pierwszym planie (uprawnienia ACCESS_COARSE_LOCATION i ACCESS_FINE_LOCATION). Aplikacja uzyskuje dostęp do lokalizacji na pierwszym planie, gdy jest otwarta i widoczna dla użytkownika. Jeśli dostęp następuje w momencie, gdy aplikacja nie jest widoczna dla użytkownika, uzyskuje ona dostęp do lokalizacji w tle.

W niektórych przypadkach korzystanie z usługi na pierwszym planie może wymagać naszego zatwierdzenia. Usługa taka to oddzielny interfejs API, który umożliwia aplikacji dostęp do informacji o lokalizacji nawet wtedy, gdy jest ona zminimalizowana i niewidoczna dla użytkownika. Takie aplikacje muszą zostać sprawdzone i muszą spełniać kluczowe wymagania określone w zasadach dotyczących uprawnień do usług działających na pierwszym planie.

Co to oznacza w kontekście naszych zasad dotyczących dostępu do lokalizacji? Dostęp do lokalizacji na pierwszym planie jest najbardziej przejrzysty dla użytkowników i zwiększa ich zaufanie. Dlatego jest to preferowana metoda korzystania z lokalizacji przez aplikacje w Google Play. Korzystanie z przycisku lokalizacji na Androidzie zapewnia dodatkową warstwę prywatności i kontroli, dzięki czemu aplikacja spełnia minimalne wymagania dotyczące zakresu dostępu.

Minimalny zakres dostępu do lokalizacji

Z myślą o ochronie prywatności użytkowników Google Play wymaga, aby wszystkie aplikacje prosiły o minimalny zakres uprawnień niezbędny do zapewnienia głównej funkcjonalności. Podczas określania zakresu lokalizacji urządzenia weź pod uwagę te wymiary:

• Dokładność: jeśli funkcja nie wymaga dużej dokładności, używaj przybliżonej lokalizacji (ACCESS_COARSE_LOCATION).
• Trwałość: w przypadku jednorazowych lub rzadkich żądań aplikacje muszą przejść z dostępu „trwałego domyślnie” na dostęp transakcyjny za pomocą przycisku lokalizacji.

Tło lub pierwszy plan: ten artykuł dotyczy dostępu na pierwszym planie. Jeśli aplikacja wymaga dostępu do lokalizacji, gdy nie jest używana, zapoznaj się z wymaganiami dotyczącymi lokalizacji w tle.

Przykładowe przypadki użycia, w których może być wymagana przybliżona lokalizacja urządzenia:

1. Zlokalizowane treści i odkrywanie

• Wiadomości i trendy lokalne: wyświetlanie informacji „Wiadomości w Gdańsku” lub „Trendy w Poznaniu” nie wymaga znajomości dokładnego adresu użytkownika.
• Odkrywanie wydarzeń regionalnych: wyszukiwanie festiwali, koncertów lub targów rolnych odbywających się w danym mieście lub okolicy.
• Usługi pogodowe o niskiej dokładności: pogoda w regionie zwykle pozostaje taka sama, niezależnie od tego, czy użytkownik jest w domu, czy w kawiarni 3 ulice dalej.

2. Społeczności i media społecznościowe

• Lokalne platformy handlowe: w przypadku aplikacji z ogłoszeniami wyświetlanie produktów na sprzedaż „w promieniu 5 km” jest wystarczająco przydatne dla kupującego, a jednocześnie nie ujawnia dokładnej lokalizacji sprzedawcy, dopóki nie zdecyduje się on jej podać.
• Ogólna funkcja „Osoby w pobliżu”: w aplikacjach społecznościowych wyświetla informację, że znajomy jest „w Twoim mieście”, zamiast podawać jego lokalizację w czasie rzeczywistym na mapie.

3. Narzędzia i optymalizacja

• Lokalizatory sklepów: wyświetlanie najbliższych sklepów sieciowych lub oddziałów banków. Dokładna lokalizacja jest przydatna w przypadku „wskazówek dojścia pieszo”, ale przybliżona lokalizacja wystarczy do wyświetlenia 3 najbliższych sklepów w promieniu 15 km.

4. Personalizacja i prywatność

• Kierowane promocje: oferowanie kuponu na zakupy w sieci sklepów spożywczych, która ma wiele lokalizacji w danym mieście.
• Język i kultura: automatyczne ustawianie języka lub waluty aplikacji na podstawie ogólnego regionu lub kraju użytkownika. 

Przycisk lokalizacji na Androidzie (obowiązkowy na Androidzie 17 lub nowszym)

W przypadku aplikacji kierowanych na Androida 17 (poziom API 37) i nowsze wersje przycisk lokalizacji na Androidzie jest wymaganą minimalną metodą zakresu dostępu do dokładnej lokalizacji w przypadku „transakcyjnych” (jednorazowych) przypadków użycia.

Dlaczego przycisk lokalizacji jest wymagany?

• Przede wszystkim prywatność: przycisk pozwala na dostęp do dokładnej lokalizacji tylko na 1 sesję, która wygasa natychmiast po zamknięciu sesji aplikacji.
• Intencja użytkownika: zapewnia przejrzystość i przewidywalność, dzięki czemu użytkownicy dokładnie wiedzą, kiedy i dlaczego jest udostępniana ich lokalizacja.
• Mniejsze utrudnienia: eliminuje potrzebę wyświetlania skomplikowanych okien dialogowych z prośbą o przyznanie uprawnień w czasie działania aplikacji w przypadku prostych zadań, takich jak znajdowanie sklepu w pobliżu lub tagowanie zdjęcia.

Kiedy przycisk lokalizacji jest wymagany?

W aplikacjach kierowanych na Androida 17 lub nowszego przycisk jest wymagany w przypadkach użycia związanych z transakcjami, w których dokładna lokalizacja jest potrzebna tylko na chwilę. Typowe przykłady:

• Wyszukiwanie lokalne: znajdowanie sklepów, bankomatów lub restauracji w pobliżu użytkownika.
• Udostępnianie jednorazowe: wysyłanie bieżącej lokalizacji do znajomego w aplikacji do obsługi wiadomości.
• Tagowanie lokalizacji: dołączanie lokalizacji do treści takich jak zdjęcia czy posty w mediach społecznościowych.
• Selektory adresów: ułatwiają użytkownikom automatyczne podanie adresu dostawy.

Przykładowa implementacja (plik manifestu)

Jeśli Twoja aplikacja wymaga dokładnej lokalizacji tylko za pomocą przycisku, musisz zadeklarować to w pliku AndroidManifest.xml za pomocą atrybutu onlyForLocationButton:

XML

<uses-permission     android:name="android.permission.ACCESS_FINE_LOCATION"     android:usesPermissionFlags="onlyForLocationButton" />

Szczegółowe informacje techniczne znajdziesz w dokumentacji API.

Wymagania dotyczące uprawnień dostępu do dokładnej lokalizacji na pierwszym planie

Aplikacje, które wymagają dokładnego, stałego dostępu do uprawnienia ACCESS_FINE_LOCATION (i nie muszą używać przycisku lokalizacji), muszą spełniać te kryteria:

• Główna funkcjonalność: dostęp musi być niezbędny do realizowania głównego przeznaczenia aplikacji lub głównej funkcji produktu, zgodnie z informacjami podanymi na stronie aplikacji w Sklepie.
• Konkretne zakazy wynikające z zasad: aplikacja nie może prosić o dostęp do lokalizacji, jeśli ma to służyć tylko do wyświetlania reklam lub analizy danych. Dane o lokalizacji urządzenia nigdy nie mogą być sprzedawane.

Deklaracja w Konsoli Play

Deweloperzy aplikacji, które potrzebują dostępu do dokładnej lokalizacji (ACCESS_FINE_LOCATION), muszą wypełnić deklarację w Konsoli Play, aby wykazać, że aplikacja wymaga takiego dostępu, i uzasadnić, dlaczego przycisk lokalizacji lub przybliżona lokalizacja są niewystarczające.

W deklaracji musisz odpowiedzieć na te pytania:

1. Które funkcje aplikacji widoczne dla użytkownika wymagają uprawnienia ACCESS_FINE_LOCATION?

W tabeli poniżej znajdziesz przypadki użycia, ich opisy oraz przykłady (lista nie jest wyczerpująca). Jeśli Twój przypadek użycia nie jest widoczny dla użytkowników lub nie ma go na liście poniżej, wybierz „Inne”.

Przykład zastosowania	Opis	Przykłady
Wyszukiwanie w pobliżu	Służy do odkrywania interesujących miejsc w pobliżu użytkownika	Znajdowanie restauracji, firm, parkingów lub dostępnych hulajnóg elektrycznych w pobliżu
Jednorazowe udostępnianie lokalizacji	Udostępnianie bieżącej lokalizacji użytkownika innym osobom lub usługom	Automatyczne wypełnianie bieżącego adresu użytkownika lub udostępnianie jego bieżących współrzędnych
Śledzenie na żywo	Służy do ciągłego monitorowania i wyświetlania lokalizacji w czasie rzeczywistym	Śledzenie postępów biegacza, udostępnianie bieżącej lokalizacji innym osobom i ciągłe śledzenie lokalizacji na potrzeby funkcji takich jak pomiary, badania przestrzenne i zbieranie danych
Oznaczanie lokalizacji przez użytkownika	Służy do dołączania lokalizacji do treści użytkowników	Oznaczanie zdjęcia miejscem, w którym zostało zrobione, lub dodawanie lokalizacji do posta w mediach społecznościowych
Automatyczne tagowanie lokalizacji	Służy do automatycznego dołączania metadanych lokalizacji	Aplikacja aparatu dodająca lokalizację do zdjęć
Personalizacja	Dostosowywanie domyślnego interfejsu lub źródła treści bez wyszukiwania zainicjowanego przez użytkownika	Wyświetlanie restauracji w pobliżu użytkownika jako domyślnego widoku aplikacji do wyszukiwania restauracji
Nawigacja	Używane do podawania szczegółowych wskazówek dojazdu, aby prowadzić użytkownika po trasie	Wskazówki dojazdu samochodem, pieszo lub rowerem
Działania dotyczące konkretnego obszaru	Służy do wywoływania działania, gdy użytkownik wchodzi na określony obszar lub go opuszcza (geofencing)	Wysyłanie przypomnienia, gdy klient dotrze do sklepu spożywczego, lub oferowanie zniżki, gdy przechodzi obok sklepu
Urządzenia w pobliżu	Łączenie się z urządzeniami Bluetooth/Wi-Fi w pobliżu w aplikacjach kierowanych na Androida 11 (poziom API 30) lub starszego, w przypadku których Android wymaga dostępu do lokalizacji	Parowanie z głośnikiem Bluetooth lub wykrywanie telewizora smart TV na potrzeby przesyłania
Dostęp do lokalizacji w przeglądarce	Przekazywanie dokładnych danych o lokalizacji do witryn lub aplikacji internetowych innych firm na prośbę użytkownika, aby umożliwić korzystanie z funkcji specyficznych dla danej witryny	Przeglądarka przekazuje lokalizację do witryny sprzedawcy, aby automatycznie wypełnić adres dostawy
Diagnostyka sieci	Monitorowanie, mapowanie i rozwiązywanie problemów z infrastrukturą sieciową i wydajnością sygnału	Generowanie map zasięgu Wi-Fi, identyfikowanie „martwych stref” sieci komórkowych lub analizowanie siły sygnału i wydajności stacji bazowych na obszarze usługowym
Inne

2. Wyjaśnij, dlaczego uprawnienie ACCESS_COARSE_LOCATION lub LocationButton nie wystarcza i potrzebujesz stałego dostępu do uprawnienia ACCESS_FINE_LOCATION.

Oś czasu

• 15 kwietnia 2026 r.: ogłosiliśmy nowe zasady dotyczące uprawnień o minimalnym zakresie dostępu do lokalizacji. Zasady te wymagają używania przycisku lokalizacji na Androidzie w celu uzyskania dostępu o minimalnym zakresie oraz deklaracji od wszystkich deweloperów, którzy korzystają z uprawnienia ACCESS_FINE_LOCATION. 
• Listopad 2026 r.: będzie dostępna deklaracja dotycząca aplikacji korzystających z dokładnej lokalizacji. Deweloperzy aplikacji, które proszą o dostęp do dokładnej lokalizacji (ACCESS_FINE_LOCATION), muszą wypełnić deklarację w Konsoli Play, aby wykazać, że aplikacja wymaga takiego dostępu, i uzasadnić z technicznego punktu widzenia, dlaczego przycisk lokalizacji lub przybliżona lokalizacja są niewystarczające.
  • Działanie: skonsultuj się ze swoimi zespołami, aby dowiedzieć się, czy Twoja aplikacja wymaga uprawnienia ACCESS_FINE_LOCATION do zapewnienia swojej głównej funkcjonalności. Jeśli tak, przygotuj wyjaśnienie, dlaczego selektor o minimalnym zakresie nie wystarcza z technicznego punktu widzenia.
• 27 stycznia 2027 r.: zgodność z zasadami jest obowiązkowa w przypadku wszystkich aplikacji. 30-dniowe przedłużenia terminu będą dostępne w Konsoli Play. Po tej dacie wszystkie aplikacje objęte zakresem zasad, które nie są z nimi zgodne, mogą zostać usunięte.
   

Dalsze kroki i sprawdzone metody

1. Sprawdź kod: określ, czy aplikacja jest przeznaczona na Androida 17 lub nowszego i czy używa dokładnej lokalizacji do jednorazowych zadań.
2. Zastosuj flagę: jeśli przycisk jest wymagany, użyj w pliku manifestu flagi onlyForLocationButton.
3. Sprawdź interfejs: aby zachować zgodność, upewnij się, że przycisk spełnia wymagania projektowe na Androida.

Najczęstsze pytania

Kiedy zaczną obowiązywać wymagania dotyczące przycisku lokalizacji? 

Egzekwowanie zasad w przypadku aplikacji kierowanych na Androida 17 lub nowszego rozpocznie się pod koniec stycznia 2027 r. Ten harmonogram będzie się zmieniać w miarę zbierania opinii deweloperów. Aktualne informacje znajdziesz w Konsoli Play.

Czy obecne aplikacje są zwolnione z tych wymagań lub czy można przedłużyć termin do momentu opublikowania ich aktualizacji?

Nie. Te wymagania muszą spełniać wszystkie aplikacje – zarówno nowe, jak i istniejące – kierowane na Androida 17 lub nowszego. Aktualizacje obecnych aplikacji, które nie spełniają tych standardów, mogą zostać odrzucone.

Czy nadal mogę używać standardowego uprawnienia ACCESS_FINE_LOCATION? 

Tylko wtedy, gdy aplikacja ma podstawową, trwałą funkcję (np. szczegółową nawigację), której nie można obsłużyć za pomocą jednorazowego przycisku lub przybliżonej lokalizacji. Musisz to uzasadnić podczas przesyłania deklaracji w Konsoli Play.

Jakie są główne przypadki użycia przycisku lokalizacji w porównaniu z uprawnieniami do dokładnej lokalizacji? 

Używaj przycisku lokalizacji w przypadku: jednorazowych zapytań „wyszukaj w pobliżu”, oznaczania lokalizacji w poście w mediach społecznościowych lub pomagania użytkownikowi w wybraniu adresu. 

Używaj dostępu do dokładnej lokalizacji w przypadku: funkcji wymagających ciągłego śledzenia w czasie rzeczywistym, gdy aplikacja jest aktywna (takich jak śledzenie aktywności fizycznej lub aktywna nawigacja).

Czy przycisk lokalizacji działa w przypadku lokalizacji w tle? 

Nie. Przycisk lokalizacji jest przeznaczony wyłącznie do użytku na pierwszym planie. Wymagania dotyczące działania w tle muszą być nadal zgodne z procesem weryfikacji lokalizacji w tle.

Powiązane artykuły

• Więcej informacji o deklarowaniu uprawnień znajdziesz w Konsoli Google Play.
• Więcej informacji o tworzeniu aplikacji korzystających z danych o lokalizacji znajdziesz na stronie dla deweloperów aplikacji na Androida.
• Więcej informacji o uprawnieniach i przepływie pracy związanych z uprawnieniami znajdziesz na stronie dla deweloperów aplikacji na Androida.
• Więcej informacji o sprawdzonych metodach ochrony prywatności znajdziesz na stronie dla deweloperów aplikacji na Androida.
• Zapoznaj się z naszymi zasadami dotyczącymi danych użytkownika.

Więcej informacji o tym, jak zachowywać zgodność z zasadami dotyczącymi lokalizacji urządzenia w Google Play, znajdziesz w Akademii dla deweloperów aplikacji.