Quando você usa o compartilhamento de jornadas do Fleet Engine para viagens sob demanda, os consumidores pode acompanhar o andamento de um pedido, de uma viagem ou de outro serviço que você oferece.
O que é compartilhamento de jornada?
O compartilhamento de jornadas é um recurso do Fleet Engine para viagens sob demanda, usado para o SDK do consumidor. Ele fornece interfaces que modelam os dados das viagens e os acompanham sessões no Fleet Engine e oferece aulas para criar uma experiência exibição baseada em mapa para informações de viagem aos usuários do consumidor. Você integra no seu app e defina os perfis de função apropriados no Fleet Engine para oferecer suporte ao uso do compartilhamento de jornadas pelos consumidores.
O compartilhamento de jornada fornece APIs específicas da plataforma para que você possa criar a jornada o compartilhamento nativo nos seus aplicativos. O SDK do consumidor está disponível para seguintes plataformas:
Por que usar o compartilhamento de jornadas?
Ao integrar o compartilhamento de viagens aos seus aplicativos de viagens sob demanda, você uma experiência abrangente de monitoramento veicular, com informações quase em tempo real atualizações de local e posições capturadas na via. Seu os consumidores podem ver o trajeto do veículo sobreposto em um mapa, incluindo detalhes do progresso que ajudam a entender onde está a viagem ou entrega.
O que é possível fazer com o compartilhamento da jornada?
É possível usar informações do SDK do Driver e do Fleet Engine para criar Visualizações do SDK para dispositivos móveis e respostas de serviços da Web que fornecem os seguintes recursos:
Personalize a interface do mapa de acordo com suas necessidades de branding.
A localização atual do veículo enquanto ele percorre o trajeto, com sua posição é atualizada periodicamente.
O horário previsto de chegada (HEC) para os locais de embarque e desembarque.
A distância restante.
Trânsito em tempo real no trajeto.
Como funciona o compartilhamento de jornadas
De modo geral, o compartilhamento de jornadas depende dos seguintes mecanismos:
- Papéis do usuário apropriados do Fleet Engine para que os usuários autenticados do app possam buscar a viagem associada ao pedido.
- Uma associação entre o consumidor e a viagem, fornecida pelo seu ou do sistema de back-end.
- O SDK para o consumidor
TripModeleJourneySharingSession, classes do SDK que modelar dados de viagens e compartilhar sessões de viagem no aplicativo para o consumidor.
O SDK do consumidor também fornece outras interfaces e classes para que você possa criando uma interface de usuário com mapeamento para o app, para que os consumidores uma experiência avançada no aplicativo, com detalhes como trânsito, marcadores de mapa, HEC e dados de trajeto.
Esta tabela mostra o fluxo de uma jornada compartilhada.
| 1 | O app do consumidor solicita uma viagem. | O servidor de back-end recebe uma solicitação de viagem sob demanda e faz
seguintes:
|
| 2 | O motorista aceita a viagem | O aplicativo do motorista recebe o ID e as informações da viagem, e o motorista aceita a viagem. |
| 3 | O app para o consumidor solicita acesso à jornada | O app para o consumidor recebe o ID da viagem do back-end e para iniciar o compartilhamento da jornada. |
| 4 | O motorista inicia a viagem | Quando o motorista usa o app do motorista para indicar que a viagem foi concluída. for iniciado, o app notifica o servidor de back-end pelo SDK do Driver. Por exemplo, quando o motorista é prestes a sair do restaurante ou dirigir até o local de embarque. |
| 5 | O Fleet Engine começa a compartilhar a jornada | O Fleet Engine começa a rastrear a jornada e compartilhar o progresso com o aplicativo para o consumidor. |
| 6 | O app para o consumidor mostra a jornada | O aplicativo do consumidor notifica o consumidor e começa a exibir a jornada até eles, atualizando a jornada à medida que ela avança. |
| 7 | A viagem foi concluída ou cancelada | Quando o motorista cancela ou conclui a viagem, o app do motorista desativa o rastreamento de localização, e o servidor de back-end informa ao Fleet Engine para marcar a viagem como cancelada ou concluída. |
| 8 | O app para consumidores interrompe o compartilhamento da jornada | A jornada é exibida como cancelada ou concluída. |
| 9 | O processo se repete para a próxima viagem | Uma nova viagem é criada e o processo se repete. |
Como usar o compartilhamento de jornadas
Selecione sua plataforma para saber como começar a compartilhar jornadas.
Android
| 1 | Configurar o SDK do consumidor no Android | Para compartilhar jornadas de viagens sob demanda no seu app, configure o SDK do consumidor. Para mais informações, consulte Instalar o SDK do consumidor do Android. |
| 2 | Configurar a interface visual de compartilhamento da jornada | Defina um mapa e adicione suporte a mapas vetoriais para configurar a interface da sua jornada. Para mais informações, consulte Configurar um mapa. |
| 3 | Compartilhar uma jornada | Acompanhe uma viagem para compartilhar o local do veículo apropriado com seu consumidor. Para mais informações, consulte Seguir uma viagem. |
| 5 | Atualizar o progresso da viagem e processar erros de viagem | Atualize os detalhes da viagem, como a distância e o horário previsto de chegada, e resolva todos os erros ocorridos durante essa jornada. Para mais informações, consulte Atualizar o andamento da viagem e Como lidar com erros de viagem. |
| 5 | Parar de compartilhar quando uma viagem terminar | Pare de seguir uma viagem para deixar de compartilhar o local de um veículo com seu consumidor. Para mais informações, consulte Parar de seguir uma viagem. |
iOS
| 1 | Configurar o SDK do consumidor no iOS | Para compartilhar jornadas de viagens sob demanda no seu app, configure o SDK do consumidor. Para mais informações, consulte Instalar o SDK do consumidor para iOS. |
| 2 | Configurar a interface visual de compartilhamento da jornada | Inicialize a visualização de mapa e processe eventos para configurar a interface da sua jornada. Para mais informações, consulte Configurar um mapa. |
| 3 | Compartilhar uma jornada | Acompanhe uma viagem para compartilhar o local do veículo apropriado com seu consumidor. Para mais informações, consulte Seguir uma viagem. |
| 5 | Atualizar o progresso da viagem e processar erros de viagem | Atualize os detalhes da viagem, como a distância e o horário previsto de chegada, e resolva todos os erros ocorridos durante essa jornada. Para mais informações, consulte Atualizar o andamento da viagem e Como lidar com erros de viagem. |
| 5 | Parar de compartilhar quando uma viagem terminar | Pare de seguir uma viagem para deixar de compartilhar o local de um veículo com seu consumidor.Para mais informações, consulte Parar de seguir uma viagem. |
JavaScript
| 1 | Configurar o compartilhamento da jornada em JavaScript | Para compartilhar jornadas de viagens sob demanda no seu app, configure o SDK do consumidor. Para mais informações, consulte Configurar o SDK do consumidor JavaScript. |
| 2 | Carregar e personalizar o mapa de compartilhamento da jornada | Ative a API Maps JavaScript e defina a autorização para configurar a interface da sua jornada. Para mais informações, consulte Configurar um mapa. |
| 3 | Compartilhar uma jornada | Acompanhe uma viagem para compartilhar o local do veículo apropriado com seu consumidor. Para mais informações, consulte Seguir uma viagem. |
| 5 | Atualizar o progresso da viagem e processar erros de viagem | Atualize os detalhes da viagem, como a distância e o horário previsto de chegada, e resolva todos os erros ocorridos durante essa jornada. Para mais informações, consulte Atualizar e acompanhar o andamento da viagem e Como lidar com erros de viagem. |
| 5 | Parar de compartilhar quando uma viagem terminar | Pare de seguir uma viagem para deixar de compartilhar o local de um veículo com seu consumidor. Para mais informações, consulte Parar o compartilhamento da viagem. |
Componentes
Esta seção resume dois componentes necessários para compartilhar uma jornada:
Também é possível personalizar sua experiência de compartilhamento da jornada com esses componentes:
Coletor de tokens de autenticação
Para controlar o acesso aos dados de local armazenados no Fleet Engine, faça o seguintes:
Implementar um serviço de criação de JSON Web Token (JWT) para o Fleet Engine no seu servidor.
Implementar um coletor de tokens de autenticação nos apps da Web ou para dispositivos móveis para autenticar o acesso aos dados de localização.
Para mais informações, consulte o guia de configuração para Android, iOS ou JavaScript.
Visualização de mapa e rastreadores de viagem
O compartilhamento da jornada inclui componentes para visualização de veículos e waypoints, além de feeds de dados brutos para HEC de um motorista. ou a distância restante.
A tabela a seguir descreve esses componentes:
| Componente | Descrição |
|---|---|
| Visualização de mapa do compartilhamento da jornada | A visualização de mapa gerencia o ciclo de vida de uma jornada, mostrando waypoints para a localização dos veículos conforme a viagem avança. Se o trajeto de um veículo for conhecido, a visualização de mapa atualizará o trajeto do veículo polilinha para indicar o progresso do veículo ao longo de seu trajeto. |
| Provedor de localização de viagens em JavaScript | Em apps da Web JavaScript, o provedor de local da viagem alimenta o local.
informações para objetos rastreados no mapa da jornada compartilhada. Para mais
informações, consulte
Instanciar um provedor de locais de viagem
Você pode usar o provedor de locais da viagem para rastrear os seguintes detalhes de uma
viagem:
|
Objetos de local rastreados
O provedor de localização rastreia a localização de objetos como waypoints e veículos, descritos na tabela a seguir.
| Local monitorado | Descrição |
|---|---|
| Local de retirada | O local de embarque é o local onde uma jornada começa. Marca o local de retirada. |
| Local de destino | O local de destino é o local onde uma jornada termina. Marca o local de desembarque. |
| Localização do waypoint | O local do ponto de referência é qualquer local intermediário ao longo da rota de um da sua jornada monitorada. Tecnicamente, waypoints podem incluir locais de embarque e desembarque, os waypoints geralmente se referem a valores intermediários paradas ao longo do trajeto. Por exemplo, as paradas entre o embarque e o destino. Os locais em um trajeto de entrega são locais de waypoint. Para mais informações, consulte Pontos de referência da viagem na documentação do Fleet Engine. |
| Localização do veículo | A localização do veículo é a localização informada de um veículo. Para mais mais informações, consulte Localização do veículo na documentação do Fleet Engine. |
Estilizar seus mapas
Os estilos de marcador e polilinha determinam a aparência do objetos de local rastreados no mapa. Você pode usar opções de estilo personalizadas para alterar o estilo padrão de acordo com o estilo do seu aplicativo da Web.
Controlar a visibilidade dos locais rastreados
Os provedores de localização predefinidos no Fleet Engine seguem estas regras de visibilidade para objetos de local rastreados no mapa. Se você criar uma tabela provedor de localização, você pode alterar as regras de visibilidade.
Os veículos ficam visíveis apenas quando a viagem está em andamento: uma viagem. está visível a partir do momento em que é atribuído a uma viagem até o o horário de desembarque. Se a viagem for cancelada, o veículo ficará mais visível.
Todos os outros marcadores de local estão sempre visíveis: todos os outros marcadores de local. para origem, destino e waypoints são sempre mostrados no mapa. Para por exemplo, um local de desembarque do compartilhamento de jornada ou uma entrega de remessa local é sempre mostrado no mapa, independentemente do estado viagem ou entrega.
A seguir
Consulte a documentação da plataforma em que você quer compartilhar jornadas: