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 ou ao SDK Navigation para iOS, melhorando 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 embarque ou desembarque pode ser ambíguo sem a entrada do usuário.

Esta imagem mostra exemplos de um app de transporte por aplicativo para o consumidor em que o ponto de navegação é selecionado e um app de motorista que usa o SDK Navigation para Android para rotear o motorista com precisão.

Exemplos de apps para consumidores e motoristas

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 de ponto de navegação, que contém as coordenadas de destino e informações contextuais, para o SDK Navigation para Android ou o SDK Navigation para iOS, em que um waypoint é criado para um roteamento preciso. O destino será destacado para o motorista pelo SDK Navigation com base no lugar ao qual o token está associado.

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

Por exemplo, imagine um caso de uso de transporte por aplicativo, em que há um app para o consumidor reservar a viagem e um segundo app para o motorista receber a notificação da viagem e as informações de roteamento para o destino.

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 token de ponto de navegação da resposta é transmitido a um app de motorista para dispositivos móveis que usa o SDK Navigation para Android ou iOS para criar um waypoint para rotear o motorista até o ponto de embarque correto.