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 um OAuth para fazer uma solicitação de API autenticada.

Para proteger os produtos da Plataforma Google Maps contra uso não autorizado, as chamadas de API precisam incluir um token OAuth.

Criar um token OAuth

O Navigation Connect é compatível com o uso do OAuth 2.0 para autenticação. O Google permite o uso do OAuth 2.0 para diversas finalidades, como em servidores da Web.

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

Sobre o OAuth

Há muitas maneiras de criar e gerenciar tokens de acesso com OAuth com base no seu ambiente de implantação.

Por exemplo, o sistema do Google OAuth 2.0 aceita interações de servidor para servidor, como as que ocorrem entre seu aplicativo e um serviço do Google. Para esse cenário, você precisa de uma conta de serviço, que pertence ao aplicativo e não a um usuário final individual. Seu aplicativo chama as APIs do Google em nome da conta de serviço, assim os usuários não são diretamente envolvidos. Para mais informações sobre métodos de autenticação, consulte Métodos de autenticação no Google.

Como alternativa, você pode usar o Navigation Connect como parte de um app para dispositivos móveis Android ou iOS. Para informações gerais sobre como usar o OAuth com o Navigation Connect, incluindo como gerenciar tokens de acesso para diferentes ambientes de implantação, consulte Como usar o OAuth 2.0 para acessar as APIs do Google.

Sobre os escopos do OAuth

Para usar o OAuth com o Navigation Connect, o token OAuth precisa receber o escopo:

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

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

Se você quiser testar o Navigation Connect usando um token OAuth, mas não tiver um ambiente configurado para gerar tokens, use o procedimento desta seção para fazer a chamada.

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

Pré-requisitos

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

  1. Instale e inicialize a gcloud CLI.

  2. Execute o seguinte comando gcloud na sua máquina local para criar o arquivo de credenciais:

    gcloud auth application-default login
  3. Uma tela de login será exibida. Após o login, suas credenciais são armazenadas 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.

O exemplo a seguir faz uma chamada para o Navigation Connect usando um token OAuth.

  1. Edite o campo PROJECT_ID para transmitir o ID do seu projeto na nuvem do Google.

    Edite também o seguinte, conforme aplicável:

    • ANDROID_APP_ID: o nome do pacote Android do seu app.
    • IOS_APP_ID: o ID do pacote iOS do seu app.
    #!/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. Clique no ícone de cópia no exemplo de código, Selecione o ícone de cópia., para copiar o comando curl.
  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 inteiro longo exclusivo do projeto.
  • TRIP_ID: o ID da viagem gerado pelo seu back-end no formato UUIDv4.
  • BASE64_ENCODED_TRIP_TOKEN: o token autenticado retornado pelo método createTrip. Transmita esse token ao seu app para dispositivos móveis 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 as credenciais do usuário final não são compatíveis com essa API, consulte Solução de problemas de configuração do ADC.

A seguir

A próxima etapa para configurar a API Navigation Connect é configurar suas contas de serviço para ativar a comunicação segura de servidor para servidor entre sua infraestrutura de back-end e o Google Maps e o Waze.

Configurar sua conta de serviço