Un set di dati rappresenta un container di proiezione per i punti dati. Non ci sono informazioni personali. I set di dati rappresentano un insieme di punti dati di una determinata origine dati. Un punto dati è disponibile in più di un set di dati.
Per un elenco dei metodi disponibili per questa risorsa, vedi la fine di questa pagina.
Rappresentazioni delle risorse
{ "minStartTimeNs": long, "maxEndTimeNs": long, "dataSourceId": string, "point": [ { "startTimeNanos": long, "endTimeNanos": long, "dataTypeName": string, "originDataSourceId": string, "value": [ { "intVal": integer, "fpVal": double, "stringVal": string, "mapVal": [ { "key": string, "value": { "fpVal": double } } ] } ], "modifiedTimeMillis": long, "rawTimestampNanos": long, "computationTimeMillis": long } ], "nextPageToken": string }
Nome proprietà | Valore | Descrizione | Note |
---|---|---|---|
dataSourceId |
string |
L'ID dello stream di dati dell'origine dati che ha creato i punti in questo set di dati. | |
maxEndTimeNs |
long |
La più alta ora di fine di tutti i punti dati in questa rappresentazione potenzialmente parziale del set di dati. Il tempo è in nanosecondi dal periodo. Deve corrispondere anche alla seconda parte dell'identificatore del set di dati. | |
minStartTimeNs |
long |
L'ora di inizio minima di tutti i punti dati in questa rappresentazione potenzialmente parziale del set di dati. Il tempo è in nanosecondi dal periodo. Deve corrispondere anche alla prima parte dell'identificatore del set di dati. | |
nextPageToken |
string |
Questo token verrà impostato quando un set di dati viene ricevuto in risposta a una richiesta GET e è troppo grande per essere incluso in una singola risposta. Fornisci questo valore in una richiesta GET successiva per restituire la pagina successiva di punti dati all'interno di questo set di dati. | |
point[] |
list |
Un elenco parziale di punti dati contenuto nel set di dati, ordinato per endTimeNanos. Questo elenco è considerato completo durante il recupero di un piccolo set di dati e parziale durante l'applicazione di patch a un set di dati o il recupero di un set di dati troppo grande per essere incluso in una singola risposta. | |
point[].computationTimeMillis |
long |
NON UTILIZZARE QUESTO CAMPO. ma viene ignorata e non viene memorizzata. | |
point[].dataTypeName |
string |
Il tipo di dati che definisce il formato dei valori in questo punto dati. | |
point[].endTimeNanos |
long |
L'ora di fine dell'intervallo rappresentata da questo punto dati, in nanosecondi dal periodo. | |
point[].modifiedTimeMillis |
long |
Indica l'ultima volta che questo punto dati è stato modificato. Utile solo in contesti in cui abbiamo elencato le modifiche dei dati, anziché rappresentare lo stato attuale dei dati. | |
point[].originDataSourceId |
string |
Se il punto dati è contenuto in un set di dati per un'origine dati derivata, questo campo verrà completato con l'ID stream origine dati che ha creato inizialmente il punto dati. AVVISO: non fare affidamento su questo campo per scopi diversi dal debug. Il valore di questo campo, se impostato, rappresenta un dettaglio di implementazione e non è garantito che rimanga coerente. |
|
point[].rawTimestampNanos |
long |
Il timestamp non elaborato dell'originale SensorEvent. | |
point[].startTimeNanos |
long |
L'ora di inizio dell'intervallo rappresentata da questo punto dati, in nanosecondi dal periodo. | |
point[].value[] |
list |
Valori di ciascun campo del tipo di dati per il punto dati. Prevediamo che ogni valore corrispondente a un campo di tipi di dati si verifichi nello stesso ordine in cui il campo è elencato nel tipo di dati specificato in un'origine dati. Verrà compilato solo un campo con numeri interi e in virgola mobile, a seconda del valore di enumerazione del formato all'interno del campo del tipo di origine dati. |
|
point[].value[].fpVal |
double |
Valore in virgola mobile. Quando è impostato questo valore, non devono essere impostati altri valori. | |
point[].value[].intVal |
integer |
Valore intero. Quando è impostato questo valore, non devono essere impostati altri valori. | |
point[].value[].mapVal[] |
list |
Valore mappa. Lo spazio chiave e le unità validi per il valore corrispondente di ogni voce devono essere documentati come parte della definizione del tipo di dati. Le chiavi devono essere di dimensioni ridotte, se possibile. Gli stream di dati con chiavi di grandi dimensioni e con un'elevata frequenza di dati potrebbero essere campionati. | |
point[].value[].mapVal[].key |
string |
||
point[].value[].mapVal[].value |
nested object |
||
point[].value[].mapVal[].value.fpVal |
double |
Valore in virgola mobile. | |
point[].value[].stringVal |
string |
Valore stringa. Quando è impostato questo valore, non devono essere impostati altri valori. Le stringhe devono essere di dimensioni ridotte, se possibile. Gli stream di dati con valori stringa di grandi dimensioni e con un'elevata frequenza dei dati potrebbero essere campionati meno. |
Metodi
- elimina
- Consente di eliminare definitivamente tutti i punti dati i cui orari di inizio e fine coincidono con qualsiasi intervallo di tempo specificato dall'ID del set di dati. Per la maggior parte dei tipi di dati, l'intero punto dati viene eliminato. Per i tipi di dati in cui l'intervallo di tempo rappresenta un valore coerente (ad esempio
com.google.activity.segment
) e un punto dati si trova a un punto finale del set di dati, verrà eliminata solo la parte che si sovrappone al punto dati. - get
- Restituisce un set di dati contenente tutti i punti dati i cui orari di inizio e fine coincidono con l'intervallo specificato di ora di inizio minima e fine massima. In particolare, qualsiasi punto dati la cui ora di inizio è inferiore o uguale all'ora di fine del set di dati e la cui ora di fine è superiore o uguale all'ora di inizio del set di dati.
- patch
- Aggiunge punti dati a un set di dati. Non è necessario creare prima il set di dati.
Tutti i punti all'interno del set di dati verranno restituiti con chiamate successive
per recuperare il set di dati. I punti dati possono appartenere a più di un set di dati.
Questo metodo non utilizza la semantica delle patch: i punti dati forniti vengono semplicemente inseriti, senza dati esistenti sostituiti.