Guida alla migrazione dell'ID cliente

Panoramica

Per iniziare, procedi nel seguente modo:

1. Controlla l'utilizzo attuale dell'ID client
2. Prepara le chiavi API
3. Controlla le impostazioni delle quote
4. Aggiorna il codice
5. Monitora il traffico dell'ID client
6. Mettere in pausa l'ID client
7. Riattivazione temporanea self-service dell'ID client

Controllare l'utilizzo corrente dell'ID client

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

• Servizi di Maps Platform con cui utilizzi il tuo ID cliente.
• Applicazioni, siti o sistemi con cui utilizzi il tuo ID client.

Google ha inviato un'email di notifica ai clienti interessati in merito al ritiro dell'ID client 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 della piattaforma Maps:

1. Apri la pagina Metriche nella console Cloud.
2. Filtra l'utilizzo con le seguenti impostazioni:
   • Credenziali: seleziona solo "project_number:<identificatore numerico>".
3. Imposta il seguente filtro.
   • Raggruppati per: API

Per suggerimenti di applicazioni, siti o sistemi:

La console Cloud 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:

1. Apri la pagina Metriche nella console Cloud.
2. Seleziona un servizio Maps Platform dal menu a discesa.
3. Filtra l'utilizzo con le seguenti impostazioni:
   • Credenziali: seleziona solo "project_number:<identificatore numerico>".
4. Imposta il seguente filtro.
   • Raggruppa per: piattaforma o dominio
5. Ripeti 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 le funzionalità mancanti.

1. Trova il progetto Cloud a cui è collegato il tuo ID client:
   • Domande frequenti sulla migrazione del portale
2. Assicurati che il tuo progetto Cloud sia collegato a un account di fatturazione aperto.
3. 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 Google 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 chiave API per impedire l'accesso non autorizzato.

• 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 API per la tua chiave API.

Per maggiori dettagli, consulta la guida alla 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 sul tuo ID client alle limitazioni della chiave 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 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 della quota, l'utilizzo attuale e modifica i limiti di quota di conseguenza.

1. Verifica se utilizzi 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:<identificatore numerico>".
   • 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 di quota, poiché il traffico dell'ID client consuma già la quota del progetto.
• Stima l'utilizzo della quota dell'ID client
  • Per ciascuno dei servizi, controlla la granularità sia al secondo sia al giorno.
  • Grafico al secondo: moltiplica il picco di traffico per 60 per le esigenze aggiuntive di quota al minuto.
  • Grafico giornaliero: il picco di traffico deve corrispondere alla quota giornaliera aggiuntiva necessaria.
• Modifica la quota per i servizi Maps Platform corrispondenti
  • In base al nome del metodo che trovi nel passaggio 1, modifica la quota sui 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.

Aggiorna 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 della 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 Imagery

L'API Maps Static e l'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 da quello per l'ID client a quello per la chiave API. Puoi utilizzare lo stesso algoritmo di firma, ma devi utilizzare un altro secret di firma. Per saperne di più, consulta Utilizza una firma digitale.

Monitorare il traffico dell'ID client

Dopo il deployment, verifica che la migrazione del traffico sia stata eseguita correttamente utilizzando i dashboard della console Cloud. Inizierai a notare una diminuzione del traffico dell'ID cliente, che viene 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 maggiori dettagli, consulta la panoramica dell'autenticazione del piano Premium.

Riattivazione temporanea self-service dell'ID client

Poiché gli ID client di Google Maps Platform sono entrati nel periodo di ritiro graduale a maggio 2026, la disponibilità del servizio non è più garantita. L'accesso verrà limitato periodicamente nell'ambito della procedura di interruzione pianificata del servizio. Anche se il servizio viene in genere ripristinato automaticamente entro poche ore, puoi scegliere di riattivare manualmente l'accesso se è necessario un ripristino immediato.

Per ripristinare urgentemente l'accesso, puoi eseguire una riattivazione self-service tramite la console Google Cloud:

• Vai alla pagina Credenziali di Google Maps Platform.
• Individua il progetto Cloud specifico collegato al tuo ID cliente.
• Fai clic sull'icona Riattiva situata all'estrema destra della voce per ripristinare il servizio.

Se non riesci a eseguire rapidamente la migrazione alle chiavi API e vuoi essere temporaneamente esentato da ulteriori interruzioni, contatta il team di assistenza di Google Maps Platform fornendo i seguenti dettagli:

• ID client
• Caso d'uso specifico
• Data di migrazione target
• Valutazione dell'impatto sull'attività

Report sull'utilizzo dell'ID client - da Report sulla fatturazione

Controllare i report sulla fatturazione anziché le metriche del progetto può essere utile per gli utenti che non hanno accesso alle metriche del progetto, ad esempio gli amministratori della fatturazione (soprattutto i partner di Maps Platform). Sebbene i report sulla fatturazione abbiano una latenza di 1-2 giorni, mostrano informazioni su utilizzo e costi per più di 30 giorni.

Puoi monitorare l'utilizzo dell'ID client tramite la console Google Cloud seguendo questi passaggi:

1. Vai alla pagina Fatturazione > Report nella console Google Cloud.
2. (Facoltativo, pertinente solo per i partner) Applica un filtro per selezionare l'account di fatturazione secondario desiderato.
3. Raggruppa i dati del report in base alla chiave dell'etichetta goog-maps-api-key-suffix. Questa etichetta mostra i caratteri finali di una chiave API.
4. Identifica il traffico dell'ID client cercando le voci in cui l'etichetta goog-maps-api-key-suffix è mancante o vuota, poiché questa etichetta non viene compilata per le richieste di ID client.
5. Ignora gli SKU che non devono essere associati alle richieste API, ad esempio gli SKU di abbonamento.

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

Errore ApiNotActivatedMapError o REQUEST_DENIED

Se non hai attivato il servizio nel tuo progetto Cloud, verrà visualizzato l'errore ApiNotActivatedMapError o REQUEST_DENIED. 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

Visualizzerai 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"

Se ricevi il seguente messaggio di errore, aggiorna le tue 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"
}