Panoramica
Per aumentare la sicurezza e l'affidabilità dell'autenticazione, gli ID client di Maps Platform sono deprecati dal 26 maggio 2025 e non potranno più essere utilizzati dopo il 31 maggio 2026.
Anziché utilizzare un ID client, devi utilizzare le credenziali della chiave API per autenticare il traffico del servizio API Google Maps. Questa guida mostra come eseguire la migrazione dall'utilizzo degli ID client all'utilizzo delle chiavi API.
Per iniziare, procedi nel seguente modo:
- Controllare l'utilizzo attuale dell'ID client
- Prepara le chiavi API
- Controllare le impostazioni delle quote
- Aggiornare il codice
- Monitorare il traffico dell'ID client
- Mettere in pausa l'ID client
Controllare l'utilizzo corrente dell'ID client
Prima di iniziare la procedura di migrazione, elenca quanto segue:
- Servizi Maps Platform che utilizzi con il tuo ID client.
- Applicazioni, siti o sistemi con cui utilizzi l'ID client.
Google ha inviato un'email di notifica ai clienti interessati in merito al ritiro dell'ID cliente a maggio 2025. Puoi trovare queste informazioni anche nell'email di notifica.
Nella console Cloud, puoi controllare lo stato più recente dell'utilizzo dell'ID client nella pagina delle metriche di Google Maps.
Per un elenco dei servizi Google Maps Platform:
- Apri la pagina Metriche nella console Cloud.
- Filtra l'utilizzo con le seguenti impostazioni:
- Credenziali: seleziona solo "project_number:<numerical identifier>".
- Imposta il seguente filtro.
- Raggruppato per: API
Per suggerimenti di applicazioni, siti o sistemi:
Cloud Console non mostra i dettagli delle tue applicazioni, dei tuoi siti o dei tuoi sistemi. Tuttavia, puoi trovare alcuni suggerimenti sulle sorgenti del traffico dell'ID client. Segui questi passaggi:
- Apri la pagina Metriche nella console Cloud.
- Seleziona un servizio della piattaforma Maps dal menu a discesa.
- Filtra l'utilizzo con le seguenti impostazioni:
- Credenziali: seleziona solo "project_number:<numerical identifier>".
- Imposta il seguente filtro.
- Raggruppa per: piattaforma o dominio
- Ripeti i passaggi a partire dal passaggio 2 per ogni servizio Maps Platform per cui devi controllare il traffico.
Prepara le chiavi API
Tutti gli ID client sono associati a un progetto Google Cloud e l'utilizzo di una chiave API di questo progetto ti darà accesso alle stesse funzionalità a cui accedevi in precedenza con il tuo ID client. Ti consigliamo di eseguire la migrazione al progetto associato, per evitare problemi con le quote o funzionalità mancanti.
- Trova il progetto Cloud a cui è collegato il tuo ID client:
- Assicurati che il tuo progetto Cloud sia collegato a un account di fatturazione aperto.
- Crea una nuova chiave API
per la migrazione dell'ID client.
- Puoi riutilizzare qualsiasi chiave API esistente nel progetto cloud.
- Puoi utilizzare più chiavi API dello stesso progetto Cloud, ad esempio per separare il traffico per ogni servizio Maps Platform o per separare il traffico da piattaforme diverse (browser, app mobile e così via). Consulta la guida alla sicurezza per le best practice sulla gestione delle chiavi API.
Proteggere la chiave API
Assicurati di proteggere la tua chiave API per evitare accessi non autorizzati.
- Imposta una limitazione delle applicazioni per la tua chiave API (ad es. siti web, indirizzi IP, app per Android o per iOS).
- Imposta le limitazioni delle API per la tua chiave API.
Per ulteriori dettagli, consulta le linee guida per la sicurezza di Google Maps Platform.
Per l'API Maps JavaScript, l'API Maps Static e l'API Street View Static, puoi migrare i referrer attendibili sull'ID client alle limitazioni della chiave API. Puoi trovare l'elenco dei referrer attendibili nella console Cloud.
Rivedi le impostazioni delle quote
Assicurati di avere le impostazioni di quota previste nel tuo progetto Cloud. Devi eseguire questa operazione solo se chiami i servizi lato client dell'API Maps JavaScript da un ID client. Puoi controllare e modificare le impostazioni della quota nella pagina Quote di Google Maps.
Scopri di più sui report sulle quote
Aumento della quota per i servizi lato client dell'API Maps JavaScript
Se utilizzi i seguenti servizi nell'API Maps JavaScript, vedrai un aumento dell'utilizzo della quota dopo la migrazione della chiave API.
Rivedi la configurazione attuale delle quote, l'utilizzo attuale e modifica i limiti delle quote di conseguenza.
- Verifica se stai utilizzando i servizi lato client dell'API Maps JavaScript con un
ID client.
- Apri la pagina Metriche nella console Cloud.
- Filtra l'utilizzo con le seguenti impostazioni:
- Raggruppato per: metodo API
- Credenziali: seleziona solo "project_number:<numerical identifier>".
- Verrà visualizzato un elenco di nomi di metodi con il relativo traffico nel grafico "Traffico per metodo API".
Metodo API |
Servizio lato client |
Servizio per modificare la quota |
google.routes.Directions.Javascript |
Servizio indicazioni |
API Directions |
google.routes.DistanceMatrix.Javascript |
Servizio Distance Matrix |
API Distance Matrix |
google.maps.Elevation.Javascript |
Servizio di elevazione |
API Elevation |
google.places.Geocoding.Javascript |
Servizio Geocoding |
API Geocoding |
google.places.*.Javascript, diverso da google.places.Geocoding.Javascript |
libreria Places |
API Places |
- Se non utilizzi questi metodi API, non devi preoccuparti delle impostazioni di quota, poiché il traffico dell'ID client consuma già la quota del progetto.
- Stimare l'utilizzo della quota dell'ID client
- Per ciascuno dei servizi, controlla sia la granularità al secondo sia quella al giorno.
- Grafico al secondo: moltiplica il traffico di picco per 60 per le esigenze di quota al minuto aggiuntive.
- Grafico giornaliero: il picco di traffico deve corrispondere alla quota giornaliera aggiuntiva necessaria.
- Modifica la quota dei servizi Maps Platform corrispondenti
- In base al nome del metodo che trovi nel passaggio 1, modifica la quota nei servizi corrispondenti.
Aggiorna il codice
Sostituisci il parametro client con il parametro chiave
Aggiorna le credenziali di autenticazione da URL&client={value} a
URL&key={value} nelle chiamate API GMP in uscita. Se le tue app utilizzano HTTP per
accedere ai servizi GMP, aggiornale in modo che utilizzino HTTPS.
Aggiornare il parametro del canale per i report
Puoi monitorare l'utilizzo per canale specificando il parametro del canale nelle richieste API. Le chiavi API supportano solo valori numerici per il parametro canale. Se utilizzi l'ID cliente con valori non numerici per il parametro canale, aggiornalo a un valore numerico supportato.
Per ulteriori informazioni, consulta la sezione Report di Google Maps Platform.
Rimuovere il parametro di firma per i servizi web
Per le seguenti API del servizio web, il parametro della firma non è necessario quando vi accedi con una chiave API. Rimuovi solo il parametro della firma dalle richieste API.
- API Directions (legacy)
- API Distance Matrix (legacy)
- API Geocoding
- API Elevation
- API Time Zone
Per saperne di più, consulta la panoramica del piano Premium.
Signing Secret per le API di immagini
API Maps Static e API Street View Static richiedono ancora il parametro signature. Accettano un numero ridotto di richieste senza firma a scopo di test, ma iniziano a non riuscire una volta raggiunto il limite nella produzione. Sostituisci il segreto di firma dell'ID client con quello della chiave API. Puoi utilizzare lo stesso algoritmo di firma, ma devi utilizzare un altro segreto di firma. Per saperne di più, vedi Utilizzare una firma digitale.
Monitorare il traffico dell'ID client
Dopo il deployment, verifica che il traffico sia stato migrato correttamente utilizzando le dashboard di Cloud Console. Inizierai a notare una diminuzione del traffico dell'ID client, visualizzato nel formato "project_number:123456" nella dashboard quando raggruppi per credenziale.
Mettere in pausa l'ID client
Consigliamo vivamente agli sviluppatori di mettere in pausa gli ID client dopo la migrazione. Lo scopo è proteggere le tue credenziali da qualsiasi traffico non intenzionale e confermare che l'utilizzo rimanente dell'ID client non è critico (ad es. test, cache, bot…) e può restituire errori senza causare un impatto sull'attività. Puoi mettere in pausa il tuo ID client nella console Cloud. Per ulteriori dettagli, consulta la panoramica sull'autenticazione del piano Premium.
Risoluzione dei problemi
Come possiamo sapere se la nostra richiesta non va a buon fine?
Puoi controllare le statistiche sugli errori nei grafici dei codici di risposta.
ApiNotActivatedMapError o errore REQUEST_DENIED
Verrà visualizzato l'errore ApiNotActivatedMapError o REQUEST_DENIED se non hai abilitato il servizio nel tuo progetto Cloud. Segui le istruzioni per
attivare il servizio.
RefererNotAllowedMapError errore
Se il dominio di origine non è aggiunto alla chiave API, verrà visualizzato l'errore RefererNotAllowedMapError. Controlla la sezione "Proteggi la tua chiave API" e aggiungi il tuo dominio alla chiave API.
OverQuotaMapError o errore OVER_QUERY_LIMIT
Vedrai OverQuotaMapError o OVER_QUERY_LIMIT se la quota configurata
non è sufficiente a coprire il traffico. Controlla la sezione "Rivedi le impostazioni della quota" e modifica la quota di conseguenza.
Errore "Requests to this API must be over SSL" (Le richieste a questa API devono essere tramite SSL)
Se ricevi il seguente messaggio di errore, aggiorna le richieste API da "http://" a "https://".
{
"error_message" : "Requests to this API must be over SSL. Load the API with
\"https://\" instead of \"http://\".",
"results" : [],
"status" : "REQUEST_DENIED"
}