Exibir código-fonte para Criação da chave API do Google Maps

==Objetivo da documentação==
<div align="justify">
Ensinar o processo de aquisição da chave do Google para uso no Google Maps dentro do ERPVoalle. A API do Google Maps é um serviço gratuito que permite incorporar o Google Maps dentro do sistema possibilitando algumas funcionalidades como: 

*Visualização de um mapa para viabilidade;
*Posicionamento de estruturas;
*Busca da geolocalização através de um endereço;<br>

<br>

===Principais conceitos===
'''API:''' Sigla para ''Application Programming Interface'', em português Interface de Programação de Aplicativos. É utilizada para nomear um conjunto de rotinas e padrões de programação para acesso a um aplicativo de software ou plataforma baseado na Web. Uma API é criada quando o desenvolvedor quer que outros desenvolvedores criem produtos e serviços associados ao seu, de maneira padronizada e de fácil manutenção. Basicamente, uma API é um programa que fica entre dois sistemas e funciona como tradutor-mensageiro, fazendo a comunicação entre ambos.

====Importante====

*A Google disponibiliza um limite de valor mensal para uso gratuito das API's, não sendo inserida uma forma de pagamento que viabilize a cobrança,  a API deixará de funcionar. <br><br>
*O uso gratuito limita-se ao máximo de 3 meses.<br><br>
*São permitidas apenas 2.500 requisições de Geolocalização por dia (carregamento de mapa ou requisições via Webservice) na versão gratuita.

==Passo a passo==
===Para quem já possui uma chave de acesso===
====Cadastrar chave no ERP - Validação====
'''1.''' Usuário do ERP com perfil ''"Administrador"'' deve acessar a rotina Suíte / Configurações / Parâmetros menu Suíte;

'''2.''' Em ''"Chave API do Google"'', inserir a chave API do Google;

'''3.''' Para verificar se a chave é válida basta clicar no ícone {{Icone|tipo=revalidar_lote}};

'''4.''' Caso a chave API esteja incorreta ou expirada, será apresentada a mensagem "Requisição falhou. Chave da API não autorizada";

'''5.''' Caso a chave esteja válida e correta, o ícone {{Icone|tipo=finalizar_atendimento}} aparecerá, bem como a mensagem "Chave API autorizada";

'''6.''' Salvar as alterações.

[[Arquivo:Atualizar Chave API Google.png|800x800px|semmoldura|centro]]


====Atualizar chave da API do Google Maps====
'''1.''' Acesse o site da Console de APIs clicando [https://console.developers.google.com/cloud-resource-manager aqui]; <br>

'''2.''' Acesse o menu de navegação, disponível no canto superior esquerdo da página, posicione o cursor em “API’s e serviços" e clique na opção "Painel": <br>

[[Arquivo:Criação da chave API do Google Maps 2.png|800x800px|semmoldura|centro]]


'''3.''' Selecione o projeto criado que contém a chave API do Google cadastrada anteriormente;

[[Arquivo:Atualizarchave.png|800x800px|semmoldura|centro]]


'''4.''' Acessar o menu lateral "Credenciais" e clicar no botão "+ CRIAR CREDENCIAIS", opção "CHAVE DE API";

[[Arquivo:Criar nova chave.png|800x800px|semmoldura|centro]]


'''5.''' Será apresentada a tela contendo a nova chave API, copiar este código e realizar os passos para cadastrar a chave no ERP.

[[Arquivo:Chave criada.png|800x800px|semmoldura|centro]]


===Para quem ainda não possui uma chave de acesso===
====Criação da chave da API do Google Maps====
'''1.''' Acesse o site da Console de APIs clicando [https://console.developers.google.com/cloud-resource-manager aqui]; <br>

'''2.''' Faça login em sua Conta do Google - caso não possua uma conta do Google, crie uma nova;

'''3.''' Após o login com a sua conta do Google, clique em “Criar Projeto”, conforme imagem abaixo: <br>

[[Arquivo:Chave google.png|800x800px|semmoldura|centro]]

'''4.''' Com os campos de criação do projeto abertos, insira o ''Nome do projeto'' e o ''Local'' (sua Empresa); <br>

'''5.''' Depois de criar o projeto, acesse o menu de navegação, disponível no canto superior esquerdo da página, posicione o cursor em “API’s e serviços" e clique na opção "Painel": <br>

[[Arquivo:Criação da chave API do Google Maps 2.png|800x800px|semmoldura|centro]]


'''6.''' Na nova página, clique em "+ ATIVAR APIS E SERVIÇO" e, na barra de pesquisa, procure pelo aplicativo '''Maps JavaScript API''', clique sobre seu nome e, por fim, em ATIVAR: <br>

[[Arquivo:Criação da chave API do Google Maps3.png|800x800px|semmoldura|centro]]


'''7.''' Após ter a ativação, na seção "OUTRAS APIS" habilite ''Geocoding API'', ''Directions API'' e ''Geolocation API.''


[[Arquivo:Criação da chave API do Google Maps4.png|800x800px|semmoldura|centro]]

'''8.''' Acessar o Menu, APIs e Serviços, opção Credenciais e clicar no botão "+ CRIAR CREDENCIAIS", opção "CHAVE DE API".

[[Arquivo:ACriação da chave API do Google Maps5.png|800x800px|semmoldura|centro]]

Pronto, a chave para aplicativo do navegador está criada e as informações da mesma serão exibidas na tela, conforme o exemplo: <br>

'''Chave para aplicativos do navegador''' <br>
Chave de API: AIzaSyDNZ9gbzeJjssLop-XXXXXXXXX-XXXXXX (exemplo) <br>
Referrers: Any referrer allowed <br>
Data de ativação: DD de MMM de AAAAA HH:MM:SS <br>
Ativado por: seu.e-mail@gmail.com <br>

====Liberação da chave API do Google====
'''1.''' Para liberar, acesse a página clicando [https://console.developers.google.com/cloud-resource-manager aqui]; <br>

'''2.''' Na página inicial, no "Menu de Navegação", clique em "Faturamento"; <br>

'''3.''' Nessa tela, você deve vincular uma conta de faturamento. Para isso, clique em “Vincular conta de faturamento”. Após, clique em "Definir conta", caso já exista ou, então, crie uma conta nova: <br>


[[Arquivo:Api6.png|800x800px|semmoldura|centro|api6]]


*Para criar uma conta nova, acesse o "Faturamento" e clique em "Gerenciar Contas de Faturamento" e, após, "Adicionar conta de faturamento", para informar os dados do cartão de crédito: <br>


[[Arquivo:Api7.png|600x600px|semmoldura|centro|api7]]


'''4.''' Após realizar o vínculo da conta de faturamento, são disponibilizados os projetos vinculados: <br>


[[Arquivo:Api8.png|800x800px|semmoldura|centro|api8]]


==Erros==

Alguns erros podem provocar problemas no uso da API, tais como: <br>

*A data de validade do cartão de crédito expirou; <br>

*Os quatro APIs não estão devidamente ativados; <br>

*Problema do usuário com a conta do Google. <br>