Para receber atualizações de dados de viagem do Google Maps ou do Waze, configure seu back-end usando uma das seguintes opções:
- Um método de pull usando a API Navigation Connect ou
- Um método push orientado a eventos que usa o Google Cloud Pub/Sub.
Opção 1: usar a API Navigation Connect
Para buscar manualmente o status mais recente da viagem, chame o método GetTrip com o ID exclusivo da viagem.
O exemplo a seguir mostra como chamar a API na linha de comando usando o Application Default Credentials (ADC) para autorizar a solicitação entre servidores.
#!/bin/bash
gcloud auth application-default login
access_token="$(gcloud auth application-default print-access-token)"
# Call the GetTrip method
curl -X GET "https://navigationconnect.googleapis.com/v1/projects/PROJECT_ID/trips/TRIP_ID" \
-H "Authorization: Bearer ${access_token}" \
-H "Content-Type: application/json"
Personalizar formatos de polilinha
Se você tiver ativado o relatório de trajeto restante durante a criação de viagens, poderá personalizar a representação da polilinha do trajeto restante retornada ao chamar o método GetTrip.
Para escolher um formato para a polilinha, inclua o parâmetro routePolylineFormat na sua solicitação. Os formatos compatíveis incluem:
ENCODED: uma string de polilinha codificada padrão (5 marcadores decimais).S2ENCODED: uma S2Polyline codificada.GEO_JSON: um formato LineString do GeoJSON.
Opção 2: usar o Google Cloud Pub/Sub
Para receber atualizações regulares de viagens, inscreva-se em um tópico do Google Cloud Pub/Sub. Depois que o motorista autoriza, o Navigation Connect envia atualizações diretamente para seu tópico.
Para uma introdução às mensagens, consulte o Guia de início rápido do Pub/Sub.
As seções a seguir descrevem como usar o Google Cloud Pub/Sub para receber dados de uma sessão de navegação com o Google Maps ou o Waze.
1. Criar um tópico
Crie um tópico chamado exatamente navigation_connect_trip_notifications no seu
projeto do Google Cloud, da seguinte maneira:
- Ative a API Pub/Sub.
- Acesse a página de tópicos do Pub/Sub no console do Google Cloud.
- Clique em Criar tópico.
Insira
navigation_connect_trip_notificationsno campo ID do tópico.Clique em Criar.
O console exibe o nome completo do tópico como projects/project-number/topics/navigation_connect_trip_notifications, em que project-number é o número exclusivo do projeto.
2. Conceder permissão de publicação à conta de serviço do Navigation Connect
O Google usa uma conta de serviço para publicar atualizações de viagens em tópicos do Google Cloud Pub/Sub. Para receber atualizações no seu tópico, conceda a permissão projects.topics.publish
para este tópico à seguinte conta de serviço:
geo-navigation-connect-pubsub@system.gserviceaccount.com.
Para mais informações, consulte a documentação do Pub/Sub sobre controle de acesso.
3. Integrar com seu back-end
Para processar atualizações, escreva um aplicativo do lado do servidor que autentique e se inscreva no seu tópico. Use as bibliotecas de cliente do Pub/Sub para simplificar o desenvolvimento. Para testes, também é possível usar a CLI gcloud e o Console do Google.
4. Testar sua assinatura
Verifique sua configuração usando a CLI gcloud ou o console do Google Cloud.
CLI da gcloud
Extraia mensagens de uma assinatura (por exemplo, my-sub) usando o seguinte
comando:
gcloud pubsub subscriptions pull my-sub --auto-ack
Console do Google Cloud
No console do Google Cloud, siga estas etapas:
- Abra a página Assinaturas.
- Selecione sua assinatura e clique na guia Mensagens.
- Clique em Pull.
A seguir
Depois de começar a receber dados de viagens, analise-os para usar nos seus sistemas e apps.