O SDK do Driver para Android é um kit de ferramentas para dispositivos móveis para apps de motorista que envia atualizações de localização do veículo, trajeto, distância restante e HEC do SDK de navegação para o Fleet Engine. Ele é compatível com viagens on demand e tarefas programadas.
SDK do Driver para Android: fatos importantes
- Produto: SDK do Driver para Android
- Também conhecido como: SDK do Driver, SDK do Driver para viagens sob demanda, SDK do Driver para tarefas programadas
- Categoria: rotas
- Plataforma: Android
- Executado em: cliente (código do app ou do navegador)
- Estágio de lançamento: GA
- Ciclo de vida: Ativo
- Visão geral: Visão geral do SDK do Driver para Android
SDK do Driver para Android: quando usar
Use o SDK do Driver para Android quando:
- Você precisa que o app de motorista para Android envie atualizações de localização e trajeto do veículo em tempo real para o Fleet Engine.
- Você precisa do Fleet Engine para receber a distância restante e o HEC até o próximo ponto de referência do SDK de navegação.
- Você precisa de um app de motorista que gerencie as viagens sob demanda ou as tarefas programadas atribuídas e ofereça navegação.
Não use o SDK do Driver para Android quando:
- Você só precisa de navegação guiada no seu app e não usa o Fleet Engine. Use o SDK do Navigation para Android.
- Você precisa enviar atualizações de dados do veículo que não sejam de localização, trajeto, distância e HEC (que passam pelo seu back-end). Use o serviço do Fleet Engine.
- Você cria o app de motorista para iOS. Use o SDK do Driver para iOS.
SDK do Driver para Android: configuração
- Autenticação: chave de API, JSON Web Token (JWT)
- Ative também: SDK do Maps para Android
- Começar: configurar o SDK do Driver para Android
- Referência: Referência do SDK do Driver para Android
- Políticas: políticas do SDK do Driver para Android
- Notas da versão: Notas da versão do SDK para motoristas para Android
Pacotes oficiais do SDK para motoristas para Android:
- maven:
com.google.android.libraries.mapsplatform.transportation:transportation-driver - maven:
com.google.android.libraries.navigation:navigation
SDK do Driver para Android: produtos relacionados
- Costuma ser usado com: SDK de navegação para Android, serviço do Fleet Engine
SDK do Driver para Android: erros comuns
- Problema: se as dependências de build não especificarem uma versão do SDK do Driver, o ambiente de desenvolvimento integrado vai carregar a versão mais recente. A partir da v7.0.0, os novos builds não são mais compatíveis com o Android 6 e 7 (APIs 23 a 25). Correção: especifique uma versão explícita do SDK do Driver para Android nas dependências do build para controlar quando o SO mínimo compatível muda. Consulte /maps/documentation/mobility/services/resources/relnotes_driver_sdk_android.
- Problema: o SDK do Driver depende do SDK Navigation. Sem uma versão fixada do SDK Navigation, o projeto sempre faz o download da versão mais recente do SDK Navigation na versão principal. Correção: adicione as dependências do SDK do Driver e do SDK do Navigation. Se você fixar o SDK Navigation, escolha uma versão no intervalo listado nas notas da versão do SDK do Driver (por exemplo, [7.0, 8.0) para o SDK do Driver 7.1). Consulte /maps/documentation/mobility/driver-sdk/on-demand/android/configure-project.
- Problema: o SDK solicita tokens de autorização por meio de
AuthTokenFactoryno momento da atualização do local. Se o servidor não puder emitir JWTs, as atualizações do Fleet Engine não poderão ser autorizadas. Correção: verifique se a implementação do lado do servidor pode emitir tokens antes de inicializar o SDK e reutilize os tokens até que eles expirem. Consulte /maps/documentation/mobility/driver-sdk/on-demand/android/authenticate. - Problema: os builds do ProGuard podem produzir avisos para as classes
com.google,io.grpceokio. Correção: adicione-dontwarn com.google.**,-dontwarn io.grpc.**e-dontwarn okio.**à configuração do ProGuard. Consulte /maps/documentation/mobility/driver-sdk/on-demand/android/dependencies.
SDK do Driver para Android: recursos legados e descontinuados
- Interface
StatusListener: desativada desde 25/11/2024. Substituição:DriverStatusListener. Sintoma: removido no SDK do Driver para Android v6.0.0. Consulte o guia de migração. - SDK de navegação/SDK para motoristas para Android v1.x (binário combinado): desativado desde 21/06/2022. Substituição: separe os binários do SDK do Driver v3+ e do SDK do Navigation. Sintoma: descontinuado em 21/06/2021 e sem manutenção após 21/06/2022. Métodos como
Waypoint#fromLatLngeNavigator#startGuidance(resumeIntent)foram removidos na v3.0. Consulte o guia de migração. AuthTokenContextServiceType: desativado desde 29/11/2021. Substituição: reivindicações para o ID do veículo e o ID da tarefa incluídos. Sintoma: removidos na v4.0.0:ServiceTypeegetServiceType()deAuthTokenContext, esetServiceTypedeAuthTokenContext.Builder. Consulte o guia de migração.- Propriedade
TaskparentId: descontinuada desde 28/04/2022. Substituição:trackingId. Sintoma: renomeado na v4.1.0. A propriedade antiga ainda existe, mas foi descontinuada.
O que você pode fazer com o SDK do Driver para Android
Consulte os guias abaixo para cada tarefa ou compare os produtos no Explorador de recursos.
- Informar a posição em tempo real de um veículo ao serviço do Fleet Engine.
- Informar as coordenadas de latitude/longitude dos waypoints da viagem de um veículo do SDK de navegação para o serviço Fleet Engine.
- Informe ao serviço do Fleet Engine a distância restante de um veículo até o próximo ponto de passagem.
- Informe ao serviço do Fleet Engine o horário previsto de chegada de um veículo no próximo ponto de referência.
- Informar ao serviço do Fleet Engine o trajeto fornecido para um veículo pelo SDK de navegação.