Este documento descreve as etapas necessárias para começar a usar o Navigation Connect.
Pré-requisitos
Neste guia, mostramos como configurar sua Conta do Google Cloud e seu projeto na nuvem do Google Cloud com o faturamento ativado. Também é importante saber como você é cobrado pelo uso da API Navigation Connect.
- Analise o faturamento e o custo de uso em Uso e faturamento do Navigation Connect.
-
Verifique se você tem uma Conta do Google Cloud.
Faça login no console do Google Cloud -
Verifique se você tem um projeto do Google Cloud com o faturamento ativado.
Acesse a página "Faturamento"- Selecione o projeto para abrir a página Faturamento.
-
Na página Faturamento:
- Se o faturamento já estiver ativado para o projeto selecionado e você tiver apenas uma conta de faturamento, a página Faturamento será aberta.
- Se você tiver várias contas de faturamento, selecione Acessar a conta de faturamento vinculada para ver os detalhes sobre a conta de faturamento associada ao projeto.
- Se uma conta de faturamento existir, mas não estiver associada ao projeto, será solicitado que você vincule uma conta de faturamento ao projeto.
- Se não houver uma conta de faturamento ou se você quiser criar uma nova, selecione Gerenciar contas de faturamento para criar uma nova conta de faturamento. Para mais informações, consulte Criar uma nova conta do Cloud Billing de autoatendimento.
Ativar a API e verificar o app
Este guia descreve o processo para ativar a API Navigation Connect e verificar seu app no console do Google Cloud, o que permite que ele interaja com segurança com o Google Maps e o Waze. Você precisa concluir esse processo para usar a API Navigation Connect.
1. Ativar a API Navigation Connect
Use o console do Google Cloud ou o comando gcloud para ativar a API Navigation Connect no seu projeto na nuvem do Google Cloud.
Para ativar a API, siga estas etapas:
Console
Abra a página do produto no console do Google Cloud:
Ativar a API Navigation ConnectClique no botão Ativar.
gcloud
gcloud services enable \ --project "PROJECT" \ "navigationconnect.googleapis.com"
Saiba mais sobre o SDK Google Cloud, a instalação do SDK Cloud e os seguintes comandos:
2. Iniciar o processo de verificação de apps
Depois de ativar a API, você precisa verificar seu app para ativar a API Navigation Connect. A ativação da API por si só não concede acesso. É necessário fornecer detalhes da empresa e do app para análise antes de usar a API Navigation Connect.
Para iniciar o processo de verificação, use um dos seguintes métodos:
-
Marketplace de APIs:
- No API Marketplace, encontre o card API Navigation Connect.
- Clique no ícone azul Verificação obrigatória para iniciar o fluxo de verificação.
-
Chaves e credenciais no console do Google Cloud:
- No console do Google Cloud, acesse a página Chaves e credenciais.
- Clique em Chaves e credenciais do Navigation Connect.
- No banner, clique em Iniciar verificação.
3. Fornecer detalhes do app, da coleta de dados e da privacidade
A tabela a seguir descreve os detalhes que você precisa fornecer para a verificação de apps:
| Campo | Descrição |
|---|---|
| Detalhes do app Forneça os detalhes a seguir para garantir que seu app seja exibido corretamente no Google Maps e no Waze. |
|
| Nome da empresa ou do app | Insira o nome que vai aparecer para os usuários no Google Maps e no Waze. |
| Identificador do aplicativo | Informe o nome do pacote Android ou o ID do pacote iOS. |
| Link universal para iOS | Informe o link universal do iOS que permite que os usuários voltem ao seu app (disponível apenas no Waze). |
| Logotipo do app (somente Waze) | (Opcional) Faça upload de um logotipo em PNG ou JPG (de 32 x 32 a 128 x 128 pixels) para exibir o logotipo do seu app no Waze durante uma sessão de navegação. |
| Detalhes sobre coleta de dados e privacidade Insira os detalhes a seguir para garantir a transparência, a confiança do motorista e a segurança de dados. |
|
| Link da Política de Privacidade | Informe o URL da Política de Privacidade do seu app. Esse link aparece na tela de permissão. |
| Controladores de dados adicionais (opcional) | Informe o nome comercial e o link da Política de Privacidade de todos os gerenciadores de dados de terceiros, como ISV. Esses detalhes aparecem na tela de permissão. |
| Conformidade dos dados | Se o app opera nos Estados Unidos, marque a caixa de seleção Este app será usado para viagens nos Estados Unidos para garantir a conformidade com as regulamentações locais. |
4. Revisar e enviar
Revise o resumo das informações fornecidas antes de enviar o app para verificação.
-
Revise com atenção o nome, a plataforma, os IDs e os links do app.
- Marque a caixa de seleção Todas as informações estão corretas.
- Clique em Enviar.
Depois que você enviar o app para verificação, a fase de análise vai começar.
- Prazo: a verificação geralmente leva de 1 a 3 dias úteis.
- Notificação: você recebe um e-mail quando o status da verificação muda. Você também vai receber um e-mail solicitando o ID do seu perfil para pagamentos ou do desenvolvedor Android. Se você precisar de um ID de desenvolvedor Android, consulte Criar uma conta de desenvolvedor.
- Acompanhamento de status: monitore seu progresso na página Chaves e credenciais no console do Google Cloud.
- Suporte: para atualizar sua configuração após a aprovação sem afetar a produção, crie um tíquete de suporte.
Após a verificação, seu app poderá usar a API Navigation Connect para gerar tokens de viagem que autorizam o acesso a uma sessão de navegação e permitem que você receba detalhes da viagem do Google Maps e do Waze.
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 é compatível com o OAuth 2.0 para autenticação. O Google é compatível com cenários comuns do OAuth 2.0, como os de um servidor da Web.
Neste documento, descrevemos como transmitir um token 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 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, em vez de 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 para dispositivos móveis Android ou iOS. Para mais informações sobre como usar o OAuth e gerenciar tokens de acesso para 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 de 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 nesta seção.
Este exemplo descreve como usar o token 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:
Instale e inicialize a CLI
gcloud. Para mais informações, consulte Instalar a CLI gcloud.Faça a autenticação com a
gcloudCLI:gcloud auth application-default login
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 da solicitação:
Transmita o token OAuth no cabeçalho
Authorizationusando o seguinte comando para gerar o token:gcloud auth application-default print-access-tokenO token retornado tem um escopo de
https://www.googleapis.com/auth/cloud-platform.Transmita o ID ou o nome do 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:
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 seu 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", }'
Para copiar o comando
curl, clique em Copiar no exemplo de código.Cole o comando em uma janela do 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 de número inteiro longo exclusivo do projeto.
- TRIP_ID: o ID da viagem UUIDv4 que seu back-end gera.
- BASE64_ENCODED_TRIP_TOKEN: o token autenticado que o método
createTripretorna para iniciar a navegação guiada monitorada no Google Maps ou no Waze.
Solução de problemas
Se a solicitação retornar uma mensagem de erro informando que essa API não é compatível com credenciais de usuário final, consulte Resolver problemas de configuração do ADC.
A seguir
Em seguida, configure suas contas de serviço para que a API Navigation Connect ofereça suporte à comunicação segura entre servidores entre sua infraestrutura de back-end, o Google Maps e o Waze.
Configurar sua conta de serviço