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 della quota
  4. Aggiorna il codice
  5. Monitora il traffico dell'ID cliente
  6. Metti in pausa l'ID client
  7. Riattivazione temporanea self-service dell'ID client

Controlla l'utilizzo corrente dell'ID client

Prima di iniziare il processo di migrazione, elenca quanto segue:

  • Servizi di Maps Platform che utilizzi con 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 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 cliente 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:<numerical identifier>".
  3. Imposta il seguente filtro.
    • Raggruppamento per: API

Per suggerimenti su 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 indizi sulle sorgenti del traffico dell'ID client. Segui questi passaggi:

  1. Apri la pagina Metriche nella console Cloud.
  2. Seleziona un servizio di 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 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 quel progetto ti consentirà di accedere 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:
  2. Assicurati che il tuo progetto Cloud sia collegato a un account di fatturazione aperto.
  3. Crea una nuova chiave API per la migrazione degli 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 di 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.

Proteggi la tua chiave API

Assicurati di proteggere la tua chiave API per impedire l'accesso non autorizzato.

  • Imposta una restrizione delle applicazioni per la tua chiave API (ad es. siti web, indirizzi IP, app per Android o app per iOS).
  • Imposta le restrizioni delle API per la tua chiave API.

Per maggiori dettagli, consulta le indicazioni sulla 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 restrizioni 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 per il tuo progetto Cloud. Devi eseguire questa operazione solo se chiami i servizi lato client dell'API Maps JavaScript da un ID cliente. Puoi controllare e modificare le impostazioni relative alle 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 attuale della quota, l'utilizzo corrente e modifica i limiti di quota di conseguenza.

  1. Controlla 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:
      • Raggruppamento per: metodo API
      • Credenziali: seleziona solo "project_number:<numerical identifier>".
    • A questo punto, vedrai un elenco di nomi di metodi con il relativo traffico nel grafico "Traffico per metodo API".

Metodo API

Servizio lato client

Servizio per cui modificare la quota

google.routes.Directions.Javascript

Servizio Directions

API Directions

google.routes.DistanceMatrix.Javascript

Servizio Distance Matrix

API Distance Matrix

google.maps.Elevation.Javascript

Servizio Elevation

API Elevation

google.places.Geocoding.Javascript

Servizio di geocodifica

API Geocoding

google.places.*.Javascript, ad eccezione di google.places.Geocoding.Javascript

libreria Places

API Places
  • 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.
  • Stima l'utilizzo della quota dell'ID client
    • Per ciascuno dei servizi, controlla la granularità al secondo e al giorno.
    • Grafico Per secondo: moltiplica il traffico di picco per 60 per le esigenze di quota aggiuntiva al minuto.
    • Grafico Per giorno: il picco di traffico deve corrispondere alle esigenze di quota aggiuntiva per giorno.
  • Modifica la quota sui servizi Maps Platform corrispondenti
    • In base al nome del metodo trovato nel passaggio 1, modifica la quota per i servizi corrispondenti.

Aggiorna il codice

Sostituisci il parametro client con il parametro key

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 del canale. Se utilizzi l'ID cliente con valori non numerici per il parametro del canale, aggiornalo con un valore numerico supportato.

Per ulteriori informazioni, consulta la sezione Reporting di Google Maps Platform.

Rimuovi il parametro della firma per i servizi web

Per le seguenti API di servizi web, il parametro signature non è necessario quando 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 per scopi di test, ma iniziano a non riuscire una volta raggiunta la soglia in produzione. Sostituisci il secret di firma dell'ID client con quello della 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.

Monitora il traffico dell'ID client

Dopo il deployment, verifica che la migrazione del traffico sia andata a buon fine utilizzando le dashboard della console Cloud. Inizierai a notare una diminuzione del traffico dell'ID client, che viene visualizzato nel formato "project_number:123456" nella dashboard quando raggruppi per credenziale.

Metti in pausa l'ID client

Consigliamo vivamente agli sviluppatori di mettere in pausa gli ID client dopo la migrazione. Questo serve a proteggere le tue credenziali da qualsiasi traffico indesiderato e a confermare che l'utilizzo rimanente del tuo ID cliente non è critico (ad es. test, cache, bot…) e può restituire errori senza causare un impatto sull'attività. Puoi mettere in pausa l'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à periodicamente limitato nell'ambito della procedura di interruzione del servizio programmata. 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 l'accesso con urgenza, 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 esente 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 cliente - dai 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 della piattaforma Maps). Sebbene i report sulla fatturazione abbiano una latenza di 1-2 giorni, hanno il vantaggio di mostrare insight sull'utilizzo e sui 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 il subaccount di fatturazione desiderato.
  3. Raggruppa i dati del report in base alla chiave 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 dell'ID client.
  5. Ignora gli SKU che non devono essere associati alle richieste API, ad esempio gli SKU degli abbonamenti.

Risoluzione dei problemi

Come facciamo a sapere se la nostra richiesta non è andata 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 tuo dominio di origine non è stato aggiunto alla chiave API, verrà visualizzato l'errore RefererNotAllowedMapError. Consulta la sezione "Proteggi la tua chiave API" e aggiungi il tuo dominio alla chiave API.

Errore OverQuotaMapError o OVER_QUERY_LIMIT

Se la quota configurata non è sufficiente per coprire il traffico, vedrai OverQuotaMapError o OVER_QUERY_LIMIT. Controlla la sezione "Rivedi le impostazioni della quota" e modifica la quota di conseguenza.

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