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.
• Report sul coinvolgimento: forniscono informazioni aziendali su come gli utenti interagiscono con le tue app di mappe.

Per un elenco completo degli stati di risposta 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 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.

Nota: se selezioni il nome di un'API abilitata, verrà visualizzata la pagina Metriche di Google Maps relativa all'API.

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 attivati 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.

Nota: le opzioni Piattaforma e Dominio nell'elenco a discesa Raggruppato per e i filtri Piattaforma e Dominio vengono visualizzati solo quando hai selezionato una singola API dall'elenco a discesa di selezione dell'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 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.

Formato delle credenziali	Significato
Nome della chiave Ad esempio, "Chiave dell'app mobile"	È stata utilizzata una chiave API per caricare l'API utilizzando ?key=...: puoi trovare i nomi delle chiavi nella console Maps Platform in Chiavi e credenziali.
Numero del progetto Ad esempio, "project_number:123456", dove 123456 è il numero del progetto.	Se vedi questa credenziale, ci sono due possibilità: Per le API che accettano ID client di Maps Platform: è stato utilizzato un ID client di 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 ulteriori informazioni, consulta Gestione dell'ID cliente del piano Premium. Per le API che accettano OAuth: l'API è stata caricata utilizzando OAuth senza una chiave API.

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

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:

Stato dell'API di 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 utilizzerà la quota.
OK	3xx	Risposta riuscita. Si tratta di una richiesta fatturabile che utilizzerà la quota. Ad esempio, le richieste andate a buon fine di Foto del luogo restituisce un reindirizzamento 302 all'immagine a cui si fa riferimento.
DATA_NOT_AVAILABLE	4xx^(1)	Risposta positiva che indica che non sono disponibili dati per le località di input. Si tratta di una richiesta fatturabile che utilizzerà la quota.
ZERO_RESULTS	4xx^(1)	La risposta corretta non ha restituito alcun risultato. Si tratta di una richiesta fatturabile che utilizzerà la quota.
NOT_FOUND	4xx^(1)	Per l'API Directions, questo messaggio indica che non è stato possibile geocodificare almeno una delle località specificate come origine, destinazione o punti di passaggio della richiesta. Per l'API Places, questo messaggio indica che la località a cui si fa riferimento (place_id) non è stata trovata nel database di Places. Si tratta di una richiesta fatturabile che utilizzerà la quota.
INVALID_REQUEST (valore del 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 utilizzerà la quota.
REQUEST_DENIED	4xx	Errore del client causato da errore 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 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 sono stati sufficienti per produrre una stima della posizione. Per l'API Roads, questo messaggio indica che non è stato possibile agganciare ragionevolmente gli input alle strade. Si tratta di una richiesta fatturabile che utilizzerà la quota.
UNKNOWN_ERROR	5xx	Errore del server che indica che non è possibile procedere con la richiesta: errore interno, servizio sovraccaricato, non disponibile, timeout e altri.
^1 Per migliorare la coerenza della generazione di report sui codici di errore, le API di Google Maps Platform stanno eseguendo la migrazione: 1) dalla classe del codice di risposta HTTP 2xx a 4xx per gli stati dell'API Maps: DATA_NOT_AVAILABLE, NOT_FOUND, ZERO_RESULTS - status, 2) dalla classe del codice di risposta HTTP 2xx a 4xx per gli stati dell'API Maps: REQUEST_DENIED, OVER_DAILY_LIMIT, OVER_QUERY_LIMIT, dailyLimitExceeded, rateLimitExceeded, userRateLimitExceeded, 3) dalla classe del codice di risposta HTTP 2xx a 5xx per lo stato dell'API Maps: UNKNOWN_ERROR. Puoi vedere entrambi i codici di risposta durante il periodo di transizione. I codici di risposta restituiti nelle risposte dell'API di Google Maps non cambieranno. Verifica che un aumento di 4xx e/o 5xx in Metriche di Google Maps Platform sia correlato a questa migrazione controllando quale codice di risposta esatto aumenta in Metrics Explorer (scopri di più sull'utilizzo del monitoraggio di Google Cloud 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 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 codelab.

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 i tuoi 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.

API Google Maps Platform	Unità di quota
Maps
Maps SDK for Android	1 panorama
Maps SDK for iOS	1 panorama
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 Routes Matrix)	1 elemento (coppia origine-destinazione)
API Directions	1 richiesta
API Distance Matrix	1 elemento (coppia origine-destinazione)
API Roads	1 richiesta
API Route Optimization	1 richiesta
SDK Navigation per Android	1 destinazione
SDK Navigation per iOS	1 destinazione
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 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.

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 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.

Figura 2: la tabella di fatturazione che mostra gli elementi pubblicitari di utilizzo e di costo per SKU.

Figura 3: i filtri del report di fatturazione.

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 i 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).

  Nota: l'implementazione potrebbe utilizzare più API fatturabili, quindi modifica la formula in base alle tue esigenze. Ricorda che ogni mese è disponibile un credito di 200 $per Google Maps Platform, quindi assicurati di tenerlo presente nel calcolo. L'offerta di 200 $di credito mensile per Google Maps Platform è valida fino alle ore 23:59 (ora locale) del 28 febbraio 2025. A partire dal 1° marzo 2025, il credito di 200 $verrà sostituito da una soglia di utilizzo senza costi per ogni API. Per ulteriori informazioni, consulta le domande frequenti.

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.

Nota: i dati dei canali non sono disponibili per Maps SDK for Android, Maps SDK for iOS, API Places (nuova), API di convalida degli indirizzi, API di visualizzazione aerea, API di qualità dell'aria, API di riquadri mappa, API di set di dati di Maps, API di strade, API di percorsi, API di polline, API di solare e API di ottimizzazione dei percorsi.

Figura 4: filtra per SKU e canali

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 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 comprendere meglio 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.

Nota: quando crei un nuovo DataSet, questo viene visualizzato immediatamente nell'interfaccia, ma la tabella da sottoporre a query non viene ancora visualizzata. La tabella verrà generata automaticamente dopo alcune ore. Poi, saranno necessarie circa 24 ore per visualizzare i dati. Il set di dati BigQuery riflette solo i dati di utilizzo e costi sostenuti a partire dalla data di configurazione dell'esportazione dei dati di fatturazione. In altre parole, i dati di fatturazione non vengono aggiunti in modo retroattivo, pertanto non vedrai i dati di fatturazione precedenti all'attivazione dell'esportazione in BigQuery.

  #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

Google Maps Platform:

• 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.

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

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.

Codici di risposta disponibili nelle risposte dell'API Maps		Disponibile nel report Utilizzo	Segnalato a
Stato dell'API di 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, dailyLimitExceeded, 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 della generazione di report sui codici di errore, le API di Google Maps Platform stanno eseguendo la migrazione: 1) dalla classe del codice di risposta HTTP 2xx a 4xx per gli stati dell'API Maps: DATA_NOT_AVAILABLE, NOT_FOUND, ZERO_RESULTS - status, 2) dalla classe del codice di risposta HTTP 2xx a 4xx per gli stati dell'API Maps: REQUEST_DENIED, OVER_DAILY_LIMIT, OVER_QUERY_LIMIT, dailyLimitExceeded, rateLimitExceeded, userRateLimitExceeded, 3) dalla classe del codice di risposta HTTP 2xx a 5xx per lo stato dell'API Maps: UNKNOWN_ERROR. Puoi vedere entrambi i codici di risposta durante il periodo di transizione. I codici di risposta restituiti nelle risposte dell'API di Google Maps non cambieranno. Verifica che un aumento di 4xx e/o 5xx in Metriche di Google Maps Platform sia correlato a questa migrazione controllando quale codice di risposta esatto aumenta in Metrics Explorer (scopri di più sull'utilizzo del monitoraggio di Google Cloud per Google Maps Platform).

Report Coinvolgimento

Questo prodotto o questa funzionalità è sperimentale (pre-release). 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 specifici di servizio di Google Maps Platform. Per ulteriori informazioni, consulta le descrizioni della fase di lancio.

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à
• Visualizzazione in dettaglio 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 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 possono essere arrotondati a zero e i contributi degli outlier possono essere ridotti.

Puoi controllare l'accesso agli approfondimenti commerciali per il tuo progetto Cloud nella console Google Cloud utilizzando l'autorizzazione Maps Analytics. I proprietari del progetto dispongono di questa autorizzazione per impostazione predefinita e 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.