Guida alla migrazione dell'ID cliente

Panoramica

Per aumentare la sicurezza e l'affidabilità dell'autenticazione, gli ID client di Maps Platform sono stati ritirati dal 26 maggio 2025 e non possono 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 dell'API Google Maps. Questa guida mostra come eseguire la migrazione dall'utilizzo degli ID cliente all'utilizzo delle chiavi API.

Per iniziare, procedi nel seguente modo:

1. Controllare l'utilizzo corrente dell'ID client
2. Prepara le chiavi API
3. Rivedi le impostazioni della quota
4. Aggiornare il codice
5. Monitorare il traffico dell'ID client
6. Mettere in pausa l'ID client

Controllare l'utilizzo corrente dell'ID client

Prima di iniziare la procedura di migrazione, elenca quanto segue:

• I servizi Maps Platform che utilizzi con il tuo ID cliente.
• Applicazioni, siti o sistemi con cui utilizzi il tuo ID client.

A maggio 2025 Google ha inviato un'email di notifica ai clienti interessati relativa al ritiro dell'ID cliente. 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 Metriche di Google Maps.

Per un elenco dei servizi di Maps Platform:

1. Apri la pagina Metriche in Cloud Console.
2. Filtra l'utilizzo con le seguenti impostazioni:
   • Credenziali: seleziona solo "project_number:<numerical identifier>".
3. Imposta il seguente filtro.
   • Raggruppato per: API

Per suggerimenti su applicazioni, siti o sistemi:

Cloud Console non mostra i dettagli delle tue applicazioni, dei tuoi siti o dei tuoi sistemi. Tuttavia, puoi trovare alcuni indizi sulle sorgenti del traffico dell'ID client. Segui questi passaggi:

1. Apri la pagina Metriche in Cloud Console.
2. Seleziona un servizio Maps Platform dal menu a discesa.
3. Filtra l'utilizzo con le seguenti impostazioni:
   • Credenziali: seleziona solo "project_number:<numerical identifier>".
4. Imposta il seguente filtro.
   • Raggruppa per: piattaforma o dominio
5. Ripeti il passaggio 2 per ogni servizio della piattaforma Maps 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 quel progetto ti consentirà di accedere alle stesse funzionalità a cui avevi precedentemente accesso con il tuo ID client. Ti consigliamo di eseguire la migrazione al progetto associato per evitare problemi con le quote o funzionalità mancanti.

1. Individua il progetto Cloud a cui è collegato il tuo ID client:
   • Domande frequenti sulla migrazione del portale
2. Assicurati che il progetto Cloud sia collegato a un account di fatturazione aperto.
3. Crea una nuova chiave API per la migrazione dell'ID client.
   • Puoi riutilizzare le chiavi API esistenti nel progetto Cloud.
   • Puoi utilizzare più chiavi API dello stesso progetto Cloud, ad esempio per separare il traffico per ciascun servizio Maps Platform o per separare il traffico proveniente da piattaforme diverse (browser, app mobile e così via). Consulta la guida alla sicurezza per le best practice sulla gestione delle chiavi API.

Proteggi la tua chiave API

Assicurati di proteggere la tua chiave API per proteggerla da 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 restrizioni delle API per la tua chiave API.

Per maggiori 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 eseguire la migrazione dei referrer attendibili nel tuo ID cliente alle limitazioni delle chiavi API. Puoi trovare l'elenco dei referrer attendibili nella console Cloud.

Rivedi le impostazioni della quota

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 delle quote nella pagina delle 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.

Esamina la configurazione e l'utilizzo attuali delle quote e modifica di conseguenza i limiti delle quote.

1. Verifica se utilizzi i servizi lato client dell'API Maps JavaScript con un ID client.
   • Apri la pagina Metriche in Cloud Console.
   • Filtra l'utilizzo con le seguenti impostazioni:
     • Raggruppato per: Metodo API
     • Credenziali: seleziona solo "project_number:<numerical identifier>".
   • Poi, vedrai un elenco di nomi di metodi con il relativo traffico nel grafico "Traffico per metodo API".

• Se non utilizzi questi metodi API, non devi preoccuparti delle impostazioni della 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à Per secondo sia quella Per giorno.
  • Grafico Al secondo: moltiplica il traffico di picco per 60 per le esigenze aggiuntive di Quota al minuto.
  • Grafico giornaliero: il traffico di picco deve corrispondere alle esigenze aggiuntive della quota giornaliera.
• Modificare la quota nei servizi Maps Platform corrispondenti
  • In base al nome del metodo che trovi nel passaggio 1, modifica la quota per i servizi corrispondenti.

Aggiorna il codice

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.

Rimuovere il parametro di firma per i servizi web

Per le API web service (*), il parametro di firma non è necessario quando accedi con una chiave API. Rimuovi solo il parametro della firma dalle richieste dell'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

L'API Maps Static e l'API Street View Static richiedono ancora il parametro di firma. Accettano un numero limitato di richieste senza firma a scopo di test, ma iniziano a non riuscire quando viene raggiunta la soglia in produzione. Sostituisci il segreto di firma da quello per l'ID client a quello per la chiave API. Puoi utilizzare lo stesso algoritmo di firma, ma devi utilizzare un altro segreto di firma. Per scoprire di più, consulta la pagina Utilizzare una firma digitale.

Monitorare il traffico dell'ID cliente

Dopo il deployment, verifica che la migrazione del traffico sia andata a buon fine utilizzando le dashboard di Cloud Console. Inizierai a notare una diminuzione del traffico per ID cliente, visualizzato in 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 cliente dopo la migrazione. Ha lo scopo di proteggere le tue credenziali da qualsiasi traffico indesiderato e di confermare che l'utilizzo rimanente del tuo ID cliente non è critico (ad es. test, cache, bot e così via) 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 dell'autenticazione del piano Premium.

Risoluzione dei problemi

Come faccio a sapere se la mia richiesta non va a buon fine?

Puoi controllare le statistiche sugli errori nei grafici dei codici di risposta.

ApiNotActivatedMapError o REQUEST_DENIED errore

Viene visualizzato l'errore ApiNotActivatedMapError o REQUEST_DENIED se non hai attivato il servizio nel tuo progetto Cloud. Segui le istruzioni per attivare il servizio.

RefererNotAllowedMapError errore

Viene visualizzato l'errore RefererNotAllowedMapError se il dominio di origine non è stato aggiunto alla chiave API. Controlla la sezione "Proteggi la tua chiave API" e aggiungi il tuo dominio alla chiave API.

OverQuotaMapError o OVER_QUERY_LIMIT errore

Vedrai OverQuotaMapError o OVER_QUERY_LIMIT se la quota configurata non è sufficiente per coprire il tuo traffico. Controlla la sezione "Esamina le impostazioni della quota" e modifica la quota di conseguenza.

Errore "Le richieste a questa API devono essere su 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"
}