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

# Connettere Google Maps alla tua app

> Aggiungi luoghi, indicazioni, mappe e meteo alla tua app Base44 con il connettore Google Maps.

Aggiungi il connettore Google Maps alla tua app Base44 per cercare luoghi, pianificare percorsi, mostrare mappe e controllare il meteo. Google Maps usa le credenziali Base44 o la tua chiave API di Google Maps Platform.

> [!NOTE]
>
> Ti serve un [**piano Builder**](https://base44.com/pricing) o superiore per usare i connettori nella tua app.

***

## Cosa puoi fare

Porta i dati di posizione nelle pagine e nei flussi che la tua app ha già.

> [card] Trova luoghi
>
> Cerca luoghi vicino a una posizione e mostra foto, valutazioni e orari di apertura.

> [card] Pianifica percorsi
>
> Ottieni indicazioni e tempi di guida in tempo reale, e suggerisci quando partire.

> [card] Mostra mappe
>
> Mostra immagini di mappe e Street View, e controlla gli indirizzi prima di un ordine.

**API incluse**

Google Maps fornisce alla tua app queste API di Google Maps Platform:

* **Places:** completamento automatico, ricerca testuale, ricerca nei dintorni, dettagli dei luoghi e foto
* **Routes:** indicazioni e tempi di guida
* **Geocoding:** converte gli indirizzi in coordinate e viceversa
* **Static Maps:** immagini di mappe
* **Street View:** immagini Street View e relativi dettagli
* **Time Zone:** il fuso orario di una posizione
* **Weather:** condizioni attuali e previsioni giornaliere
* **Air Quality:** qualità dell'aria attuale
* **Roads:** allinea un percorso alle strade e trova le strade più vicine
* **Address Validation:** controlla e correggi gli indirizzi

> [!NOTE]
>
> Le mappe interattive e 3D non sono incluse. Vengono eseguite nei browser dei visitatori. Per questo richiedono una chiave browser di Google Maps separata, non la chiave che aggiungi in **New credentials**.

**Prompt di esempio**

Nella chat AI, descrivi i luoghi o gli indirizzi, cosa attiva l'azione e come devono apparire i risultati nella tua app. Ad esempio:

```text wrap theme={null}
Mostra il mio punto vendita più vicino all'indirizzo di un cliente, con il tempo di guida in tempo reale e una mappa.
```

```text wrap theme={null}
Trova i bar più votati vicino a un indirizzo, con foto, valutazioni e orari di apertura.
```

```text wrap theme={null}
Mostra un avviso "è ora di partire" per ogni appuntamento, usando il traffico in tempo reale e il meteo al suo indirizzo.
```

```text wrap theme={null}
Controlla e correggi gli indirizzi di consegna prima che venga effettuato un ordine.
```

```text wrap theme={null}
Mostra una foto Street View di un indirizzo, così i visitatori possono riconoscere l'ingresso.
```

***

## Connettere Google Maps

Aggiungi Google Maps dalla chat AI o dalla pagina **Integrations** della tua app, poi scegli come connetterti:

* **Base44 credentials:** non serve una chiave API. Le chiamate usano crediti di integrazione. Solo il proprietario dell'app può scegliere questa opzione.
* **New credentials:** usa la tua chiave API di Google Maps Platform. Le chiamate non usano crediti di integrazione e Google potrebbe addebitartele. Abilita le [API incluse](#cosa-puoi-fare) in Google Cloud e non limitare la chiave ai siti web.

> [!NOTE]
>
> I termini di servizio della tua app devono indicare che include funzionalità e contenuti di Google Maps. Devono anche indicare che il loro uso è soggetto ai [Termini di servizio aggiuntivi per l'utente finale di Google Maps](https://maps.google.com/help/terms_maps/) e alle [Norme sulla privacy di Google](https://policies.google.com/privacy).

> [tab] Dalla chat AI
>
> **Per connettere Google Maps dalla chat AI:**
>
> 1. Apri la tua app nell'editor dell'app.
> 2. Chiedi alla chat AI di aggiungere una funzionalità di Google Maps, come uno dei prompt di esempio.
> 3. Se la chat AI fa prima delle domande, rispondi.
> 4. Scegli come connetterti:
>    * **Base44 credentials:** clicca su **Use Base44 credentials**.
>    * **New credentials:**
>      1. Seleziona **New credentials**.
>      2. Clicca su **Continue**.
>      3. Inserisci la tua chiave in **Google Maps Platform API key**.
>      4. Clicca su **Save credentials**.

> [tab] Dalla dashboard dell'app
>
> **Per aggiungere Google Maps dalla dashboard dell'app:**
>
> 1. Clicca su **Dashboard** nell'editor della tua app.
> 2. Clicca su **Integrations**.
> 3. Clicca su **Add connector**.
> 4. Clicca su **Google Maps**.
> 5. Clicca su **Next**.
> 6. Clicca su **Add connector**.
> 7. Scegli come connetterti:
>    * **Base44 credentials:** clicca su **Use these credentials**.
>    * **New credentials:**
>      1. Seleziona **New credentials**.
>      2. Clicca su **Continue**.
>      3. Inserisci la tua chiave in **Google Maps Platform API key**.
>      4. Clicca su **Save credentials**.

> [!TIP]
>
> Dopo esserti connesso, clicca su un prompt sotto **What you can build** per aggiungerlo alla chat AI, poi modificalo e invialo.

***

## Risoluzione dei problemi

Se la tua app non riesce a connettersi o smette di funzionare, controlla chi ha connesso Google Maps e quali credenziali usa la tua app.

> [accordion] Le credenziali Base44 non compaiono quando aggiungi Google Maps
>
> Solo il proprietario dell'app può scegliere le credenziali Base44. Chiedi al proprietario dell'app di connettere Google Maps, oppure seleziona **New credentials** e usa la tua chiave API di Google Maps Platform.

> [accordion] Le chiamate con la tua chiave falliscono con un errore di Google
>
> Google rifiuta le chiamate quando un'API non è abilitata per la tua chiave o le restrizioni della chiave la bloccano. Base44 mostra l'errore di Google così com'è. Nel tuo progetto Google Cloud, abilita le [API incluse](#cosa-puoi-fare) e consentile nelle restrizioni API della chiave. Rimuovi poi dalla chiave eventuali restrizioni per siti web (HTTP referrer).

***

## Domande frequenti

> [accordion] Posso passare dalle credenziali Base44 alla mia chiave API e viceversa?
>
> Sì, puoi cambiare in qualsiasi momento. Solo il proprietario dell'app può scegliere le credenziali Base44.
>
> **Per cambiare credenziali:**
>
> 1. Clicca su **Dashboard** nell'editor della tua app.
> 2. Clicca su **Integrations**.
> 3. Clicca su **Google Maps** sotto **App connections**.
> 4. Clicca su **Change credentials**. Le credenziali che la tua app usa ora sono contrassegnate come **In use**.
> 5. Scegli come connetterti:
>    * **Base44 credentials:** clicca su **Use these credentials**.
>    * **New credentials:**
>      1. Seleziona **New credentials**.
>      2. Clicca su **Continue**.
>      3. Inserisci la tua chiave in **Google Maps Platform API key**.
>      4. Clicca su **Save credentials**.

> [accordion] Come usa i crediti Google Maps?
>
> Le chiamate con le credenziali Base44 usano crediti di integrazione, incluse le chiamate di prova che la chat AI fa mentre costruisce la tua funzionalità. Il numero di crediti dipende dalla chiamata. Una funzionalità può fare più di una chiamata ogni volta che viene eseguita, ad esempio una ricerca di luoghi e un'immagine della mappa.
>
> Per vedere cosa ha usato la tua app, [apri App usage](https://docs.base44.com/it/Account-and-billing/Credits.md#viewing-from-your-app) e seleziona **Show details** sotto **Integration credits**.

> [!NOTE]
>
> Questa pagina è stata tradotta con l'AI. Per le informazioni più accurate e aggiornate, consulta la [versione inglese](https://docs.base44.com/index.md).


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