Migrazione: modulo Maps in google.load

Il 13 ottobre 2021 disattiveremo il servizio che fornisce il modulo "Mappe" per google.load. Ciò significa che dopo il 13 ottobre 2021, se provi a utilizzare il modulo "Mappe" in google.load, riceverai un errore (il modulo "Mappe" non è supportato) e non verrà caricata nessuna mappa. Per evitare potenziali malfunzionamenti, devi passare a una delle alternative.

Che cosa devo fare?

Rimuovi innanzitutto il tag <script> che carica il caricatore google.load, quindi rimuovi le chiamate a google.load. Se utilizzi il caricatore Google per altri scopi, puoi lasciare il tag <script> del caricatore.

Successivamente, implementa un nuovo modo per caricare l'API Maps JavaScript (seleziona una delle seguenti opzioni):

Esempio attuale che utilizza il caricatore Google

L'esempio seguente mostra come viene attualmente utilizzato il caricatore Google per caricare l'API Maps JavaScript (sono presenti due blocchi <script>):

Prima

<script type='text/javascript' src='https://www.google.com/jsapi'></script>
<script type='text/javascript'>
google.load("maps", "3.exp", {
    "callback": initMap,
    "key": "YOUR_KEY",
    "libraries": "places,visualization"
});
function initMap() {
  // Google Maps JS API is loaded and available
}
</script>

Quando viene utilizzato questo approccio, l'API Maps JavaScript viene caricata nello stesso momento in cui viene caricata la pagina. Per implementare il caricamento in linea, devi prima sostituire il tag <script> che carica www.google.com/jsapi (&quot;before&quot;) con il tag <script> mostrato nell'esempio seguente:

<script async src="https://maps.googleapis.com/maps/api/js?libraries=places,visualization&key=YOUR_API_KEY&v=weekly&callback=initMap">
</script>

Quindi, nel codice JavaScript, rimuovi la chiamata alla funzione google.load, poiché non è più necessaria. L'esempio seguente mostra una funzione initMap() vuota, che viene richiamata quando la libreria di Maps è stata caricata correttamente:

<script type='text/javascript'>
function initMap() {
  // Google Maps JS API is loaded and available
}
</script>

Visualizza la documentazione

Caricamento dinamico da un altro file JavaScript

Il caricamento dinamico ti consente di controllare quando viene caricata l'API Maps JavaScript. Ad esempio, puoi attendere di caricare l'API Maps JavaScript finché l'utente non fa clic su un pulsante o non esegue un'altra azione. Per implementare il caricamento dinamico, innanzitutto sostituisci il tag <script> che carica www.google.com/jsapi ("prima") con il codice per aggiungere il tag <script> in modo programmatico, come mostrato nell'esempio seguente:

var script = document.createElement('script');
script.src =
'https://maps.googleapis.com/maps/api/js?libraries=places,visualization&key=YOUR_API_KEY&v=weekly&callback=initMap';
script.async=true;

Quindi collega la funzione di callback all'oggetto finestra in questo modo:

window.initMap = function() {
  // Google Maps JS API is loaded and available
};

Infine, aggiungi il tag <script> all'intestazione della pagina nel seguente modo:

document.head.appendChild(script);

Consulta la documentazione