Criar rotas usando tokens de ponto de navegação

Desenvolvedores do Espaço Econômico Europeu (EEE)

Com os tokens de ponto de navegação, você pode enviar informações contextuais importantes sobre um destino para o SDK do Navigation para Android, o SDK do Navigation para iOS ou a API Routes para melhorar as rotas e a experiência do motorista. Isso é útil em casos como entrega de comida ou transporte por aplicativo, em que o ponto de retirada ou entrega pode ser ambíguo sem a entrada do usuário.

Para criar e transmitir um token de ponto de navegação, use o método Destinations da API Geocoding para permitir que os usuários selecionem um local preferido em uma lista de pontos de navegação. A seleção do usuário se torna um ponto de navegação retornado pelo método Destinations da API Geocoding.

Em seguida, você pode transmitir o token do ponto de navegação, que contém as coordenadas de destino e as informações contextuais, para o SDK do Navigation para Android, o SDK do Navigation para iOS ou a API Routes, em que um waypoint é criado para um trajeto preciso. O destino será destacado para o motorista pelo SDK de navegação com base no lugar associado ao token.

Exemplo: caso de uso de transporte por aplicativo

Visão geral

Este exemplo mostra como combinar a API Geocoding, a API Routes e o SDK do Navigation para iOS ou Android para criar um app de transporte por aplicativo que calcula o preço do trajeto e direciona os motoristas para o ponto de partida correto.

Estas são as etapas gerais:

  1. Recupere um token de ponto de navegação pela API Geocoding.
  2. Use a API Routes para calcular um trajeto e codificá-lo em um token de trajeto.
  3. Transmita o token do ponto de navegação e o token do trajeto para o SDK do Navigation.
  4. Use o SDK do Navigation para direcionar o motorista ao ponto de retirada correto.

Consulte a seção Leitura adicional para ver links para a documentação relevante da API Routes, do SDK do Navigation para iOS e do SDK do Navigation para Android.

Este diagrama mostra como um app de transporte por aplicativo ou entrega usaria a API Geocoding, a API Routes e o SDK do Navigation para iOS ou Android para traçar o trajeto de um motorista usando um token de trajeto e um token de ponto de navegação:

Diagrama de caso de uso de transporte por aplicativo ou entrega
Diagrama de um caso de uso de transporte por aplicativo ou entrega

Exemplo de transporte por aplicativo

Imagine um cenário de transporte por aplicativo em que há um app para o consumidor reservar a viagem e um segundo app para o motorista receber notificações sobre a viagem e informações de trajeto até o destino.

Esta imagem mostra exemplos de um app de transporte por aplicativo para consumidores em que o ponto de navegação é selecionado e um app de motorista que usa o SDK de navegação para Android para traçar o trajeto do motorista com precisão.

Exemplos de apps para consumidores e motoristas

Quando um consumidor abre o aplicativo para o consumidor, o app chama o método Destinations da API Geocoding e oferece ao consumidor uma seleção de possíveis pontos de navegação:

Consumidor escolhendo um ponto de entrega

O usuário escolhe o ponto preferido, que é um na matriz de navigationPoints no corpo da resposta de uma solicitação SearchDestinations:

"navigationPoints": [
    {
      "navigationPointToken": <encoded navigation point token>,
      "displayName": "South Entrance",
      "travelModes": ["DRIVE"],
      "usages": ["PICKUP","DROPOFF"],
      "location": {
        "lat": 37.3940894,
        "lng": -122.0788389
      }
    }
]

O back-end do app fornece o token do ponto de navegação para a API Routes calcular o trajeto e recuperar um token de trajeto.

Por fim, o token do ponto de navegação e o token do trajeto são transmitidos para um app de motorista para dispositivos móveis que usa o SDK Navigation para iOS ou Android para criar um waypoint que direciona o motorista ao ponto de retirada correto.

Leitura adicional