Report Google Maps Platform

La funzionalità di generazione dei report di Google Maps Platform offre una serie di report visivi predefiniti sull'utilizzo di base dell'API, sulla quota e sui dati di fatturazione nella console Google Cloud. Utilizza questi report per determinare il numero di chiamate API effettuate, quanto sei vicino al raggiungimento delle quote di utilizzo delle API e monitorare l'utilizzo della fatturazione nel tempo.

I tipi di report includono:

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

Per un elenco completo degli stati delle risposte 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, la quota e la fatturazione di Google Maps Platform utilizzando Cloud Console.

Report sull'utilizzo

L'utilizzo si basa sul numero di richieste che il progetto invia 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 il piano Premium e i progetti con piano Premium migrati). 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). 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 seguenti 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 di API e servizi offre una panoramica delle metriche di utilizzo per tutte le API abilitate per il tuo progetto: le API Google Maps Platform e 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 fino 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. Richieste indica il numero di richieste (per il periodo di tempo selezionato). Errori indica il numero di richieste che hanno generato errori. La latenza (latenza media e percentile) è la latenza per queste richieste.

Per accedere alla pagina Dashboard di API e servizi:

1. Apri la pagina del selettore progetti 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 di menu e seleziona 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 negli ultimi 30 giorni. Anche le richieste per API sono mostrate sotto forma di grafico. Un grafico relativo alla fatturazione mostra la fattura attuale e l'utilizzo totale degli ultimi tre mesi.

Nota: se selezioni il nome di un'API abilitata, verrà visualizzata la 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, verrà visualizzata la 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 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 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 di risposta, tipo di piattaforma e/o dominio specifici o più. Puoi anche selezionare un periodo di tempo (da un'ora fino agli ultimi 30 giorni) e una 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 selezioni 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 delle 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 delle credenziali	Significato
Nome chiave Ad esempio, "Chiave app mobile"	Per caricare l'API è stata utilizzata una chiave API utilizzando ?key=...: puoi trovare i nomi delle chiavi nella sezione Chiavi e credenziali della console di Maps Platform.
Numero progetto Ad esempio, "project_number:123456", dove 123456 è il numero del tuo progetto.	Se visualizzi questa credenziale, esistono due possibilità: Per le API che accettano gli 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 maggiori informazioni, consulta Gestione degli 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, quindi 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 Errore per codice di risposta suddividono l'utilizzo per 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 Google Maps	Classe del codice di risposta HTTP - Report sull'utilizzo (2xx, 3xx, 4xx, 5xx)	Note
Ok	2xx	Risposta riuscita. Questa è una richiesta fatturabile che consumerà quota.
Ok	3xx	Risposta riuscita. Questa è una richiesta fatturabile che consumerà quota. Ad esempio, le richieste riuscite Foto del luogo restituiscono un reindirizzamento 302 all'immagine di riferimento.
DATA_NOT_AVAILABLE	4xx^(1)	Risposta riuscita che indica che non ci sono dati disponibili per le località di input. Questa è una richiesta fatturabile che consumerà quota.
ZERO_RESULTS	4xx^(1)	La risposta riuscita non ha restituito alcun risultato. Questa è 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 nelle tappe della richiesta. Per l'API Places, questo messaggio indica che la località a cui viene fatto riferimento (place_id) non è stata trovata nel database di Places. Questa è 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 parametro non valido. Per ulteriori dettagli, controlla la risposta dell'API. Questa è una richiesta fatturabile che consumerà quota.
REQUEST_DENIED	4xx	Errore del client causato da errori di autenticazione, errori di accesso e altri problemi. 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 il 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 posizione. 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, verrà eseguita la migrazione delle API di Google Maps Platform: 1) dalla classe del codice di risposta HTTP 2xx alla classe 4xx per gli stati dell'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 codice di risposta HTTP: {13/Maps/}, rateLimitExceeded2xxuserRateLimitExceeded5xxUNKNOWN_ERROR Durante il periodo di transizione puoi vedere entrambi i codici di risposta. I codici di risposta restituiti nelle risposte dell'API di Google Maps non cambiano. Verifica che un aumento di 4xx e/o 5xx nelle metriche di Google Maps Platform sia correlato a questa migrazione controllando l'esatto codice di risposta che 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 delle risposte per l'API che ti interessa (ad esempio, Geocoding Responses o Directions Responses).

Parametro delle soluzioni di Google Maps Platform

Google Maps Platform fornisce molti tipi di codice campione per aiutarti a iniziare rapidamente. Ad esempio, puoi utilizzare Quick Builder nella console Cloud, seguire le guide all'implementazione delle soluzioni di settore e imparare dai 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 l'analisi relativa all'adozione della soluzione per migliorarne la qualità nelle iterazioni future.
• Per disattivarla, elimina il parametro di query solution_channel e il relativo valore dal codice campione.
• Non è obbligatorio 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 tutti i report e le analisi specifici dell'API. Ciò significa che la rimozione del parametro dal codice di esempio della soluzione non disabilita i report interni dell'API Maps JavaScript.

Report sulle quote

Le quote impostano 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 quelle che causano errori del server vengono conteggiate nella quota. Le richieste con autenticazione non riuscita non incidono sulla quota.

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

Per ottenere il valore della quota al minuto per qualsiasi prodotto dell'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 nella console Google Cloud mostra il traffico totale per le chiavi API e gli ID client. Il traffico dell'ID client è disponibile anche nel grafico delle metriche nella console Cloud.

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

Le richieste che causano errori del client, ovvero errori di autenticazione, autorizzazione e argomento non valido (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 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 mappa.
• Per Maps SDK for Android e Maps SDK for iOS, l'unità di quota è una richiesta Street View o caricamento Panorama. I caricamenti mappa sono disponibili senza costi 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
API Route Optimization	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 di fatturazione relativi all'utilizzo dei prodotti Google Maps Platform sono disponibili nella console Google Cloud. Per ulteriori informazioni, consulta la sezione Fatturazione.

Per accedere ai report sulla fatturazione:

1. Apri la pagina del selettore progetti 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 sulla fatturazione

I report di fatturazione tracciano i costi nel tempo in un grafico a linee in pila. La visualizzazione 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 e il costo totale previsto per l'intero mese in corso. Ogni riga nel grafico (e riga nella tabella di riepilogo) corrisponde al progetto, dal più grande al più piccolo in base al 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 con la visualizzazione preimpostata predefinita.

Suggerimento: analizza l'utilizzo e il costo per SKU

Per comprendere in modo più preciso i dettagli del modello di prezzi con pagamento a consumo e il modo in cui influisce sull'implementazione, esamina l'utilizzo e il costo per SKU.

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

Figura 3. Filtri del report di fatturazione.

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

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

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

Per classificare l'origine dell'utilizzo oltre al prodotto, raggruppa i report sulla fatturazione in base a uno dei valori elencati. Le tre chiavi correlate alle API di Google Maps Platform sono goog-maps-api-key-suffix (gli ultimi quattro caratteri di una chiave API), goog-maps-platform-type (la piattaforma: Android, iOS, JavaScript o servizio web) e goog-maps-channel (un valore numerico predefinito di una query API). Scopri di più su filtri e raggruppamento.

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

Monitora e limita il consumo

Per pianificare il budget e controllare i costi:

• 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 di spesa si avvicina all'importo specificato.

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

  Nota: la tua implementazione potrebbe utilizzare più API fatturabili, quindi modifica l'equazione in base alle tue esigenze. Ricorda che ogni mese è disponibile un credito di 200 $per Google Maps Platform, quindi assicurati di tenerne conto nel 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 accettabili 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 del canale non sono disponibili per Maps SDK for Android, Maps SDK for iOS, API Places (novità), API Address Validation, API Aerial View, API Air Quality, API Map Tiles, API Roads, API Routes, API Pollen, API Solar e API Route Optimization.

Figura 4: filtro per SKU e canali

Per filtrare il report sulla fatturazione per SKU e canale

1. Utilizza il filtro per SKU Raggruppa per.
2. Seleziona il cursore Etichette.
3. Seleziona il menu a discesa Chiave e poi 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.

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

Esporta i dati di fatturazione con BigQuery

Puoi anche esportare i dati di fatturazione in BigQuery.

BigQuery Export consente di esportare dati di fatturazione Cloud dettagliati, come dati sull'utilizzo e sulla stima dei costi, automaticamente durante il giorno in un set di dati BigQuery da te specificato. Potrai quindi accedere ai dati di fatturazione da BigQuery per un'analisi dettagliata. Ciò fornisce un ulteriore livello di granularità 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:

• Abilita la fatturazione e l' esportazione della fatturazione BigQuery nel tuo account.
• Il formato della tabella è PROJECT_ID.DATASET_NAME.gcp_billing_exportv1BILLING_ACCOUNT_ID dove:
• PROJECT_ID è l'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 dell'ID account di fatturazione, preceduto dal prefisso "gcp_billing_exportv1" e da cui vengono modificati i trattini (-) e trattini bassi (_). Ad esempio, l'ID account di fatturazione 123456-7890AB-CDEF01 diventerebbe gcp_billing_export_v1_123456_789AB_CDEF01.

Nota: quando crei un nuovo set di dati, questo verrà visualizzato immediatamente nell'interfaccia, ma la tabella su cui eseguire la query non sarà ancora visualizzata. La tabella verrà generata automaticamente dopo alcune ore. Sono quindi necessarie circa 24 ore per visualizzare i dati. Il set di dati BigQuery riflette solo i dati di utilizzo e di costo a partire dalla data in cui hai configurato l'esportazione della fatturazione e in seguito. In altre parole, i dati di fatturazione non vengono aggiunti in modo retroattivo, quindi non vengono 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 delle API

Google Maps Platform:

• Fatturazione di Google Maps Platform
• Guida all'ottimizzazione
• Best practice relative alle chiavi API

Stato e report 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 sull'utilizzo, sulla quota e sulla 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 (Metriche di Google Maps Platform). Le metriche dei report sull'utilizzo utilizzano un insieme di valori di codici 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 una granularità HTTP response code class. Se hai bisogno di un livello di granularità superiore, 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 di 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, e così via.	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 dei report sui codici di errore, verrà eseguita la migrazione delle API di Google Maps Platform: 1) dalla classe del codice di risposta HTTP 2xx alla classe 4xx per gli stati dell'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 codice di risposta HTTP: {13/Maps/}, rateLimitExceeded2xxuserRateLimitExceeded5xxUNKNOWN_ERROR Durante il periodo di transizione puoi vedere entrambi i codici di risposta. I codici di risposta restituiti nelle risposte dell'API di Google Maps non cambiano. Verifica che un aumento di 4xx e/o 5xx nelle metriche di Google Maps Platform sia correlato a questa migrazione controllando l'esatto codice di risposta che 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 di 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. Queste informazioni 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ù popolari per la pubblicità e il marketing oppure per ottimizzare l'esperienza utente.

Le funzionalità di generazione di report delle informazioni sull'attività includono:

• Visualizzazione di un'istantanea generale degli approfondimenti sull'attività per vedere a colpo d'occhio le tendenze principali degli approfondimenti sull'attività.
• Visualizzazione in dettaglio per analizzare una metrica specifica nella console in modo da comprendere meglio le metriche in modo più dettagliato
• Esportazione delle metriche in formato CSV per consentire l'analisi dei dati degli approfondimenti sull'attività nel tuo strumento di analisi aziendale preferito

Le metriche sul coinvolgimento disponibili includono:

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

Gli utenti possono visualizzare insight aziendali nella pagina Metriche della console Cloud. Nel progetto deve essere abilitata l'API Maps JavaScript.

Puoi analizzare le metriche sul coinvolgimento direttamente nella console con le funzionalità Filtra e Raggruppa per 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 in 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 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 di dimensioni 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 delle informazioni sull'attività sono anonimizzate e pertanto riflettono solo le tendenze generali relative al coinvolgimento con le tue mappe. I conteggi bassi potrebbero essere arrotondati a zero e i contributi provenienti da valori anomali potrebbero essere ridotti.

Puoi controllare l'accesso agli insight aziendali per il tuo progetto Cloud in Google Cloud Console utilizzando l'autorizzazione Maps Analytics. I proprietari del progetto ricevono questa autorizzazione per impostazione predefinita e possono eseguire il provisioning dell'accesso per 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, consulta i report di utilizzo.

Locator Plus

Per gli utenti di Locator Plus, una dashboard di analisi consente di analizzare e generare approfondimenti dai dati, fornendo un quadro chiaro del livello di coinvolgimento degli acquirenti con lo Store locator. Puoi misurare il tuo rendimento su base settimanale, compresi il numero di visualizzazioni, il numero di interazioni con la Ricerca e i dettagli del luogo e il tasso di coinvolgimento complessivo. Inoltre, la dashboard offre benchmark importanti per confrontare la tua implementazione con quella di altri retailer.

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

Il report di benchmarking ti consente di confrontare i dati con dati aggregati di settore di altre aziende che condividono i propri dati. Il confronto fornisce un contesto prezioso, che ti consente di impostare obiettivi significativi, ottenere informazioni sulle tendenze del settore e scoprire i tuoi risultati rispetto alla concorrenza.

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