Configurar o Navigation Connect

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

Este documento descreve as etapas necessárias para começar a usar o Navigation Connect.

Verifique se você atende aos pré-requisitos.

Ative a API no seu projeto na nuvem do Google Cloud.

Configure o OAuth para fazer uma solicitação de API autenticada.

Os produtos da Plataforma Google Maps exigem que as chamadas de API incluam um token OAuth para evitar o uso não autorizado.

Criar um token OAuth

O Navigation Connect oferece suporte ao OAuth 2.0 para autenticação. O Google oferece suporte a cenários comuns do OAuth 2.0, como os de um servidor da Web.

Este documento descreve como transmitir um token do OAuth para uma chamada do Navigation Connect no seu ambiente de desenvolvimento. Para mais informações sobre como usar o OAuth em um ambiente de produção, consulte Métodos de autenticação no Google.

É possível chamar as APIs do Google Maps diretamente fazendo solicitações de API ao servidor ou usar bibliotecas de cliente para simplificar seu código. O Google Maps oferece bibliotecas de cliente para Go, Java, Node.js e Python. Para mais informações, consulte Bibliotecas de cliente do Navigation Connect.

Visão geral do OAuth

É possível criar e gerenciar tokens de acesso com o OAuth de várias maneiras, dependendo do seu ambiente de implantação.

É possível usar o OAuth 2.0 para interações de servidor para servidor entre seu aplicativo e um serviço do Google. Nesse cenário, você usa uma conta de serviço associada ao aplicativo, e não a um usuário individual. É possível fazer solicitações de API usando a conta de serviço sem envolver os usuários diretamente. Para mais informações sobre métodos de autenticação, consulte Métodos de autenticação no Google.

Como alternativa, é possível integrar o Navigation Connect a um app móvel Android ou iOS. Para mais informações sobre como usar o OAuth e gerenciar tokens de acesso em diferentes ambientes de implantação, consulte Como usar o OAuth 2.0 para acessar as APIs do Google.

Escopos do OAuth

Para usar o OAuth com o Navigation Connect, atribua ao token OAuth o seguinte escopo:

https://www.googleapis.com/auth/cloud-platform

Exemplo: testar chamadas da API REST no ambiente de desenvolvimento local

Se você não tiver um ambiente que gere tokens e quiser testar o Navigation Connect com um token OAuth, use o procedimento desta seção.

Este exemplo descreve como usar o token do OAuth fornecido pelo Application Default Credentials (ADC) para fazer a chamada. Para mais informações sobre como usar o ADC para chamar APIs do Google com bibliotecas de cliente, consulte Autenticar usando bibliotecas de cliente.

Use o procedimento REST a seguir apenas para desenvolvimento ou teste, não para produção.

Pré-requisitos

Antes de fazer uma solicitação REST usando o ADC, use a CLI gcloud para fornecer credenciais ao ADC:

  1. Instale e inicialize a CLI gcloud. Para mais informações, consulte Instalar a CLI gcloud.

  2. Faça a autenticação com a gcloud CLI:

    gcloud auth application-default login

  3. Conclua o processo de login para salvar suas credenciais no arquivo de credenciais local usado pelo ADC.

Para mais informações, consulte Configurar o ADC para um ambiente de desenvolvimento local.

Fazer uma solicitação REST

Neste exemplo, você transmite dois cabeçalhos de solicitação:

  • Transmita o token OAuth no cabeçalho Authorization usando o seguinte comando para gerar o token:

    gcloud auth application-default print-access-token

    O token retornado tem um escopo de https://www.googleapis.com/auth/cloud-platform.

  • Transmita o ID ou o nome do seu projeto na nuvem do Google Cloud com o faturamento ativado no cabeçalho X-Goog-User-Project.

Para chamar o Navigation Connect usando um token OAuth, siga estas etapas:

  1. No exemplo de código a seguir, substitua os marcadores de posição pelos seus valores:

    • PROJECT_ID: o ID do projeto do Google Cloud
    • ANDROID_APP_ID: o nome do pacote Android do app, se aplicável.
    • IOS_APP_ID: o ID do pacote iOS do seu app, se aplicável
    #!/bin/bash
trip_id="$(uuidgen)"
access_token="$(gcloud auth application-default print-access-token)"
curl -X POST "https://navigationconnect.googleapis.com/v1/projects/PROJECT_ID/trips?tripId=${trip_id}" \
-H "Authorization: Bearer ${access_token}" \
-H "Content-Type: application/json" \
-d '{
"androidAppId": "ANDROID_APP_ID",
"iosAppId": "IOS_APP_ID",
}'

  2. Para copiar o comando curl, clique em Copiar no exemplo de código.

  3. Cole o comando em uma janela de terminal e execute-o.

A resposta é um objeto JSON:

{
  "name": "projects/PROJECT_NUMBER/trips/TRIP_ID",
  "authToken": {
    "token": "BASE64_ENCODED_TRIP_TOKEN",
    "expireTime": "2026-03-06T11:09:47.476942Z"
  },
  "state": "NEW",
  "execution": {
    "traveledDistanceMeters": 0,
    "stopAddedInRoute": false
  },
  "createTime": "2026-03-05T23:09:50.768959Z",
  "updateTime": "2026-03-05T23:09:50.768959Z",
}

Essa resposta inclui os seguintes valores:

  • PROJECT_NUMBER: o identificador exclusivo de número inteiro longo do projeto.
  • TRIP_ID: o ID de viagem UUIDv4 gerado pelo seu back-end.
  • BASE64_ENCODED_TRIP_TOKEN: o token autenticado que o método createTrip retorna para iniciar a navegação guiada rastreada no Google Maps ou no Waze.

Solução de problemas

Se a sua solicitação retornar uma mensagem de erro informando que essa API não é compatível com credenciais do usuário final, consulte Solução de problemas de configuração do ADC.

A seguir

Em seguida, configure suas contas de serviço para a API Navigation Connect e ofereça suporte à comunicação segura de servidor para servidor entre sua infraestrutura de back-end, o Google Maps e o Waze.

Configurar sua conta de serviço