Report Google Maps Platform

I report in Google Maps Platform forniscono una serie di report visivi predefiniti relativi a utilizzo di base dell'API, quota e 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 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: segnala l'utilizzo delle quote nei 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: registra i costi nel tempo come 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 Coinvolgimento: forniscono informazioni commerciali sul modo in cui gli utenti interagiscono con le app delle tue 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 e report delle risposte.

Visualizzare i report su utilizzo, quota e fatturazione di Google Maps Platform utilizzando Cloud Console.

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 le richieste andate a buon fine, quelle che generano errori del server e quelle 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 in grafici (Traffico, Errori e Latenza). A scopo di monitoraggio:

  • Tutte le API: puoi filtrare e raggruppare le metriche di utilizzo per tutte le API in questi 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 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). "Errori" indica il numero di richieste che hanno generato errori. La latenza (latenza media e percentile) è la latenza di queste richieste.

monitoraggio API

Per accedere alla pagina della dashboard API e servizi:

  1. Apri la pagina del selettore di 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 del menu menu e poi 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 per gli ultimi 30 giorni. Le richieste per API vengono mostrate anche sotto forma di grafico. Un grafico di fatturazione mostra la fattura attuale e l'utilizzo totale negli ultimi 3 mesi.

Screenshot di un grafico Panoramica che mostra una tabella che elenca le API e le richieste API abilitate per gli ultimi 30 giorni.

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.

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 delle metriche di Google Maps

La pagina Metriche di Google Maps mostra tre grafici: Traffico, Errori e Latenza mediana. I dati di 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 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 specifiche o più specifiche, credenziali, classi del codice di risposta, tipo di piattaforma e/o dominio. 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.

La pagina delle metriche mostra tre grafici: Traffico, Errori e Latenza mediana.

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:

Il filtro Piattaforma viene visualizzato solo quando è selezionata una singola API. Il filtro Piattaforma viene visualizzato solo quando è selezionata una singola API.

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 dell'app per dispositivi mobili"
È stata utilizzata una chiave API per caricare l'API con ?key=...: puoi trovare i nomi delle chiavi nella console di Maps Platform in Chiavi e credenziali.
Numero di progetto
Ad esempio, "numero_progetto:123456", dove 123456 è il numero di progetto.
Se vedi questa credenziale, esistono due possibilità:
  1. 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 Distanza Matrix, API Geocoding, API Time Zone. Per maggiori informazioni, consulta Gestione degli ID client del piano Premium.

  2. Per le API che accettano OAuth: l'API è stata caricata utilizzando OAuth senza una chiave API.

Grafici dei codici delle risposte

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 codice di risposta HTTP - Report sull'utilizzo
(2xx, 3xx, 4xx, 5xx)
Note
Ok 2xx Risposta riuscita.

Questa è una richiesta fatturabile e consuma quota.
Ok 3xx Risposta riuscita.

Questa è una richiesta fatturabile e consuma quota.

Ad esempio, le richieste andate a buon fine Place Photo restituiscono il reindirizzamento 302 all'immagine di riferimento.
DATA_NOT_AVAILABLE 4xx(1) Risposta corretta che indica che non sono disponibili dati per le località di input.

Questa è una richiesta fatturabile e consuma quota.
ZERO_RESULTS 4xx(1) Una risposta riuscita non ha restituito risultati.

Questa è una richiesta fatturabile e consuma 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 punti di arrivo 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.

Questa è una richiesta fatturabile e consuma 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.

Questa è una richiesta fatturabile e consuma quota.
REQUEST_DENIED 4xx Errore del client causato da errori di autenticazione, di accesso e altro. 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 nel 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 ragionevolmente possibile agganciare i dati alle strade.

Questa è una richiesta fatturabile e che consumerà quota.
UNKNOWN_ERROR 5xx Errore del server che indica che non è possibile continuare la richiesta: errore interno, servizio sovraccarico, non disponibile, timeout e altro ancora.
1 Per migliorare la coerenza della segnalazione dei 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 dell'API di Google Maps: DATA_NOT_AVAILABLE, NOT_FOUND, ZERO_RESULTS - stato, 2) dalla classe del codice di risposta HTTP 2xx alla classe 4xx per gli stati dell'API di Google Maps: REQUEST_DENIED, OVER_DAILY_LIMIT, OVER_QUERY_LIMIT, dailyLimitExceeded, rateLimitExceeded, stato dell'API HTTP/3, 2xxuserRateLimitExceeded5xxUNKNOWN_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 vengono modificati. Conferma che un aumento di 4xx e/o 5xx nelle 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 delle risposte per l'API che ti interessa (ad esempio, Risposte geocodificate o Risposte alle indicazioni stradali).

Parametro delle soluzioni di Google Maps Platform

Google Maps Platform fornisce molti tipi di codice campione per aiutarti a iniziare a utilizzarlo rapidamente. Ad esempio, puoi utilizzare Builder rapido in Cloud Console, 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 al fine di raccogliere informazioni sull'utilizzo di 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 relative 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 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 disabilita i report interni dell'API Maps JavaScript.

Report sulle quote

Le quote impostano dei limiti al numero di richieste che il tuo progetto può fare 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 ai fini della quota. Le richieste che non superano l'autenticazione non vengono conteggiate ai fini della quota.

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

Per conoscere 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 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 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 parametro non valido), UNKNOWN_ERROR).

Le richieste che causano errori del client, ovvero 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 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 Distanza Matrix, l'unità di quota è un elemento, ovvero 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à di quota è una richiesta Street View o un caricamento Panorama. I caricamenti mappa sono disponibili senza costi aggiuntivi e non consumano quota.

Screenshot della pagina Quote di Maps nella console Google Cloud. Mostra le quote per API utilizzando un selettore, poi mostra i carichi di mappa relativi alle quote impostate per l'API in questione.

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 (route di computing) 1 richiesta
API Routes (matrice di route Compute) 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 di fatturazione

Visualizza il report sulla fatturazione

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

Per accedere ai report di fatturazione:

  1. Apri la pagina del selettore di progetti nella console Cloud:

    Pagina del selettore progetti

  2. Seleziona un progetto.
  3. Seleziona il pulsante del menu 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 visualizzazione predefinita mostra i costi specifici dell'utilizzo giornaliero 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 in corso. Ogni riga nel grafico (e riga nella tabella di riepilogo) corrisponde al progetto, dal più alto al più piccolo per costo. Scopri di più su come interpretare il grafico del report di fatturazione.

Screenshot del report di fatturazione che mostra il grafico e la tabella utilizzando
la visualizzazione preimpostata predefinita
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 pagamento a consumo e l'impatto sull'implementazione, esamina l'utilizzo e i costi per SKU.

Report di fatturazione raggruppato per SKU
Figura 2: la tabella di fatturazione che mostra gli elementi pubblicitari relativi a utilizzo e costo per SKU.
Screenshot dei filtri del report di fatturazione
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.

Gli altri filtri disponibili per i report sulla 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 numerico impostato per il canale di una query API). Scopri di più 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.

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, ma 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. Usa una semplice equazione per determinare il limite giornaliero in base a quanto vuoi spendere. Ad esempio: (spesa mensile /prezzo per ogni SKU)/30 = limite di richieste al giorno (per un'API).

Monitoraggio dell'utilizzo per canale

Per monitorare l'utilizzo tramite canali numerici, devi aggiungere il parametro "channel" alle richieste 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. Nella sezione Etichette i canali verranno visualizzati come chiave goog-maps-channel.

Filtra per etichette
Figura 4: filtri per SKU e canali
Per filtrare il report di fatturazione per SKU e canale
  1. Utilizza il filtro SKU Raggruppa per.
  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 che vuoi filtrare.

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

Dopo aver implementato i dati sull'utilizzo dei canali nelle richieste, potrebbe trascorrere un po' di tempo (fino a 24 ore) prima che i dati vengano visualizzati 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 dei costi) automaticamente durante la giornata in un set di dati BigQuery da te specificato. Successivamente, potrai accedere ai dati di fatturazione da BigQuery per un'analisi dettagliata. In questo modo ottieni un ulteriore livello di granularità per la comprensione della fonte del tuo utilizzo di Google Maps Platform.

Se vuoi iniziare a utilizzare le esportazioni in BigQuery e l'esecuzione di 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 del tuo ID account di fatturazione, preceduto dal prefisso "gcp_billing_exportv1" e che cambia i trattini (-) in trattini bassi (_). Ad esempio, l'ID account di fatturazione 123456-7890AB-CDEF01 diventerà gcp_billing_export_v1_123456_789AB_CDEF01.

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

Fatturazione Cloud:

Piattaforma Google Maps:

Stato delle risposte e report

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 viene visualizzata nei report su utilizzo, quota e fatturazione.

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à più elevato, consulta i codici di stato delle risposte disponibili nel 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
DATA_NOT_AVAILABLE,
NOT_FOUND,
ZERO_RESULTS
200;
404
4xx1
INVALID_REQUEST (valore parametro non valido),
MAX_ROUTE_LENGTH_EXCEEDED,
MAX_WAYPOINTS_EXCEEDED
ecc.
200,
400
4xx
INVALID_REQUEST (parametro non valido/mancante, errore di analisi della richiesta) 200,
400
4xx No No
REQUEST_DENIED 200,
400,
403
4xx1 No No
OVER_DAILY_LIMIT,
OVER_QUERY_LIMIT,
RESOURCE_EXHAUSTED,
DailyLimitExceeded,
rateLimitExceeded,
userRateLimitExceeded
200,
403,
429
4xx1 No No
UNKNOWN_ERROR 200,
500,
503
5xx1 No
1 Per migliorare la coerenza della segnalazione dei 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 dell'API di Google Maps: DATA_NOT_AVAILABLE, NOT_FOUND, ZERO_RESULTS - stato, 2) dalla classe del codice di risposta HTTP 2xx alla classe 4xx per gli stati dell'API di Google Maps: REQUEST_DENIED, OVER_DAILY_LIMIT, OVER_QUERY_LIMIT, dailyLimitExceeded, rateLimitExceeded, stato dell'API HTTP/3, 2xxuserRateLimitExceeded5xxUNKNOWN_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 vengono modificati. Conferma che un aumento di 4xx e/o 5xx nelle 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

Approfondimenti sull'attività commerciale

Google Maps Platform ti offre informazioni approfondite 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ù utilizzate per la pubblicità e il marketing oppure per ottimizzare l'esperienza utente.

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

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

Le metriche sul coinvolgimento disponibili includono:

  • Visualizzazioni mappa: monitora le visualizzazioni sulla mappa risultanti 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 approfondimenti sull'attività nella pagina Metriche di Cloud Console. Al momento, le visualizzazioni mappa sono disponibili solo per alcuni sviluppatori dell'API Maps JS per i test.

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, puoi 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 analizzarla ulteriormente nello strumento di analisi aziendale che preferisci. 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.

Esportazione degli approfondimenti sull&#39;attività

Le metriche degli approfondimenti sull'attività sono anonimizzate e, di conseguenza, riflettono solo le tendenze generali del coinvolgimento con le mappe. I conteggi bassi potrebbero essere arrotondati a zero e i contributi delle anomalie potrebbero essere ridotti.

Puoi controllare l'accesso agli insight sull'attività per il tuo progetto cloud nella console Google Cloud utilizzando l'autorizzazione per 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 approfondimenti sull'attività non devono essere utilizzati per stimare i costi di utilizzo. Per ulteriori informazioni sull'utilizzo, fai riferimento ai report di utilizzo.

Locator Plus

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

Il rapporto di benchmarking ti consente di confrontare i tuoi dati con dati aggregati di settore di altre aziende che condividono i propri dati. Il confronto fornisce un contesto prezioso, aiutandoti a definire target significativi, ad acquisire informazioni sulle tendenze del settore e a confrontare il tuo rendimento con quello della concorrenza.

I dati sul coinvolgimento vengono inclusi in modo anonimo nei benchmark di Google. Per disattivare la visualizzazione e l'inclusione anonima dei dati sul coinvolgimento nei report di benchmarking, invia un richiesta di assistenza. Generalmente il ticket di assistenza viene risolto entro tre giorni.