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


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://ola.meajuda.cc/extras/chave-api-google-maps.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.