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.
Per accedere alle API e Pagina Dashboard dei servizi:
- Apri la pagina del selettore progetti nella console Cloud:
- Seleziona il progetto. Le API e Viene visualizzata la pagina Dashboard dei servizi.
Se la pagina non viene visualizzata, seleziona il pulsante del menuquindi 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.
Per accedere alla pagina Panoramica di Google Maps Platform:
- Apri la pagina Google Maps Platform nella console Cloud:
- 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.
Per accedere alle API di Google Maps Platform e Pagina Servizi:
- Apri la pagina Google Maps Platform nella console Cloud:
- 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.
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:
Per accedere alla pagina delle metriche dell'API Google Maps Platform:
- Apri la pagina Google Maps Platform nella console Cloud:
- 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à:
|
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.
Per accedere alla pagina Quote di Google Maps Platform:
- Apri la pagina Google Maps Platform nella console Cloud:
- Nel menu a sinistra, seleziona Quote.
- 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:
- Apri la pagina del selettore progetti nella console Cloud:
- Seleziona un progetto.
- Seleziona il pulsante del menu
e seleziona Fatturazione.
- Se hai più account di fatturazione, seleziona Vai all'account di fatturazione collegato. per aprire la pagina Panoramica dell'account di fatturazione collegato.
- 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](https://cloud.google.com/billing/docs/images/billing-reports1.png?authuser=6&hl=it)
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](https://developers-dot-devsite-v2-prod.appspot.com/static/maps/reporting-and-monitoring/images/billing-report-table-by-sku.png?authuser=6&hl=it)
![Screenshot dei filtri del report sulla fatturazione](https://developers-dot-devsite-v2-prod.appspot.com/static/maps/reporting-and-monitoring/images/billing-report-filters-sku.png?authuser=6&hl=it)
Per modificare la vista report in modo da mostrare gli elementi pubblicitari in base allo SKU:
- Nel riquadro a destra del grafico, espandi il filtro Raggruppa per.
- 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](https://developers-dot-devsite-v2-prod.appspot.com/static/maps/reporting-and-monitoring/images/billing-report-filter-channel.png?authuser=6&hl=it)
Per filtrare il report sulla fatturazione per SKU e canale
- Utilizza il filtro per SKU Raggruppa per.
- Seleziona il cursore Etichette.
- Seleziona il menu a discesa Chiave e poi goog-maps-channel.
- 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
Risorse correlate
Fatturazione Cloud:
- Crea, modifica o chiudi l'account di fatturazione Cloud
- Modificare le impostazioni di fatturazione di un progetto
- Visualizzare i report di fatturazione e le tendenze dei costi
- Configurare avvisi relativi a budget e budget
- Limitazione dell'utilizzo delle API
- 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 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 |
Sì | Sì | Sì |
DATA_NOT_AVAILABLE, NOT_FOUND, ZERO_RESULTS |
200, 404 |
4xx1 | Sì | Sì | Sì |
INVALID_REQUEST (valore parametro non valido), MAX_ROUTE_LENGTH_EXCEEDED, MAX_WAYPOINTS_EXCEEDED, ecc. |
200, 400 |
4xx | Sì | Sì | Sì |
INVALID_REQUEST (parametro non valido/mancante, errore di analisi della richiesta) | 200, 400 |
4xx | Sì | No | No |
REQUEST_DENIED | 200, 400, 403 |
4xx1 | Sì | No | No |
OVER_DAILY_LIMIT, OVER_QUERY_LIMIT, RESOURCE_EXHAUSTED, giornalieroLimite superato, rateLimitExceeded, userRateLimitExceeded |
200, 403, 429 |
4xx1 | Sì | No | No |
UNKNOWN_ERROR | 200, 500, 503 |
5xx1 | Sì | Sì | 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.
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.
- Vai a Locator Plus in la console Google Cloud.
- Vai alla sezione Report sul coinvolgimento della console Google Cloud. per visualizzare la dashboard di Analytics.
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.