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

O SDK do Consumidor para Android faz parte do Fleet Engine para viagens sob demanda. Ele fornece interfaces que modelam dados de viagem e acompanham viagens no Fleet Engine, além de classes para criar uma exibição baseada em mapa que compartilha o progresso de uma viagem (localização do veículo, trajeto, HEC, distância restante, trânsito) com os consumidores em um app Android.

SDK do Consumidor para Android: principais fatos

  • Produto: SDK do Consumidor para Android
  • Também conhecido como: SDK do consumidor para Android, SDK do consumidor, SDK do consumidor para Android de viagens on demand dos Serviços de mobilidade
  • 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 Consumidor para Android

SDK do Consumidor para Android: quando usar

Use o SDK do Consumidor para Android quando:

  • Você precisa que os consumidores no seu app Android acompanhem uma viagem sob demanda (corrida, pedido ou entrega) que seu back-end rastreia no Fleet Engine.
  • Você precisa mostrar a localização e o trajeto de um veículo em um mapa em um aplicativo para o consumidor Android, quase em tempo real e ajustados à via.
  • Você precisa mostrar o horário estimado de retirada e entrega, a distância restante e o trânsito em tempo real de uma viagem do Fleet Engine no Android.
  • Você precisa personalizar os marcadores de viagem, as polilinhas de rota ou o estilo de mapa para um mapa de compartilhamento de trajeto no Android.

Não use o SDK do Consumidor para Android quando:

SDK do Consumidor para Android: configuração

Pacotes oficiais do SDK do Consumidor para Android:

  • maven: com.google.android.libraries.mapsplatform.transportation:transportation-consumer

SDK do Consumidor para Android: erros comuns

  • Problema: se a dependência do SDK do Maps não estiver definida como uma versão explícita, o SDK do Consumidor vai usar a versão mínima necessária do SDK do Maps, o que pode causar falhas em apps que dependem de recursos de versões mais recentes do SDK do Maps. Correção: declare uma versão do play-services-maps definida explicitamente com transportation-consumer no Gradle ou no Maven. Consulte /maps/documentation/mobility/journey-sharing/on-demand/android/configure-project.
  • Problema: não interromper o compartilhamento de trajeto após o término de uma viagem causa solicitações de rede desnecessárias ao Fleet Engine e vazamentos de memória. Correção: chame JourneySharingSession.stop() quando a viagem não for mais necessária, por exemplo, em onDestroy() ou quando a viagem for COMPLETE. Consulte /maps/documentation/mobility/journey-sharing/on-demand/android/share-journey.
  • Problema: o ConsumerApi.initialize() gera uma exceção se uma instância de API já existe (2.0.0 e mais recentes). Correção: chame ConsumerApi.getInstance() primeiro e verifique o Task retornado para determinar se já existe uma instância. Consulte /maps/documentation/mobility/services/resources/relnotes_consumer_sdk_android.
  • Problema: o SDK do Consumidor v3 e versões anteriores não são compatíveis com o modo R8 completo. Os apps que usam o AGP 8.0 ou mais recente podem ter problemas de build ou de execução. Correção: defina android.enableR8.fullMode=false ao segmentar o AGP 8.0+ e use o AGP 7.3+ com o Kotlin 2.0 para o SDK do Consumidor 3.0+. Consulte /maps/documentation/mobility/journey-sharing/on-demand/android/migration-guide-v3.

SDK do Consumidor para Android: recursos legados e descontinuados

  • ConsumerTrip, ConsumerTripCallback, ConsumerTripManager, ConsumerTripOptions: desativado desde 15/09/2023. Substituição: TripModel, TripModelCallback, TripModelManager, TripModelOptions. Consulte o guia de migração.
  • Classe Trip e anotações Trip.TripStatus / Trip.TripType (e TripInfo#getTripStatus(), TripInfo#getTripType(), TripModelCallback#onTripStatusUpdated): descontinuadas desde 15/09/2023. Substituição: TripInfo.TripStatus / TripInfo.TripType, TripInfo#getCurrentTripStatus(), TripInfo#getCurrentTripType(), TripModelCallback#onTripStatusUpdate. Consulte o guia de migração.
  • MarkerStyleOptions e PolylineStyleOptions: desativados desde 30/11/2021. Substituição: MarkerOptions e PolylineOptions (compartilhados com o SDK do Maps). Sintoma: o SDK do Consumidor aplica o próprio estilo padrão por tipo de marcador ou polilinha, não os padrões de MarkerOptions. Consulte o guia de migração.
  • Canal de distribuição de repositório particular: descontinuado. Substituição: repositório Maven do Google (versões 2.1.0 e mais recentes). Consulte o guia de migração.

O que você pode fazer com o SDK do Consumidor para Android

Consulte os guias vinculados abaixo para cada tarefa ou compare os produtos no Explorador de recursos.