Note di rilascio dell'API Maps JavaScript

Iscriviti a queste note di rilascio. Iscriviti

Il team dell'API Maps JavaScript aggiorna regolarmente l'API con nuove funzionalità, correzioni di bug e miglioramenti delle prestazioni. Puoi indicare quale versione dell'API caricare all'interno della tua applicazione specificandola nel parametro v della richiesta di bootstrap dell'API Maps JavaScript. Scopri di più sul controllo delle versioni.

Questo log delle modifiche elenca le release in base alla data e al numero di versione, insieme alle modifiche associate.

Questa pagina elenca le note di rilascio per il 2025 e il 2026. Per le release precedenti, consulta l'archivio delle note di rilascio dell'API Maps JavaScript.

Per ricevere aggiornamenti sulle nuove versioni dell'API di Google Maps, iscriviti al gruppo google-maps-js-api-v3-notify.

3.66.11a

22 ottobre 2026

Modifiche:

  • Gli elementi di Places UI Kit Pro (AdvancedPlaceDetailsElement, AdvancedPlaceDetailsCompactElement, AdvancedPlaceSearchElement, AdvancedPlaceListElement) sono ora disponibili a livello generale nel canale settimanale.
  • Nei layout compatti orizzontali di PlaceDetailsCompactElement (<gmp-place-details-compact>) e PlaceSearchElement (<gmp-place-search>), il pulsante icona Apri in Google Maps ora viene visualizzato nella riga superiore accanto al nome e all'indirizzo del luogo, in modo che le righe delle informazioni di base rimanenti occupino l'intera larghezza.
  • Place Details non mostra più un'area di azione vuota quando nessuno degli elementi gmp-place-link o gmp-place-button inseriti può essere visualizzato per il luogo.
  • PlaceContentConfigElement (<gmp-place-content-config>) deprecato. Aggiungi elementi di contenuto direttamente a PlaceDetailsElement o PlaceDetailsCompactElement oppure all'interno di un elemento <template slot="details-item"> in PlaceSearchElement.
  • La funzionalità KmlLayer nell'API Maps JavaScript non è più disponibile. Per saperne di più, visita la pagina https://developers.google.com/maps/deprecations.
  • [Canale alpha] È stato aggiunto PlacePinElement (<gmp-place-pin>), che mostra un segnaposto sulla mappa per un luogo utilizzando l'icona o la foto della categoria del luogo, da utilizzare come contenuto di un AdvancedMarkerElement.
  • [Canale alpha] Risolto il problema per cui i contenuti dei popup Route3DElement e Route.createPopover() venivano tagliati nelle mappe corte, ad esempio sugli smartphone con zoom della pagina al 200%.

3.66.9d

14 ottobre 2026

Modifiche:

  • Risolto un problema per cui il completamento di un trascinamento su un elemento AdvancedMarkerElement attivava erroneamente un evento di clic sulla mappa.
  • Risolve il problema per cui la finestra informativa del PDI non si chiudeva con il tasto Esc dopo aver riaperto lo stesso PDI.
  • [alpha channel] AdvancedPlaceDetailsElement, AdvancedPlaceDetailsCompactElement e AdvancedPlaceItemElement ora supportano gli slot basic-section-top e basic-section-bottom nel canale alpha.
  • [alpha channel] PlacePinElement è ora disponibile nel canale alpha per mostrare le informazioni sui luoghi su una mappa
  • Risolve il problema per cui InfoWindow non si chiudeva con il tasto Esc e lo stato attivo non tornava all'elemento precedentemente attivo quando la mappa è un elemento gmp-map.

3.66.8b

8 ottobre 2026

Modifiche:

  • Risolve il problema per cui la finestra informativa del PDI non si chiudeva con il tasto Esc dopo aver fatto di nuovo clic sull'icona del PDI.
  • Risolve il problema per cui la navigazione con i tasti Freccia della tastiera sposta lo stato attivo su AdvancedMarkerElement al di fuori dell'area della mappa visibile.
  • [canale beta] Sono stati aggiunti MapMode.ROADMAP, il controllo UI della modalità mappa, Map3DElement.colorScheme (per lo stile di mappa chiaro e scuro) e Label3DElement (<gmp-label-3d>) alle mappe 3D (Map3DElement).

3.66.7

1° ottobre 2026

Modifiche:

  • [Canale alpha] Risolto il problema per cui le icone dei mezzi di trasporto pubblico nel popover Route3DElement scomparivano in modalità Colori forzati.
  • [Canale alpha] Route.createWaypointMarkers() ora imposta un valore predefinito localizzato title ("Origine" o "Destinazione") sugli indicatori che crea.
  • [Canale alpha] Risolto il problema per cui il testo del popover Route3DElement non era visibile nelle modalità mappa ibrida e satellitare.
  • [alpha channel] 3D markers created by Route.createWaypointMarkers() now keep a constant screen size (sizePreserved is true by default).
  • [canale alpha] Ora è possibile raggiungere gli indicatori di origine e destinazione Route3DElement con la tastiera e vengono annunciati dagli screen reader. Se passi il mouse sopra un indicatore, il titolo viene visualizzato come descrizione comando.
  • [canale beta] Sono state aggiunte le proprietà Map3DElement.maxMemoryMegabytes e Map3DElement.qualityMode, insieme all'enum QualityMode, per contribuire a ridurre la memoria utilizzata dalla mappa 3D.
  • Risolto un problema per cui PopoverElement (<gmp-popover>) si spostava dalla sua ancora quando si modificava lo zoom della pagina in Safari.
  • È stato aggiunto il supporto degli eventi del puntatore tramite gmp-pointerover, gmp-pointerout e gmp-pointermove per gli elementi interattivi in Maps3D.
  • Sono state corrette le definizioni TypeScript per gli elementi di disegno delle mappe 3D (Marker3DElement, Model3DElement, Polygon3DElement, Polyline3DElement, FlattenerElement, CirclePathElement) e PopoverElement per accettare google.maps.LatLng.

3.66.6c

22 settembre 2026

Modifiche:

  • Risolto un problema per cui PlaceAutocompleteElement non mostrava il pulsante Cancella se compilato in modo programmatico tramite le opzioni del costruttore o la proprietà value.
  • [alpha channel] Removed colorScheme from google.maps.routes.RoutePolyline3DOptions. Route3DElement ora monitora la combinazione di colori effettiva dell'elemento Map3D principale.
  • [canale beta] Risolto il problema di perdita di memoria nel ciclo di vita del rendering della Panoramica in Street View.
  • [canale beta] Le icone predefinite di PlaceLinkElement possono essere nascoste con l'attributo default-icon-hidden, consentendo link ai luoghi di solo testo.

3.66.4d

9 settembre 2026

Modifiche:

  • [Canale alpha] L'intervallo minimo di AutofitsCamera è stato modificato da 2000 metri a 80 metri.
  • Eventi AdvancedMarkerElement.addListener() deprecati ed eventi legacy (click, dragstart, drag, dragend). Utilizza invece l'evento addEventListener() standard con gli eventi con prefisso gmp-.

3.66.3d

2 settembre 2026

Modifiche:

  • [Canale alpha] È stato aggiunto il campo trafficPolylinesDisabled a RoutePolyline3DOptions. In questo modo, gli sviluppatori possono disattivare le polilinee sensibili al traffico durante la creazione di polilinee di percorsi 3D.
  • [alpha channel] Optimize Route3DElement to avoid unnecessary backend requests when toggling trafficPolylinesDisabled.

3.66.2d

26 agosto 2026

Modifiche:

  • [Canale alpha] Sono state rimosse le icone 3D dei percorsi dal caricamento dei caratteri e sono state spostate negli asset SVG incorporati per evitare complicazioni durante il caricamento del carattere Material Symbols più di una volta.
  • [canale beta] Aggiunge i componenti avanzati del Places UI Kit: AdvancedPlaceDetailsElement, AdvancedPlaceDetailsCompactElement, PlaceLinkElement, PlaceButtonElement, PlaceNameElement, AdvancedPlaceListElement, AdvancedPlaceSearchElement
  • È stato aggiunto un tooltip ai nomi delle linee di trasporto pubblico per visualizzare il nome completo anche quando è troncato.
  • Sono state aggiunte le digitazioni removeEventListener per i componenti web personalizzati.
  • Risolto un problema per cui VoiceOver mostrava un contorno di stato attivo sugli elementi dello screen reader nascosti visivamente per gli indicatori di percorso

3.66.1a

17 agosto 2026

Modifiche:

  • È stato corretto il comportamento di accessibilità delle immagini statiche delle schede dei luoghi aggiungendo etichette di riserva e rimuovendo i punti di selezione della tastiera ridondanti.

3.65.12f

6 agosto 2026

Modifiche:

  • [canale alpha] Aggiunge <gmp-label-3d> (google.maps.maps3d.Label3DElement) al canale alpha dell'API JS di 3D Maps. Gli sviluppatori ora possono utilizzare il nuovo elemento per dichiarare il testo dell'etichetta e configurare in modo indipendente il comportamento della sovrapposizione separatamente dagli elementi degli indicatori 3D collegati (come <gmp-marker-3d> e <gmp-marker-3d-interactive>).
  • Fornisci nomi accessibili univoci per i pulsanti Altre opzioni nei widget Place Details.
  • [canale alpha] Messaggi di errore migliorati per la modalità di viaggio Route 3D quando TravelMode.TWO_WHEELER viene utilizzato al di fuori della versione alpha/beta
  • [alpha channel] Il componente Route3D ora supporta la proprietà trafficPolylinesDisabled. In questo modo, gli sviluppatori possono disattivare le polilinee sensibili al traffico quando utilizzano le opzioni di routing TRAFFIC_AWARE o TRAFFIC_AWARE_OPTIMAL.
  • [Canale alpha] Il padding dei limiti settentrionali di AutofitsCamera è stato aumentato per evitare il ritaglio predefinito dei segnaposto.
  • Risolto un problema per cui non era possibile trascinare Pegman di Street View sulla mappa sui dispositivi touch screen.

3.65.11b

27 luglio 2026

Modifiche:

  • [alpha channel] Enhanced Route3D popover to show non-transit icons (bicycling, driving, two-wheeler, and walking).
  • [canale alpha] Route.createWaypointMarkers crea indicatori per l'origine e la destinazione, con lo stile predefinito applicato, a meno che non venga specificata una funzione customOverride. I waypoint intermedi non sono attualmente supportati.

3.65.10a

22 luglio 2026

Modifiche:

  • È stato risolto un problema per cui Maps JS caricava il carattere Material Symbols Outlined in un modo che poteva influire sullo stesso carattere caricato nella pagina di base.
  • Risolto un problema per cui PlaceAutocompleteElement inviava un valore vuoto nel POST del modulo quando veniva inizializzato con options.value o modificato in modo programmatico tramite la proprietà value.
  • Aggiornati i controlli UI di inclinazione e direzione della mappa 3D per riattivarli se l'intervallo di limitazione della fotocamera viene aumentato.

3.65.8c (Rollback eseguito)

7 luglio 2026

Modifiche:

  • [canale alpha] Route3DElement esegue il rendering di dati aggiuntivi relativi a polilinee e popover per i percorsi di trasporto pubblico.
  • È stato aggiunto il supporto di internalUsageAttributionIds all'API Address Validation. Questa proprietà consente l'attribuzione delle chiamate API a pacchetti o librerie OSS specifici.
  • La finestra informativa predefinita per i clic sui PDI nelle mappe 2D è stata aggiornata per utilizzare i Place Widgets.
  • Migliorata l'affidabilità delle panoramiche di Street View in condizioni di traffico elevato.

3.65.6a

25 giugno 2026

Modifiche:

  • [canale beta] Aggiornata la finestra informativa predefinita per i clic sui PDI nelle mappe 2D per utilizzare i Place Widgets.
  • È stato risolto un bug per cui la mappa 3D a volte generava un errore con valori fov estremi.
  • Aggiornati i segnapunti predefiniti del percorso in modo che non utilizzino più l'opzione glyph PinElement deprecata.

3.65.5e

17 giugno 2026

Modifiche:

  • Correzione delle digitazioni per OverlayView.getMap()
  • Aggiornati i tipi per BasicPlaceAutocompleteElement e PlaceAutocompleteElement per indicare che il parametro delle opzioni del costruttore è facoltativo

3.65.3b

4 giugno 2026

Modifiche:

  • La funzionalità DrawingManager nell'API Maps JavaScript non è più disponibile. Per saperne di più, visita la pagina https://developers.google.com/maps/deprecations.
  • Contrasto dei colori migliorato per la finestra di dialogo del copyright della mappa in modalità Buio.
  • Disattiva i controlli di rotazione della mappa 3D quando vengono raggiunti i limiti di direzione.
  • È stato risolto un problema per cui il campo di immissione mobile di Place Autocomplete si sovrapponeva alla barra di stato/area sicura del sistema iOS. Nota: la correzione funziona quando viewport-fit=cover è impostato nel meta tag viewport.
  • Aggiunto il supporto di internalUsageAttributionIds all'API Maps JavaScript 3D. Questa proprietà consente agli sviluppatori di attribuire le chiamate API a pacchetti o librerie OSS specifici.
  • Aggiunto il supporto per internalUsageAttributionIds all'API Places (novità). Questa proprietà consente agli sviluppatori di attribuire le chiamate API a pacchetti o librerie OSS specifici.
  • [Canale alpha] Tipi di getter limitati delle proprietà Route3DElement per corrispondere alla normalizzazione del setter.
  • [Canale alpha] Route3DElement espone le proprietà routes, fallbackInfo e geocodingResults.

3.65.2d

27 maggio 2026

Modifiche:

  • È stato risolto un problema relativo al pulsante di zoom quando si diminuiva lo zoom su una mappa con limiti limitati.
  • La libreria Places ha introdotto transitStation nei luoghi.
  • È stato aggiunto il supporto di internalUsageAttributionIds nella libreria Routes. Questa proprietà consente agli sviluppatori di attribuire le chiamate API a pacchetti o librerie OSS specifici.

3.65.1c

20 maggio 2026

Modifiche:

  • Il logo Google sarà ora grigio scuro su sfondo bianco per i tipi di mappa Stradale e Terreno in modalità Luce, indipendentemente dal fatto che venga fornito un ID mappa o uno stile personalizzato.
  • [canale alpha] Route3DElement invia eventi gmp-load e gmp-error rispettivamente dopo chiamate API Routes riuscite ed errate.
  • È stata corretta la documentazione errata che indicava che le corrispondenze sono evidenziate nel testo secondario delle previsioni di completamento automatico. Le corrispondenze vengono evidenziate solo nel testo principale, riflettendo il comportamento di completamento automatico dell'API Places.
  • Migliorata l'ereditarietà dei colori per gli elementi di previsione di completamento automatico di Place Autocomplete, in modo che ereditino correttamente il colore impostato sull'elemento principale.
  • Sono stati aggiunti gli slot "input-icon" e "clear-icon" sia a PlaceAutocompleteElement che a BasicPlaceAutocompleteElement per la personalizzazione delle icone.
  • Sono state esposte le parti shadow prediction-item-secondary-text e prediction-item-nonmatch per gli elementi di previsione BasicPlaceAutocomplete e PlaceAutocomplete, consentendo uno stile personalizzato per il testo principale e il testo secondario non corrispondenti.
  • Aggiungi l'attributo no-clear-button e la proprietà noClearButton sia a PlaceAutocompleteElement che a BasicPlaceAutocompleteElement per consentire di nascondere il pulsante Cancella
  • La funzionalità del livello della mappa termica nell'API Maps JavaScript è stata ritirata.
  • Migliorata la gestione degli errori per il recupero della configurazione della mappa.
  • Le immagini a 45 gradi sono state ritirate per le mappe raster.
  • Sono state aggiunte le classi mancanti alla documentazione di PlacesLibrary. È stato documentato anche il metodo toString() su FormattableText.
  • Miglioramento dell'accessibilità dei link "Segnala un errore sulla mappa".

3.64.12d

6 maggio 2026

Modifiche:

  • Il metodo equals() di LatLng ora accetta oggetti LatLngLiteral anziché generare un errore. La documentazione di LatLng e LatLngAltitude equals() ora riflette con precisione anche il livello di tolleranza esistente di 1e-9.
  • [Canale alpha] Map3DElement con elementi secondari con adattamento automatico ora viene inizialmente visualizzato con la modalità di altitudine RELATIVE_TO_GROUND, che supporta la visualizzazione di aree con altitudine più elevata al caricamento per i casi in cui le proprietà della fotocamera sono predefinite anziché applicate utilizzando flyCameraTo. Inoltre, al caricamento iniziale di Map3DElement, se la mappa ha elementi secondari che utilizzano l'API AutofitsCamera ancora in funzione, il rendering iniziale della mappa viene posticipato fino al termine del loro funzionamento e la fotocamera si aggancia indipendentemente dall'impostazione dell'animazione di volo. Gli aggiornamenti successivi della fotocamera rispettano l'impostazione di volo.
  • [canale alpha] Polygon3DElement aggiunge la proprietà autofitsCamera per supportare l'adattamento automatico della videocamera.

3.64.11d

29 aprile 2026

Modifiche:

  • [Canale alpha] MarkerElement aggiunge la proprietà autofitsCamera per supportare l'adattamento automatico della fotocamera dell'indicatore.
  • Risolto un problema in PlaceAutocompleteElement per cui l'icona dell'elemento di previsione non veniva visualizzata nel browser Safari.
  • La libreria Places ha introdotto isPureServiceAreaBusiness nei luoghi. Ora è possibile richiedere risultati per le attività al domicilio del cliente impostando pureServiceAreaBusinessesIncluded nelle richieste di Place Autocomplete (API di dati e widget) e Ricerca testuale.
  • La libreria Places ha introdotto addressDescriptor, containingPlaces e timeZone nei luoghi.
  • La libreria Places ha introdotto futureOpeningDate nei luoghi. Ora è possibile richiedere risultati per le attività che non hanno ancora aperto impostando futureOpeningBusinessesIncluded nelle richieste di Place Autocomplete (API di dati e widget), Nearby Search e Ricerca testuale.
  • Il logo Google ora sarà lo stesso per la mappa stradale chiara con o senza un ID mappa o uno stile personalizzato. In precedenza, mostravamo il logo Google in modalità Buio per tutte le mappe di Roadmap utilizzando un ID mappa. Per mantenere il logo Google bianco, gli utenti devono passare alla modalità Buio.
  • Aggiunta di focus-ring come CSS Shadow Part sia in PlaceAutocompleteElement che in BasicPlaceAutocompleteElement.
  • Aggiunti nuovi FuelType DIESEL_PLUS e E100. Nuovo EVConnectorType aggiunto: NACS.
  • Sono stati aggiunti gli attributi value, placeholder, disabled, readonly, no-input-icon e maxlength a PlaceAutocompleteElement e BasicPlaceAutocompleteElement.
  • È stata aggiunta una proprietà "description" sia a PlaceAutocompleteElement che a BasicPlaceAutocompleteElement per fornire un contesto aggiuntivo agli utenti di screen reader.
  • Il tipo dichiarato di LatLngAltitudeLiteral.altitude è stato limitato per non consentire valori null o undefined. Corretto il tipo restituito dichiarato di DirectionalLocation.toJSON().

3.64.9c

14 aprile 2026

Modifiche:

  • Le dichiarazioni TypeScript ora distinguono correttamente i tipi di getter e setter delle proprietà (incluse le proprietà di sola lettura senza setter).

3.64.8b

8 aprile 2026

Modifiche:

  • [Canale alpha] Route3DElement, Marker3DElement e Polyline3DElement con autofitsCamera non causeranno aggiornamenti della fotocamera quando vengono rimossi dal DOM. Per Route3DElement, gli errori o le risposte vuote non hanno alcun effetto sulla videocamera. Inoltre, la modifica di autofitsCamera da true a false su un determinato elemento non aggiornerà la videocamera per escludere quell'elemento, ma lo escluderà dai futuri aggiornamenti della videocamera.
  • La proprietà zIndex di un elemento AdvancedMarkerElement è ora determinata dal valore impostato esplicitamente o, per impostazione predefinita, dalla posizione verticale dei pixel. I valori espliciti hanno la precedenza su quelli predefiniti. Per evitare che gli indicatori più in basso sullo schermo senza zIndex si sovrappongano inaspettatamente a quelli con, ti consigliamo di applicare zIndex in modo coerente a tutti gli indicatori.
  • Le dichiarazioni TypeScript ora includono un'interfaccia che mappa i nomi dei tag HTML alle classi JS (google.maps.HTMLElementTagNameMap e l'interfaccia globale HTMLElementTagNameMap), un'interfaccia che mappa i nomi dei tag HTML all'EventMap di ogni classe JS (google.maps.HTMLElementEventMapTagNameMap), un'interfaccia di tutte le proprietà CSS personalizzate (google.maps.CSSProperties) e ogni enum basato su stringa ha un tipo di unione di stringhe definito (come ${EnumName}String) e l'unione di stringhe viene utilizzata per l'enum in tutte le dichiarazioni. addEventListener() è anche sovraccaricato su ogni elemento personalizzato con i relativi tipi EventMap e google.maps.importLibrary() è sovraccaricato per digitare correttamente ogni libreria restituita per il nome della libreria passato.

3.64.7d

1° aprile 2026

Modifiche:

  • La proprietà mapId ora può essere aggiornata dinamicamente dopo l'inizializzazione di Map3DElement, eliminando la necessità di creare nuovamente un'istanza di Map3DElement.
  • [Canale alpha] È stato aggiunto un nuovo Route3DElement per il rendering dei percorsi su mappe 3D.
  • [Canale alpha] Sono state aggiunte nuove API Route.create3DPolylines() e Route.createPopover().
  • [Canale alpha] È stata aggiunta una nuova API spherical.traversePath().
  • [Canale alpha] È stata aggiunta una nuova API autofitsCamera a Marker3DElement, Polyline3DElement e Route3DElement, con una nuova API autofitsCameraAnimation per Map3DElement.
  • [Canale alpha] È stato aggiunto un nuovo CirclePathElement per il rendering dei cerchi con Polygon3DElement.
  • [alpha channel] Una nuova modalità mappa ROADMAP è ora disponibile su Mappe 3D nel canale alpha.
  • Risolto un bug per cui l'omino di Street View non funzionava correttamente sui dispositivi mobili quando si trovava in una mappa collegata a un elemento DOM creato in un contesto di frame diverso dal codice della libreria Maps JS.

3.64.6d

26 marzo 2026

Modifiche:

  • Risolto un problema per cui premendo Invio non veniva inviato un modulo contenente elementi di Place Autocomplete se non veniva evidenziata alcuna previsione.
  • È stata corretta una race condition che impediva a FlattenerElement di disegnare su Maps 3D.
  • È stato risolto un bug per cui la gestione del tocco sui dispositivi mobili non funzionava correttamente quando una mappa era collegata a un elemento DOM creato in un contesto iframe diverso dal codice della libreria Maps JS.

3.64.5d

18 marzo 2026

Modifiche:

  • Il canale weekly ora include diversi aggiornamenti di Maps 3D, tra cui i nuovi MarkerElement e FlattenerElement. Inoltre, abbiamo aggiunto le proprietà cameraPosition e fov, nonché il supporto di altitudeMode per i metodi flyCameraTo e flyCameraAround.
  • La libreria Places ha introdotto currentOpeningHours, regularSecondaryOpeningHours e currentSecondaryOpeningHours per i luoghi identificati. currentOpeningHours fornisce l'orario di apertura per la settimana successiva, inclusi eventuali orari eccezionali, ad esempio per le festività. Gli orari secondari sono diversi dagli orari principali di un luogo e indicano gli orari di servizi come asporto dall'auto, ritiro o asporto.
  • Risolto un problema nelle mappe 3D per cui il link a Google Maps a volte non veniva aggiornato correttamente dopo lo spostamento della mappa.

3.64.4d

12 marzo 2026

Modifiche:

  • Sincronizza la proprietà della mappa InfoWindow al cambio di posizione per risolvere il problema che causava avvisi non necessari nella console.
  • Risolve un problema per cui gli aggiornamenti programmatici fov di Map3DElement venivano occasionalmente ignorati.
  • Il metodo flyCameraAround su Map3DElement ora accetta Number.Infinity per il parametro repeatCount, consentendo un'animazione infinita.

3.64.3a

2 marzo 2026

Modifiche:

  • L'API Maps Embed ora utilizza Places UI Kit per mostrare i Place Details.
  • [canale beta] La proprietà cameraPosition introdotta in precedenza su Map3DElement nella versione 3.64.2 è ora supportata anche nel target flyCameraTo. Per saperne di più, consulta Mappe 3D in Maps JavaScript.

3.64.2b

26 febbraio 2026

Modifiche:

  • google.maps.DirectionsService, google.maps.DirectionsRenderer e google.maps.DistanceMatrixService sono ritirati a partire dal 25 febbraio 2026. Al momento, non è prevista la loro interruzione e continueranno a ricevere correzioni di bug per eventuali regressioni importanti. Verrà dato un preavviso di almeno 12 mesi prima dell'interruzione del supporto. Per ulteriori dettagli (incluse le alternative più recenti e consigliate), consulta la sezione Legacy.
  • [canale beta] È stato introdotto un nuovo MarkerElement che ti consente di visualizzare contenuti HTML personalizzati all'interno degli indicatori sulla mappa 3D. Inoltre, un nuovo FlattenerElement ora può appiattire le mesh 3D in aree specifiche.
  • [canale beta] Map3DElement è stato aggiornato con le proprietà fov e cameraPosition, mentre i metodi flyCameraTo e flyCameraAround ora supportano altitudeMode. Per saperne di più, consulta Mappe 3D in Maps JavaScript.
  • Risolto un bug che causava la generazione di un errore NotSupportedError durante la creazione di un PinElement utilizzando document.createElement('gmp-pin').

3.64.1c

19 febbraio 2026

Modifiche:

  • Aggiorna la collisione quando AdvancedMarkerElement viene ridimensionato.

3.63.14d

5 febbraio 2026

Modifiche:

  • La libreria Places ha introdotto nuove opzioni per identificare un luogo quando si richiedono dati. Oltre a utilizzare id, ora puoi specificare un resourceName per inizializzare un oggetto Place.
  • La libreria Places ha introdotto subDestinations per i luoghi identificati. Questi subDestinations forniscono destinazioni più specifiche per gli utenti che effettuano ricerche all'interno di un luogo grande o complesso, come un aeroporto, un parco nazionale, un'università o uno stadio.
  • È stato risolto un problema per cui Map3D richiedeva di specificare un'altitudine quando veniva impostata la proprietà center in JS (ora il valore predefinito è 0).
  • L'oggetto Place di PlaceDetailsElement e PlaceDetailsCompactElement ora include una proprietà googleMapsLinks, che fornisce URL per il deep linking in Google Maps per una serie di azioni. Sono inclusi gli URI per visualizzare il luogo, ottenere indicazioni stradali, visualizzare foto, leggere le recensioni esistenti e scrivere una nuova recensione.

3.63.13

29 gennaio 2026

Modifiche:

  • L'API Maps Embed non mostra più le schede riepilogative quando si posiziona il cursore del mouse sui PDI.
  • Aggiunge avvisi della console per gli elementi di Places UI Kit (Place Details + Place Search) configurati in modo errato
  • PlaceDetailsElement ora mostrerà i riepiloghi dei luoghi generati con l'AI, se disponibili.
  • Ora è disponibile un riepilogo delle recensioni creato con l'AI per PlaceDetailsElement.

3.63.10a

13 gennaio 2026

Modifiche:

  • È stato risolto un problema che impediva i gesti di scorrimento e clic all'interno dei popover.
  • I campi resourceName e shortFormattedAddress sono ora disponibili tramite l'API Places

3.63.9d

8 gennaio 2026

Modifiche:

  • PlaceSearchElement mostra i contenuti non fotografici un po' più velocemente durante il caricamento delle foto. Le animazioni di dissolvenza in entrata delle foto sono state perfezionate in Places UI Kit.
  • Miglioramento del rendimento durante il rendering delle polilinee su una mappa inclinata.
  • Risolto un bug per cui la fotocamera della mappa 3D non si aggiornava se impostata in modo programmatico in determinate condizioni.
  • Piccolo miglioramento delle prestazioni nel caricamento delle foto per PlaceDetailsElement e PlaceSearchElement.
  • È stato chiarito il comportamento della proprietà draggable in MapOptions per spiegare meglio i vincoli di interazione dell'utente.
  • Forza l'accesso al canale beta per possibleNextAction nella libreria Address Validation
  • Aggiungi il supporto della proprietà placeholder e dell'attributo HTML a PlaceAutocompleteElement
  • PlaceAutocompleteElement ora supporta la personalizzazione di altre proprietà dei caratteri CSS standard, tra cui: font, font-size, font-family, font-weight, line-height, font-style e color. La dimensione carattere predefinita ora diventa 16 px.
  • Aggiungi il supporto della proprietà value e dell'attributo HTML a PlaceAutocompleteElement
  • Ottimizza il caricamento delle immagini in Places UI Kit.
  • Aggiunta della parte CSS input a PlaceAutocompleteElement

3.63.5d

11 dicembre 2025

Modifiche:

  • Lancia l'API Address Validation nell'API Maps JavaScript
  • mapTypeId ora viene impostato su MapTypeId.ROADMAP per impostazione predefinita quando è impostato su null o undefined, risolvendo un problema che poteva impedire il caricamento dei riquadri della mappa.
  • Nascondi la sezione delle recensioni in PlaceDetailsElement se il luogo non è valutabile.
  • Contrasto di colore migliorato per il logo Google mostrato su google.maps.Map con stile personalizzato
  • Le mappe vettoriali ora utilizzano le stesse immagini satellitari delle mappe raster, consentendo una maggiore fedeltà visiva.

3.63.4a

4 dicembre 2025

Modifiche:

  • --gmp-mat-spacing-medium ora si applica al padding del contenitore interno per la visualizzazione orizzontale di PlaceDetailsCompactElement.
  • È stato risolto un problema relativo allo spostamento della mappa 3D su macOS Safari durante l'interazione con i controlli UI.
  • Le proprietà language e region ora possono essere modificate dinamicamente su Map3DElement senza dover ricreare una mappa.

3.63.1b

20 novembre 2025

Modifiche:

  • Risolto un problema per cui la finestra informativa non era posizionata correttamente quando era collegata a un AdvancedMarkerElement.
  • Il pulsante Cancella di PlaceAutocompleteElement è stato reso visibile solo quando l'input contiene testo.
  • È stata resa senza distinzione tra maiuscole e minuscole la corrispondenza dell'attributo di orientamento negli stili PlaceDetailsCompactElement.
  • È stata aggiunta la possibilità di disattivare la panoramica della mappa quando PopoverElement è aperto in Maps 3D.
  • Risolto un bug che impedisce l'utilizzo di addEventListener() su PinElement.
  • Le finestre di dialogo modali (come la finestra di dialogo delle scorciatoie da tastiera sulla mappa e la finestra di dialogo delle informative in Places UI Kit) ora si chiudono con un clic all'esterno dell'area dei contenuti.
  • I dati sui luoghi ora includono riepiloghi informativi creati con l'AI per le recensioni e i servizi nelle vicinanze. Le nuove proprietà sono evChargeAmenitySummary, neighborhoodSummary, generativeSummary e reviewSummary.

3.62.13e

6 novembre 2025

Modifiche:

  • Risolto un problema di perdita di memoria quando un PopoverElement viene aggiunto e rimosso dinamicamente dal DOM.
  • Risolto un problema di perdita di memoria quando un Map3DElement viene aggiunto e rimosso dinamicamente dal DOM.
  • È stato corretto l'allineamento degli angoli arrotondati delle immagini con gli angoli arrotondati dei contenitori quando si utilizza un bordo spesso in PlaceDetailsCompactElement.

3.62.12c

30 ottobre 2025

Modifiche:

  • [alpha channel] Removed the experimental ElevationElement.
  • Sono state aggiunte variabili CSS per background-color, border-radius, box-shadow e padding a Map 3D PopoverElement.
  • Le lightbox delle foto di Places UI Kit non si chiudono più quando si fa clic all'esterno della foto.

3.62.11d

23 ottobre 2025

Modifiche:

  • [alpha channel] Make dark mode work for highlighting place contextual list items.
  • Aggiunte le proprietà anchorLeft e anchorTop a AdvancedMarkerElementOptions.
  • Il componente web <gmp-pin> è ora disponibile. Utilizza la nuova proprietà glyphSrc per fornire un URL immagine per il glifo o la proprietà glyphText per visualizzare il testo. La proprietà glyph è ora deprecata su PinElement.
  • Impedisce la visualizzazione imprevista della finestra informativa quando viene creato un AdvancedMarker associato al di fuori dell'area visibile.
  • 3D Maps è ora disponibile nel canale settimanale. Questa release include un nuovo controllo della bussola e controlli UI predefiniti semplificati, il supporto per la personalizzazione delle mappe basata su cloud e la gestione dei gesti cooperativi, una localizzazione migliorata con nuove proprietà language e region su Map3DElement, nonché miglioramenti dell'accessibilità per le etichette delle mappe base. Per saperne di più, consulta Mappe 3D in Maps JavaScript.
  • Migliorata la gestione della memoria per Map 3D per evitare problemi di memoria esaurita sui dispositivi iOS.
  • Lancio di Routes JS. Consente agli sviluppatori di effettuare chiamate API Routes e disegnare percorsi con l'API Maps JS.

3.62.9c

9 ottobre 2025

Modifiche:

  • Sono state aggiunte le proprietà anchorTop e anchorLeft a AdvancedMarkerElement. In questo modo, è possibile modificare il punto di ancoraggio di un indicatore in un punto diverso da quello predefinito in basso al centro.

3.62.8d

2 ottobre 2025

Modifiche:

  • Nuovi controlli della fotocamera abilitati per l'API Maps Embed.
  • [canale beta] La proprietà defaultUIDisabled nella classe Map3DElement e nell'interfaccia Map3DElementOptions è stata sostituita con defaultUIHidden. defaultUIDisabled continuerà a funzionare nel canale beta.
  • [canale beta] La proprietà rounds nell'interfaccia FlyAroundAnimationOptions è stata sostituita con repeatCount. rounds continuerà a funzionare nel canale beta.
  • La proprietà mapMode è ora deprecata su PlaceContextualElement.

3.62.7e

25 settembre 2025

Modifiche:

  • Attiva gli indicatori di evidenziazione per PlaceContextualElement.

3.62.6d

18 settembre 2025

Modifiche:

  • [canale beta] Chiarisci i messaggi di errore di Route.
  • [canale beta] Supporto dei nomi delle risorse Place nelle richieste Route.
  • [canale beta] Consenti la creazione di polilinee Route da percorsi RouteLeg.

3.62.5d

10 settembre 2025

Modifiche:

  • [canale beta] La proprietà coordinates in Polyline3DElement è stata sostituita con path, che ora è disponibile come attributo HTML. La proprietà outerCoordinates di Polygon3DElement è stata sostituita con path, che ora è disponibile come attributo HTML. La proprietà innerCoordinates di Polygon3DElement è stata sostituita da innerPaths. Tutte le proprietà "coordinates" di questi due elementi sono state ritirate, ma continueranno a funzionare nel canale beta.

3.62.3c

3 settembre 2025

Nessuna modifica visibile pubblicamente.

3.62.2c

28 agosto 2025

Modifiche:

3.62.1

21 agosto 2025

Modifiche:

  • [canale beta] Sono stati aggiunti sessionToken e placeAutocompleteElement come opzioni facoltative per l'API Address Validation per la gestione delle sessioni in AddressValidation.fetchAddressValidation()
  • [canale beta] Lancio di Routes JS. Consente agli sviluppatori di effettuare chiamate API Routes e disegnare percorsi con l'API Maps JS.

3.61.14

7 agosto 2025

Modifiche:

  • Risolve un problema per cui la lightbox delle foto non era disponibile nell'elemento Place Details Compact in modalità orizzontale.

3.61.12c

31 luglio 2025

Modifiche:

  • È stata aggiunta la documentazione per i campi aggiuntivi in PlaceAutocompleteElementOptions e BasicPlaceAutocompleteElementOptions.
  • Risolto un problema per cui gli indicatori avanzati lampeggiavano brevemente e poi scomparivano quando venivano spostati fuori dallo schermo.
  • Aggiunta di googleMapsLinks alla classe Place.

3.61.11a

24 luglio 2025

Modifiche:

  • Aggiungi originalText e originalTextLanguageCode alla classe Place Review.
  • [Canale alpha] Attiva mapMode per il widget di grounding di PlaceContextual Maps. Consente agli utenti di passare da ROADMAP a HYBRID e NONE.
  • [canale beta] Map3DElement ora attiva un evento se l'inizializzazione della mappa non va a buon fine, ad esempio a causa della mancanza del supporto di WebGL nel browser dell'utente.
  • Le immagini a 45° sulla mappa sono ora deprecate. Per saperne di più, consulta Deprecazioni - Immagini a 45°.

3.61.10d

17 luglio 2025

Modifiche:

  • Il widget Place Autocomplete di base è ora disponibile nel canale settimanale.
  • [Canale alpha] Rimuovi l'elemento PlaceListElement sperimentale.
  • Aggiungi PlaceSearchElement e gli elementi di configurazione / richiesta associati.
  • Token di stile aggiuntivi per PlaceDetailsElement e PlaceDetailsCompactElement.

3.61.9a

10 luglio 2025

Modifiche:

  • Sono stati aggiornati gli indicatori per evitare istruzioni di navigazione ripetute su ogni elemento quando si utilizza uno screen reader. Ora le istruzioni vengono annunciate una sola volta ogni volta che accedi al gruppo.
  • È stato risolto un problema di contrasto nella finestra di dialogo delle scorciatoie da tastiera in modalità Buio.
  • Attiva il supporto per la personalizzazione di bordo, raggio del bordo, colore di sfondo del widget e combinazione di colori per l'elemento Place Autocomplete. L'elemento Place Autocomplete ora rispetta automaticamente la modalità Buio. Per disattivarlo, applica color-scheme: light in CSS.
  • Sono stati aggiunti i campi googleMapsURI alle classi Place Photo e Review.
  • [canale beta] Aggiunta dell'enum PossibleNextAction all'API Address Validation.

3.61.7a

1° luglio 2025

Modifiche:

  • La funzionalità Heatmap Layer nell'API Maps JavaScript non è più supportata. Questa API è stata ritirata a maggio 2025 e non sarà più disponibile in una versione successiva dell'API Maps JavaScript, che verrà rilasciata a maggio 2026. Per saperne di più, consulta la pagina https://developers.google.com/maps/deprecations).
  • Risolve un problema in GA che impedisce l'elaborazione dei clic sui PDI nascosti dallo stile personalizzato.
  • [canale beta] È stata aggiunta una gestione aggiuntiva per la perdita di contesto WebGL nelle mappe 3D. Le mappe 3D ora proveranno a ripristinarsi quando viene ripristinato il contesto WebGL.

3.61.6d

26 giugno 2025

Modifiche:

  • Aggiungi internalUsageAttributionIds a Map3DElement e Map3DElementOptions.

3.61.5a

17 giugno 2025

Modifiche:

  • Abilita il supporto della stringa "IP_BIAS" per LocationBias per Place Autocomplete.
  • È stato corretto un errore della documentazione per SearchNearbyRequest. Il valore predefinito per SearchNearbyRequest.RankPreference è POPULARITY, non DISTANCE.

3.61.4a

12 giugno 2025

Modifiche:

  • Aggiunta dell'enum RPCStatus per descrivere i codici di stato restituiti da determinati servizi web.

3.61.3b

5 giugno 2025

Nessuna modifica visibile pubblicamente.

3.61.2

29 maggio 2025

Modifiche:

  • Sono stati aggiunti PlaceDetailsElement, PlaceDetailsCompactElement e gli elementi di configurazione associati. Rimosso PlaceDetailsSize.
  • È stato risolto un problema relativo a PlaceAutocompleteElement per cui la selezione di una voce IME causava la selezione di un elemento di previsione da parte dell'elemento.

3.61.1

22 maggio 2025

Modifiche:

  • [canale beta] Correzione della posizione/dell'area visibile mancante nell'output del luogo PlaceDetailsCompactElement.
  • I dettagli a livello di strada sono disponibili nelle città coperte.

3.60.12

8 maggio 2025

Modifiche:

  • [Canale beta] Aggiunto il supporto dell'API Address Validation nell'API Maps JavaScript.
  • Risolto un problema relativo alle chiamate di rete da contesti senza intestazioni Origin.

3.60.11 (Rollback eseguito)

1° maggio 2025

Modifiche:

  • [canale beta] Aggiungi PlaceDetailsCompactElement e gli elementi di configurazione associati.
  • Risolto il problema per cui StreetViewPanoramaOptions.zoomControl = false non funzionava per le mappe di Street View.

3.60.10

24 aprile 2025

Modifiche:

  • [canale beta] 3D Maps è ora disponibile nel canale beta. Questa release include miglioramenti dell'accessibilità e nuovi elementi interattivi per polilinee, poligoni e modelli 3D. Inoltre, è ora disponibile un nuovo PopoverElement per la visualizzazione di contenuti HTML personalizzati su mappe 3D. Per saperne di più, consulta Mappe 3D in Maps JavaScript.

3.60.9

17 aprile 2025

Modifiche:

  • [alpha channel] Launch PlaceContextualElement to unrestricted experimental.
  • [Canale alpha] I modelli 3D vengono ora visualizzati con un'illuminazione basata su immagini (IBL) per impostazione predefinita su Maps 3D.

3.60.8

9 aprile 2025

Modifiche:

  • [canale beta] L'API LocalContext è stata completamente rimossa. Il tentativo di creare un'istanza di LocalContextMapView ora genera un errore. Per saperne di più, consulta la pagina https://developers.google.com/maps/deprecations#localcontext-deprecation.
  • Risolto un bug che causava un comportamento anomalo durante il trascinamento dei segnaposto avanzati sui dispositivi touch.
  • È stata aumentata l'opacità dell'overlay Gestione dei gesti cooperativi in modo che il testo soddisfi i requisiti di contrasto in tutte le aree della mappa.
  • Aggiungi il supporto per PostalAddress nell'API Places.
  • Assicura che l'overlay mappa statica all'avvio abbia lo stesso colorScheme della mappa sottostante.

3.60.7b

3 aprile 2025

Modifiche:

  • Il widget Place Autocomplete è ora disponibile nel canale settimanale.

3.60.6

27 marzo 2025

Modifiche:

  • Risolto un problema su Safari per cui le pagine che utilizzavano overscroll-behavior non scorrevano correttamente.
  • Risolto lo sfarfallio che si verificava quando venivano aggiunti molti indicatori avanzati con il comportamento della sovrapposizione attivato.
  • È stato aggiunto il supporto di PriceRange in Places.

3.60.5 (Rollback eseguito)

20 marzo 2025

Modifiche:

  • Risolto un bug che impediva lo scorrimento della pagina quando si faceva clic o si toccavano gli indicatori avanzati.
  • Risolto un bug che impediva il corretto funzionamento della modalità a schermo intero in <gmp-map>.
  • Risolto un bug per cui la finestra informativa di un indicatore avanzato nascosto era ancora visibile.
  • Le mappe con stili personalizzati in Roadmap non perderanno lo stile personalizzato quando viene aggiunto il livello Bicicletta.

3.60.4

11 marzo 2025

Modifiche:

  • Gli stili e i colori di sfondo personalizzati vengono applicati al tipo di mappa e alla combinazione di colori specifici per cui è definito lo stile (inizialmente, questo sarà limitato a Roadmap e Roadmap scura). Il livello Trasporto pubblico manterrà lo stile personalizzato per il tipo di mappa selezionato.

3.60.3 (Rollback eseguito)

5 marzo 2025

Modifiche:

  • Risolto un bug che impediva la visualizzazione del riquadro delle indicazioni stradali.

3.60.2

27 febbraio 2025

Modifiche:

  • Places: aggiunto il supporto per il tipo di connettore EV NACS (SAE J3400).
  • Rilascio degli elementi HTML gmp-map e gmp-advanced-marker in GA.

3.60.1

20 febbraio 2025

Modifiche:

  • [Canale alpha] altitudeMode su Polygon3DElement e Polyline3DElement ora utilizza CLAMP_TO_GROUND come impostazione predefinita.
  • [Canale alpha] Ora è necessario impostare una nuova opzione mode su Map3DElement per il rendering della mappa 3D (sono disponibili due nuovi valori HYBRID e SATELLITE). L'opzione defaultLabelsDisabled esistente è stata rimossa. Imposta mode su HYBRID o SATELLITE.
  • [canale beta] Il colore di sfondo tornerà al valore predefinito o al colore impostato in MapOptions se non è stato impostato specificamente per un determinato tipo di mappa.
  • [canale beta] Gli stili personalizzati raster devono essere applicati solo al tipo di mappa a cui è stato assegnato lo stile.
  • È stato risolto un problema per cui i segnaposto avanzati si spostavano quando venivano trascinati in modalità a schermo intero. È stato inoltre risolto un problema relativo all'offset del Pegman di Street View quando veniva trascinato in modalità a schermo intero.
  • Sostituisci il controllo dello zoom predefinito con il nuovo controllo della videocamera, che contiene i pulsanti di panoramica e zoom.
  • Aggiorna le icone dei pulsanti di zoom per allinearle alle nuove icone dei pulsanti di panoramica.

3.59.8

6 febbraio 2025

Modifiche:

  • Ora i clienti possono accedere ai valori TransitFare sotto forma di testo.
  • [Canale alpha] È stato lanciato il nuovo AirQualityMeterElement: <gmp-air-quality-meter>.
  • [Canale alpha] L'utilizzo di PlaceAutocompleteElement ora richiede l'abilitazione dell'API Places (nuova) nel progetto Google Cloud. .
  • [Canale alpha] PlaceAutocompleteElement: l'evento gmp-placeselect è sostituito da gmp-select e fornisce un oggetto PlacePredictionSelectEvent anziché un oggetto PlaceAutocompletePlaceSelect.
  • [Canale alpha] PlaceAutocompleteElement: l'evento gmp-requesterror è sostituito da gmp-error e fornisce un oggetto Event anziché un oggetto PlaceAutocompleteRequestErrorEvent.
  • [alpha channel] PlaceAutocompleteElement: componentRestrictions is replaced by includedRegionCodes.
  • [alpha channel] PlaceAutocompleteElement: types è sostituito da includedPrimaryTypes.

3.59.7

30 gennaio 2025

Modifiche:

  • [canale beta] I colori di sfondo della mappa stradale e della mappa stradale in modalità Buio impostati per gli stili personalizzati devono essere visualizzati dietro i riquadri e oltre i margini della mappa.
  • [Canale beta] Una mappa stradale con stile personalizzato (o una mappa stradale in modalità Buio) manterrà lo stile personalizzato quando viene aggiunto un livello di trasporto pubblico, anziché tornare allo stile mappa base predefinito.
  • Le mappe in modalità Buio rimarranno in questa modalità quando viene aggiunto il livello Trasporto pubblico.

3.59.6

23 gennaio 2025

Nessuna modifica visibile pubblicamente.

3.59.5

16 gennaio 2025

Modifiche:

  • Risolto un bug che causava errori non rilevati durante la creazione di una panoramica in Street View personalizzata.

3.59.4a

9 gennaio 2025

Modifiche:

  • È stato corretto un bug che causava errori non rilevati quando il livello del traffico era attivo.
  • [Canale beta] Risolve un problema per cui PlaceAutocompleteElement non restituiva correttamente lo stato attivo.
  • [canale beta] Gli elementi della mappa atomici verranno mostrati nelle città supportate a partire dal livello di zoom 17.

Note di rilascio precedenti

Per le note di rilascio del 2024 e degli anni precedenti, consulta l'archivio delle note di rilascio dell'API Maps JavaScript.