Objetivo

Este documento descreve o procedimento para ativação das APIs do Google Maps necessárias para utilizar a Roteirização dos planejamentos de Fiscalização do BRC, bem como os possíveis custos associados ao seu uso.

As APIs contempladas são:

• Google Maps JavaScript API
• Places API
• Geocoding API
• Directions API
• Distance Matrix API

Pré-requisitos

Para utilização das APIs é obrigatório:

1. Criar ou selecionar um projeto no Google Cloud.
2. Vincular o projeto a uma conta de faturamento válida.
3. Gerar uma chave de API (API Key).
4. Aplicar restrições de segurança à chave.

Observação: O Google exige cadastro de cartão de crédito mesmo para uso dentro do limite gratuito.

Procedimento de Ativação

Criação ou seleção de projeto

• Acessar o Google Cloud Console: https://console.cloud.google.com/welcome
• Criar novo projeto ou selecionar projeto existente.

Ativação de faturamento

• Vincular o projeto a uma conta de faturamento ativa.

Habilitação das APIs

No menu “APIs & Services” → “Library”, habilitar individualmente:

• Google Maps JavaScript API
• Places API
• Geocoding API
• Directions API
• Distance Matrix API

Geração da API Key

• Acessar “APIs & Services” → “Credentials”
• Criar nova “API Key”
• Copiar a “API Key e acessar no BRC Interno > Parâmetros > Fiscalização, e então, preencher o campo ‘Chave Google Maps API’

Configuração de segurança (obrigatória)

Recomenda-se:

• Restrição por domínio (HTTP referrer) para aplicações web.
• Restrição por IP para integrações server-side.
• Limitação da chave apenas às APIs efetivamente utilizadas.

Modelo de Custos

O Google Maps Platform opera sob modelo de cobrança por consumo (pay-as-you-go).

Crédito mensal gratuito

O Google disponibiliza um crédito mensal gratuito por conta de faturamento.
Caso o consumo permaneça dentro desse limite, não há cobrança.

Se o consumo exceder o crédito mensal, o valor excedente é faturado automaticamente.

Como ocorre a cobrança

A cobrança é baseada em:

• Número de requisições realizadas
• Tipo de API utilizada
• Complexidade da operação (exemplo: rotas simples vs. múltiplos destinos)

Cada API possui uma métrica específica de cobrança.

Exemplos práticos:

• Maps JavaScript API: cobrança por carregamento de mapa.
• Places API: cobrança por requisição de busca ou autocomplete.
• Geocoding API: cobrança por conversão de endereço em coordenadas (ou vice-versa).
• Directions API: cobrança por cálculo de rota.
• Distance Matrix API: cobrança por elemento calculado (origem × destino).

Fatores que impactam diretamente o custo

O custo pode aumentar conforme:

• Alto volume de acessos simultâneos.
• Uso frequente de autocomplete de endereços.
• Cálculo recorrente de rotas em tempo real.
• Grande volume de consultas automáticas via backend.

Controle de custos

Para evitar cobranças inesperadas, recomenda-se:

1. Definir limites de quota no Google Cloud.
2. Configurar alertas de orçamento.
3. Monitorar relatórios de uso mensalmente.
4. Restringir a chave para evitar uso indevido.

Responsabilidade de Custos

Os custos gerados pelo uso das APIs do Google Maps são faturados diretamente na conta Google Cloud vinculada ao projeto.

A responsabilidade pelo pagamento é do titular da conta de faturamento associada.

Considerações Finais

• A ativação das APIs é indispensável para funcionamento das funcionalidades de mapa, geolocalização, rotas e cálculo de distâncias.
• A não configuração adequada de restrições pode gerar uso indevido e custos inesperados.
• Recomenda-se monitoramento contínuo do consumo.