# Chave API Google - Inmap Fiberdocs

## 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.

> [!NOTA] Acesso à Configuração
> Caminho Fiberdocs:  Menu lnmap > Inmap > Fiberdocs > Configurações > Configurações de chaves ou em Parâmetros: Menu Sistema > Configurações > Parâmetros > Parâmetros Gerais > Aba cadastros

## 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
### 1. Acesso e Login
- Clique no link a seguir para acessar o site onde é configurada a chave API Google: https://developers.google.com/maps/documentation/javascript/get-api-key?hl=pt-br
- Primeiramente, faça o login com uma conta Google e após isso clique em começar.
- Em seguida, irá carregar 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.**
  
 ### 2. Configuração da Conta
- Nesta etapa, clique em **concluir a configuração da conta**.

### 3. Informações da Conta
- Nesta etapa de informações da conta, é necessário aceitar os termos de serviço e clicar em **continuar**.

### 4.  Verificação de Informações de Pagamento
- Nesta etapa é feita a verificação de informações de pagamento, onde é necessário definir uma conta de **pessoa física** ou **pessoa jurídica**. Após selecionar a opção desejada, é necessário inserir o **CPF/CNPJ** e clicar em **verificar.** Caso a opção desejada seja **pessoa física**, é necessário inserir a **data de nascimento**. Após realizada a verificação, preencher as informações de **nome e endereço**.
- Na sequência, é 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, deverá clicar em **iniciar minha teste gratuito** para avançar para a próxima etapa.
  
  >[!WARNING] A chave API do Google é cobrada?  
Ao inserir os dados do cartão para obter a chave API do Google, não se preocupe: não será gerado faturamento automaticamente. O Google disponibiliza créditos para que você possa usar seus serviços sem cobranças inesperadas até o término da avaliação. Isso significa que, durante o período de avaliação, você pode utilizar a API dentro dos limites dos créditos oferecidos sem incorrer em custos adicionais.

### 5. Questionário de Uso
- Após ser criada a conta e o cartão aprovado, deverá responder um questionário de uso da Chave API Google. Nesta etapa, sugerimos responder todas as perguntas com a resposta **"outro(s)"** e clicar em **enviar.**

### 6. Geração da Chave
-  Nesta etapa é gerada a chave, porém, ainda é necessário restringir os acessos a essa chave. Para isso, clique em **acessar a plataforma google maps**.

### 7. 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, deverão ser marcadas as seguintes **restrições API**:
    -  **Geocoding API;**  
    -  **Maps JavaScript API;**  
    - **Places API**;
    - **Routes API**
> [!QUESTION] Como Habilitar a restrição Routes API?
>  Para habilitar a **Routes API** e garantir que ela esteja disponível para uso, siga estes passos simples:
>  
>1. Acesse a página de documentação:
>  Acesse o Link: https://developers.google.com/maps/documentation/javascript/get-api-key?hl=pt-br
>> 
>2. Inície o processo:
>  Clique no botão **"Começar"** para acessar as configurações da API.
>>
>3. 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.
>  Isso permite que a Routes API seja usada em seu projeto.
>>
>4. Configure as Restrições da Chave API
>  No menu lateral, vá para **"Chaves credenciais"**
>  Na seção **"Chaves do 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"**, procure por **"Routes API"** e marque a caixa de seleção. 
>  *Isso garante que sua chave API possa ser usada especificamente com a Routes API.*
>>
>5. Salve as Alterações
>  Clique em **"Salvar"** para aplicar as restrições.
Agora, a Routes API estará habilitada e visível para ser adicionada junto com as outras APIs em seu projeto.
### 8. Acesso á chave
- Para acessar a chave API Google, deverá ir até as **credenciais**.

### 9. Exibir chave
- Na página de credenciais, é necessário clicar em **exibir chave** e clicar no ícone para **copiar para a área de transferência**.

> [!QUESTION] Como reativar a Chave API do Google?
> Para reativar sua chave API do Google, siga os passos abaixo:  
> 1. Acesse o link: https://developers.google.com/maps/documentation/javascript/get-api-key?hl=pt-br
> 2. No site da Google, clique em "Começar".  
> 3. Ao entrar no console, você verá uma mensagem informando que o período de teste gratuito terminou e que é necessário fazer um upgrade para restaurar os serviços.  
> 4. Clique no botão "Fazer Upgrade" para reativar a chave.  
> 5. Após a ativação, a chave estará no modo completo e você receberá créditos mensais (não cumulativos).  
> 6. 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ço.
## Configuração no Sistema
1. Acesse o caminho: Fiberdocs > Menu Principal > Configurações > Configurações de chaves.
2. Vá para a aba "Cadastros".
3. Localize o campo "Chave API Google".
4. Cole a chave obtida do Google Cloud Console.
5. Salve as alterações.

> [!IMPORTANTE]
> Certifique-se de que as APIs necessárias estejam habilitadas no Google Cloud Console, como Maps JavaScript API, Geocoding API, e Places API.
## Casos de Uso

### Visualização de Clientes no Mapa
**Cenário**: Um gerente precisa visualizar a distribuição geográfica dos clientes.
**Processo**:
1. O gerente acessa o módulo do Inmap Fiberdocs.
2. O sistema utiliza a pesquisa de endereço pela API Google.
3. Os clientes são exibidos como ícones em específicos no mapa.
4. O gerente pode clicar nos marcadores para obter mais informações sobre cada cliente.

## Fluxos de Trabalho

```mermaid
graph TD
    A[Obter Token de Acesso Google] --> B[Acessar Configurações Inmap Fiberdocs]
    B --> C[Localizar Seção Goole]
    C --> D[Inserir Token de Acesso]
    D --> E[Ativar Integração]
    E --> F[Configurar Estilo de Mapa]
    F --> G[Ajustar Zoom Padrão]
    G --> H[Salvar Configurações]
    H --> I[Testar Visualização]
```

## 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.

## Etiquetas
#APIGoogle #Geolocalizacao #Mapas #Integracao #ConfiguracaoSistema #Localizacao 

## Leia Também
- [[chave api open street maps|Chave API Open Street Maps]]
- [[marcacao de localizacao no mapa pelo cadastro do cliente|Marcação de Localização no Mapa pelo Cadastro do Cliente]]
- [[acessos inmap service|Acessos]]
- [[filtro de logins|Filtro de Logins]]
- [[clientes inmap sales|Clientes]]