Deprecazioni

traduzione: umano

Questa pagina elenca tutti i prodotti e le funzionalità di Google Maps Platform che sono attualmente in un periodo di deprecazione. Sono inclusi i prodotti in Maps, Routes e Places.

Come funziona il ritiro

Il periodo di deprecazione di un prodotto, di una funzionalità o di una versione inizia alla data dell'annuncio relativo al ritiro. Il prodotto, la funzionalità o la versione continueranno a essere disponibili per tutto il periodo di deprecazione (in genere 12 mesi). Una volta trascorso il periodo di deprecazione, il prodotto, la funzionalità o la versione dovrebbero essere dismessi e non saranno più disponibili.

I proprietari del progetto con indirizzi email monitorati ricevono notifiche proattive sulle modifiche che interessano ciascuno dei loro progetti. Resta al corrente su importanti aggiornamenti, ritiri e altre modifiche.

Ritiro nelle versioni dell'SDK

Negli SDK e nell'API Maps JavaScript, il ritiro delle funzionalità è legato alla disponibilità della versione. Le nuove versioni principali dichiarano le modifiche che provocano errori, inclusi i ritiri di funzionalità e le note di rilascio, che indicano la versione massima che supporta ogni funzionalità deprecata. Puoi continuare a utilizzare la funzionalità ritirata finché è disponibile la versione massima dell'SDK che supporta l'SDK. Per eseguire l'upgrade alla versione principale successiva dell'SDK, devi rimuovere l'utilizzo della funzionalità deprecata dal codice o eseguire la migrazione alla versione sostitutiva.

Scopri di più sulla disponibilità della versione dell'API Maps JavaScript, che segue un rilascio trimestrale e una pianificazione di ritiro.

Consulta le indicazioni sulla gestione delle dipendenze di versione con Maps SDK for Android, Maps SDK for iOS, SDK Places per Android e SDK Places per iOS.

Ritiri attivi

Questa sezione elenca tutti i prodotti e le funzionalità che al momento rientrano in un periodo di ritiro.


google.maps.Marker nell'API Maps JavaScript (deprecata a febbraio 2024)

Gli indicatori avanzati (google.maps.flag.AdvancedMarkerElement) sono migliori di google.maps.Marker sotto quasi tutti gli aspetti: sono più facili da usare, sono più performanti, più accessibili, più ricchi di funzionalità e più personalizzabili. google.maps.Marker nell'API Maps JavaScript è deprecato a partire dalla versione 3.56.

Cosa devo fare? Utilizza invece google.maps.marker.AdvancedMarkerElement. La versione minima dell'API Maps JavaScript con google.maps.flag.AdvancedMarkerElement è la 3.53.2. Al momento non è prevista la disattivazione di google.maps.Marker, ma google.maps.flag.AdvancedMarkerElement è consigliato rispetto a google.maps.Marker. Anche se google.maps.Marker continuerà a ricevere correzioni di bug per le regressioni principali, i bug esistenti in google.maps.Marker non verranno risolti. Prima dell'interruzione dell'assistenza, verrà dato un preavviso di almeno 12 mesi.


Limiti, posizione e raggio nel servizio Place Autocomplete dell'API Maps JavaScript (deprecato a maggio 2023)

Per il servizio Place Autocomplete nell'API Maps JavaScript, a partire da maggio 2023 le seguenti opzioni di richiesta sono deprecate: limiti, località e raggio. Utilizza invece locationBias e limitazione di località.

La funzionalità continuerà a funzionare e verrà dato un preavviso di 12 mesi prima che l'assistenza venga sospesa.


Libreria di compatibilità di Places per l'SDK Places per Android (al 31 marzo 2022)

Tutte le versioni della libreria di compatibilità di Places per l'SDK Places per Android sono deprecate a partire dal 31 marzo 2022. Stiamo bloccando lo sviluppo della libreria di compatibilità di Places su Places SDK for Android v2.6.0 (specificato nelle dipendenze come com.google.android.libraries.places:places-compat:2.6.0).

Dopo questa data non verrà rilasciata nessuna nuova versione di questa libreria. L'unico modo per accedere alle funzionalità e alle correzioni di bug in Places SDK for Android versione 2.6.0 sarà utilizzare l'SDK Places for Android.

La libreria di compatibilità di Places è stata introdotta a gennaio 2019 per facilitare la migrazione dall'SDK precedente (disponibile in Play Services) all'SDK Places per Android autonomo.

Segui la guida alla migrazione per utilizzare direttamente l'SDK Places per Android. Alcuni codici di stato, nomi di metodi e nomi di classi Autocomplete sono diversi tra la libreria di compatibilità di Places e l'SDK Places for Android. Consulta la documentazione relativa alle versioni per specificare e gestire le dipendenze nelle versioni dell'SDK Places per Android.

Al momento non è prevista la disattivazione della libreria per la compatibilità di Places. Tuttavia, se scegli di continuare a utilizzare le versioni disponibili della libreria di compatibilità di Places, tieni presente le limitazioni relative al supporto di versioni precedenti di un SDK.


Aggiornamento dei criteri di sicurezza del contenuto (21 marzo 2022 - mag 2023)

Il supporto per i siti web che utilizzano Criterio di sicurezza del contenuto (CSP) che non specificano googleapis.com nell'API Maps JavaScript è deprecato a partire dalla versione 3.49 e non sarà più supportato a partire dalla versione 3.50. L'ultima versione di supporto, v3.49, verrà dismessa nel secondo trimestre del 2023, dopodiché l'API Maps JavaScript rifiuterà tutte le richieste che utilizzano direttive CSP che non specificano googleapis.com.

Per evitare interruzioni dell'esperienza con il sito web, specifica googleapis.com nel tuo CSP. Tutte le versioni attualmente disponibili dell'API Maps JavaScript supportano CSP.


Servizi per i giochi di Google Maps Platform (18 ottobre 2021 - 31 dicembre 2022)

I servizi per i giochi di Google Maps Platform sono stati ritirati a partire dal 18 ottobre 2021 e verranno dismessi il 31 dicembre 2022. Durante il periodo di deprecazione, Google continuerà a fornire assistenza e correzioni per i principali bug e interruzioni del servizio. Consulta la Guida alla transizione ai servizi di gaming per trovare risorse che ti aiutano a pianificare i passaggi successivi per i tuoi progetti.


ID luogo obsoleti (16 marzo 2021 - 30 marzo 2022)

Il 30 marzo 2022, tutte le API Google Maps Platform non accetteranno più alcuni ID luogo obsoleti. A partire dal 30 marzo 2022, qualsiasi richiesta effettuata utilizzando ID luogo obsoleti verrà rifiutata e verrà restituito il codice di errore INVALID_REQUEST. Per evitare un peggioramento dell'esperienza utente, aggiorna tutti gli ID luogo che risalgono a più di 12 mesi prima del 30 marzo 2022.


Modulo Maps in google.load (13 ottobre 2020 - 13 ottobre 2021)

Il servizio che fornisce il modulo "Maps" per google.load è deprecato dal 13 ottobre 2020 e verrà disattivato il 13 ottobre 2021. Le successive richieste di caricamento del modulo "Maps" in google.load comporteranno un errore e non verrà caricata alcuna mappa. Consulta la guida alla migrazione per ulteriori informazioni.


L'SDK Places per iOS GMSPlaceField ora utilizza la macro NS_OPTIONS (a partire dalla versione 4.0.0)

A partire dall'SDK Places per iOS v4.0.0, GMSPlaceField ora utilizza la macro NS_OPTIONS invece di NS_ENUM per un supporto Swift migliore. Scopri di più sulla migrazione a GMSPlaceField come NS_OPTIONS.

Per continuare a utilizzare GMSPlaceField come NS_ENUM, specifica v3.10.0 o una versione precedente nelle dipendenze.


SDK di Places per i metodi iOS: setAutocompleteBoundsUsingNorthEastCorner:SouthWestCorner, initWithBounds:filter (v3.10.0 - v4.0.0)

Il metodo helper setAutocompleteBoundsUsingNorthEastCorner:SouthWestCorner è deprecato a partire dalla v3.10.0 e non è supportato nella v4.0.0 e nelle versioni successive. Usa invece locationBias o locationRestriction.

Il metodo initWithBounds:filter è deprecato a partire dalla v3.10.0 e non è supportato nella v4.0.0 e nelle versioni successive. Usa invece initWithFilter: in GMSAutocompleteFetcher.

La versione massima che supporta questi metodi deprecati è v3.10.0.

Per maggiori dettagli sui metodi di sostituzione, consulta l'Appendice 1.


GMSCoordinateBounds in Place Autocomplete (v3.9.0 - v4.0.0)

Diversi parametri/proprietà che utilizzano GMSCoordinateBounds nel servizio di completamento automatico dell'SDK Places per iOS sono deprecati a partire dalla v3.9.0 e non sono supportati nella v4.0.0 e successive. La versione massima di supporto per le proprietà/i parametri deprecati è v3.10.0.

Limiti in GMSAutocompleteViewController

Le seguenti proprietà GMSAutocompleteViewController sono deprecate:

Per una funzionalità equivalente, utilizza GMSAutocompleteViewController.autocompleteFilter con GMSAutocompleteFilter.locationBias o GMSAutocompleteFilter.locationRestriction. La versione minima dell'SDK Places per iOS con queste proprietà sostitutive è la versione 3.8.0.

Limiti in findAutocompletePredictionsFromQuery e autocompleteQuery

Per una funzionalità equivalente, utilizza findAutocompletePredictionsFromQuery:filter:sessionToken:callback con GMSAutocompleteFilter.locationBias o GMSAutocompleteFilter.locationRestriction. La versione minima dell'SDK Places per iOS con queste proprietà sostitutive è v3.8.0.

Per maggiori dettagli sui metodi di sostituzione, consulta l'Appendice 1.


Campo Luoghi GMSPlace.openNowStatus (v3.0.0 - v4.0.0)

Il campo/la proprietà Places GMSPlace.openNowStatus nell'SDK Places per iOS è deprecato a partire dalla v3.0.0 e non è supportato nella v4.0.0 e successive. La versione massima di supporto per il campo obsoleto è v3.10.0.

Utilizza invece le funzioni GMSPlace.isOpen o GMSPlace.isOpenAtDate. La versione minima dell'SDK Places per iOS con queste funzioni sostitutive è v3.3.0.


Campo Luoghi: permanently_closed (ritirato il 26 maggio 2020)

Il campo Places permanently_closed nell'API Places e nella libreria Places, l'API Maps JavaScript è deprecata e non deve essere utilizzato. Utilizza invece business_status (API Places) o business_status (libreria Places) per conoscere lo stato operativo delle attività. La versione minima della libreria Places, l'API Maps JavaScript con business_status è v3.40.


Campi luoghi open_now, utc_offset (ritirati il 20 novembre 2019)

I campi Places open_now e utc_offset nella libreria Places e nell'API Maps JavaScript sono deprecati a partire dal 20 novembre 2019 e non devono essere utilizzati.

Questi campi sono deprecati solo nell'API Places Library, Maps JavaScript.

  • Il campo open_now è stato sostituito da PlaceResult.opening_hours.isOpen() in Dettagli luogo. Per Ricerca nelle vicinanze e Ricerca testuale, utilizza il parametro di richiesta openNow:true per filtrare in base ai luoghi attualmente aperti. Non è stato fornito un equivalente per Find Place. Per ottenere questo valore, devi effettuare una richiesta Dettagli luogo.
  • Il campo utc_offset è stato sostituito da PlaceResult.utc_offset_minutes in Dettagli luogo.

Per scoprire di più, consulta la pagina relativa alla migrazione dei campi di Places.


API Maps JavaScript: google.maps.event.addDomListener() e google.maps.event.addDomListenerOnce() (ritirata il 7 aprile 2022)

Le funzioni [google.maps.event.addDomListener()](/maps/documentation/javascript/reference/event#event.addDomListener) e [google.maps.event.addDomListenerOnce()](/maps/documentation/javascript/reference/event#event.addDomListenerOnce) nell'API Maps JavaScript sono deprecate e non devono essere utilizzate. Utilizza invece il metodo standard addEventListener().

Questi metodi continueranno a funzionare e non è prevista la loro dismissione.


Ritiri completati

Questa sezione elenca tutti i prodotti e le funzionalità che sono stati dismessi. Questi prodotti e queste funzionalità non sono più disponibili.


Libreria contesto locale, API Maps JavaScript (deprecata a partire dalla v3.51.2)

A causa dell'adozione limitata di questa funzionalità beta, la Libreria contesto locale non è più disponibile a gennaio 2024.

Se ti interessa creare personalmente un'esperienza simile alla libreria di contesto locale, ti consigliamo di dare un'occhiata alla soluzione "Nearby Discovery" in Quick Builder oppure di utilizzare la libreria Places, l'API Maps JavaScript. Gli esempi di codice e i codelab per la libreria Places possono esserti utili.


SDK Maps for iOS 2.5 e versioni precedenti (gennaio 2022-gennaio 2023)

L'SDK Maps per iOS 2.5 e versioni precedenti è stato dismesso a gennaio 2023, con conseguente aumento del sistema operativo minimo supportato da Maps SDK per iOS a iOS 8 e l'IDE minimo supportato a Xcode 8.

Ti invitiamo a specificare e utilizzare la versione più recente dell'SDK Maps for iOS.


API Maps JavaScript v2 (19 maggio 2010 - 26 maggio 2021)

La versione 2 dell'API Maps JavaScript non è più disponibile dal 26 maggio 2021. Di conseguenza, le mappe v2 del tuo sito smetteranno di funzionare e restituiranno errori JavaScript. Per continuare a utilizzare le mappe sul tuo sito, esegui la migrazione all'API Maps JavaScript v3. Scopri di più sull'upgrade della tua applicazione API Maps JavaScript dalla versione 2 alla versione 3.


Campi dei luoghi: reference, id, alt_id, scope (3 settembre 2019 - 10 agosto 2020)

I campi Places id, alt_id e scope non sono più disponibili dal 10 agosto 2020. Il campo Places reference è deprecato e non deve essere utilizzato.

  • Il campo della risposta id è stato sostituito dal campo della risposta place_id.
  • Il campo della risposta reference è stato sostituito dalla risposta place_id e non deve essere utilizzato.
  • i campi alt_id e scope non hanno valori equivalenti, perché sono stati utilizzati solo per il servizio Inserisci luogo, disattivato a luglio 2018.

Per maggiori dettagli, vedi Migrazione dei campi del luogo.


iOS versione 10, architettura ARMv7 a 32 bit in Maps SDK per iOS 5.0

A partire da Maps SDK for iOS versione 5.0, iOS 10 e l'architettura a 32 bit ARMv7 non sono più supportati.

Places SDK for iOS

Con la release dell'SDK Places per iOS 5.0, GMSCoordinateBounds viene dismesso e sostituito da GMSPlacesViewportInfo.

Livello Fusion Tables (sperimentale) (3 dicembre 2018 - 3 dicembre 2019)

Il livello Fusion Tables nell'API Maps JavaScript è stato disattivato il 3 dicembre 2019 e non è più disponibile a partire dalla versione 3.38 (la versione 3.37 è l'ultima a supportare Fusion Tables). Scopri di più.


SDK Places for Android and iOS (29 gennaio 2019 - 29 luglio 2019)

A partire dal 29 gennaio 2019, gli SDK Places aggiornati per Android e iOS hanno sostituito le versioni esistenti degli SDK Places. Le versioni correnti di Places SDK for iOS, di Places SDK for Android e del Selettore di luogo sono state ritirate il 29 gennaio 2019 e sono state disattivate il 29 luglio 2019.


Place Add and Place Delete (30 giugno 2017 - 30 giugno 2018)

A partire dal 30 giugno 2018, le funzionalità di aggiunta di luogo e di eliminazione del luogo sono state disattivate e non sono più disponibili.


Query di Place Search non supportate nell'API Places e nella libreria Places, API Maps JavaScript (31 marzo 2022 - 31 marzo 2023)

Le query di ricerca dei luoghi non supportate per Text Search, Nearby Search e Find Place nell'API Places e nella libreria Places, l'API Maps JavaScript sono state ritirate a partire dal 31 marzo 2022 e riceveranno INVALID_REQUEST risposte di errore a partire dal 31 marzo 2023.

L'API Places e l'API Places Library, Maps JavaScript supportano tre metodi per trovare i luoghi: Text Search, Nearby Search e Find Place. Ogni metodo accetta le richieste con combinazioni di parametri supportate e rifiuta la maggior parte delle richieste con combinazioni di parametri non supportate.

Alcune combinazioni di parametri non supportati non sono state correttamente rifiutate fino a oggi:

  • Richieste di ricerca testuale con un parametro query vuoto o mancante e senza un parametro type supportato.
  • Richieste di ricerca testuale con query=*.
  • Richieste di Nearby Search con keyword=*.
  • Richieste di Nearby Search con name=*.
  • Trova le richieste di luogo con input=*.

Queste richieste di ricerca di luoghi non supportate devono essere sostituite con uno dei seguenti:

  • Le richieste Ricerca nelle vicinanze senza il parametro keyword (o name) possono essere utilizzate per trovare stabilimenti nelle vicinanze. Ti consigliamo di utilizzare anche il parametro type con un tipo supportato (consulta la Tabella 1: tipi di luoghi). In questo modo viene trovata la corrispondenza più simile al comportamento attuale delle richieste di ricerca testuale con un parametro query vuoto o mancante.

  • Le richieste dell'API Geocoding con il parametro latlng possono essere utilizzate per trovare gli indirizzi più vicini. Ciò fornisce la corrispondenza più simile al comportamento attuale di:

    • Richieste di ricerca testuale con query=*.
    • Richieste di Nearby Search con keyword=*.
    • Richieste di Nearby Search con name=*.
    • Trova le richieste di luogo con input=*.

Appendice 1: Riepilogo delle sostituzioni dell'API deprecata dell'SDK Places per iOS

La seguente tabella mostra il metodo di sostituzione da utilizzare per ogni metodo o proprietà deprecato.

Metodo/proprietà deprecati Utilizza invece
setAutocompleteBoundsUsingNorthEastCorner:SouthWestCorner
(in GMSAutocompleteViewController)
locationRestriction e locationBias
setAutocompleteBoundsUsingNorthEastCorner:SouthWestCorner
(in GMSAutocompleteResultsViewController)
locationRestriction e locationBias
setAutocompleteBoundsUsingNorthEastCorner:SouthWestCorner
(in GMSAutocompleteTableDataSource)
locationRestriction e locationBias
initWithBounds:filter
(in GMSAutocompleteFetcher)
initWithFilter:
autocompleteBounds e autocompleteBoundsMode
(in GMSAutocompleteViewController)
GMSAutocompleteViewController.autocompleteFilter con locationBias o locationRestriction.
findAutocompletePredictionsFromQuery:bounds:boundsMode:filter:SessionToken:callback, autocompleteQuery:bounds:filter:callback e autocompleteQuery:bounds:boundsMode:filter:callback
(in GMSPlacesClient)
findAutocompletePredictionsFromQuery:filter:sessionToken:callback, con locationBias o locationRestriction.

La versione minima dell'SDK Places per iOS con le proprietà sostitutive è v3.8.0.