Report Google Maps Platform

I report in Google Maps Platform forniscono un insieme di report visivi predefiniti su utilizzo, quota e informazioni di fatturazione di base delle API nella console Google Cloud. Utilizza questi report per determinare il numero di chiamate API che hai effettuato, quanto manca per raggiungere le quote di utilizzo dell'API e monitorare l'utilizzo della fatturazione nel tempo.

I tipi di report includono:

• Report sull'utilizzo: indica il numero di richieste inviate dal progetto alle API di Google Maps Platform utilizzando le credenziali associate al progetto.
• Report sulle quote: riportano l'utilizzo della quota in grafici che possono essere raggruppati in richieste al minuto. I limiti di quota attuali per le API selezionate sono visualizzati nelle tabelle sotto i grafici di utilizzo delle quote.
• Report di fatturazione: riporta i costi nel tempo sotto forma di grafico a linee in pila. Visualizza l'utilizzo della quota del mese in corso, inclusi eventuali crediti specifici per l'utilizzo applicati, nonché il costo totale previsto per l'intero mese in corso.
• scienceReport sul coinvolgimento: forniscono informazioni aziendali su come gli utenti interagiscono con le tue app di mappe.

Per un elenco completo degli stati e dei codici di risposta che definiscono se una richiesta viene visualizzata nei report Utilizzo, Quota e/o Fatturazione, consulta Stato di risposta e report.

Visualizza i report sull'utilizzo, sulla quota e sulla fatturazione di Google Maps Platform utilizzando la console Cloud.

Report sull'utilizzo

L'utilizzo si basa sul numero di richieste inviate dal progetto alle API di Google Maps Platform utilizzando le credenziali associate al progetto. Le richieste includono richieste riuscite, richieste che generano errori del server e richieste che generano errori del client. Le credenziali includono chiavi API e ID client (per i progetti del piano Premium e di quelli di cui è stata eseguita la migrazione al piano Premium). Per maggiori dettagli, consulta la Panoramica del piano Premium e le informazioni sull'utilizzo di un ID client.

Le metriche di utilizzo vengono visualizzate in tabelle (Richieste, Errori e Latenza) e grafici (Traffico, Errori e Latenza). A fini di monitoraggio:

• Tutte le API: puoi filtrare e raggruppare le metriche di utilizzo per tutte le API nei seguenti modi:

  • Filtra per periodo di tempo e API.
  • Visualizza traffico, errori e latenza raggruppati per codice di risposta, API e credenziale.

• Un'API specifica: puoi filtrare e raggruppare le metriche di utilizzo per un'API specifica in questi modi:

  • Filtra per periodo di tempo, versioni API, credenziali e metodi.
  • Visualizza traffico, errori e latenza raggruppati per codice di risposta, metodo e versione dell'API e credenziale.

Pagina Dashboard API e servizi

La dashboard API e servizi fornisce una panoramica delle metriche di utilizzo per tutte le API attivate per il tuo progetto: le API di Google Maps Platform, nonché altre API e altri servizi.

• La pagina Dashboard contiene tre grafici e una tabella. Puoi filtrare l'utilizzo visualizzato nei grafici e nelle tabelle selezionando un periodo di tempo compreso tra 1 ora e gli ultimi 30 giorni.

• Il grafico Traffico mostra l'utilizzo in query al minuto (QPM) per API.

• Il grafico Errori mostra la percentuale di richieste che hanno generato errori per API.

• Il grafico Latenza mostra la latenza media delle richieste per API.

Sotto i grafici, una tabella elenca le API e i servizi abilitati. Le richieste corrispondono al numero di richieste (per il periodo di tempo selezionato). Errori indica il numero di queste richieste che hanno generato errori. La latenza (latenza media e percentile) è la latenza per queste richieste.

Per accedere alla pagina Dashboard API e servizi:

1. Apri la pagina del selettore di progetti in Cloud Console:

   Pagina del selettore di progetti

2. Seleziona il progetto. Viene visualizzata la pagina Dashboard API e servizi.
   
   Se la pagina non viene visualizzata, seleziona il pulsante del menu e poi API e servizi.

Per saperne di più, consulta la pagina Monitoraggio dell'utilizzo delle API.

Pagina Panoramica di Google Maps

La pagina Panoramica di Google Maps include una tabella che elenca le API abilitate e le richieste di utilizzo negli ultimi 30 giorni. Le richieste per API vengono mostrate anche sotto forma di grafico. Un grafico di fatturazione mostra la tua attuale bolletta e l'utilizzo totale negli ultimi 3 mesi.

Per accedere alla pagina Panoramica di Google Maps Platform:

1. Apri la pagina Google Maps Platform in Cloud Console:

   Vai alla pagina di Google Maps Platform

2. Nel menu a sinistra, seleziona Panoramica.

Pagina API e servizi di Google Maps Platform

La pagina API e servizi di Google Maps contiene una griglia di riquadri che rappresentano le API, gli SDK e altri servizi disponibili per il tuo progetto. In ogni riquadro, puoi attivare o disattivare il servizio selezionando Attiva o Disattiva e puoi accedere alle informazioni sulle credenziali, alle metriche e alle guide per l'utente per le API attivate. Puoi anche utilizzare i filtri della pagina per visualizzare i servizi abilitati o disattivati e altre categorie di servizi.

Per accedere alla pagina API e servizi di Google Maps Platform:

1. Apri la pagina Google Maps Platform in Cloud Console:

   Vai alla pagina di Google Maps Platform

2. Nel menu a sinistra, seleziona API e servizi.

Pagina Metriche di Google Maps

La pagina Metriche di Google Maps mostra tre grafici: Traffico, Errori e Latenza media. I dati di utilizzo nei grafici possono essere raggruppati per classe di codice di risposta, API, metodo API, credenziale, piattaforma e dominio.

Sotto i grafici, la pagina Metriche include una tabella delle API che mostra le richieste, gli errori e la latenza per le API che hai selezionato.

Utilizzando il menu a discesa API in alto e le opzioni di raggruppamento e filtro nel riquadro a destra, puoi raggruppare e filtrare le metriche di utilizzo visualizzate selezionando API, credenziali, classi di codici di risposta, tipo di piattaforma e/o dominio specifici o multipli. Puoi anche selezionare un periodo di tempo (da un'ora fino agli ultimi 30 giorni) e la granularità (per secondo o giorno) per le metriche di utilizzo visualizzate.

Le seguenti immagini mostrano i filtri Piattaforma e Dominio per una singola API quando il raggruppamento per Piattaforma e Dominio è selezionato nell'elenco a discesa Raggruppato per:

Per accedere alla pagina Metriche dell'API Google Maps Platform:

1. Apri la pagina Google Maps Platform in Cloud Console:

   Vai alla pagina di Google Maps Platform

2. Nel menu a sinistra, seleziona Metriche.

Report sulle credenziali

Puoi filtrare e raggruppare le metriche in base alle credenziali utilizzate per caricare l'API.

Grafici dei codici di risposta

I grafici Traffico per codice di risposta ed Errori per codice di risposta suddividono l'utilizzo in base alla classe del codice di risposta HTTP. Questa tabella mostra la mappatura tra lo stato di risposta dell'API Google Maps Platform e la classe del codice di risposta HTTP:

Per ulteriori informazioni sui codici di stato e sui messaggi di errore, consulta la documentazione relativa alle risposte per l'API che ti interessa (ad es. Risposte di geocodifica o Risposte di indicazioni stradali).

Parametro delle soluzioni Google Maps Platform

Google Maps Platform fornisce molti tipi di codice di esempio per aiutarti a iniziare rapidamente. Ad esempio, puoi utilizzare Quick Builder in Cloud Console, seguire le guide all'implementazione delle soluzioni di settore e imparare da codelabs.

Per comprendere l'utilizzo e i modi per migliorare le proprie soluzioni, Google include il parametro di query solution_channel nelle chiamate API per raccogliere informazioni sull'utilizzo del codice di esempio:

• Il parametro di query solution_channel è incluso per impostazione predefinita nel codice di esempio della soluzione.
• Il parametro di query restituisce a Google analisi sull'adozione della soluzione per migliorare la qualità della soluzione nelle iterazioni future.
• Per disattivare questa funzionalità, elimina il parametro di query solution_channel e il relativo valore dal codice di esempio.
• Non è necessario mantenere il parametro. La rimozione del parametro di query non influisce sulle prestazioni.
• Il parametro di query viene utilizzato solo per i report sull'utilizzo del codice di esempio.
• Il parametro di query è separato da qualsiasi analisi e report specifici dell'API. Ciò significa che la rimozione del parametro dal codice di esempio della soluzione non disattiva i report interni dell'API Maps JavaScript.

Report sulla quota

Le quote impostano limiti sul numero di richieste che il progetto può effettuare alle API di Google Maps Platform. Le richieste possono essere limitate in tre modi: al giorno, al minuto e per utente al minuto. Solo le richieste andate a buon fine e quelle che causano errori del server vengono conteggiate ai fini della quota. Le richieste che non superano l'autenticazione non vengono conteggiate ai fini della quota.

L'utilizzo delle quote viene visualizzato in grafici nella pagina Quote di Cloud Console e può essere raggruppato in richieste al minuto. I limiti di quota attuali per le API selezionate vengono visualizzati nelle tabelle sotto i grafici di utilizzo delle quote.

Per ottenere il valore della quota per minuto per qualsiasi prodotto API GMP, utilizza questo calcolatore.

Pagina Quote di Google Maps

La pagina Quote di Google Maps mostra i limiti e il consumo delle quote per l'API specifica che hai selezionato.

Il grafico sull'utilizzo delle quote in Google Cloud Console mostra il traffico totale per le tue chiavi API e gli ID client. Il traffico dell'ID client è disponibile anche nel grafico Metriche della console Cloud.

La pagina mostra solo le richieste che consumano la quota: richieste riuscite (OK, ZERO_RESULTS, DATA_NOT_AVAILABLE) e richieste che causano errori del server (NOT_FOUND, INVALID_REQUEST/INVALID_VALUE (valore del parametro non valido), UNKNOWN_ERROR).

Le richieste che causano errori client (autenticazione, autorizzazione ed errori di argomenti non validi (REQUEST_DENIED, OVER_QUERY_LIMIT, INVALID_REQUEST (parametro non valido, errore di analisi della richiesta)) non consumano quota e non vengono visualizzate.

L'unità di quota è una richiesta per la maggior parte delle API di Google Maps Platform (API Maps Static, API Street View Static, API Geocoding, API Directions, API Places, API Time Zone, API Geolocation e API Elevation), ma ci sono alcune eccezioni:

• Per l'API Distance Matrix, l'unità di quota è un elemento che è una coppia origine-destinazione.
• Per l'API Maps JavaScript, l'unità di quota è un caricamento della mappa.
• Per Maps SDK for Android e Maps SDK for iOS, l'unità di quota è una richiesta di Street View o un caricamento di panoramica. I caricamenti delle mappe sono disponibili senza costi e non consumano quota.

Per accedere alla pagina delle quote di Google Maps Platform:

1. Apri la pagina Google Maps Platform in Cloud Console:

   Vai alla pagina di Google Maps Platform

2. Nel menu a sinistra, seleziona Quote.
3. Seleziona un'API dall'elenco a discesa API.

Unità di quota

Questa tabella mostra l'unità di quota per le API di Google Maps Platform.

Report di fatturazione

Visualizzazione del rapporto di fatturazione

I report di fatturazione per l'utilizzo dei prodotti Google Maps Platform sono disponibili nella console Google Cloud. Per ulteriori informazioni, consulta Fatturazione.

Per accedere ai report di fatturazione:

1. Apri la pagina del selettore di progetti in Cloud Console:

   Pagina del selettore di progetti

2. Seleziona un progetto.
3. Seleziona il pulsante Menu e poi Fatturazione.
4. Se hai più account di fatturazione, seleziona Vai all'account di fatturazione collegato per aprire la pagina Panoramica dell'account di fatturazione collegato.
5. Nel menu a sinistra, seleziona Report per aprire la pagina Report relativa alla fatturazione per l'account di fatturazione collegato.

Come leggere il grafico del report sulla fatturazione

I report di fatturazione tracciano il costo nel tempo sotto forma di grafico a linee in pila. La visualizzazione predefinita mostra i costi giornalieri specifici per l'utilizzo del mese corrente raggruppati per progetto (per tutti i prodotti), inclusi eventuali crediti specifici per l'utilizzo applicati, nonché il costo totale previsto per l'intero mese corrente. Ogni riga del grafico (e della tabella di riepilogo) corrisponde al progetto, in ordine crescente di costo. Scopri di più su come interpretare il grafico del report di fatturazione.

Suggerimento: analizza l'utilizzo e il costo per SKU

Per comprendere con maggiore precisione i dettagli del modello di prezzi di pagamento a consumo e il suo impatto sull'implementazione, controlla l'utilizzo e il costo per SKU.

Per modificare la visualizzazione del report in modo da visualizzare gli elementi pubblicitari per SKU:

1. Nel riquadro a destra del grafico, espandi il filtro Raggruppa per.
2. Seleziona SKU.

Altri filtri dei report di fatturazione disponibili includono Intervallo di tempo, Progetti, Prodotti, SKU e Località, che ti consentono di filtrare in base a da dove vengono inviate le richieste API.

Per classificare l'origine dell'utilizzo oltre al prodotto, raggruppa i report di fatturazione in base a uno dei valori elencati. Le tre chiavi relative alle API di Google Maps Platform sono goog-maps-api-key-suffix (i quattro caratteri finali di una chiave API), goog-maps-platform-type (la piattaforma: Android, iOS, JavaScript o web service) e goog-maps-channel (un valore numerico impostato per il canale da una query dell'API). Ulteriori informazioni su filtri e raggruppamenti.

Puoi modificare la visualizzazione del grafico in modo da escludere i crediti specifici per l'utilizzo deselezionando la casella di controllo Includi crediti nel costo nel riquadro a destra.

Monitorare e limitare il consumo

Per aiutarti a pianificare il budget e controllare i costi, puoi:

• Imposta un avviso relativo al budget per monitorare l'aumento della spesa rispetto a un determinato importo. L'impostazione di un budget non pone un limite all'utilizzo dell'API, ma ti avvisa solo quando l'importo della spesa si avvicina all'importo specificato.

• Imposta un limite per l'utilizzo giornaliero delle API per gestire il costo di utilizzo delle API fatturabili. Impostando dei limiti per le richieste al giorno, puoi limitare la spesa. Utilizza una semplice equazione per determinare il tuo limite giornaliero in base all'importo che vuoi spendere. Ad esempio: (spesa mensile /prezzo per ogni SKU)/30 = limite di richieste al giorno (per un'API).

Monitoraggio dell'utilizzo per canale

Per monitorare l'utilizzo tramite canali numerici, devi aggiungere il parametro "channel" alle richieste dell'API. Gli unici valori accettabili per il canale sono numeri compresi tra 0 e 999. Ecco alcuni esempi:

• API Geocoding Web Service

  https://maps.googleapis.com/maps/api/geocode/json?address=1600+Amphitheatre+Parkway,+Mountain+View,+CA&key=YOUR_API_KEY&channel=1

• API Maps JavaScript

  <script src="https://maps.googleapis.com/maps/api/js?key=YOUR_API_KEY&channel=2&callback=initMap"
  async defer></script>

Monitora l'utilizzo del tuo canale direttamente nel report di fatturazione. I canali verranno visualizzati in Etichette come chiave goog-maps-channel.

Per filtrare il report sulla fatturazione per SKU e canale

1. Utilizza il filtro Raggruppa per SKU.
2. Seleziona il cursore Etichette.
3. Seleziona il menu a discesa Chiave e seleziona goog-maps-channel.
4. Seleziona il menu a discesa Valore e i canali numerici da filtrare.

Raggruppa per chiave dell'etichetta goog-maps-channel per visualizzare il costo generato da ciascun canale.

Una volta implementati i dati sull'utilizzo dei canali nelle richieste, potrebbe verificarsi un breve ritardo (fino a 24 ore) prima che i dati vengano riportati nel report di fatturazione.

Esportare i dati di fatturazione con BigQuery

Puoi anche esportare i tuoi dati di fatturazione in BigQuery.

BigQuery Export ti consente di esportare automaticamente durante la giornata i dati dettagliati della fatturazione Cloud (ad esempio dati su utilizzo e stime di costi) in un set di dati BigQuery da te specificato. Potrai quindi accedere ai tuoi dati di fatturazione da BigQuery per un'analisi dettagliata. In questo modo, puoi ottenere un livello di granularità aggiuntivo per comprendere l'origine del tuo utilizzo di Google Maps Platform.

Se vuoi iniziare a utilizzare le esportazioni di BigQuery ed eseguire query sui dati, puoi provare la query di esempio riportata di seguito. Prima di eseguire questa query, devi:

• Attiva la fatturazione e BigQuery Export nel tuo account.
• Il formato della tabella è PROJECT_ID.DATASET_NAME.gcp_billing_exportv1BILLING_ACCOUNT_ID, dove:
• PROJECT_ID è il tuo ID progetto effettivo (ad es. "my-project-123456").
• DATASET_NAME è il nome del set di dati che hai creato (ad es. "SampleDataSet").
• BILLING_ACCOUNT_ID è un riferimento all'ID account di fatturazione, con prefisso "gcp_billing_exportv1" e i trattini (-) sostituiti da trattini bassi (_). Ad esempio, l'ID account di fatturazione 123456-7890AB-CDEF01 diventerà gcp_billing_export_v1_123456_789AB_CDEF01.

  #standardSQL
  SELECT   Date(usage_start_time, "America/Los_Angeles") AS billing_day,
           invoice.month                                 AS invoice_month,
           service.description                           AS service,
           sku.description                               AS sku,
           (
                  SELECT l.value
                  FROM   Unnest(labels) AS l
                  WHERE  l.KEY = 'goog-maps-channel' ) AS goog_maps_channel,
           Round(Sum(usage.amount), 2)                 AS usage_amount,
           usage.unit                                  AS usage_unit,
           Round(Sum(cost), 2)                         AS cost,
           cost_type,
           currency
  FROM     PROJECT_ID.DATASET_NAME.gcp_billing_export_v1_BILLING_ACCOUNT_ID
  WHERE    invoice.month = '202002' -- Change the invoice month with the same format as the example.
  GROUP BY billing_day,
           invoice_month,
           service,
           sku,
           goog_maps_channel,
           usage_unit,
           cost_type,
           currency
  ORDER BY billing_day,
           service,
           sku
  

Risorse correlate

Fatturazione Cloud:

• Crea, modifica o chiudi il tuo account di fatturazione Cloud
• Modificare le impostazioni di fatturazione di un progetto
• Visualizzare i report di fatturazione e le tendenze dei costi
• Impostare budget e avvisi relativi al budget
• Limitazione dell'utilizzo delle API

• Fatturazione di Google Maps Platform
• Guida all'ottimizzazione
• Best practice per le chiavi API

Stato di risposta e report

La tabella seguente mostra la mappatura tra lo stato dell'API Maps, il codice di risposta HTTP restituito nelle risposte dell'API Maps e la classe del codice di risposta HTTP nel report Utilizzo e indica se la richiesta corrispondente viene visualizzata nei report Utilizzo, Quota e Fatturazione.

Il report Utilizzo in Metriche di Google Maps Platform fornisce una granularità di HTTP response code class. Se hai bisogno di un livello di granularità superiore, consulta i codici di stato della risposta disponibili nel monitoraggio dell'utilizzo di Google Maps Platform.

Report Coinvolgimento

Insight sull'attività commerciale

Google Maps Platform ti fornisce informazioni su come gli utenti interagiscono con le tue mappe. Questi approfondimenti includono metriche chiave sul coinvolgimento, come le visualizzazioni su una mappa o le interazioni con un PDI. Puoi analizzare questi approfondimenti per scoprire le località più apprezzate per la pubblicità e il marketing o per ottimizzare l'esperienza utente.

Le funzionalità di generazione di report di Business Insights includono:

• Visualizzazione di un'istantanea di insight sull'attività di alto livello per visualizzare rapidamente le tendenze principali degli insight sull'attività
• Eseguire drill-down per analizzare una metrica specifica all'interno della console per comprendere meglio le metriche
• Esportazione delle metriche in formato CSV per analizzare i dati degli Approfondimenti aziendali nel tuo strumento di analisi aziendale preferito

Le metriche sul coinvolgimento disponibili includono:

• Visualizzazioni mappa:monitora le visualizzazioni sulla mappa risultanti da panoramiche, zoom o inclinazioni. Le visualizzazioni mappa vengono calcolate in base al codice postale su base settimanale (da domenica a sabato, fuso orario del Pacifico USA). I nuovi dati vengono pubblicati settimanalmente il primo mercoledì successivo al periodo di osservazione.

I proprietari del progetto e gli utenti con il ruolo Visualizzatore di Maps Analytics possono visualizzare gli approfondimenti sull'attività nella pagina Metriche della console Cloud. Nel progetto deve essere attivata l'API Maps JavaScript.

Puoi analizzare le metriche sul coinvolgimento direttamente nella console con le funzionalità Filtra e Raggruppa per esaminarle in modo più dettagliato. Ad esempio, puoi scegliere di filtrare i risultati in base a una regione specifica per scoprire le tendenze delle visualizzazioni della mappa solo per i codici postali di quella regione. D'altra parte, potresti voler raggruppare in base a una regione specifica per aggregare le interazioni all'interno di quella regione.

Gli utenti possono esportare l'intero set di dati o una visualizzazione filtrata in formato CSV per analizzarli ulteriormente nel tuo strumento di analisi aziendale preferito. Puoi scaricare fino a 90 giorni alla volta e i download superiori a 60.000 celle verranno troncati. L'esportazione dei dati delle visualizzazioni mappa in formato CSV può richiedere alcuni minuti, a seconda dell'intervallo di tempo selezionato.

Le metriche degli Approfondimenti aziendali sono anonimizzate e quindi riflettono solo le tendenze generali del coinvolgimento con le tue mappe. I conteggi ridotti potrebbero essere arrotondati a zero e i contributi degli outlier potrebbero essere ridotti.

Puoi controllare l'accesso agli approfondimenti commerciali per il tuo progetto Cloud nella console Google Cloud utilizzando l'autorizzazione Maps Analytics. Per impostazione predefinita, questa autorizzazione viene concessa ai proprietari del progetto, che possono eseguire il provisioning dell'accesso ad altri utenti in base alle esigenze.

Gli approfondimenti aziendali non devono essere utilizzati per stimare i costi di utilizzo. Per ulteriori informazioni sull'utilizzo, consulta i report sull'utilizzo.