Report Google Maps Platform

I report di Google Maps Platform forniscono una serie di immagini predefinite report sull'utilizzo di base dell'API, sulla quota e sui dati di fatturazione in Google Cloud Console. Utilizza questi report per determinare il numero di API chiamate effettuate, quanto sei vicino al raggiungimento delle quote di utilizzo delle API e monitora l'utilizzo della fatturazione nel tempo.

I tipi di report includono:

  • Report di utilizzo: indica il numero di richieste inviate dal progetto le 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 l'utilizzo applicati, nonché il totale costo 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 compare nei campi Utilizzo, Quota e/o sui report Fatturazione, consulta Stato e report delle risposte.

Visualizza i report sull'utilizzo, la quota e la fatturazione di Google Maps Platform usando la Console Cloud.

Report sull'utilizzo

L'utilizzo si basa sul numero di richieste che il progetto invia alla le API di Google Maps Platform utilizzando le credenziali associate al tuo progetto. Le richieste includono richieste riuscite, richieste che hanno generato 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 di cui è stata eseguita la migrazione). Per maggiori dettagli, consulta la panoramica del piano Premium e 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 in queste modi:

    • Filtra per periodo di tempo e API.
    • Visualizza il traffico, gli errori e la latenza raggruppati per codice di risposta, API e la 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 il traffico, gli errori e la latenza raggruppati per codice di risposta e metodo API la versione e la credenziale.

API e Pagina Dashboard dei servizi

Le API e Servizi Dashboard 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 i dati sull'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 minuto (QPM) 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.

api Monitoring

Per accedere alle API e Pagina Dashboard dei servizi:

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

    Pagina del selettore progetti

  2. Seleziona il progetto. Le API e Viene visualizzata la pagina Dashboard dei servizi.

    Se la pagina non viene visualizzata, seleziona il pulsante del menu menù quindi seleziona API e Servizi.

Per ulteriori informazioni, consulta la sezione Monitoraggio dell'utilizzo delle API.

Pagina Panoramica di Google Maps

Google Maps Pagina Panoramica include una tabella che elenca le API abilitate e le richieste di utilizzo degli ultimi 30 giorni. Anche le richieste per API sono mostrate sotto forma di grafico. Grafico della fatturazione che 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 abilitate e
  Richieste API degli 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.

API e API di Google Maps Platform Pagina dei servizi

Google Maps API e Servizi contiene una griglia di riquadri che rappresentano API, SDK e altri servizi disponibili per il tuo progetto. All'interno di ogni riquadro, puoi attivare o disattivare la relativa servizio selezionando Attiva o Disattiva e potrai accedere alle credenziali informazioni, metriche e guide dell'utente per le API abilitate. Puoi anche usare i filtri di pagina per visualizzare i servizi abilitati o disabilitati e altre categorie di servizi.

api

Per accedere alle API di Google Maps Platform e Pagina Servizi:

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

    Vai alla pagina di Google Maps Platform

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

Pagina Metriche di Google Maps

Google Maps Pagina Metriche mostra tre grafici: Traffico, Errori e Latenza mediana. I dati sull'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 richieste, errori e latenza per le API che hai selezionato.

Tramite l'elenco a discesa API in alto e le opzioni di raggruppamento e filtro nel riquadro a destra, puoi raggruppare e filtrare le metriche di utilizzo mostrate selezionando API specifiche o Credenziali, classi di codici di risposta, tipo di piattaforma e/o dominio. Puoi anche selezionare un periodo di tempo (da un'ora fino agli ultimi 30 giorni) e granularità (al secondo o al giorno) per le metriche di utilizzo visualizzate.

Pagina delle metriche che 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 sia 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 tramite Google Cloud CLI o tramite l'API Compute Engine.

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 in Maps Platform della console in Chiavi e Credenziali.
Numero progetto
Ad esempio, "project_number:123456", dove 123456 è il numero del tuo progetto.
Se vedi questa credenziale, esistono due possibilità:
  1. Per le API che accettano gli ID client di Maps Platform: A Per caricare l'API è stato utilizzato l'ID client Maps Platform. Ad esempio: utilizzando &client=gme-_mycompany_.

    Queste API accettano ID client: API Maps JavaScript, Maps Static API, API Street View Static, API Elevation, API Directions, Distance API Matrix, API Geocoding, API Time Zone. Per ulteriori informazioni, vedi Gestione degli ID cliente del piano Premium.

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

Grafici dei codici di risposta

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

Stato dell'API di Google Maps Classe del codice di risposta HTTP - Report sull'utilizzo
(2xx, 3xx, 4xx, 5xx)
Note
OK 2xx Risposta riuscita.

Si tratta di una richiesta fatturabile che consumerà quota.
OK 3xx Risposta riuscita.

Si tratta di una richiesta fatturabile che consumerà quota.

Ad esempio, la foto del luogo Le richieste andate a buon fine restituiscono un reindirizzamento 302 all'immagine di riferimento.
DATA_NOT_AVAILABLE 4xx(1) Risposta riuscita che indica che non ci sono dati disponibili per il posizioni di input.

Si tratta di una richiesta fatturabile che consumerà quota.
ZERO_RESULTS 4xx(1) La risposta riuscita non ha restituito alcun risultato.

Si tratta di una richiesta fatturabile che consumerà quota.
NOT_FOUND 4xx(1) Per API Directions, questo messaggio indica che almeno una delle località specificate in non è stato possibile geocodificare l'origine, la destinazione o i waypoint della richiesta.

Per API Places questo messaggio indica che la posizione di riferimento (place_id) non era nel database di Places.

Si tratta di una richiesta fatturabile che consumerà quota.
INVALID_REQUEST (valore parametro non valido),
MAX_WAYPOINTS_EXCEEDED,
MAX_ROUTE_LENGTH_EXCEEDED e altri.
4xx Errore causato da un valore parametro non valido. Controlla l'API risposta per ulteriori dettagli.

Si tratta di una richiesta fatturabile che consumerà quota.
REQUEST_DENIED 4xx Errore del client causato da errori di autenticazione, errori di accesso e altri problemi. Per ulteriori dettagli, controlla la risposta dell'API.
OVER_DAILY_LIMIT,
OVER_QUERY_LIMIT,
RESOURCE_EXHAUSTED,
PercentualeLimitesuperato,
giornalieroLimite superato,
userRateLimitExceeded
4xx Errore del client causato da troppe richieste per il 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, richiesta errore di analisi o convalida) 4xx Errore del client causato da una richiesta non valida. Controlla la risposta dell'API per ulteriori informazioni i dettagli.
NOT_FOUND (404) 4xx Per 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 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: interno errore del servizio, servizio sovraccarico, non disponibile, timeout e altro ancora.
1 Per migliorare la coerenza dei report sui codici di errore, Google Maps Platform È in corso la migrazione delle API: 1) dalla classe del codice di risposta HTTP 2xx a 4xx per 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 Stati dell'API di Google Maps: REQUEST_DENIED, OVER_DAILY_LIMIT, OVER_QUERY_LIMIT, dailyLimitExceeded, rateLimitExceeded, userRateLimitExceeded, 3) dalla classe del codice di risposta HTTP 2xx a 5xx per Stato dell'API di Google Maps: UNKNOWN_ERROR. Durante la transizione puoi visualizzare entrambi i codici di risposta punto. I codici di risposta restituiti nelle risposte dell'API di Google Maps non cambiano. Conferma che un aumento di 4xx e/o 5xx di Metriche di Google Maps Platform è correlato a questa migrazione, controllando quale codice di risposta esatto aumenta Esplora metriche (scopri di più sull'uso Google Cloud Monitoring per Google Maps Platform).

Per ulteriori informazioni su codici di stato e messaggi di errore, consulta la risposta documentazione per l'API che ti interessa (ad esempio, Risposte di geocodifica 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 e di funzionare rapidamente. Ad esempio, puoi utilizzare Builder rapido nella console Cloud, segui le soluzioni di settore guide all'implementazione, e imparano codelab.

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

  • Il parametro di query solution_channel è incluso per impostazione predefinita nel codice campione della soluzione.
  • Il parametro di query restituisce a Google analisi sull'adozione della soluzione per migliorare la qualità delle soluzioni nelle iterazioni future.
  • Puoi disattivare la funzionalità eliminando la query solution_channel e il relativo valore dal codice di esempio.
  • Non è obbligatorio mantenere il parametro. Rimozione della 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 analisi specifica per API i report. Ciò significa rimuovere il parametro dal codice campione 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 progetto può inviare 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 delle richieste che causano errori del server vengono conteggiate ai fini della quota. Richieste che una mancata riuscita dell'autenticazione non viene considerata ai fini del calcolo della quota.

L'utilizzo della quota viene visualizzato nei grafici nella pagina Quote della console Cloud. e possono essere raggruppate in richieste al minuto. Gli attuali limiti di quota Le API selezionate vengono visualizzate in tabelle al di sotto dell'utilizzo della quota grafici.

Per ottenere il valore della quota al minuto per qualsiasi prodotto dell'API di GMP, utilizza questo calcolatrice.

Pagina Quote di Google Maps

Google Maps Pagina Quote mostra i limiti di quota e il consumo della quota per l'API specifica selezionata.

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 Grafico delle metriche nella console Cloud.

La pagina mostra solo le richieste che utilizzano la 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).

Richieste che causano errori del client: autenticazione, autorizzazione errori relativi ad argomenti non validi (REQUEST_DENIED, OVER_QUERY_LIMIT, INVALID_REQUEST (parametro non valido, errore di analisi della richiesta)) non consumano quota e non vengono visualizzati.

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, 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 di Street View o Panorama caricamento. I caricamenti mappa sono disponibili senza costi e non consumano quota.

Screenshot della sezione Maps pagina Quote nella console Google Cloud. Mostra
  quote per API utilizzando un selettore, poi mostra i caricamenti mappa rispetto 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 (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

Visualizzazione del rapporto di fatturazione

I report di fatturazione relativi all'utilizzo dei prodotti Google Maps Platform disponibili nella console Google Cloud. Per ulteriori informazioni, vedi 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 menù e seleziona 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 sulla 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. Il valore predefinito mostra i costi specifici per l'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. Ciascuna nel grafico (e la riga nella tabella di riepilogo) corrisponde al progetto, classificato dal più alto al più basso in base al costo. Scopri di più sull'interpretazione del grafico del report sulla fatturazione.

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

Suggerimento: analizza l'utilizzo e il costo per SKU

Per comprendere in modo più preciso i dettagli del modello di determinazione del prezzo con pagamento a consumo l'impatto sull'implementazione, guarda l'utilizzo e il costo per SKU.

Report di fatturazione raggruppato per SKU
Figura 2: la tabella di fatturazione che mostra l'utilizzo e di costo delle voci per SKU.
Screenshot dei filtri del report sulla fatturazione
Figura 3. Filtri del report sulla 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 il report di fatturazione sono Intervallo di tempo, Progetti e Prodotti, SKU e Località, che ti consentono di filtrare in base a dove da cui vengono gestite le richieste API.

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

Puoi modificare la visualizzazione del grafico in modo da escludere i crediti specifici per l'utilizzo cancellando sulla 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:

  • Configura un avviso relativo al budget per monitorare l'aumento della spesa rispetto a un determinato importo. Impostare un budget non limita l'utilizzo dell'API, ma ti avvisa solo quando l'importo di spesa si avvicina l'importo specificato.
  • Limitare l'utilizzo giornaliero dell'API, per gestire il costo di utilizzo delle API fatturabili. Impostando limiti sulle richieste per giorno, puoi limitare la spesa. Usa una semplice equazione per determinare la tua attività a seconda di quanto vuoi spendere. Ad esempio: (spesa mensile /prezzo per ogni SKU)/30 = limite per richieste al giorno (per un'API).

Monitoraggio dell'utilizzo per canale

Per monitorare l'utilizzo tramite canali numerici, devi aggiungere il canale parametro alle tue 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 rispecchieranno in Etichette come chiave goog-maps-channel.

Filtra per etichette
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 siano 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, ad esempio dati dei dati di stima dei costi) automaticamente durante la giornata a un set di dati BigQuery 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 fatturazione e Esportazione della fatturazione BigQuery sul 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, con prefisso "gcp_billing_exportv1" e modifica dei trattini (-) in trattini bassi (_). Ad esempio, l'ID account di fatturazione 123456-7890AB-CDEF01 diventa 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:

Google Maps Platform:

Stato e report delle risposte

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

Il report sull'utilizzo nelle metriche della piattaforma Google Maps forniscono una granularità HTTP response code class. Se hai bisogno di una maggiore granularità, consulta Codici di stato della risposta disponibile 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
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,
giornalieroLimite superato,
rateLimitExceeded,
userRateLimitExceeded
200,
403,
429
4xx1 No No
UNKNOWN_ERROR 200,
500,
503
5xx1 No
1 Per migliorare la coerenza dei report sui codici di errore, Google Maps Platform È in corso la migrazione delle API: 1) dalla classe del codice di risposta HTTP 2xx a 4xx per 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 Stati dell'API di Google Maps: REQUEST_DENIED, OVER_DAILY_LIMIT, OVER_QUERY_LIMIT, dailyLimitExceeded, rateLimitExceeded, userRateLimitExceeded, 3) dalla classe del codice di risposta HTTP 2xx a 5xx per Stato dell'API di Google Maps: UNKNOWN_ERROR. Durante la transizione puoi visualizzare entrambi i codici di risposta punto. I codici di risposta restituiti nelle risposte dell'API di Google Maps non cambiano. Conferma che un aumento di 4xx e/o 5xx di Metriche di Google Maps Platform è correlato a questa migrazione, controllando quale codice di risposta esatto aumenta Esplora metriche (scopri di più sull'uso Google Cloud Monitoring per Google Maps Platform).

Report Coinvolgimento

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. Il progetto deve Avere l'API Maps JavaScript attivata.

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.

Esportazione degli approfondimenti sull&#39;attività

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 ti aiuta ad analizzare e generare approfondimenti basati sui tuoi dati, per avere un quadro chiaro dell'andamento dei tuoi acquirenti interagire con lo Store locator. Puoi misurare il rendimento ogni settimana settimana, inclusi il numero di visualizzazioni, il numero di interazioni con la Ricerca e Place Details e il tasso di coinvolgimento complessivo. Inoltre, la dashboard fornisce benchmark importanti per confrontare la tua implementazione con altri rivenditori.

Il report di benchmarking ti consente di confrontare i dati con quelli Dati di settore di altre aziende che condividono i propri dati. Il confronto fornisce un contesto prezioso, aiutandoti a fissare obiettivi significativi, approfondimenti sulle tendenze del settore e scoprire il tuo rendimento rispetto a la 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 dei tuoi dati sul coinvolgimento in forma anonima nei report di benchmarking, ticket di assistenza. Il ticket di assistenza viene generalmente risolto entro 3 giorni.