Elenco di controllo pre-lancio

Dove gestire l'ID client nella console Google Cloud

La funzionalità di gestione dell'ID client del piano Premium è disponibile nella console Cloud nella parte inferiore della pagina delle credenziali della piattaforma Google Maps, nella sezione ID client.

La nuova area ID client nella pagina Credenziali

Per accedere ad altre attività di gestione dell'ID client, tra cui l'autorizzazione URL e la gestione del segreto di firma dell'ID client, puoi fare clic sull'icona Modifica in alto a destra nella sezione ID client della pagina ID client.

Importante:il piano Premium di Google Maps Platform non è più disponibile per la registrazione o i nuovi clienti.

Garantire che il team abbia accesso alle risorse necessarie

Utilizzare la console Google Cloud

Perché è importante: la console Google Cloud ti consente di accedere a informazioni quali report sull'utilizzo, feed di notizie e risorse per gli sviluppatori. Ancora più importante, la console Cloud consente di inviare richieste di assistenza al team di assistenza di Google Maps Platform in caso di problemi tecnici durante lo sviluppo o il lancio.

Prima di un lancio, attiva l'accesso alla console Cloud per tutti gli sviluppatori responsabili della manutenzione dell'applicazione. Se hai problemi tecnici, l'accesso a Cloud Console consente ai membri del tuo team di contattare l'assistenza e anche al nostro team di assistenza di contattare gli stakeholder appropriati della tua organizzazione. Ad esempio, il team di assistenza potrebbe dover contattare la tua organizzazione se rileviamo traffico o comportamenti anomali che potrebbero causare il malfunzionamento della tua applicazione. Garantire che possiamo contattare gli sviluppatori appropriati potrebbe fare la differenza tra un'interruzione imprevista e la sua prevenzione.

Iscriverti ai gruppi di email di notifica

Perché è importante: per non perderti gli sviluppi e le modifiche delle API Maps, ti consigliamo di iscriverti a uno o più dei seguenti gruppi di email:

  • google-maps-platform-notifications: aggiornamenti tecnici sulle API e sui servizi web di Google Maps Platform, notifiche di interruzione del servizio e annunci relativi alle funzionalità della piattaforma (~3-5 messaggi al mese).
  • google-maps-js-api-v3-notify - Nuove release dell'API Maps JavaScript di Google (~4 messaggi all'anno).

Ottimizzazione dell'applicazione

Configura un firewall per consentire l'accesso ai servizi Google Maps Platform

Perché è importante: i servizi della piattaforma Google Maps utilizzano diversi domini, alcuni dei quali non appartengono al dominio *google.com. Se utilizzi un firewall restrittivo, è importante consentire l'accesso ai domini utilizzati da ciascun servizio dell'API Maps. Se il firewall non consente l'accesso a questi domini, le richieste API non andranno a buon fine e le tue applicazioni potrebbero non funzionare. Consulta un elenco completo dei domini utilizzati dalle API Maps.

Sconsigliamo di gestire le restrizioni del firewall in base all'indirizzo IP, in quanto gli IP associati a questi domini non sono statici.

Nota:i servizi della piattaforma Google Maps utilizzano la porta 80 (HTTP) e 443 (HTTPS) per il traffico in entrata e in uscita. Questi servizi richiedono anche richieste GET, POST, PUT, DELETE e HEAD. Configura il firewall in modo da consentire il traffico su queste porte e le richieste, a seconda dell'API e del caso d'uso.

Autorizza i tuoi domini SSL per l'utilizzo con l'API Maps JavaScript

Perché è importante: quando utilizzi l'API JavaScript di Maps con un dominio SSL, è fondamentale che tu abbia autorizzato esplicitamente i tuoi domini HTTPS per assicurarti che le richieste non vengano rifiutate. Tieni presente che l'autorizzazione di http://yourdomain.com non attiva automaticamente il relativo equivalente SSL, https://yourdomain.com. Controlla l'elenco dei domini autorizzati nella console Cloud scorrendo verso il basso fino alla sezione ID cliente. Per risolvere i problemi relativi all'utilizzo delle API lato client con un dominio SSL, controlla se alcuni elementi della pagina vengono caricati tramite HTTP. Consulta la guida alla risoluzione dei problemi relativi all'autorizzazione.

Seleziona la versione dell'API corretta

Perché è importante: prima di sviluppare l'applicazione, è importante sapere quali versioni delle API sono ritirate. Se scegli di sviluppare in base alle versioni non ritirate delle API, risparmierai tempo e costi di sviluppo in futuro, quando le versioni ritirate non saranno più disponibili.

In particolare, è fondamentale comprendere lo schema di versionamento utilizzato dall'API Maps JavaScript per evitare di utilizzare accidentalmente una versione non corretta dell'API nel tuo ambiente.

Ad esempio, potrebbe essere opportuno utilizzare la versione sperimentale dell'API nell'ambiente di sviluppo o di test, ma sconsigliamo vivamente l'uso della versione sperimentale in un ambiente di produzione. Il nostro SLA si applica solo alle versioni stabili dell'API, pertanto devi utilizzare solo le versioni stabili nel tuo ambiente di produzione.

Consulta la guida alle versioni dell'API Maps JavaScript.

Scegliere tra il design lato client e lato server

Perché è importante: la scelta di un approccio lato client o lato server è una decisione di architettura ed è assolutamente fondamentale per la stabilità e la scalabilità della tua applicazione. In generale, per l'elaborazione pre e post dei record offline (ovvero al di fuori dell'applicazione) dovrebbe essere utilizzato un approccio lato server. In alternativa, per le parti delle tue applicazioni che interagiscono con gli utenti (ovvero che elaborano le richieste inviate dagli utenti in tempo reale) dovrebbe essere utilizzato un approccio lato client.

Il deployment di un approccio lato server quando invece dovrebbe essere utilizzato un approccio lato client è la causa principale del superamento delle quote e, di conseguenza, di applicazioni non funzionanti. Ti consigliamo vivamente di consultare le strategie di geocodifica prima di progettare o lanciare applicazioni che si basano su chiamate lato server.

Ottimizzare l'utilizzo della quota

Perché è importante: comprendere il modo in cui la tua applicazione consuma la quota, nota come Crediti API Maps, ti aiuta a ridurre l'importo che paghi. Ad esempio, se utilizzi l'API Maps JavaScript, la tua applicazione consuma i crediti delle API di Maps per ogni caricamento della mappa. Consulta la guida alle tariffe e ai limiti di utilizzo del piano Premium.

Gestire l'utilizzo della quota dei servizi web

Prima di lanciare il servizio, è fondamentale comprendere i diversi errori relativi alle quote (ad es. OVER_QUERY_LIMIT, User Rate Limit Exceeded) e configurare la logica appropriata nell'applicazione per poter rispondere a questi errori quando superi la quota. Per prima cosa, consulta le domande frequenti sui limiti di utilizzo. Per informazioni sui codici di stato restituiti da ogni API, consulta la Guida per gli sviluppatori dell'API in questione. Ad esempio, consulta la guida ai codici di stato dell'API Directions. Comprendere e implementare questi concetti ridurrà notevolmente le probabilità che la tua applicazione superi la quota consentita, venga bloccata da Google e/o si blocchi.

Esegui test di carico sulla tua app

Perché è importante: utilizza i test di carico della tua applicazione per assicurarti che possa gestire elevati volumi di richieste senza superare le quote per le API Maps.

Sebbene Google Maps Platform possa gestire volumi di traffico molto elevati, i test con i servizi Google in produzione faranno sì che la tua applicazione superi la quota consentita e possa essere bloccata da Google. Sei inoltre responsabile degli addebiti di utilizzo sostenuti dai test di carico.

Invece, i test di carico dell'applicazione devono garantire che l'applicazione sia in grado di gestire elevati volumi di richieste senza superare le quote per le API Maps o essere bloccata da Google. Per farlo in sicurezza, esegui test di carico su un'API simulata (falsificata), un servizio in grado di assorbire un numero elevato di richieste, e rispondi alle richieste con risposte valide, senza coinvolgere Google Maps Platform. Esempio: se la tua quota per l'API Geocoding è di 3000 QPM (query al minuto), il test di carico dell'applicazione dovrebbe garantire che l'applicazione possa gestire un volume molto più elevato, ad esempio 90000 QPM, senza inviare più di 3000 QPM all'API Geocoding.

Se prevedi di eseguire test di carico significativi, contatta l'assistenza Google per ricevere indicazioni e assicurarti che Google sia al corrente dei test pianificati.