O SDK do Location Based Service (LBS) oferece APIs de localização leves integradas ao framework mPaaS. Utilize-o para obter a posição atual do dispositivo — latitude, longitude e, opcionalmente, um endereço com geocodificação reversa — em Android e iOS.
Como funciona
Quando seu aplicativo chama a API LBS, o SDK consulta o provedor de localização subjacente (GPS, rede ou combinado) e retorna um objeto LBSLocation contendo coordenadas e metadados de precisão. Se a geocodificação reversa estiver ativada, o SDK também retorna um objeto LBSLocationInfo com um endereço estruturado.
Todas as solicitações de localização são assíncronas. Seu aplicativo registra um callback e recebe os resultados sem bloquear a thread principal.
Plataformas suportadas e métodos de integração
|
Plataforma |
Método de integração |
|
Android |
AAR nativo (dependência direta) |
|
Android |
Integração baseada em componentes (framework de componentes mPaaS) |
|
iOS |
CocoaPods |
Escolha o método de integração compatível com a configuração do seu projeto antes de começar. A troca de métodos após a integração exige a reconfiguração dos scripts de build e das dependências.
Capacidades
Obtenha as coordenadas do dispositivo (latitude e longitude) com uma única chamada de API
Ative a geocodificação reversa para converter coordenadas em um endereço legível
Controle a precisão da localização para equilibrar exatidão e consumo de bateria
Solicite correções de localização únicas ou atualizações contínuas de posição
Limitações
iOS: A geocodificação reversa não é suportada no iOS. O parâmetro
needReGeocodenão tem efeito em dispositivos iOS.Precisão da localização: O SDK depende do hardware subjacente do dispositivo e dos sinais disponíveis (GPS, Wi-Fi, rede celular). A precisão varia conforme o ambiente.
Localização em segundo plano: As atualizações de localização em segundo plano exigem permissões adicionais e configurações no nível do sistema operacional que não são abordadas neste guia.
Pré-requisitos
Antes de começar, verifique se você possui:
Um projeto mPaaS configurado para Android ou iOS
Uma chave de serviço de localização (chave do Gaode Maps) obtida na Gaode Open Platform
Permissões de localização adicionadas ao manifesto do seu aplicativo (Android) ou ao arquivo
Info.plist(iOS)