Report Google Maps Platform

La generazione di report in Google Maps Platform fornisce una serie di report visivi predefiniti di utilizzo delle API di base, quota e dati di fatturazione nella console Google Cloud. Utilizza questi report per determinare il numero di chiamate API che hai effettuato, quanto sei vicino al raggiungimento delle quote di utilizzo delle API e per monitorare l'utilizzo della fatturazione nel tempo.

I tipi di report includono:

• Report di utilizzo: segnala il numero di richieste inviate dal tuo progetto alle API Google Maps Platform utilizzando le credenziali associate al progetto.
• Report sulle quote: indica l'utilizzo delle quote 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 dell'utilizzo delle quote.
• Report di fatturazione: registra 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.
• Report sul coinvolgimento: forniscono informazioni sull'attività relative al modo in cui gli utenti interagiscono con le app delle tue mappe.

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

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 tuo progetto alle API di Google Maps Platform utilizzando le credenziali associate al progetto. Le richieste includono richieste andate a buon fine, richieste che generano errori del server e richieste che generano errori del client. Le credenziali includono chiavi API e ID client (per i progetti con piano Premium e piano Premium di cui è stata eseguita la migrazione). Per i dettagli, consulta la panoramica del piano Premium e le informazioni sull'utilizzo di un ID client.

Le metriche di utilizzo sono visualizzate in tabelle (Richieste, Errori e Latenza) e grafici (Traffico, Errori e Latenza). Ai fini del 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 credenziali.

• Un'API specifica: puoi filtrare e raggruppare le metriche di utilizzo per un'API specifica nei modi indicati di seguito.

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

Pagina della dashboard API e servizi

La dashboard di API e servizi fornisce una panoramica delle metriche di utilizzo per tutte le API abilitate per il tuo progetto: le API Google Maps Platform, così come altre API e 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 da 1 ora agli ultimi 30 giorni.

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

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

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

Sotto i grafici, una tabella elenca le API e i servizi abilitati. Le richieste indicano il numero di richieste (per il periodo di tempo selezionato). Gli errori corrispondono al numero di 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 progetto nella console Cloud:

   Pagina del selettore progetti

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

Per ulteriori informazioni, consulta la sezione 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 degli ultimi 30 giorni. Le richieste per API vengono visualizzate anche sotto forma di grafico. Un grafico di fatturazione mostra la fattura attuale e l'utilizzo totale negli ultimi 3 mesi.

Nota: se selezioni il nome di un'API abilitata, ti reindirizzeremo alla pagina Metriche di Google Maps per quell'API.

Per accedere alla pagina Panoramica di Google Maps Platform:

1. Apri la pagina Google Maps Platform nella console Cloud:

   Vai alla pagina di Google Maps Platform

2. Nel menu a sinistra, seleziona Panoramica.

Pagina delle API di Google Maps Platform

La pagina API di Google Maps include due tabelle. La tabella API abilitate mostra il numero di richieste, il numero di errori e la latenza media per ogni API abilitata negli ultimi 30 giorni. Nella tabella API aggiuntive sono elencate le API che non sono state abilitate.

Nota: quando selezioni il nome di un'API abilitata, ti reindirizzeremo alla pagina Metriche di Google Maps per quell'API.

Per accedere alla pagina delle API di Google Maps Platform:

1. Apri la pagina Google Maps Platform nella console Cloud:

   Vai alla pagina di Google Maps Platform

2. Nel menu a sinistra, seleziona API.

Pagina Metriche di Google Maps

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

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

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 codice risposta, Tipo di piattaforma e/o Dominio specifici. Puoi anche selezionare un periodo di tempo (da un'ora agli ultimi 30 giorni) e la granularità (al secondo o al giorno) per le metriche di utilizzo visualizzate.

Nota: l'opzione Piattaforma e Dominio nell'elenco a discesa Raggruppato per e i filtri Piattaforma e Dominio vengono visualizzati solo se è stata selezionata una singola API dall'elenco a discesa di selezione delle API.

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

   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 alla credenziale utilizzata per caricare l'API.

Formato credenziali	Significato
Nome chiave Ad esempio, "Chiave app mobile"	È stata utilizzata una chiave API per caricare l'API utilizzando ?key=...: puoi trovare i nomi delle chiavi nella console di Maps Platform in Keys & Credentials.
Numero di progetto Ad esempio, "numero_progetto:123456", dove 123456 è il numero del progetto.	Se vedi questa credenziale, esistono due possibilità: Per le API che accettano gli ID client di Maps Platform: è stato utilizzato un ID client Maps Platform per caricare l'API. Ad esempio, utilizzando &client=gme-_mycompany_. Queste API accettano ID client: API Maps JavaScript, API Maps Static, API Street View Static, API Elevation, API Directions, API Distance Matrix, API Geocoding, API Time Zone. Per maggiori informazioni, consulta Gestione degli ID client del piano Premium. Per le API che accettano OAuth: l'API è stata caricata utilizzando OAuth senza una chiave API.

Nota: poiché non esistono API di Maps Platform che supportano sia gli ID client di Maps Platform che OAuth, puoi sapere se l'API è stata caricata con un ID client o OAuth in base all'API utilizzata.

Grafici dei codici di risposta

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

Stato dell'API di Google Maps	Classe del codice di risposta HTTP - Report sull'utilizzo (2xx, 3xx, 4xx, 5xx)	Note
Ok	2xx	Risposta riuscita. Si tratta di una richiesta fatturabile che consumerà quota.
Ok	3xx	Risposta riuscita. Si tratta di una richiesta fatturabile che consumerà quota. Ad esempio, le richieste andate a buon fine per Foto del luogo restituiscono il reindirizzamento 302 all'immagine di riferimento.
DATA_NOT_AVAILABLE	4xx^(1)	Risposta riuscita che indica che non sono disponibili dati per le località di input. Si tratta di una richiesta fatturabile che consumerà quota.
ZERO_RESULTS	4xx^(1)	Una risposta riuscita non ha restituito nessun risultato. Si tratta di una richiesta fatturabile che consumerà quota.
NOT_FOUND	4xx^(1)	Per l'API Directions, questo messaggio indica che non è stato possibile geocodificare almeno una delle località specificate nell'origine, nella destinazione o nei tappe della richiesta. Per l'API Places, questo messaggio indica che la località a cui si fa riferimento (place_id) non è stata trovata nel database Places. Si tratta di una richiesta fatturabile che consumerà quota.
INVALID_REQUEST (valore parametro non valido), MAX_WAYPOINTS_EXCEEDED, MAX_ROUTE_LENGTH_EXCEEDED e altri.	4xx	Errore causato da un valore del parametro non valido. Per ulteriori dettagli, controlla la risposta dell'API. Si tratta di una richiesta fatturabile che consumerà quota.
REQUEST_DENIED	4xx	Errore del client causato da errori di autenticazione, errori di accesso e altri. Per ulteriori dettagli, controlla la risposta dell'API.
OVER_DAILY_LIMIT, OVER_QUERY_LIMIT, RESOURCE_EXHAUSTED, rateLimitExceeded, DailyLimitExceeded, userRateLimitExceeded	4xx	Errore del client causato da troppe richieste per periodo di tempo consentito. Riprova a inviare la richiesta in un secondo momento. Per ulteriori dettagli, controlla la risposta dell'API.
INVALID_REQUEST (parametro non valido o mancante, errore di analisi o convalida della richiesta)	4xx	Errore del client causato da una richiesta non valida. Per ulteriori dettagli, controlla la risposta dell'API.
NOT_FOUND (404)	4xx	Per l'API Geolocation, questo messaggio indica che gli input non erano sufficienti per produrre una stima della località. Per l'API Roads, questo messaggio indica che non è stato possibile agganciare gli input alle strade. Si tratta di una richiesta fatturabile che consumerà quota.
UNKNOWN_ERROR	5xx	Errore del server che indica che non è possibile procedere con la richiesta: errore interno, servizio sovraccarico, non disponibile, timeout e altro ancora.
^1 Per migliorare la coerenza dei report sui codici di errore, è in corso la migrazione delle API di Google Maps Platform: 1) dalla classe del codice di risposta HTTP 2xx alla classe 4xx per gli stati delle API di Google Maps: DATA_NOT_AVAILABLE, NOT_FOUND, ZERO_RESULTS - stato, 2) dalla classe del codice di risposta HTTP 2xx a 4xx per gli stati dell'API di Google Maps: REQUEST_DENIED, OVER_DAILY_LIMIT, OVER_QUERY_LIMIT, dailyLimitExceeded, rateLimitExceeded, per la risposta rateLimitExceeded, per codice , rateLimitExceeded, per la classe 4xx2xxuserRateLimitExceeded5xxUNKNOWN_ERROR Puoi visualizzare entrambi i codici di risposta durante il periodo di transizione. I codici di risposta restituiti nelle risposte dell'API di Google Maps non verranno modificati. Conferma che un aumento di 4xx e/o di 5xx in Metriche di Google Maps Platform è correlato a questa migrazione controllando quale codice di risposta esatto aumenta in Metrics Explorer (scopri di più sull'utilizzo di Google Cloud Monitoring per Google Maps Platform).

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 esempio, Risposte geocodificate o Risposte relative alle indicazioni stradali).

Parametro delle soluzioni di Google Maps Platform

Google Maps Platform fornisce molti tipi di codice campione per aiutarti a iniziare a utilizzarla rapidamente. Ad esempio, puoi utilizzare Builder rapido nella console Cloud, seguire le guide all'implementazione delle soluzioni di settore e imparare dai codelab.

Al fine di comprendere l'utilizzo e i modi per migliorare le 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 dati analitici relativi all'adozione della soluzione per migliorare la qualità della soluzione nelle iterazioni future.
• Per disattivare questa opzione, 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 di esempio sull'utilizzo del codice.
• Il parametro di query è separato da qualsiasi analisi e report specifici per API. Ciò significa che la rimozione del parametro dal codice campione della soluzione non disabilita i report interni dell'API Maps JavaScript.

Report sulle quote

Le quote impostano dei limiti per il numero di richieste che il tuo progetto può inviare alle API 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 che causano errori del server vengono conteggiate nella quota. Le richieste che non superano l'autenticazione non vengono conteggiate nella quota.

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

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

Pagina Quote di Google Maps

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

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

La pagina mostra solo le richieste che consumano 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 del client (errori di autenticazione, autorizzazione ed argomenti non validi (REQUEST_DENIED, OVER_QUERY_LIMIT, INVALID_REQUEST) (parametro non valido, errore di analisi della richiesta)) non consumano la 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à della quota è un caricamento mappa.
• Per Maps SDK for Android e Maps SDK for iOS, l'unità della quota è una richiesta Street View o un caricamento Panorama. I caricamenti mappa sono disponibili senza costi aggiuntivi e non consumano quota.

Per accedere alla pagina Quote di Google Maps Platform:

1. Apri la pagina Google Maps Platform nella console Cloud:

   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 Google Maps Platform.

API Google Maps Platform	Unità quota
Maps
Maps SDK for Android	1 panoramica
Maps SDK for iOS	1 panoramica
API Map Tiles	1 richiesta
API Maps Aerial View	1 richiesta
API Maps Static	1 richiesta
API Maps JavaScript	1 caricamento mappa
API Street View Static	1 richiesta
API Maps Embed	1 caricamento mappa
Percorsi
API Routes (Compute Routes)	1 richiesta
API Routes (Compute Route Matrix)	1 elemento (coppia origine-destinazione)
API Directions	1 richiesta
API Distance Matrix	1 elemento (coppia origine-destinazione)
API Roads	1 richiesta
Luoghi
API Places	1 richiesta
API Address Validation	1 richiesta
API Geocoding	1 richiesta
API Geolocation	1 richiesta
API Time Zone	1 richiesta
Ambiente
API Air Quality (CurrentConditions e HeatmapTile)	1 richiesta
API Air Quality (Cronologia)	1 pagina
API Pollen	1 richiesta
API Solar	1 richiesta

Report sulla fatturazione

Visualizza il report sulla fatturazione

I report sulla fatturazione per il tuo 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 progetto nella console Cloud:

   Pagina del selettore progetti

2. Seleziona un progetto.
3. Seleziona il pulsante del 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 di fatturazione per l'account di fatturazione collegato.

Come leggere il grafico del report di fatturazione

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

Figura 1: il report di fatturazione che mostra il grafico e la tabella utilizzando la visualizzazione preimpostata predefinita.

Suggerimento: analizza l'utilizzo e il costo per SKU

Per comprendere più accuratamente i dettagli del modello di pagamento a consumo e come influisce sulla tua implementazione, esamina l'utilizzo e il costo per SKU.

Figura 2: la tabella di fatturazione che mostra le voci relative a utilizzo e costo per SKU.

Figura 3: filtri del report di fatturazione.

Per modificare la vista report in modo da mostrare gli elementi pubblicitari per SKU:

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

Altri filtri disponibili per i report di fatturazione sono Intervallo di tempo, Progetti, Prodotti, SKU e Località, che ti consente di filtrare in base a dove vengono pubblicate 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 correlate 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 servizio web) e goog-maps-channel (un valore di canale numerico impostato da una query API). Scopri di più su filtri e raggruppamento.

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

Monitora e limita il consumo

Per 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, ti avvisa solo quando l'importo della spesa si avvicina all'importo specificato.

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

  Nota: la tua implementazione potrebbe utilizzare più API fatturabili, quindi modifica l'equazione in base alle esigenze. Ricorda che ogni mese è disponibile un credito per Google Maps Platform di 200 $, quindi assicurati di tenerlo conto nel tuo calcolo.

Monitoraggio dell'utilizzo per canale

Per monitorare l'utilizzo tramite canali numerici, devi aggiungere il parametro "channel" alle richieste API. Gli unici valori di canale accettati 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 canale direttamente nel report di fatturazione. I canali verranno visualizzati in Etichette come chiave goog-maps-channel.

Nota: i dati sul canale non sono disponibili per Maps SDK for Android, SDK Maps for iOS, API Places (Novità), API Address Validation, API Aerial View, API Air Quality, API Map Tiles, API Roads, API Routes, API Pollen e API Solar.

Figura 4: filtri per SKU e canali

Filtrare il report di 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 seleziona i canali numerici da filtrare.

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

Dopo aver implementato i dati sull'utilizzo del canale nelle tue 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 dati di fatturazione in BigQuery.

BigQuery Export consente di esportare dati dettagliati di fatturazione Cloud (come dati su utilizzo e stime di costi) automaticamente nell'arco della giornata 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 avrai un ulteriore livello di granularità per la comprensione dell'origine del tuo utilizzo di Google Maps Platform.

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

• Abilita la fatturazione e l' esportazione della fatturazione di BigQuery sul tuo account.
• Il formato della tabella è PROJECT_ID.DATASET_NAME.gcp_billing_exportv1BILLING_ACCOUNT_ID, in cui:
• PROJECT_ID è l'ID progetto effettivo (ad es. "mio-progetto-123456").
• DATASET_NAME è il nome del set di dati che hai creato (ad es. "SampleDataSet").
• BILLING_ACCOUNT_ID è un riferimento del tuo ID account di fatturazione, preceduto da "gcp_billing_exportv1" e modificato i trattini (-) in trattini bassi (_). Ad esempio, l'ID account di fatturazione 123456-7890AB-CDEF01 diventerà gcp_billing_export_v1_123456_789AB_CDEF01.

Nota: quando crei un nuovo set di dati, questo viene visualizzato immediatamente nell'interfaccia, ma la tabella su cui eseguire la query non viene ancora visualizzata. La tabella verrà generata automaticamente dopo alcune ore. Saranno quindi necessarie circa 24 ore per visualizzare i dati. Il set di dati BigQuery riflette solo i dati di utilizzo e di costo sostenuti a partire dalla data in cui hai configurato l'esportazione della fatturazione. In altre parole, i dati di fatturazione non vengono aggiunti in modo retroattivo, quindi non verranno visualizzati i dati di fatturazione precedenti all'abilitazione di BigQuery Export.

  #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 l'account di fatturazione Cloud
• Modificare le impostazioni di fatturazione di un progetto
• Visualizza i report di fatturazione e le tendenze dei costi
• Imposta budget e avvisi relativi al budget
• Limitazione dell'utilizzo dell'API

Google Maps Platform:

• Fatturazione di Google Maps Platform
• Guida all'ottimizzazione
• Best practice chiave API

Stato e segnalazioni delle risposte

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

Nota: per motivi storici, il codice di risposta HTTP restituito in risposta alle richieste API di Google Maps Platform può essere diverso dal codice di risposta HTTP nei report sull'utilizzo (Google Maps Platform Metrics). Le metriche dei report sull'utilizzo utilizzano un insieme di valori del codice di risposta coerenti con quelli utilizzati nelle API più recenti. Ciò migliora l'osservabilità dell'utilizzo delle API nelle metriche di Google Maps Platform e nel monitoraggio di Google Maps Platform.

Il report sull'utilizzo nelle metriche di Google Maps Platform fornisce un livello di granularità HTTP response code class. Se hai bisogno di un livello di granularità maggiore, consulta i Codici di stato della risposta disponibili in Monitoraggio dell'utilizzo di Google Maps Platform.

Codici di risposta disponibili nelle risposte dell'API di Google Maps		Disponibile nel report sull'utilizzo	Segnalato a
Stato dell'API di Google Maps	Codice di risposta HTTP	Classe del codice di risposta HTTP	Utilizzo	Quota	Fatturazione
Ok	200, 204, 302	2xx, 3xx	Sì	Sì	Sì
DATA_NOT_AVAILABLE, NOT_FOUND, ZERO_RESULTS	200, 404	4xx^1	Sì	Sì	Sì
INVALID_REQUEST (valore parametro non valido), MAX_ROUTE_LENGTH_EXCEEDED, MAX_WAYPOINTS_EXCEEDED ecc.	200, 400	4xx	Sì	Sì	Sì
INVALID_REQUEST (parametro non valido/mancante, errore di analisi della richiesta)	200, 400	4xx	Sì	No	No
REQUEST_DENIED	200, 400, 403	4xx^1	Sì	No	No
OVER_DAILY_LIMIT, OVER_QUERY_LIMIT, RESOURCE_EXHAUSTED, giornaliereLimitExceeded, rateLimitExceeded, userRateLimitExceeded	200, 403, 429	4xx^1	Sì	No	No
UNKNOWN_ERROR	200, 500, 503	5xx^1	Sì	Sì	No
^1 Per migliorare la coerenza dei report sui codici di errore, è in corso la migrazione delle API di Google Maps Platform: 1) dalla classe del codice di risposta HTTP 2xx alla classe 4xx per gli stati delle API di Google Maps: DATA_NOT_AVAILABLE, NOT_FOUND, ZERO_RESULTS - stato, 2) dalla classe del codice di risposta HTTP 2xx a 4xx per gli stati dell'API di Google Maps: REQUEST_DENIED, OVER_DAILY_LIMIT, OVER_QUERY_LIMIT, dailyLimitExceeded, rateLimitExceeded, per la risposta rateLimitExceeded, per codice , rateLimitExceeded, per la classe 4xx2xxuserRateLimitExceeded5xxUNKNOWN_ERROR Puoi visualizzare entrambi i codici di risposta durante il periodo di transizione. I codici di risposta restituiti nelle risposte dell'API di Google Maps non verranno modificati. Conferma che un aumento di 4xx e/o di 5xx in Metriche di Google Maps Platform è correlato a questa migrazione controllando quale codice di risposta esatto aumenta in Metrics Explorer (scopri di più sull'utilizzo di Google Cloud Monitoring per Google Maps Platform).

Report Coinvolgimento

Questo prodotto o questa funzionalità è sperimentale (pre-GA). I prodotti e le funzionalità pre-GA potrebbero avere supporto limitato e le modifiche ai prodotti e alle funzionalità pre-GA potrebbero non essere compatibili con altre versioni pre-GA. Le Offerte pre-GA sono coperte dai Termini di servizio specifici per Google Maps Platform. Per maggiori informazioni, consulta le descrizioni della fase di lancio.

Approfondimenti sull'attività commerciale

Google Maps Platform ti offre 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 queste informazioni per scoprire le località più apprezzate per la pubblicità e il marketing o per ottimizzare l'esperienza utente.

Le funzionalità di generazione di report sugli approfondimenti sull'attività includono:

• Visualizzare un'istantanea di approfondimenti sull'attività di alto livello per vedere a colpo d'occhio le tendenze chiave negli approfondimenti sull'attività.
• Visualizzazione in dettaglio per analizzare una metrica specifica all'interno della console e approfondire la comprensione delle metriche in modo più dettagliato.
• Esportazione delle metriche in formato CSV per analizzare i dati degli approfondimenti sull'attività nello strumento di analisi aziendale che preferisci

Le metriche sul coinvolgimento disponibili includono:

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

Gli utenti possono visualizzare gli insight aziendali nella pagina Metriche di Cloud Console. Il progetto deve avere l'API Maps JavaScript abilitata.

Puoi analizzare le metriche sul coinvolgimento direttamente nella console con le funzionalità di filtro e raggruppamento per approfondire le metriche in modo più dettagliato. Ad esempio, potresti scegliere di filtrare in base a una regione specifica per scoprire l'andamento delle visualizzazioni mappa solo per i codici postali di quella regione. Potresti voler invece 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 vista 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 con più di 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 sull'attività sono anonimizzate e, di conseguenza, riflettono solo le tendenze generali di coinvolgimento con le tue mappe. Un numero basso può essere arrotondato a zero e i contributi da valori anomali potrebbero essere ridotti.

Puoi controllare l'accesso agli insight aziendali per il tuo progetto Cloud nella console Google Cloud utilizzando l'autorizzazione Maps Analytics. Ai proprietari del progetto viene concessa questa autorizzazione per impostazione predefinita e possono eseguire il provisioning dell'accesso ad altri utenti in base alle esigenze.

Gli insight sull'attività non devono essere utilizzati per stimare i costi di utilizzo. Per ulteriori informazioni sull'utilizzo, fai riferimento ai report sull'utilizzo.

Locator Plus

Per gli utenti di Locator Plus, una dashboard di analisi consente di analizzare e generare insight dai dati, fornendo un quadro chiaro di come gli acquirenti interagiscono con il tuo store locator. Puoi misurare il rendimento su base settimanale, compresi il numero di visualizzazioni, il numero di interazioni con i dettagli sulla ricerca e sui luoghi e il tasso di coinvolgimento complessivo. Inoltre, la dashboard fornisce importanti benchmark per confrontare la tua implementazione con quella di altri rivenditori.

• Vai a Locator Plus nella console Google Cloud.
• Vai alla sezione Report sul coinvolgimento della console Google Cloud per visualizzare la dashboard di analisi.

Il report di benchmarking ti consente di confrontare i tuoi dati con dati aggregati di settore di altre aziende che condividono i loro dati. Il confronto fornisce un contesto prezioso, aiutandoti a stabilire obiettivi significativi, a ottenere informazioni sulle tendenze del settore e a confrontare il tuo rendimento con quello della concorrenza.

Per visualizzare dati di benchmarking, i dati sul coinvolgimento vengono inclusi in modo anonimo nei benchmark di Google. Per disattivare la visualizzazione e l'inclusione dei dati sul coinvolgimento in modo anonimo nei report di benchmarking, invia un ticket di assistenza. Il ticket di assistenza viene generalmente risolto entro 3 giorni.