Criar rotas usando tokens de ponto de navegação

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

Os tokens de ponto de navegação permitem enviar informações contextuais importantes sobre um destino ao SDK Navigation para Android (link em inglês) para melhorar o roteamento e a experiência do motorista. Isso é útil em casos como entrega de comida ou transporte por aplicativo, em que o ponto de coleta ou desembarque pode ser ambíguo sem a entrada do usuário.

Esta imagem mostra exemplos de um app de carona compartilhada para consumidores em que o ponto de navegação é selecionado e um app para motoristas usando o SDK Navigation para Android para traçar a rota do motorista com precisão.

Exemplos de apps para consumidores e motoristas

Para criar e transmitir um token de ponto de navegação, use o endpoint 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 endpoint Destinations da API Geocoding. Em seguida, transmita o token do ponto de navegação, que contém as coordenadas de destino e informações contextuais, para o SDK Navigation para Android, em que um ponto de parada é criado para um roteamento preciso. O destino será destacado para o motorista pelo SDK Navigation com base no lugar associado ao token.

Como um token de ponto de navegação é criado e enviado ao SDK Navigation para roteamento

Por exemplo, imagine um caso de uso de carona compartilhada, 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 roteamento até o destino.

Quando um consumidor abre o app dele, o app chama o endpoint Destinations da API Geocoding e oferece 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 token do ponto de navegação da resposta é transmitido para um app de motorista para dispositivos móveis que usa o SDK Navigation para Android e cria um Waypoint para direcionar o motorista ao ponto de coleta correto. Consulte a documentação do SDK do Navigation para Android sobre pontos de referência de navegação.