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:
- Você precisa do compartilhamento de trajeto para viagens on demand em um app iOS. Use o SDK do Consumidor para iOS.
- Você precisa compartilhar trajetos em uma página da Web ou rastrear tarefas programadas, como entregas. Use o SDK do Consumidor para JavaScript.
- Você precisa informar a localização do motorista e o progresso da viagem pelo app Android do motorista. Use o SDK do Driver para Android.
SDK do Consumidor para Android: configuração
- Autenticação: JSON Web Token (JWT), chave de API
- Ative também: serviço do Fleet Engine, SDK do Maps para Android
- Começar: configurar o SDK do Consumidor para Android
- Referência: SDK do Consumidor para Android
- Políticas: Políticas do SDK do Consumidor para Android
- Notas da versão: Notas da versão do SDK do Consumidor para Android
Pacotes oficiais do SDK do Consumidor para Android:
- maven:
com.google.android.libraries.mapsplatform.transportation:transportation-consumer
SDK do Consumidor para Android: produtos relacionados
- Geralmente usado com: serviço do Fleet Engine, SDK do Driver para Android, SDK do Maps para Android
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-mapsdefinida explicitamente comtransportation-consumerno 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, emonDestroy()ou quando a viagem forCOMPLETE. 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: chameConsumerApi.getInstance()primeiro e verifique oTaskretornado 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=falseao 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
Tripe anotaçõesTrip.TripStatus/Trip.TripType(eTripInfo#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. MarkerStyleOptionsePolylineStyleOptions: desativados desde 30/11/2021. Substituição:MarkerOptionsePolylineOptions(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 deMarkerOptions. 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.
- Adicione um mapa interativo e personalizável que acompanha o progresso de uma viagem do Fleet Engine para um app para dispositivos móveis.
- Adicione uma polilinha de trajeto que rastreia uma viagem do Fleet Engine a um mapa em uma página da Web ou um app para dispositivos móveis.
- Atualize o progresso da viagem ao longo de um trajeto em um mapa em uma página da Web ou em um app para dispositivos móveis para uma viagem do Fleet Engine.
- Mude o estilo de vias, polilinhas e polígonos em um mapa que acompanha o progresso de uma viagem do Fleet Engine.
- Mostrar ou ocultar elementos em um mapa que acompanha o progresso de uma viagem do Fleet Engine.
- Mude o estilo dos ícones e dos rótulos de texto em um mapa que acompanha o progresso de uma viagem do Fleet Engine.
- Aplique estilos de mapa diferentes a níveis de zoom distintos em um mapa que acompanha o progresso de uma viagem do Fleet Engine.
- Mudar a densidade de lugares em um mapa que acompanha o progresso de uma viagem do Fleet Engine. Experimental Observação: o suporte à Estilização de Mapas Baseada na Nuvem no SDK para Consumidores está em disponibilidade geral, enquanto o controle de densidade de PDIs é um recurso experimental da Estilização de Mapas Baseada na Nuvem (compatível apenas com estilos de mapa claros).
- Mudar o estilo dos edifícios em um mapa que acompanha o progresso de uma viagem do Fleet Engine. Experimental Observação: o suporte à Estilização de Mapas Baseada na Nuvem no SDK do Consumidor está em disponibilidade geral, enquanto a personalização do estilo de construção em 3D e de pegada é um recurso experimental da Estilização de Mapas Baseada na Nuvem (compatível apenas com estilos de mapa claros).
- Mudar o estilo dos pontos de referência em um mapa que acompanha o progresso de uma viagem do Fleet Engine. Experimental Observação: o suporte à Estilização de Mapas Baseada na Nuvem no SDK para Consumidores está em disponibilidade geral, enquanto a personalização de ícones de pontos de referência é um recurso experimental da Estilização de Mapas Baseada na Nuvem (compatível apenas com estilos de mapa claros).
- Personalize um marcador em um mapa que acompanha o progresso de uma viagem do Fleet Engine.
- Personalize a polilinha do trajeto em um mapa que acompanha o progresso de uma viagem do Fleet Engine.