In questa pagina sono elencati tutti i prodotti e le funzionalità di Google Maps Platform attualmente in un periodo di ritiro. Sono inclusi i prodotti in Maps, Routes e Places.
Come funziona il ritiro
Il periodo di deprecazione di un prodotto, una funzionalità o una versione inizia alla data di annuncio del ritiro. Il prodotto, la funzionalità o la versione continueranno a essere disponibili per tutto il periodo di ritiro (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. Informati su importanti aggiornamenti, ritiri e altri cambiamenti.
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 eseguirne la migrazione alla versione sostitutiva.
Scopri di più sulla disponibilità delle versioni dell'API Maps JavaScript, che segue un programma di rilascio e ritiro trimestrale.
Consulta le indicazioni sulla gestione delle dipendenze tra le versioni con Maps SDK for Android, Maps SDK for iOS, Places SDK for Android, e Places SDK for iOS.
Ritiri attivi
Questa sezione elenca tutti i prodotti e le funzionalità attualmente in un periodo di ritiro.
Limiti, posizione e raggio nel servizio Place Autocomplete dell'API Maps JavaScript (ritirato a partire da maggio 2023)
Per il servizio Place Autocomplete nell'API Maps JavaScript, a partire da maggio 2023 le seguenti opzioni di richiesta non saranno più disponibili: limiti, località e raggio. Utilizza invece locationBias e locationRestriction.
La funzionalità continuerà a funzionare e verrà dato un preavviso di 12 mesi prima che l'assistenza venga interrotta.
API Maps JavaScript (ritirata a partire dalla v3.51.2)
A causa dell'adozione limitata di questa funzionalità beta, Libreria Contesto locale è stata ritirata a partire dalla v3.51.2. La libreria contesto locale non sarà più disponibile a partire da gennaio 2024. Fino ad allora, verranno fornite correzioni ai bug e agli incidenti principali.
Se ti interessa creare personalmente un'esperienza simile alla libreria di contesto locale, ti consigliamo di dare un'occhiata alla soluzione "Neighborhood Discovery" in Builder rapido o di utilizzare la Libreria luoghi, l'API Maps JavaScript. Gli esempi di codice e i codelab per la libreria Places possono aiutarti.
Libreria di compatibilità di Places per l'SDK Places per Android (a partire dal 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à Places su Places SDK for Android v2.6.0 (specificate in dipendenze come com.google.android.libraries.places:places-compat:2.6.0
).
Dopo questa data non verranno rilasciate nuove versioni di questa libreria. L'unico modo per accedere alle funzionalità e alle correzioni di bug dell'SDK Places per Android versione 2.6.0 sarà utilizzare l'SDK Places per 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 autonomo per Android.
Segui la guida alla migrazione per utilizzare direttamente l'SDK Places per Android. Alcuni codici di stato, nomi di metodi e nomi delle classi di completamento automatico sono diversi tra la libreria di compatibilità di Places e l'SDK Places per Android. Consulta la documentazione relativa alle versioni per specificare e gestire le dipendenze nelle versioni dell'SDK Places for Android.
Al momento non è previsto il ritiro della libreria di compatibilità di Places. Tuttavia, se scegli di continuare a utilizzare le versioni disponibili della libreria di compatibilità di Places, tieni presenti le limitazioni relative al supporto delle versioni precedenti di un SDK.
Aggiornamento dei criteri di sicurezza del contenuto (21 marzo 2022 - maggio 2023)
Il supporto per i siti web che utilizzano Criteri di sicurezza del contenuto (CSP) che non specificano googleapis.com nell'API Maps JavaScript è deprecato a partire dalla v3.49 e non sarà più supportato a partire dalla v3.50. L'ultima versione supportata, v3.49, verrà ritirata nel secondo trimestre del 2023, dopodiché l'API Maps JavaScript rifiuterà tutte le richieste che utilizzano istruzioni CSP che non specificano googleapis.com.
Per evitare interruzioni dell'esperienza con il tuo 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 il 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 gioco per trovare risorse che ti aiutino a pianificare i passaggi successivi dei 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, tutte le richieste effettuate utilizzando ID luogo obsoleti verranno rifiutate e restituiranno 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 - 13 ottobre 2021)
Il servizio che fornisce il modulo "Maps" per google.load
è stato ritirato il 13 ottobre 2020 e verrà disattivato
il 13 ottobre 2021. Le richieste successive di caricamento del modulo "Maps" in google.load
causeranno 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
anziché
NS_ENUM
per un migliore supporto Swift. Scopri di più sulla migrazione a GMSPlaceField come NS_OPTIONS.
Per continuare a utilizzare GMSPlaceField
come NS_ENUM
, specifica la v3.10.0 o una versione precedente nelle dipendenze.
SDK 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.
Utilizza 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 informazioni dettagliate sui metodi di sostituzione, consulta l'Appendice 1.
GMSCoordinateBounds
in Place Autocomplete (v3.9.0 - v4.0.0)
Diversi parametri e 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 nelle versioni successive. La versione massima di supporto per proprietà/parametri deprecati è v3.10.0.
Limiti in GMSAutocompleteViewController
Le seguenti proprietà GMSAutocompleteViewController
sono deprecate:
GMSAutocompleteViewController.autocompleteBounds
GMSAutocompleteViewController.autocompleteBoundsMode
Per una funzionalità equivalente, usa GMSAutocompleteViewController.autocompleteFilter
con GMSAutocompleteFilter.locationBias
o GMSAutocompleteFilter.locationRestriction
.
La versione minima dell'SDK Places per iOS con queste proprietà sostitutive è la v3.8.0.
Limiti tra findAutocompletePredictionsFromQuery
e autocompleteQuery
- Parametri
bounds
eboundsMode
per:
Per una funzionalità equivalente, usa 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 informazioni dettagliate 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 versioni successive.
La versione massima di supporto per il campo deprecato è 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 nell'API Places Library, l'API Maps JavaScript è deprecato 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 dell'API Places Library, l'API Maps JavaScript con business_status
, è v3.40.
Campi Places 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 stati ritirati solo nella Libreria Places, nell'API Maps JavaScript.
- Il campo
open_now
è stato sostituito daPlaceResult.opening_hours.isOpen()
in Dettagli luogo. Per la ricerca nelle vicinanze e la ricerca testuale, utilizza il parametro di richiestaopenNow:true
per filtrare in base ai luoghi attualmente aperti. Non è previsto alcun equivalente per Find Place. Per ottenere questo valore, ora devi effettuare una richiesta Dettagli luogo. - Il campo
utc_offset
è stato sostituito daPlaceResult.utc_offset_minutes
in Dettagli luogo.
Per ulteriori informazioni, consulta 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 è possibile dismetterli.
Ritiri completati
In questa sezione sono elencati tutti i prodotti e le funzionalità che sono stati dismessi. Questi prodotti e queste funzionalità non sono più disponibili.
SDK di Maps per iOS v2.5 e versioni precedenti (gennaio 2022 - gennaio 2023)
L'SDK Maps per iOS v2.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 dell'IDE minimo supportato a Xcode 8.
Ti invitiamo a specificare e utilizzare la versione più recente dell'SDK Maps per iOS.
API Maps JavaScript v2 (19 maggio 2010 - 26 maggio 2021)
La versione 2 dell'API Maps JavaScript non è più disponibile a partire 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 dell'applicazione dell'API Maps JavaScript da v2 a v3.
Campi di Places: reference
, id
, alt_id
, scope
(3 settembre 2019 - 10 agosto 2020)
I campi di Places id
, alt_id
e scope
non sono più disponibili a partire dal
10 agosto 2020. Il campo Luoghi reference
è deprecato e non deve essere utilizzato.
- Il campo di risposta
id
è stato sostituito dal campo di rispostaplace_id
. - Il campo della risposta
reference
è stato sostituito dalla rispostaplace_id
e non deve essere utilizzato. - i campi
alt_id
escope
non hanno equivalenti, poiché sono stati utilizzati solo per il servizio Place Add, 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 per iOS versione 5.0, iOS 10 e l'architettura a 32 bit ARMv7 non sono più supportati.
Places SDK for iOS
Con il rilascio dell'SDK Places per iOS 5.0, GMSCoordinateBounds
viene dismesso e sostituito da GMSPlacesViewportInfo
.
Livello Fusion Tables (sperimentale) (3 dicembre 2018 - 3 dicembre 2019)
Fusion Tables Layer 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 per Android e 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 attuali dell'SDK Places per iOS, dell'SDK Places per Android e del selettore di luoghi sono state ritirate il 29 gennaio 2019 e sono state disattivate il 29 luglio 2019.
- Esegui l'aggiornamento all'ultima versione dell'SDK Places per iOS.
- Esegui l'aggiornamento all'ultima versione dell'SDK Places per Android.
- Il Selettore luogo non è più disponibile a partire dal 29 luglio 2019.
Place Add and Place Delete (30 giugno 2017 - 30 giugno 2018)
A partire dal 30 giugno 2018, le funzionalità Aggiunta ed Eliminazione luogo sono state disattivate e non sono più disponibili.
Query Place Search non supportate nell'API Places e nella libreria Places, nell'API Maps JavaScript (31 marzo 2022 - 31 marzo 2023)
Le query di ricerca di luoghi non supportate per Text Search, Nearby Search e Find Place
nell'API Places e nella libreria Places, l'API Maps JavaScript
sono deprecate 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 la ricerca di luoghi: Ricerca testuale, Ricerca nelle vicinanze e Trova luogo. 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 finora:
- Richieste di ricerca di testo con un parametro
query
vuoto o mancante e senza un parametrotype
supportato. - Richieste di ricerca testuale con
query=*
. - Richieste di ricerca nelle vicinanze con
keyword=*
. - Richieste di ricerca nelle vicinanze con
name=*
. - Trova 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
(oname
) possono essere utilizzate per trovare stabilimenti nelle vicinanze. Ti consigliamo di utilizzare anche il parametrotype
con un tipo supportato (consulta Tabella 1: tipi di luogo). Ciò fornisce la corrispondenza più simile al comportamento attuale delle richieste di ricerca testuale con un parametroquery
vuoto o mancante.Le richieste dell'API Geocoding con il parametro
latlng
possono essere utilizzate per trovare gli indirizzi più vicini. Questo fornisce la corrispondenza più simile al comportamento attuale di:- Richieste di ricerca testuale con
query=*
. - Richieste di ricerca nelle vicinanze con
keyword=*
. - Richieste di ricerca nelle vicinanze con
name=*
. - Trova richieste di luogo con
input=*
.
- Richieste di ricerca testuale con
Appendice 1: riepilogo delle sostituzioni delle API deprecate per l'SDK Places per iOS
La tabella seguente mostra il metodo di sostituzione da utilizzare per ogni metodo o proprietà deprecati.
La versione minima dell'SDK Places per iOS con le proprietà sostitutive è v3.8.0.