> For the complete documentation index, see [llms.txt](https://ola.meajuda.cc/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://ola.meajuda.cc/extras/chave-api-google-maps.md).

# 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="/files/NV38UapsuB37uYghOrWH" alt="" width="482"><figcaption></figcaption></figure>

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

<figure><img src="/files/hU0Mr4C96UZSTpQm4Jvq" 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="/files/KnWzzLovTSkiztujBFJp" 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="/files/fWwaTEZm90McmJLJY5mf" 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="/files/qz0zJd0xS8iXEFdVK7DK" alt="" width="403"><figcaption></figcaption></figure>

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

<figure><img src="/files/5t9nuGJNBjBX9AhMEd1I" 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="/files/nAnVH47oFRi46BHttcOi" alt=""><figcaption></figcaption></figure>

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

<figure><img src="/files/1XVnFhyu091oijWJN2G4" alt=""><figcaption></figcaption></figure>

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

<figure><img src="/files/izu9btYsMH5fsQc8IOt0" alt="" width="410"><figcaption></figcaption></figure>

Depois, clique no menu "Biblioteca":

<img src="/files/-Mgk7BRFH17xl4hqznu7" alt="" width="188">

A tela da biblioteca será similar a esta:

![](/files/-Mgk8KtsqGr51n4CzzK3)

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

![](/files/twEpmKhTAgkbGekqdmk0)

Em seguida, clique em "Ativar":

<img src="/files/yefFwMZz19VWr8rCgKJr" alt="" width="433">

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

<figure><img src="/files/V4TND5xlkmhZS8CMnKt4" alt="" width="520"><figcaption></figcaption></figure>

Ative-o também:

<figure><img src="/files/hiLDcBxMsPnf6Uh6zsnx" 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="/files/WXLyL6nUAYRLWTJH7f9W" alt="" width="285"><figcaption></figcaption></figure>

<figure><img src="/files/UG37chlIEQUWXwVXMT4F" 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="/files/f9attdM3D9XmfJ5rldEO" alt=""><figcaption></figcaption></figure>

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

<figure><img src="/files/TxN6Per5QRe2AZK2TVFP" 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="/files/N4MfT9r9BUVOlqvS9aF7" alt="" width="563"><figcaption></figcaption></figure>