--- title: "Permissões de localização no iOS" slug: "ios-sdk-location" updated: 2026-06-12T10:30:57Z published: 2026-06-12T10:30:57Z canonical: "docs.xtremepush.com/ios-sdk-location" --- > ## Documentation Index > Fetch the complete documentation index at: https://docs.xtremepush.com/llms.txt > Use this file to discover all available pages before exploring further. # Permissões de localização no iOS Habilitar suporte para geofences e iBeacons Os serviços de localização permitem adicionar regiões de geofence ou iBeacon relacionadas ao seu app na plataforma Xtremepush. Isso permite que você analise o público do seu aplicativo, visitas aos seus locais e acione notificações quando eles entram/saem/permanecem em seus locais. ## Habilitar serviços de localização Na [integração padrão do SDK do iOS](/documentation/docs/pt-br/ios-sdk-integration), os Serviços de Localização estão desligados. Eles podem ser ativados usando esse `setLocationEnabled` método. **Swift** ```swift func application(_ application: UIApplication, didFinishLaunchingWithOptions launchOptions: [UIApplicationLaunchOptionsKey: Any]?) -> Bool {        // ...    XPush.setLocationEnabled(true)    // ...    XPush.applicationDidFinishLaunching(options: launchOptions)        return true } ``` **Objective-C** ```objectivec - (BOOL)application:(UIApplication *)application didFinishLaunchingWithOptions:(NSDictionary *)launchOptions {        // ...    [XPush setLocationEnabled:YES];    // ...    [XPush applicationDidFinishLaunchingWithOptions:launchOptions];    return YES; } ``` Você também precisa adicionar as seguintes chaves de descrição de uso e o texto associado para a localização do seu `Info.plist` arquivo. Ele será mostrado ao usuário no diálogo de permissões de localização. - `NSLocationAlwaysUsageDescription` - `NSLocationAlwaysAndWhenInUseUsageDescription` - `NSLocationWhenInUseUsageDescription` Sem isso, seu aplicativo não solicitará permissão de localização. Você deve explicar explicitamente por que seu app precisa da permissão *Always* para qualquer uso que você o utilize, por exemplo, notificando sobre experiências especiais no estádio no dia do jogo, adicionando pontos de recompensa quando você visita nossa loja, etc. ![960](https://cdn.document360.io/b056e88b-f6c1-4bd2-b5b8-08e9336a17c9/Images/Documentation/957fa37-Location_Permission_Screens_1(1).png?sv=2026-02-06&spr=https&st=2026-11-04T09%3A28%3A53Z&se=2026-11-04T10%3A28%3A53Z&sr=c&sp=r&sig=jEmFd6Zh%2BPkFfkL%2Bbs3scpBF3nY1aH8hqzRvB9aiCMA%3D) ### Lembrete de uso periódico em segundo plano do iOS 13 A partir do iOS 13 (setembro de 2019), o sistema operacional exibe periodicamente um prompt para lembrar o usuário sobre aplicativos usando a localização em segundo plano (ou seja, aqueles que receberam a permissão *Sempre* ). O usuário deve confirmar permissão contínua para acessar o local. O prompt inclui um mapa mostrando onde seu app acionou geofences e onde ele verificou a localização para garantir que as geofences próximas estavam configuradas corretamente. A descrição do uso da sua localização é repetida aqui, então você deve verificar se a descrição descreve corretamente como você usa os dados de localização, ou corre o risco de perder a confiança do usuário e, com ela, seus privilégios de acesso à localização em segundo plano. ![960](https://cdn.document360.io/b056e88b-f6c1-4bd2-b5b8-08e9336a17c9/Images/Documentation/9279d2e-Location_Permission_Screens_3(1).png?sv=2026-02-06&spr=https&st=2026-11-04T09%3A28%3A53Z&se=2026-11-04T10%3A28%3A53Z&sr=c&sp=r&sig=jEmFd6Zh%2BPkFfkL%2Bbs3scpBF3nY1aH8hqzRvB9aiCMA%3D) ### Alterações no iOS 13 na concessão de permissão de localização A partir do iOS 13 (setembro de 2019), os aplicativos que solicitam a *permissão Sempre* mostram uma opção **Permitir Uma Vez** para o usuário no primeiro prompt de localização do aplicativo. Se o usuário escolher **Permitir uma** vez, o aplicativo recebe permissão de localização apenas para uma única sessão em primeiro plano. Quando o usuário sai do aplicativo ou bloqueia o dispositivo, a permissão expira automaticamente e o aviso é exibido novamente no próximo uso dos serviços de localização. Se o usuário concordar com **Enquanto Está Usando o App** , no futuro, quando seu app normalmente receberia um evento de localização em segundo plano (por exemplo, um evento *de região de entrar* beacon), o usuário terá uma opção para atualizar a permissão para *Sempre*. Se isso acontecer, seu aplicativo receberá o evento em segundo plano. ![960](https://cdn.document360.io/b056e88b-f6c1-4bd2-b5b8-08e9336a17c9/Images/Documentation/97670d0-Location_Permission_Screens_2(1).png?sv=2026-02-06&spr=https&st=2026-11-04T09%3A28%3A53Z&se=2026-11-04T10%3A28%3A53Z&sr=c&sp=r&sig=jEmFd6Zh%2BPkFfkL%2Bbs3scpBF3nY1aH8hqzRvB9aiCMA%3D) ## ## Ative o Bluetooth para iBeacons Desde a versão 4.1.0 do Xtremepush SDK, você deve habilitar explicitamente o suporte para iBeacons. Isso é para evitar que seus usuários sejam solicitados (desde o iOS 13 em setembro de 2019) a permitir o acesso a serviços Bluetooth, a menos que você precise especificamente. ![960](https://cdn.document360.io/b056e88b-f6c1-4bd2-b5b8-08e9336a17c9/Images/Documentation/3a14de7-Bluetooth_Permission_Screen(1).png?sv=2026-02-06&spr=https&st=2026-11-04T09%3A28%3A53Z&se=2026-11-04T10%3A28%3A53Z&sr=c&sp=r&sig=jEmFd6Zh%2BPkFfkL%2Bbs3scpBF3nY1aH8hqzRvB9aiCMA%3D) Para habilitar o suporte a iBeacons e pedir aos seus usuários que permitam o acesso ao Bluetooth: 1. Siga os passos acima para habilitar os Serviços de Localização 2. Adicione a seguinte chamada de método imediatamente após a chamada ao `setLocationEnabled`: **Swift** ```swift XPush.setBeaconsEnabled(true) ``` **Objective-C** ```objectivec [XPush setBeaconsEnabled:YES]; ``` 1. Adicione a `NSBluetoothAlwaysUsageDescription` chave e a descrição de uso associada ao seu `Info.plist` arquivo para explicar o uso do Bluetooth aos seus usuários. > [!TIP] > **Em contraste com o existente** `NSBluetoothPeripheralUsageDescription`necessário **para** [**integrar o SDK do iOS**](/documentation/docs/pt-br/ios-sdk-integration)**, essa nova descrição será exibida como parte do pedido de permissão Bluetooth e também no app Configurações nas telas de Privacidade Bluetooth.**