# Chave API Google Maps

### O que é a Chave API do Google Cloud?

É uma chave que da acesso a serviços do Google, dentre eles, consultar endereços no Google Maps e outros serviços relacionados. Ela é fundamental para funcionamento correto da plataforma.

### Como funcionam as consultas de endereço no Delivery da plataforma?

Para garantir precisão nas entregas via delivery, a plataforma utiliza duas tecnologias integradas de geolocalização: **OpenStreetMap** e **API do Google Maps**.

O OpenStreetMap, que é totalmente gratuito, é sempre consultado primeiro. Caso o OpenStreetMap não encontre a localização informada pelo cliente, a plataforma automaticamente realiza uma consulta à API do Google Maps, que oferece até 10 mil consultas mensais gratuitas.

### As consultas aos serviços de geolocalização acontecem somente em situações específicas:

**Quando as consultas são feitas?**

* Quando o cliente informa um endereço pela primeira vez;
* Sempre que o cliente alterar seu endereço;
* Apenas em métodos de taxa por raio ou área.

**🚫 NÃO são feitas consultas quando:**

* O pedido é para retirada ou consumo no local;
* A loja usa o método de taxa por lista de bairros;
* O endereço já está salvo no cadastro e não sofreu alterações.
* O pedido vem através de integrações como iFood, Delivery Much e aiqfome, que já contam com a informação do endereço e localização.

### Os serviços ativados no Google Cloud terão algum custo?

Por padrão, você terá 10.000 consultas mensais gratuitas. Lembrando que essa consulta é realizada somente casos específicos, então dificilmente o total será maior que esse. Mesmo que o volume não gere cobrança, o Google exige uma conta com cartão de crédito vinculada para ativar o serviço.

### 1. Criando a conta e ativando as APIs

Acesse: [cloud.google.com/](https://cloud.google.com/) e clique em "Comece a usar Gratuitamente":

<figure><img src="https://3193212287-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-ME41abfRf7bWmvqahTl%2Fuploads%2FeuTCxTqsSeh39ztEexC1%2F1.png?alt=media&#x26;token=e17cb463-7f5f-450a-b195-8ebb07abbcff" alt="" width="482"><figcaption></figcaption></figure>

Selecione o país (Brasil) e clique em "Concordar e Continuar":

<figure><img src="https://3193212287-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-ME41abfRf7bWmvqahTl%2Fuploads%2FT4mYYzfXzVzCNHL7hzKr%2F2.png?alt=media&#x26;token=166ebf4c-c763-44d3-afbf-668a75f9834c" alt="" width="386"><figcaption></figcaption></figure>

Selecione "Organização" para CNPJ e "Pessoa Física" para CPF. Preencha os dados e clique em "Verificar":

<figure><img src="https://3193212287-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-ME41abfRf7bWmvqahTl%2Fuploads%2Fm7u8oFkS7X91NYJ8VW31%2Fscreenshot-console.cloud.google.com-2024.07.01-16_52_48.png?alt=media&#x26;token=da568ffd-290a-48e4-93aa-945c576e033a" alt="" width="386"><figcaption></figcaption></figure>

{% hint style="info" %}
Importante: Será necessário preencher dados de pagamento associados ao cadastro utilizado.
{% endhint %}

Preencha os dados de endereço atentamente:

<figure><img src="https://3193212287-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-ME41abfRf7bWmvqahTl%2Fuploads%2Fbfcvt9UvKMm5zGK8QlDi%2Fscreenshot-console.cloud.google.com-2024.07.01-16_56_32.png?alt=media&#x26;token=bd22365a-2490-4ea6-a4a8-129cc774a6dc" alt="" width="344"><figcaption></figcaption></figure>

Vincule um cartão de crédito associado aos dados preenchidos e clique em Começar Gratuitamente:

<figure><img src="https://3193212287-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-ME41abfRf7bWmvqahTl%2Fuploads%2F2IOX7Jm2VLJ86oSfRc54%2Fscreenshot-console.cloud.google.com-2024.07.01-16_58_23.png?alt=media&#x26;token=6cb8fa86-b059-429e-8b2a-6808213e0416" alt="" width="403"><figcaption></figcaption></figure>

Preencha o pesquisa do Google a seguir e clique em "Concluído":

<figure><img src="https://3193212287-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-ME41abfRf7bWmvqahTl%2Fuploads%2Fi2NeoqUSjPZZbwNodC8X%2Fscreenshot-console.cloud.google.com-2024.07.01-17_11_09.png?alt=media&#x26;token=e52d82ac-7a9a-48e5-acfc-e533a5ea1134" alt="" width="407"><figcaption></figcaption></figure>

A tela seguinte é o painel de controle do Google Cloud, na barra de pesquisa, digite "credenciais" e clique na opção API:

<figure><img src="https://3193212287-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-ME41abfRf7bWmvqahTl%2Fuploads%2F4m1j5auoqaq6c0Vs4N6A%2FCapturar.PNG?alt=media&#x26;token=320c15b5-9e86-43e0-8862-a8d1c11382a9" alt=""><figcaption></figcaption></figure>

Em seguida, clique em "Criar credenciais" em seguida em "Chave API":

<figure><img src="https://3193212287-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-ME41abfRf7bWmvqahTl%2Fuploads%2FaTpRLc7do4C71QBWThSM%2Fscreenshot-console.cloud.google.com-2024.07.01-17_51_40%20(1).png?alt=media&#x26;token=c466cdb0-fdb0-4074-995c-f7a1daf73f42" alt=""><figcaption></figcaption></figure>

A seguir, copie a chave criada e salve em algum documento para enviar posteriormente para nosso suporte.

<figure><img src="https://3193212287-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-ME41abfRf7bWmvqahTl%2Fuploads%2FSwPfnWLFvnJzsMR30ziX%2Fscreenshot-console.cloud.google.com-2024.07.01-17_55_26.png?alt=media&#x26;token=e048f730-7d92-47e5-b908-83cb432fa011" alt="" width="410"><figcaption></figcaption></figure>

Depois, clique no menu "Biblioteca":

![](https://3193212287-files.gitbook.io/~/files/v0/b/gitbook-legacy-files/o/assets%2F-ME41abfRf7bWmvqahTl%2F-Mgk1LS0iYN0u5rNe5AQ%2F-Mgk7BRFH17xl4hqznu7%2Fapi%20Google%20Maps%20biblioteca.jpg?alt=media\&token=49492f9a-3a24-4658-ba58-eb9fd5182090)

A tela da biblioteca será similar a esta:

![](https://3193212287-files.gitbook.io/~/files/v0/b/gitbook-legacy-files/o/assets%2F-ME41abfRf7bWmvqahTl%2F-Mgk1LS0iYN0u5rNe5AQ%2F-Mgk8KtsqGr51n4CzzK3%2Fapi%20Google%20Maps%208.webp?alt=media\&token=4cfcc3f7-b8a6-423e-9c37-1f29cd7a0f16)

Procure pela opção "Maps Static API" e clique nel&#x61;**:**

![](https://3193212287-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-ME41abfRf7bWmvqahTl%2Fuploads%2FzlLrLnPUUrRVWvMN0CE0%2Fscreenshot-console.cloud.google.com-2024.07.01-18_12_33.png?alt=media\&token=06560c2a-7c09-4c03-bfa1-ea6305666551)

Em seguida, clique em "Ativar":

![](https://3193212287-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-ME41abfRf7bWmvqahTl%2Fuploads%2FtPcc1VjgOA9u6aaOm1Lp%2Fscreenshot-console.cloud.google.com-2024.07.01-18_14_03.png?alt=media\&token=6d98c99d-aae7-439b-a0ca-b39b50cc81e3)

Depois, volte a biblioteca e pesquise por "Geocoding API":

<figure><img src="https://3193212287-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-ME41abfRf7bWmvqahTl%2Fuploads%2Fcww3JLZzKNDSojh1KAM7%2FCapturar.PNG?alt=media&#x26;token=0d212f95-5bad-4808-8476-b04f1ef21fbd" alt="" width="520"><figcaption></figcaption></figure>

Ative-o também:

<figure><img src="https://3193212287-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-ME41abfRf7bWmvqahTl%2Fuploads%2FkJDhR4Wgp0GTwt5N10YB%2Fscreenshot-console.cloud.google.com-2024.07.01-18_19_26.png?alt=media&#x26;token=a002bd6a-9a63-4e06-95ae-627a479b7aa7" alt="" width="445"><figcaption></figcaption></figure>

Depois, volte a tela inicial, clicando na logo do Google Cloud e clique em "Ativar conta completa", se ainda não estiver ativada:

<figure><img src="https://3193212287-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-ME41abfRf7bWmvqahTl%2Fuploads%2F84KiGN4zd6NSOuNgewf4%2Fscreenshot-console.cloud.google.com-2024.07.01-19_01_16.png?alt=media&#x26;token=0c79acc3-7237-4a37-b2bd-424e7ed09e5f" alt="" width="285"><figcaption></figcaption></figure>

<figure><img src="https://3193212287-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-ME41abfRf7bWmvqahTl%2Fuploads%2FEBjfCKtyNMUAMYG15fN5%2Fativar%20conta%20completa.png?alt=media&#x26;token=3e4c74e6-57f5-4987-abc5-3f2f28501766" alt="" width="451"><figcaption></figcaption></figure>

Pronto, agora basta compartilhar a chave copiada com nosso suporte para inserir em sua plataforma!

***

### As APIs pararam de funcionar? Confira sua conta de faturamento:

Se a forma de pagamento que vinculou à sua conta Google Cloud tiver algum problema, por exemplo, dados desatualizados, cartão cancelado ou vencido, os serviços são suspensos.

Para verificar sua conta, acesse [cloud.google.com/](https://cloud.google.com/) com a conta Google vinculada a seu projeto e clique em "Console" no canto superior direito:

<figure><img src="https://3193212287-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-ME41abfRf7bWmvqahTl%2Fuploads%2F8dknbZGIOGA78nDRnxQL%2Fscreenshot-cloud.google.com-2024.07.01-18_46_26.png?alt=media&#x26;token=08b1de66-b03a-44c7-bd1f-22061417faf2" alt=""><figcaption></figcaption></figure>

Depois de acessar o console, clique nas opções e em "Formas de Pagamento":

<figure><img src="https://3193212287-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-ME41abfRf7bWmvqahTl%2Fuploads%2FqxyMxE0czh5akyKD4yM1%2Fscreenshot-console.cloud.google.com-2024.07.01-18_48_49.png?alt=media&#x26;token=495d3ca7-e203-4a5c-b177-901cf97a3afd" alt="" width="350"><figcaption></figcaption></figure>

Na tela seguinte confira se há problemas com algum método de pagamento inserido. Se necessário, edite os dados ou insira um novo método:

<figure><img src="https://3193212287-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-ME41abfRf7bWmvqahTl%2Fuploads%2FrMLj2c43mcSgF4HCLjar%2Fscreenshot-console.cloud.google.com-2024.07.01-18_50_53.png?alt=media&#x26;token=d9db09a6-fda3-4163-bb93-da4fe87dd933" alt="" width="563"><figcaption></figcaption></figure>
