In questa pagina sono elencati tutti i prodotti e le funzionalità di Google Maps Platform al momento in un periodo di ritiro. Questi includono i prodotti in Maps, Routes e Places.
Come funziona il ritiro
Il periodo di deprecazione per 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 deprecazione (in genere 12 mesi). Una volta trascorso il periodo di ritiro, il prodotto, la funzionalità o la versione sono stati ritirati e non saranno più disponibili.
I proprietari del progetto con indirizzi email monitorati ricevono notifiche proattive sulle modifiche che influiscono su ciascuno dei loro progetti. Informati su aggiornamenti, ritiri e altre modifiche importanti.
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 che le modifiche che provocano un errore, incluse le deprecazioni di funzionalità e le note di rilascio, indicano la versione massima che supporta ogni funzionalità deprecata. Puoi continuare a usare la funzionalità deprecata per tutto il tempo per cui è disponibile la sua versione massima di supporto dell'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 sostituzione.
Scopri di più sulla disponibilità della versione dell'API Maps JavaScript, che segue un piano di rilascio e ritiro trimestrale.
Consulta le indicazioni sulla gestione delle dipendenze con le versioni con l'SDK Maps per Android, l'SDK Maps per iOS, l'SDK Places per Android e l'SDK Places per iOS.
Ritiri attivi
Questa sezione elenca tutti i prodotti e le funzionalità che sono attualmente in un periodo di ritiro.
Limiti, posizione e raggio nel servizio di completamento automatico dei luoghi dell'API Maps JavaScript (ritirato a maggio 2023)
Per il servizio di completamento automatico dell'attività nell'API Maps JavaScript, a partire da maggio 2023 le seguenti opzioni di richiesta sono state ritirate: limiti, località e raggio. Utilizza locationBias e locationRestriction.
La funzionalità continuerà a funzionare e verrà fornito un preavviso di 12 mesi prima dell'interruzione del supporto.
Libreria contesto locale, API Maps JavaScript (ritirata a partire dalla v3.51.2)
A causa dell'adozione limitata di questa funzionalità beta, la Libreria di contesto locale è stata ritirata a partire dalla v3.51.2. La libreria di contesto locale non sarà più disponibile a gennaio 2024. Fino ad allora, verranno fornite le correzioni di bug e incidenti più gravi.
Se ti interessa creare un'esperienza simile a una Libreria contesto locale, ti suggeriamo di provare la soluzione "Rilevamento quartiere" in Builder rapido o di utilizzare la Raccolta di luoghi, l'API Maps JavaScript. Esempi di codice e codelab per la libreria Luoghi possono aiutarvi.
Libreria per la compatibilità dei luoghi 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 state ritirate a partire dal 31 marzo 2022. Stiamo bloccando lo sviluppo della libreria di compatibilità di Places sull'SDK Places per Android 2.6.0 (specificato nelle dipendenze come com.google.android.libraries.places:places-compat:2.6.0
).
Dopo questa data non verranno rilasciate nuove versioni di questa raccolta. L'unico modo per accedere alle funzionalità e alle correzioni di bug nell'SDK Places per Android superiore alla versione 2.6.0 è utilizzare l'SDK Places per Android.
La libreria di compatibilità Places è stata introdotta a gennaio 2019 per facilitare la migrazione dall'SDK legacy (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 di completamento automatico sono diversi tra la libreria di compatibilità di Places e l'SDK Places per Android. Consulta la documentazione sulle versioni per specificare e mantenere le dipendenze dalle versioni dell'SDK Places per 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à Places, tieni presente le limitazioni relative al supporto delle versioni precedenti di un SDK.
Query di ricerca di luoghi 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 Ricerca di testo, Ricerca nelle vicinanze e Trova luogo
nell'API Places e nella libreria Places 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, Maps Maps JavaScript supportano tre metodi per trovare luoghi: Ricerca di testo, Ricerca nelle vicinanze e Trova luogo. Ogni metodo accetta richieste con combinazioni di parametri supportate e rifiuta la maggior parte delle richieste con combinazioni di parametri non supportati.
Ad oggi, alcune combinazioni di parametri non supportati non sono state rifiutate:
- Richieste di ricerca di testo con un parametro
query
vuoto o mancante e senza un parametrotype
supportato. - Richieste di ricerca tramite SMS con
query=*
. - Richieste di ricerca nelle vicinanze con
keyword=*
. - Richieste di ricerca nelle vicinanze con
name=*
. - Trova richieste di luoghi 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 attività nelle vicinanze. Ti consigliamo di utilizzare anche il parametrotype
con un tipo supportato (vedi Tabella 1: tipi di luogo). Ciò fornisce la corrispondenza più vicina al comportamento corrente delle richieste di Ricerca testo con un parametroquery
vuoto o mancante.Le richieste API Geocoding con il parametro
latlng
possono essere utilizzate per trovare gli indirizzi più vicini. Ciò fornisce la corrispondenza più simile al comportamento corrente di:- Richieste di ricerca tramite SMS con
query=*
. - Richieste di ricerca nelle vicinanze con
keyword=*
. - Richieste di ricerca nelle vicinanze con
name=*
. - Trova richieste di luoghi con
input=*
.
- Richieste di ricerca tramite SMS con
Aggiornamento delle norme sulla sicurezza dei contenuti (21 marzo 2022-maggio 2023)
A partire dalla v3.49, il supporto per i siti web che utilizzano Criteri di sicurezza del contenuto (CSP) che non specificano googleapis.com nell'API Maps JavaScript sarà ritirato e non sarà supportato. L'ultima versione di supporto, v3.49, verrà ritirata nel secondo trimestre del 2023; in seguito, l'API JavaScript di Maps rifiuterà tutte le richieste che utilizzano istruzioni CSP che non specificano googleapis.com.
Per evitare interruzioni dell'esperienza sul tuo sito web, specifica googleapis.com nel tuo CSP. Tutte le versioni attualmente disponibili dell'API Maps JavaScript supportano CSP.
Servizi di 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 ritirati il 31 dicembre 2022. Durante il periodo di deprecazione, Google continuerà a fornire assistenza e correzioni per bug importanti e interruzioni. Consulta la Guida alla transizione dei servizi di gioco per risorse che ti aiuteranno a pianificare le fasi successive per i tuoi progetti.
ID luogo obsoleto (16 marzo 2021 - 30 marzo 2022)
Il 30 marzo 2022 tutte le API Google Maps Platform smetteranno di accettare determinati ID luogo obsoleti.
A partire dal 30 marzo 2022, le eventuali richieste effettuate utilizzando gli ID luogo obsoleti verranno rifiutate e restituiranno il codice di errore INVALID_REQUEST
.
Per evitare il degrado dell'esperienza utente, aggiorna tutti gli ID luogo che risalgono a più di 12 mesi prima del 30 marzo 2022.
Modulo di Google Maps in google.load (13 ottobre 2020-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 successive richieste di caricamento del modulo "Maps" in google.load
comporteranno un errore e non verranno caricate mappe. Per ulteriori informazioni, consulta la Guida alla migrazione.
L'SDK Places per iOS
GMSPlaceField
ora utilizza la macro NS_OPTIONS
(a partire dalla v4.0.0)
A partire dall'SDK Places per iOS
v4.0.0,
GMSPlaceField
utilizza ora la macro NS_OPTIONS
anziché
NS_ENUM
per un migliore supporto di Swift. Scopri di più sulla migrazione a DASHPlaceField come NS_OPTIONS.
Per continuare a utilizzare GMSPlaceField
come NS_ENUM
, specifica
v3.10.0
o prima nelle dipendenze.
SDK Places per metodi iOS: setAutocompleteBoundsUsingNorthernEastCorner:SouthWestCorner, initWithBounds:filter (v3.10.0 - v4.0.0)
Il metodo di supporto setAutocompleteBoundsUsingNorthEastCorner:SouthWestCorner
è deprecato a partire dalla versione v3.10.0 ed è non supportato nella versione v4.0.0 e successive.
Utilizza invece locationBias
o locationRestriction
.
Il metodo initWithBounds:filter
è deprecato a partire dalla versione v3.10.0 ed è non supportato nella versione v4.0.0 e successive.
Utilizza invece initWithFilter:
in GMSAutocompleteFetcher
.
La versione massima di supporto per questi metodi obsoleti è v3.10.0.
Per informazioni dettagliate sui metodi di sostituzione, consulta l'Appendice 1.
GMSCoordinateBounds
in Place Autocomplete (v3.9.0 - v4.0.0)
Diverse proprietà/parametri che utilizzano GMSCoordinateBounds
nel servizio Place Autocomplete dell'SDK Places per iOS sono deprecati a partire dalla versione v3.9.0 e non sono supportati nella versione 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:
GMSAutocompleteViewController.autocompleteBounds
GMSAutocompleteViewController.autocompleteBoundsMode
Per la funzionalità equivalente, utilizza 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 in findAutocompletePredictionsFromQuery
e autocompleteQuery
- Parametri
bounds
eboundsMode
per:
Per la 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 informazioni dettagliate sui metodi di sostituzione, consulta l'Appendice 1.
Campo Luoghi GMSPlace.openNowStatus
(v3.0.0 - v4.0.0)
La proprietà/il campo Places GMSPlace.openNowStatus
nell'SDK Places per iOS è deprecato a partire dalla v3.0.0 e non è supportato nella versione v4.0.0 e 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 Places: permanently_closed
(ritirato il 26 maggio 2020)
Il campo Places permanently_closed
nell'API Places
e nella libreria Places, 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 della
libreria Places, l'API Maps JavaScript con business_status
è
v3.40.
Campi luoghi open_now
, utc_offset
(ritirato il 20 novembre 2019)
I campi Places open_now
e utc_offset
nella libreria Places, l'API Maps JavaScript sono deprecati a partire dal 20 novembre 2019 e non devono essere utilizzati.
Questi campi sono deprecati 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 di testo, utilizza il parametro di richiestaopenNow:true
per filtrare i luoghi attualmente aperti. Non viene fornito alcun equivalente per Find Place. Per ottenere questo valore, devi ora effettuare una richiesta Dettagli luogo. - Il campo
utc_offset
è stato sostituito daPlaceResult.utc_offset_minutes
in Dettagli luogo.
Per saperne di più, 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 AdsBot().
Questi metodi continueranno a funzionare e non sarà previsto di ritirarli.
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.
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 Maps sul tuo sito, esegui la migrazione all'API Maps JavaScript v3. Scopri di più su come eseguire l'upgrade dell'applicazione API Maps JavaScript da v2 a v3.
Campi luoghi: reference
, id
, alt_id
, scope
(3 settembre 2019-10 agosto 2020)
I campi Places id
, alt_id
e scope
non sono più disponibili a partire dal 10 agosto 2020. Il campo Places reference
è deprecato e non deve essere utilizzato.
- Il campo di risposta
id
è stato sostituito dal campo di rispostaplace_id
. - Il campo
reference
di risposta è 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, che è stato disattivato a luglio 2018.
Per maggiori dettagli, vedi Effettua la migrazione dei campi.
Versione 10 di iOS, architettura ARMv7 a 32 bit nell'SDK di Maps per iOS 5.0
A partire dall'SDK Maps per iOS versione 5.0, iOS 10 e l'architettura ARMv7 a 32 bit non sono più supportati.
Places SDK for iOS
Con il rilascio dell'SDK Places per iOS 5.0, viene ritirato GMSCoordinateBounds
, 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 (3.37 è l'ultima versione a supportare le tabelle fusion). Ulteriori informazioni.
SDK Places per Android e iOS (29 gennaio 2019 - 29 luglio 2019)
A partire dal 29 gennaio 2019, gli SDK aggiornati per i dispositivi Android e iOS hanno sostituito le versioni esistenti degli SDK Places. Le versioni attuali di Places SDK per iOS, Places SDK for Android e Place Picker sono state ritirate il 29 gennaio 2019 e sono state disattivate il 29 luglio 2019.
- Esegui l'aggiornamento alla versione più recente dell'SDK Places per iOS.
- Esegui l'aggiornamento alla versione più recente 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à Aggiungi e Elimina luogo sono state disattivate e non sono più disponibili.
Allegato 1. Riepilogo dell'SDK Places per le sostituzioni API deprecate per iOS
La seguente tabella mostra il metodo di sostituzione da utilizzare per ogni proprietà o metodo deprecato.
La versione minima dell'SDK Places per iOS con le proprietà sostitutive è v3.8.0.