> ## Documentation Index
> Fetch the complete documentation index at: https://docs.base44.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Conectando o Google Maps ao seu app

> Adicione lugares, rotas, mapas e clima ao seu app da Base44 com o conector do Google Maps.

Adicione o conector do Google Maps ao seu app da Base44 para pesquisar lugares, planejar rotas, mostrar mapas e consultar o clima. O Google Maps usa Base44 credentials ou sua própria chave de API da Google Maps Platform.

> [!NOTE]
>
> Você precisa de um [**Plano Builder**](https://base44.com/pricing) ou superior para usar conectores no seu app.

***

## O que você pode fazer

Leve dados de localização para as páginas e os fluxos que seu app já tem.

> [card] Encontrar lugares
>
> Pesquise lugares perto de um local e mostre fotos, avaliações e horários de funcionamento.

> [card] Planejar rotas
>
> Obtenha rotas e tempos de viagem ao vivo e sugira quando sair.

> [card] Mostrar mapas
>
> Mostre imagens de mapas e o Street View, e verifique endereços antes de um pedido ser feito.

**APIs incluídas**

O Google Maps dá ao seu app estas APIs da Google Maps Platform:

* **Places:** Preenchimento automático, pesquisa por texto, pesquisa nas proximidades, detalhes do lugar e fotos
* **Routes:** Rotas e tempos de viagem
* **Geocoding:** Converta endereços em coordenadas e vice-versa
* **Static Maps:** Imagens de mapas
* **Street View:** Imagens do Street View e os detalhes delas
* **Time Zone:** O fuso horário de um local
* **Weather:** Condições atuais e a previsão diária
* **Air Quality:** Qualidade do ar atual
* **Roads:** Ajuste uma rota às vias e encontre as vias mais próximas
* **Address Validation:** Verifique e corrija endereços

> [!NOTE]
>
> Mapas interativos e 3D não estão incluídos. Eles rodam no navegador dos seus visitantes. Por isso, precisam de uma chave de navegador separada do Google Maps, não da chave que você adiciona em **New credentials**.

**Prompts de exemplo**

No chat de IA, descreva os lugares ou endereços, o que aciona a ação e como os resultados devem aparecer no seu app. Por exemplo:

```text wrap theme={null}
Mostre a loja mais próxima do endereço de um cliente, com o tempo de viagem ao vivo e um mapa.
```

```text wrap theme={null}
Encontre os cafés mais bem avaliados perto de um endereço, com fotos, avaliações e horários de funcionamento.
```

```text wrap theme={null}
Mostre um alerta de "hora de sair" para cada compromisso, usando o trânsito ao vivo e o clima no endereço.
```

```text wrap theme={null}
Verifique e corrija os endereços de entrega antes de um pedido ser feito.
```

```text wrap theme={null}
Mostre uma foto do Street View de um endereço para que os visitantes reconheçam a entrada.
```

***

## Conectando o Google Maps

Adicione o Google Maps pelo chat de IA ou pela página **Integrations** do seu app. Depois, escolha como conectar:

* **Base44 credentials:** Nenhuma chave de API é necessária. As chamadas usam créditos de integração. Somente o dono do app pode escolher essa opção.
* **New credentials:** Use sua própria chave de API da Google Maps Platform. As chamadas não usam créditos de integração, e o Google pode cobrar você por elas. Ative as [APIs incluídas](#o-que-você-pode-fazer) no Google Cloud e não restrinja a chave a sites.

> [!NOTE]
>
> Os termos de serviço do seu app devem informar que ele inclui recursos e conteúdo do Google Maps. Eles também devem informar que o uso desses recursos está sujeito aos [Termos de Serviço Adicionais do Usuário Final do Google Maps](https://maps.google.com/help/terms_maps/) e à [Política de Privacidade do Google](https://policies.google.com/privacy).

> [tab] Pelo chat de IA
>
> **Para conectar o Google Maps pelo chat de IA:**
>
> 1. Abra seu app no editor de apps.
> 2. Peça ao chat de IA para adicionar um recurso do Google Maps, como um dos prompts de exemplo.
> 3. Se o chat de IA fizer perguntas antes, responda a elas.
> 4. Escolha como conectar:
>    * **Base44 credentials:** Clique em **Use Base44 credentials**.
>    * **New credentials:**
>      1. Selecione **New credentials**.
>      2. Clique em **Continue**.
>      3. Digite sua chave em **Google Maps Platform API key**.
>      4. Clique em **Save credentials**.

> [tab] Pelo dashboard do seu app
>
> **Para adicionar o Google Maps pelo dashboard do seu app:**
>
> 1. Clique em **Dashboard** no editor do seu app.
> 2. Clique em **Integrations**.
> 3. Clique em **Add connector**.
> 4. Clique em **Google Maps**.
> 5. Clique em **Next**.
> 6. Clique em **Add connector**.
> 7. Escolha como conectar:
>    * **Base44 credentials:** Clique em **Use these credentials**.
>    * **New credentials:**
>      1. Selecione **New credentials**.
>      2. Clique em **Continue**.
>      3. Digite sua chave em **Google Maps Platform API key**.
>      4. Clique em **Save credentials**.

> [!TIP]
>
> Depois de conectar, clique em um prompt em **What you can build** para adicioná-lo ao chat de IA. Depois, edite-o e envie.

***

## Solução de problemas

Se o Google Maps não conectar ou parar de funcionar, verifique quem o conectou e quais credenciais seu app usa.

> [accordion] As Base44 credentials não aparecem quando você adiciona o Google Maps
>
> Somente o dono do app pode escolher as Base44 credentials. Peça ao dono do app para conectar o Google Maps, ou selecione **New credentials** e use sua própria chave de API da Google Maps Platform.

> [accordion] As chamadas com sua própria chave falham com um erro do Google
>
> O Google rejeita chamadas quando uma API não está ativada para sua chave ou quando as restrições da chave a bloqueiam. A Base44 mostra o erro do Google como ele é. No seu projeto do Google Cloud, ative as [APIs incluídas](#o-que-você-pode-fazer) e permita-as nas restrições de API da chave. Remova também qualquer restrição de site (referenciador HTTP) da chave.

***

## Perguntas frequentes

> [accordion] Posso alternar entre as Base44 credentials e minha própria chave de API?
>
> Sim, você pode alternar a qualquer momento. Somente o dono do app pode escolher as Base44 credentials.
>
> **Para alternar as credenciais:**
>
> 1. Clique em **Dashboard** no editor do seu app.
> 2. Clique em **Integrations**.
> 3. Clique em **Google Maps** em **App connections**.
> 4. Clique em **Change credentials**. As credenciais que seu app usa agora aparecem marcadas como **In use**.
> 5. Escolha como conectar:
>    * **Base44 credentials:** Clique em **Use these credentials**.
>    * **New credentials:**
>      1. Selecione **New credentials**.
>      2. Clique em **Continue**.
>      3. Digite sua chave em **Google Maps Platform API key**.
>      4. Clique em **Save credentials**.

> [accordion] Como o Google Maps usa créditos?
>
> As chamadas com Base44 credentials usam créditos de integração. Isso inclui as chamadas de teste que o chat de IA faz enquanto cria seu recurso. O número de créditos depende da chamada. Um recurso pode fazer mais de uma chamada a cada execução, por exemplo uma pesquisa de lugar e uma imagem de mapa.
>
> Para ver o que seu app usou, [abra App usage](https://docs.base44.com/pt-BR/Account-and-billing/Credits.md#visualizando-pelo-app) e selecione **Show details** em **Integration credits**.

> [!NOTE]
>
> Esta página foi traduzida usando IA. Para as informações mais precisas e atualizadas, consulte a [versão em inglês](https://docs.base44.com/index.md).


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.