Minimális hatókör: az előtérbeli helyhozzáférés és a helymegosztó gomb

Megjegyzés: Ez az irányelvekkel kapcsolatos súgócikk az előtérbeli helyhozzáféréssel és a helymegosztó gombbal kapcsolatban nyújt iránymutatást. Az eszköz háttérbeli helymeghatározásával kapcsolatban A háttérbeli helymeghatározásra vonatkozó engedélyek című súgócikkben találsz bővebb tájékoztatást.

A eszköz helyéhez való hozzáférésre vonatkozó egyértelmű irányelvek meghatározása kulcsfontosságú a felhasználók bizalmának elnyeréséhez és a biztonságos ökoszisztéma fenntartásához. Ez a cikk részletezi az új androidos helymegosztó gomb alkalmazások általi használatára vonatkozó követelményeket, valamint az eszköz helyadatainak előtérben való normál használatát (ACCESS_COARSE_LOCATION vagy ACCESS_FINE_LOCATION). A helyadatokhoz előtérben történő hozzáférésére akkor kerül sor, amikor az alkalmazás meg van nyitva, és látható a felhasználó számára. Ha a hozzáférés akkor történik, amikor az alkalmazás nem látható a felhasználó számára, akkor az alkalmazás a háttérben fér hozzá a helyadatokhoz.

Bizonyos esetekben előfordulhat, hogy jóváhagyjuk az alkalmazás számára az előtérben futó szolgáltatás használatát. Ez egy különálló API, amely lehetővé teszi az alkalmazás számára a helyadatokhoz való hozzáférést akkor is, amikor az alkalmazás kis méretű, és nem látható a felhasználó számára. Ezeket azonban külön ellenőrizzük, és meg kell felelniük az Előtérben futó szolgáltatásokra vonatkozó irányelvekben meghatározott követelményeknek.

Mit jelent ez a helymeghatározási jogosultságokra vonatkozó irányelvünkre nézve? A felhasználók számára az a legátláthatóbb megközelítés, ha egy alkalmazás az előtérben fér hozzá a helyadatokhoz, ami erősíti a bizalmat, és a Google Playen található alkalmazások esetében is ezt a módszert részesítjük előnyben. Az androidos helymegosztó gomb használata további adatvédelmi és ellenőrzési réteget biztosít annak érdekében, hogy az alkalmazás megfeleljen a minimális hatókörre vonatkozó követelményeknek.

Áttekintés: A helyadatokhoz való hozzáférés minimális hatóköre

A felhasználói adatvédelem érdekében a Google Play megköveteli, hogy minden alkalmazás csak az alapvető funkciók biztosításához szükséges minimális jogosultsági hatókörre vonatkozóan kérjen engedélyt. Az eszköz helyadataira vonatkozó jogosultság meghatározásakor vedd figyelembe a következő szempontokat:

• Pontosság: Használj hozzávetőleges helymeghatározást (ACCESS_COARSE_LOCATION), ha a funkció nem igényel feltétlenül nagyobb pontosságot.
• Állandóság: Egyszeri vagy ritka igények esetén az alkalmazásoknak az alapértelmezett „állandó” hozzáférésről tranzakciónkénti hozzáférésre kell váltaniuk a helymegosztó gomb segítségével.

Háttérben vagy előtérben: Ez a cikk az előtérbeli hozzáférést ismerteti. Ha az alkalmazásodnak akkor is szüksége van a helyadatokra, amikor nincs használatban, olvasd el a háttérbeli helyhozzáférésre vonatkozó követelményeket.

Példák olyan használati esetekre, amikor elegendő lehet az eszköz hozzávetőleges helyadataihoz való hozzáférés:

1. Lokalizált tartalom és felfedezés

• Helyi hírek és trendek: A „Chicagói hírek” vagy a „Felkapott témák San Franciscóban” megjelenítéséhez nincs szükség a felhasználó pontos címének ismeretére.
• Regionális események felfedezése: Fesztiválok, koncertek vagy termelői piacok keresése egy adott városban vagy környéken.
• Időjárási szolgáltatások: A regionális időjárás attól függetlenül pontos, hogy a felhasználó otthon tartózkodik-e, vagy egy három háztömbnyire lévő kávézóban.

2. Közösségi és társasági élet

• Helyi piacok: A vásárlók számára elegendő információ, ha a hirdetési alkalmazások annyit jelenítenek meg, hogy egy adott termék „5 kilométeren belül” kapható, és csak akkor fedik fel az eladó pontos tartózkodási helyét, amikor ő megosztja azt.
• A „közelben lévő személyek”: A közösségi alkalmazásokban elegendő annyit megmutatni, hogy egy ismerős „a városodban” tartózkodik, és nincs szükség arra, hogy valós időben megjelenjen a tartózkodási helye a térképen.

3. Segédprogram és optimalizálás

• Üzletkeresők: Egy országos kiskereskedelmi üzletlánc vagy bank legközelebbi fiókjainak megjelenítése. Míg „gyalogos útvonalterv” biztosításához szükség van a pontos helyadatokra, ahhoz a durva helymeghatározás is elegendő, hogy az alkalmazás megjelenítse a három legközelebbi üzletet 10 kilométeres körzetben.

4. Személyre szabás és adatvédelem

• Célzott promóciók: Egy olyan élelmiszerlánc kuponjának felajánlása, amelynek több üzlete is van egy városban.
• Nyelv és kultúra: Az alkalmazás nyelvének vagy pénznemének automatikus beállítása a felhasználó tágabb régiója vagy az ország alapján. 

Az androidos helymegosztó gomb (Android 17 vagy újabb rendszer esetén kötelező)

Az Android 17-es (37-es API-szint) és újabb verzióját megcélzó alkalmazások esetében az alkalmazás az androidos helymegosztó gomb segítségével szerezheti meg a szükséges minimális hatókört a pontos helymeghatározáshoz a „tranzakciónkénti” (egyszeri) használati esetekben.

Miért van szükség a helymegosztó gombra?

• Az adatvédelem az első: Csak egyetlen munkamenetre ad hozzáférést a pontos helyadatokhoz, ami a munkamenet bezárásakor lejár.
• Felhasználói szándék: Egyértelmű, kiszámítható élményt hoz létre, amelyben a felhasználók pontosan tudják, mikor és miért osztják meg a tartózkodási helyüket.
• Kevesebb súrlódás: Nincs szükség összetett, futáskor megjelenő engedélykérő párbeszédpanelekre az olyan egyszerű feladatokhoz, mint például egy közeli üzlet megkeresése vagy egy fotó felcímkézése.

Mikor kötelező a helymegosztó gomb használata?

Az Android 17 vagy újabb verzióját célzó alkalmazások esetében a gomb használata kötelező az olyan tranzakciónkénti használati esetekben, amikor csak pillanatnyilag van szükség pontos helymeghatározásra. Gyakori példák:

• Keresés a közelben: Üzletek, bankautomaták vagy éttermek keresése a felhasználó közelében.
• Egyszeri megosztás: Az aktuális tartózkodási hely elküldése egy ismerősnek üzenetküldő alkalmazásban.
• Helycímkézés: Hely hozzáadása a felhasználók által létrehozott tartalmakhoz, például fotókhoz vagy közösségi bejegyzésekhez.
• Címválasztók: A szállítási cím automatikus kitöltése.

Példa a megvalósításra (manifest)

Ha az alkalmazásod csak a gomb használatával igényel pontos helymeghatározást, akkor ezt deklarálnod kell az onlyForLocationButton attribútum használatával az AndroidManifest.xml fájlban:

XML

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

A technikai részletek az API-dokumentációban található.

A pontos előtérbeli helymeghatározási jogosultságra vonatkozó követelmények

Azoknak az alkalmazásoknak, amelyek pontos, állandó hozzáférést igényelnek az ACCESS_FINE_LOCATION engedélyhez (és nem kötelesek használni a helymegosztó gombot), meg kell felelniük a következő feltételeknek:

• Alapvető funkciók: A hozzáférésnek elengedhetetlenül szükségesnek kell lennie ahhoz, hogy az alkalmazás elsődleges célja vagy az elsődleges termékfunkció az áruházi adatlapodon közzétett módon megvalósulhasson.
• Konkrét irányelvi tilalmak: Helymeghatározási jogosultság nem kérhető kizárólag hirdetési vagy elemzési célból, és az eszköz helyadatai soha nem értékesíthetők.

Play Console-nyilatkozat

Minden olyan alkalmazás esetében, amelynek pontos helymeghatározásra (ACCESS_FINE_LOCATION) van szüksége, ki kell töltened egy nyilatkozatot a Play Console-ban, amelyben ismerteted a hozzáférési igényeket, és megindoklod, hogy miért nem elegendő a helymegosztó gomb vagy a hozzávetőleges helymeghatározás használata.

A nyilatkozatban a következő kérdésekre kell válaszolnod:

1. Az alkalmazásod felhasználók számára rendelkezésre álló funkciói közül melyek igénylik az ACCESS_FINE_LOCATION engedélyt?

Az alábbi táblázat felsorolja a használati eseteket, azok leírását, valamint a vonatkozó, nem teljes körű példakat. (Ha a használati eset nem felhasználóknak szól, vagy nem szerepel az alábbi listán, válaszd az „Egyéb” lehetőséget).

Használati eset	Leírás	Példák
Keresés a közelben	A felhasználó környékén található érdekes helyek felfedezésére szolgál	Közeli éttermek, vállalkozások, parkolási lehetőségek vagy rendelkezésre álló elektromos rollerek keresése.
Egyszeri helymegosztás	A felhasználó aktuális tartózkodási helyének megosztása más személyekkel vagy szolgáltatásokkal	A felhasználó aktuális címének automatikus kitöltése vagy az aktuális koordináták megosztása.
Élő nyomon követés	A tartózkodási hely folyamatos, valós idejű nyomon követésére és megjelenítésére szolgál	Egy futó haladásának nyomon követése, a tartózkodási hely folyamatos megosztása másokkal, valamint a tartózkodási hely folyamatos nyomon követése olyan funkciókhoz, mint a mérés, a térbeli felmérés és az adatgyűjtés.
Felhasználó általi helymegjelölés	Hely csatolására szolgál a felhasználó által létrehozott tartalomnál	Fotó megcímkézése a készítés helyével, illetve hely hozzáadása egy közösségimédia-bejegyzéshez.
Automatikus helycímkézés	Helyre vonatkozó metaadatok automatikus csatolására szolgál	Egy kameraalkalmazás helyadatokat ad hozzá a fotókhoz.
Személyre szabás	Az alapértelmezett felület vagy tartalomfeed testreszabása felhasználó által kezdeményezett keresés nélkül	A felhasználó környékén lévő éttermek megjelenítése az alkalmazások alapértelmezett nézetében egy étteremkereső alkalmazásban.
Navigáció	Részletes útvonalterv biztosítására szolgál a felhasználó adott útvonalon való végigvezetése érdekében	Útvonalterv vezetéshez, gyalogláshoz vagy kerékpározáshoz.
Területspecifikus műveletek	Művelet aktiválására szolgál, amikor egy felhasználó belép egy adott területre, vagy elhagyja azt (földrajzi helymeghatározás)	Emlékeztető küldése, amikor megérkezik az élelmiszerboltba, vagy ajánlat felkínálása, amikor elhalad mellette.
Közeli eszközök	Csatlakozás közeli Bluetooth-/Wi-Fi-eszközökhöz olyan alkalmazásokban, amelyek az Android 11-es (30-as API-szint) vagy régebbi verzióját célozzák, ahol az Android helymeghatározási engedélyt kér	Párosítás Bluetooth-hangfallal, vagy okostévé felfedezése átküldéshez.
Böngésző helyhozzáférése	Pontos helyadatok továbbítása harmadik felek webhelyeinek vagy internetes alkalmazásainak a felhasználó kérésére a webhelyspecifikus funkciók engedélyezése érdekében	A böngésző átadja a helyet egy kiskereskedelmi webhelynek a szállítási cím automatikus kitöltéséhez.
Hálózati diagnosztika	A hálózati infrastruktúra és a jel teljesítményének figyelése, feltérképezése, és a problémák megoldása	Wi-Fi-hőtérképek generálása, mobilos „holtterek” azonosítása, illetve a jelerősség és a tornyok teljesítményének elemzése egy szolgáltatási területen.
Egyéb

2. Magyarázd el, miért nem elegendő az ACCESS_COARSE_LOCATION vagy a LocationButton, és miért van szükséged folyamatos ACCESS_FINE_LOCATION engedélyre.

Idővonal

• 2026. április 15.: Bejelentettük a helyhozzáférésre vonatkozó új, minimális hatókörű engedélyekre vonatkozó irányelvet. Ez az irányelv megköveteli az Android helymegosztó gomb használatát a minimális hatókörű hozzáféréshez, és nyilatkozatot ír elő az ACCESS_FINE_LOCATION engedélyt használó összes fejlesztő számára.
• 2026. november: A pontos helyet használó alkalmazásokra vonatkozó nyilatkozat rendelkezésre fog állni. Azoknak a fejlesztőknek, akiknek az alkalmazásai pontos helymeghatározást (ACCESS_FINE_LOCATION) kérnek, ki kell tölteniük egy nyilatkozatot a Play Console-ban, amelyben ismertetik a hozzáférési igényeket, és technikai indoklást adnak arra vonatkozóan, hogy miért nem elegendő a helymegosztó gomb vagy a hozzávetőleges helymeghatározás használata.
  • Teendő: Konzultálj a csapataiddal, hogy megtudd, az alkalmazásodnak szüksége van-e az ACCESS_FINE_LOCATION engedélyre az alapvető funkciók biztosításához, és ha igen, készülj fel magyarázattal arra, hogy technikai szempontból miért nem elegendő a minimális hatókörű választó.
• 2027. január 27.: Az irányelveknek való megfelelés kötelező minden alkalmazás esetében. A Play Console-ban 30 napos önálló határidő-hosszabbítás fog rendelkezésre állni. E dátum után az irányelv hatálya alá tartozó összes alkalmazás ellen intézkedés hajtható végre, ha az adott alkalmazás nem felel meg az irányelvnek.
   

További lépések és bevált módszerek

1. Ellenőrizd a kódot: Állapítsd meg, hogy az alkalmazásod az Android 17 vagy újabb verzióját célozza-e meg, és hogy használ-e pontos helymeghatározást egyszeri feladatokhoz.
2. Implementáld a jelzőt: Ha kötelező a gomb használata, használd az onlyForLocationButton jelzőt a manifestfájlban.
3. Ellenőrizd a kezelőfelületet: Az egységes megjelenés érdekében győződj meg arról, hogy a gomb megfelel az Android tervezési irányelveinek.

Gyakran ismételt kérdések (GYIK)

Mikor lépnek hatályba a helymegosztó gombra vonatkozó követelmények? 

Várhatóan 2026. október végén kezdjük el az Android 17-es vagy újabb verzióját célzó alkalmazásokra vonatkozó irányelvek betartatását. Az ütemezést a fejlesztői visszajelzések függvényében pontosítjuk. Figyeld a frissítéseket a Play Console-ban.

A meglévő alkalmazások mentesülnek ezek alól a követelmények alól, vagy kaphatnak haladékot a következő frissítés közzétételéig?

Nem. Az Android 17-es vagy újabb verzióját megcélzó összes alkalmazásnak – újnak és meglévőnek egyaránt – meg kell felelnie ezeknek a követelményeknek. Előfordulhat, hogy elutasítjuk azokat az alkalmazásfrissítéseket, amelyek nem felelnek meg a fenti követelményeknek.

Továbbra is használhatom a normál ACCESS_FINE_LOCATION jogosultságot? 

Csak akkor, ha az alkalmazásod alapvető állandó funkciója (például részletes navigáció) nem biztosítható egyszeri gombbal vagy durva helymeghatározással. Ezt a Play Console-nyilatkozatban meg kell indokolnod.

Melyek a helymegosztó gomb és a pontos helymeghatározási engedély elsődleges használati esetei? 

A helymegosztó gomb a következő esetekben használható: Egyszeri „keresés a közelben” jellegű lekérdezések, helyek megcímkézése egy közösségi bejegyzésben, vagy segítségnyújtás a felhasználónak a cím kiválasztásában. 

A pontos helymeghatározási jogosultság a következő esetekben használható: Olyan funkciók, amelyek folyamatos, valós idejű nyomon követést igényelnek az alkalmazás aktív használata közben, például aktivitásmérés vagy aktív navigáció.

A helymegosztó gombbal biztosítható a háttérbeli helyhozzáférés? 

Nem. A helymegosztó gomb kizárólag az előtérben, tranzakciónkénti használatra szolgál. A háttérbeli helyhozzáférést igénylő funkcióknak továbbra is követniük kell a háttérbeli helyhozzáféréssel kapcsolatos ellenőrzési folyamatot.

Kapcsolódó tartalmak

• További információ az engedélyek Google Play Console-ban való deklarálásáról.
• További információ a helyadatokat használó alkalmazások fejlesztéséről az Android-fejlesztők webhelyén.
• További információ az engedélyekről és az engedélyek használatával kapcsolatos munkamenetről az Android-fejlesztők webhelyén.
• További információ az adatvédelem bevált módszereiről az Android-fejlesztők webhelyén.
• További információ a felhasználói adatokra vonatkozó irányelveinkről.

További információ arról, hogyan tarthatod be a Google Play eszközhelyadatokkal kapcsolatos irányelveit az Academy for App Success oldalon.