Annuncio: i nuovi stili delle mappe base saranno presto disponibili su Google Maps Platform. Questo aggiornamento dello stile della mappa include una nuova tavolozza dei colori predefinita, segnaposto moderni e miglioramenti alle esperienze sulla mappa e all'usabilità. Tutti gli stili di mappa verranno aggiornati automaticamente a marzo 2025. Per ulteriori informazioni sulla disponibilità e su come attivare in anteprima la funzionalità, consulta Nuovo stile di mappa per Google Maps Platform.

Questa pagina è stata tradotta dall'API Cloud Translation.

Risoluzione dei problemi

Errori relativi alla chiave API e alla fatturazione

In determinate circostanze, è possibile che venga visualizzata una mappa scura o un'immagine di Street View "negativa" con la filigrana "Solo a scopo di sviluppo". Questo comportamento in genere indica problemi con una chiave API o con la fatturazione. Per utilizzare i prodotti Google Maps Platform, la fatturazione deve essere attivata nel tuo account e tutte le richieste devono includere una chiave API valida. La seguente procedura ti aiuterà a risolvere il problema:

Utilizzi una chiave API?

Non saprei. Come faccio a verificare se sto utilizzando una chiave API?

Una chiave API viene passata come parametro key nell'URL utilizzato per caricare l'API Maps JavaScript. Di seguito sono riportate alcune opzioni per verificare se utilizzi una chiave API:

Utilizza l'estensione di Chrome Google Maps Platform API Checker. In questo modo puoi determinare se il tuo sito web implementa correttamente le API di Maps concesse in licenza da Google.
Se utilizzi una libreria o un plug-in per caricare l'API Maps JavaScript, controlla le impostazioni della libreria e cerca un'opzione per la chiave API.
Controlla gli errori nel browser. Se visualizzi i seguenti messaggi, significa che non stai utilizzando correttamente la chiave API:

Avviso relativo all'API Google Maps JavaScript: NoApiKeys
Errore dell'API Google Maps JavaScript: MissingKeyMapError

Per gli sviluppatori web:

Se hai accesso al codice sorgente della tua applicazione, cerca il tag <script> utilizzato per caricare l'API Maps JavaScript. Quando carichi l'API Maps JavaScript, sostituisci YOUR_API_KEY nel codice seguente con la tua chiave API.
```
  <script async defer
    src="https://maps.googleapis.com/maps/api/js?key=YOUR_API_KEY&callback=initMap">
  </script>
```
Controlla il traffico di rete generato dal tuo sito web nel browser. In Chrome, puoi visualizzarlo utilizzando la scheda Rete di DevTools. Qui vedrai le richieste di rete effettuate dal tuo sito web. Le richieste effettuate utilizzando l'API Maps JavaScript saranno nel percorso maps/api/js. Qui puoi verificare se le richieste utilizzano il parametro key. Può essere utile filtrare il traffico di rete in base a maps/api/js quando visualizzi la scheda Rete.

No, non utilizzo una chiave API.

Per ottenere una chiave API, fai clic sul pulsante di seguito. Se non vedi una configurazione guidata, segui le istruzioni complete nella pagina Iniziare a utilizzare Google Maps Platform.
Inizia

Sì, sto utilizzando una chiave API.

Bene. Andiamo avanti e controlliamo se è associato un account di fatturazione al tuo progetto.

Un account di fatturazione è collegato al tuo progetto?

Non saprei. Come posso controllare se l'account di fatturazione è collegato al mio progetto?

Vai alla pagina Fatturazione nella console Google Cloud e seleziona il progetto in cui è stata creata la chiave API. Per verificare che la chiave sia associata al progetto:

Vai alla sezione Credenziali, a cui puoi accedere dalla barra laterale sinistra in Google Maps Platform > Credenziali.
Verifica che la chiave API che utilizzi attualmente sul tuo sito web sia elencata. In caso contrario, passa a un altro progetto e controlla le credenziali.
Se non riesci a trovare il progetto per la tua chiave API, potresti aver perso l'accesso a questo progetto. Chiedi aiuto ad altri membri della tua organizzazione. Se non è possibile trovare il progetto originale, devi:
1. Crea un nuovo progetto. Per farlo, seleziona Nuovo progetto dall'elenco dei progetti o Crea progetto tramite la pagina Resource Manager.
2. Creazione di una nuova chiave API. Puoi farlo nella pagina Credenziali. Una volta qui, fai clic su Crea credenziali e poi seleziona Chiave API.

Dopo aver individuato il progetto in Cloud Console, controlla se è collegato un account di fatturazione nella sezione Fatturazione del menu a sinistra.

No, un account di fatturazione non è collegato al mio progetto.

Vai alla pagina Abilita fatturazione nella console Cloud e aggiungi un account di fatturazione al progetto. Per ulteriori informazioni, consulta Iniziare a utilizzare Google Maps Platform.

Sì, un account di fatturazione è associato al mio progetto.

Bene. Assicurati che il metodo di fatturazione fornito sia valido.

Il metodo di fatturazione fornito non è più valido, ad esempio una carta di credito scaduta?

Puoi aggiungere, rimuovere o aggiornare un metodo di pagamento nella Console Cloud.

È stato superato il limite giornaliero autoimpostato per l'API?

Se hai impostato un limite giornaliero per una delle tue API, cosa comune per evitare aumenti imprevisti, puoi risolvere il problema aumentando il limite giornaliero.

Puoi controllare i tuoi limiti giornalieri nella dashboard API e servizi in Cloud Console. Una volta lì:

Seleziona un progetto, se richiesto.
Seleziona un'API dall'elenco e poi fai clic sulla scheda Quote.

La tua chiave API ha una limitazione degli indirizzi IP?

Le chiavi API con una limitazione degli indirizzi IP possono essere utilizzate solo con i servizi web destinati all'utilizzo lato server (ad esempio l'API Geocoding e altre API di servizi web). La maggior parte di questi servizi web ha servizi equivalenti all'interno dell'API Maps JavaScript (ad esempio, consulta il servizio di geocodifica). Per utilizzare i servizi lato client dell'API Maps JavaScript, devi creare una chiave API separata che può essere protetta con una limitazione dei referrer HTTP (vedi Ottenere, aggiungere e limitare una chiave API).

Se il codice non funziona:

Per aiutarti a mettere in funzione il codice di Maps, Brendan Kenny e Mano Marks indicano alcuni errori comuni e come correggerli in questo video.

Cerca gli errori ortografici. Ricorda che JavaScript è un linguaggio sensibile alle maiuscole.
Verifica le basi: alcuni dei problemi più comuni si verificano durante la creazione iniziale della mappa. Ad esempio:
- Verifica di aver specificato le proprietà zoom e center nelle opzioni della mappa.
- Assicurati di aver dichiarato un elemento div in cui la mappa verrà visualizzata sullo schermo.
- Assicurati che l'elemento div per la mappa abbia un'altezza. Per impostazione predefinita, gli elementi div vengono creati con un'altezza pari a 0 e sono quindi invisibili.
Consulta i nostri esempi per un'implementazione di riferimento.
Utilizza un debugger JavaScript per identificare i problemi, ad esempio quello disponibile negli Strumenti per sviluppatori di Chrome. Per prima cosa, controlla se nella console JavaScript sono presenti errori.
Pubblica domande su Stack Overflow. Le linee guida su come pubblicare ottime domande sono disponibili nella pagina Assistenza.