Chave API Google
Introdução
A Chave API Google é uma credencial essencial para integrar serviços do Google ao Sistema. Esta chave permite o acesso a diversas funcionalidades, como geolocalização, mapas interativos e autocompletar endereços, melhorando significativamente a experiência do usuário e a precisão dos dados geográficos no sistema.
Caminho: menu Configurações > Configurações do sistema > Chaves.
Entrega de Valor
Habilita recursos avançados de geolocalização e mapeamento.
Melhora a precisão e facilidade no cadastro de endereços.
Permite visualização de clientes e infraestrutura em mapas interativos.
Otimiza processos operacionais relacionados à localização geográfica.
Cadastro da Chave API Google
Passo a passo para criação e configuração da chave API
Etapa 1 — Configuração no Google
Acesse o link: https://console.cloud.google.com/freetrial/signup/tos
Realize o login na sua conta Google (usar e-mail e senha).
Em seguida, serão carregadas as informações para iniciar o cadastro. Nessa etapa, será preciso preencher o país e concordar com os termos de serviço. Para avançar no processo, clique em Concordar e continuar.
Etapa 2 — Verificação de informações de pagamento
Dados de contato
Neste campo, adicione um nome e endereço para contato:
Clique no ícone de + e selecione o tipo de perfil Organização ou Pessoa Física.
Preencha os dados solicitados:
Se você selecionou Organização, preencha o CNPJ da empresa e clique em Confirmar.
Se você selecionou Pessoa Física, preencha o CPF e a data de nascimento e clique em Confirmar.
Verificação de informações de pagamento
- Adicione a forma de pagamento: Cartão de crédito ou débito ou Pix.
É necessário preencher as informações de pagamento com um cartão de crédito válido para aprovar a sua conta e avançar para a liberação das APIs. Após esta etapa, clique em Iniciar meu teste gratuito para avançar para a próxima etapa.
Ao inserir os dados do cartão para obter a chave API do Google, não se preocupe: não será gerado faturamento automaticamente. Após a ativação, o Google disponibiliza uma faixa de uso gratuito para diversos serviços da Maps Platform. Dessa forma, você pode utilizar a API dentro dos limites permitidos sem custos, sendo cobrado somente se ultrapassar essa faixa de uso.
Você pode consultar os detalhes da faixa gratuita diretamente na página oficial de preços da Google Maps Platform.
Etapa 3 — Questionário de uso
- Após a criação da conta e a aprovação do cartão, será necessário responder a um questionário de uso da chave API do Google. Nesta etapa, sugerimos responder todas as perguntas com a opção Outro(s) e clicar em Enviar.
Etapa 4 — Geração da chave
- Nesta etapa, a chave é gerada. No entanto, ainda é necessário restringir os acessos a essa chave. Para isso, clique em Acessar a plataforma Google Maps.
Etapa 5 — Acesso às credenciais
Nesta etapa, é feita a restrição da chave para o seu correto funcionamento dentro do sistema. É necessário selecionar o tipo de restrição como Restrição de APIs.
Na mesma janela, marque as seguintes restrições de API:
Geocoding API;
Maps JavaScript API;
Places API;
Routes API.
Para habilitar a Routes API e garantir que ela esteja disponível para uso, siga os passos abaixo:
Acesse a página de documentação:
Inicie o processo:
- Clique no botão Começar para acessar as configurações da API.
Habilite a Routes API:
No menu lateral esquerdo, selecione APIs e serviços.
Na seção Encontre os produtos de mapa certos, clique em Routes.
Escolha a Routes API e clique em Enable para ativá-la.
Configure as restrições da chave API:
No menu lateral, vá para Chaves e credenciais.
Na seção Chaves de API, localize sua chave e clique nos três pontinhos ao lado de Exibir chave.
Selecione Exibir chave de API.
Na seção Restrições da API, marque a opção Routes API.
Salve as alterações:
- Clique em Salvar para aplicar as restrições.
Após esses passos, a Routes API estará habilitada e disponível para ser adicionada junto com as outras APIs em seu projeto.
Acesso à chave
Para acessar a chave API do Google, vá até o menu Chaves e credenciais.
Na página de credenciais, clique em Exibir chave e, em seguida, no ícone para copiar para a área de transferência.
Para reativar sua chave API do Google, siga os passos abaixo:
Acesse o link: https://developers.google.com/maps/documentation/javascript/get-api-key?hl=pt-br
No site do Google, clique em Começar.
Ao entrar no console, será exibida uma mensagem informando que o período de teste gratuito terminou e que é necessário realizar um upgrade para restaurar os serviços.
Clique no botão Fazer upgrade para reativar a chave.
Após a ativação, a chave ficará no modo completo e você receberá créditos mensais (não cumulativos).
Crie um orçamento e configure alertas para controlar os créditos fornecidos pelo Google, que serão consumidos conforme o volume de requisições de busca de endereços.
Configuração no Inmap Fiberdocs
Acesse o caminho: Menu Configurações > Configurações do sistema > Chaves.
Selecione a API de mapas que será utilizada:
Google Maps;
OpenStreetMap;
Azure Maps.
Selecione a API de busca de endereços.
No campo Google API Key, cole a chave obtida.
Clique no botão Salvar para aplicar a configuração.
Configuração da Chave Map ID
Um Map ID (ID do Mapa) é um identificador único utilizado para gerenciar estilos e configurações de mapas em aplicativos e sites, especialmente nas APIs do Google Maps. Ele permite personalizar a aparência do mapa e habilitar recursos avançados, como marcadores e mapas vetoriais. O Map ID é criado e configurado no Google Cloud
Etapa 1 — Cadastro do Map ID (criação dos estilos de mapa)
- Acesse o Google Maps Cloud:
https://console.cloud.google.com/google/maps-apis/overview
Selecione o Projeto, localizado no topo à esquerda da tela.
No menu lateral esquerdo, clique em Estilos de mapa.
Clique em Criar estilo.
Será exibida uma janela com um mapa e o campo de seleção de Modo:
Claro
Escuro
Etapa 2 — Criação do estilo (Modo Claro)
Selecione o modo Claro e clique em Personalizar.
Acesse a aba JSON.
Copie e cole o código abaixo:
{
"variant": "light",
"styles": [
{
"id": "infrastructure",
"label": {
"visible": true
}
},
{
"id": "infrastructure.roadNetwork",
"label": {
"visible": true
}
},
{
"id": "infrastructure.transitStation",
"label": {
"visible": false
}
},
{
"id": "natural",
"label": {
"visible": false
}
},
{
"id": "pointOfInterest",
"geometry": {
"visible": false
},
"label": {
"visible": false
}
},
{
"id": "political",
"label": {
"visible": true
}
}
]
}- Clique em Aplicar > Salvar > Publicar.
Exemplo: Modo Claro Fiberdocs.
Etapa 3 — Criação do estilo (Modo Escuro)
Após concluir o estilo do modo claro, crie o estilo do modo escuro seguindo os mesmos passos:
Estilos de mapa > Criar estilo.
Selecione o modo Escuro.
Acesse a aba JSON e cole o código abaixo:
{
"variant": "dark",
"backgroundColor": "#1d2c4d",
"styles": [
{
"id": "infrastructure.railwayTrack",
"geometry": {
"visible": false
}
},
{
"id": "infrastructure.roadNetwork.road",
"geometry": {
"strokeColor": "#304a7d"
},
"label": {
"textFillColor": "#98a5be",
"textStrokeColor": "#1d2c4d"
}
},
{
"id": "infrastructure.roadNetwork.road.highway",
"geometry": {
"fillColor": "#2c6675",
"strokeColor": "#255763"
},
"label": {
"textFillColor": "#b0d5ce",
"textStrokeColor": "#023e58"
}
},
{
"id": "infrastructure.roadNetwork.roadShield",
"label": {
"visible": false
}
},
{
"id": "infrastructure.roadNetwork.roadSign",
"label": {
"visible": false
}
},
{
"id": "infrastructure.transitStation",
"label": {
"visible": false
}
},
{
"id": "natural.land",
"geometry": {
"fillColor": "#023e58"
}
},
{
"id": "natural.water",
"geometry": {
"fillColor": "#0e1626"
},
"label": {
"textFillColor": "#4e6d70"
}
},
{
"id": "pointOfInterest",
"geometry": {
"visible": false
},
"label": {
"visible": false
}
},
{
"id": "pointOfInterest.transit",
"geometry": {
"visible": false
},
"label": {
"visible": false
}
},
{
"id": "political",
"label": {
"textFillOpacity": 1,
"textFillColor": "#98a5be",
"textStrokeOpacity": 1,
"textStrokeColor": "#1d2c4d"
}
},
{
"id": "political.landParcel",
"geometry": {
"visible": false
}
}
]
}- Clique em Aplicar > Salvar > Publicar.
Etapa 4 — Gerenciamento de mapas (criação do Map ID)
No menu lateral esquerdo, clique em Gerenciamento de mapas.
Clique em Criar ID do mapa.
Preencha um nome para o Map ID.
- Exemplo: Fiberdocs
No campo Tipo de mapa, selecione JavaScript.
Selecione Vetor e clique em Salvar.
Etapa 5 — Vincular estilos ao Map ID
Após salvar, role até o final da página. Serão exibidos os estilos vinculados ao Map ID.
Clique no ícone de lápis do Modo Claro.
Na seção Meus estilos, selecione o estilo Modo Claro e clique em Concluído.
Repita o mesmo processo para o Modo Escuro, clicando no ícone de lápis correspondente.
Clique em Salvar.
Etapa 6 — Configuração no sistema Fiberdocs
Copie o Map ID gerado.
Acesse o caminho:
Menu Configurações > Configurações do sistema > Chaves.No campo Google Map ID, cole o código copiado.
Salve as alterações.
Casos de Uso
Localização de Leads via API Google
Cenário: Vendedor precisa localizar e validar endereços de leads usando API Google Maps. Processo:
- Acessar Inmap Sales, por exemplo.
- Sistema utiliza API Google para:
- Geocodificar endereços automaticamente
- Validar CEP e logradouro
- Sugerir endereços corretos
Considerações Finais
A integração da Chave API Google no Sistema é fundamental para aprimorar a precisão e eficiência de diversas funcionalidades relacionadas à localização geográfica. Desde o cadastro de clientes até a otimização de rotas para equipes de campo, esta integração oferece um valor significativo para a operação da empresa. É crucial manter a chave API atualizada e gerenciar corretamente as permissões e uso no Google Cloud Console para garantir o funcionamento contínuo e seguro dessas funcionalidades.