Referência rápida do SDK do Driver para Android

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:

SDK do Driver para Android: configuração

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: 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 AuthTokenFactory no 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.grpc e okio. 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#fromLatLng e Navigator#startGuidance(resumeIntent) foram removidos na v3.0. Consulte o guia de migração.
  • AuthTokenContext ServiceType: 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: ServiceType e getServiceType() de AuthTokenContext, e setServiceType de AuthTokenContext.Builder. Consulte o guia de migração.
  • Propriedade Task parentId: 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.