Tipi di dati

Google Fit fornisce una serie di tipi di dati su salute e benessere nello spazio dei nomi com.google.

I tipi di dati definiscono il formato dei valori all'interno dei punti dati. Un punto dati può rappresentare:

• Una lettura o un'osservazione istantanea
• Un'aggregazione con statistiche su un intervallo di tempo

Google Fit definisce i tipi di dati per le osservazioni istantanee e i tipi di dati per i dati aggregati e i dati di Google Cloud. I punti dati sono costituiti dai valori per i campi di un tipo di dati e da informazioni di timestamp. I punti che rappresentano osservazioni istantanee includono un timestamp e i punti un tipo di dati aggregati include anche l'ora di inizio dell'intervallo.

Google Fit ti consente anche di definire nuovi tipi di dati.

Gruppi di tipi di dati

In Google Fit sono disponibili i seguenti tipi di dati:

Tipi di dati pubblici

I tipi di dati standard forniti dalla piattaforma utilizzano "com.google" . Ad esempio, com.google.step_count.delta. Questi tipi di dati acquisiscono letture istantanee dati su salute e benessere, tra cui attività fisica, sonno e alimentazione. Qualsiasi un'app può richiedere le autorizzazioni pertinenti per leggere e scrivere in questi tipi di dati, ad eccezione di alcuni tipi di dati sulla posizione che possono essere letti solo dall'app che li ha scritti.

Per ulteriori informazioni, vedi:

• Tipi di dati relativi alle attività
• Tipi di dati sulla posizione
• Tipi di dati nutrizionali

Tipi di dati sanitari

Tipi di dati forniti dalla piattaforma che hanno accesso limitato a causa di: dati potenzialmente sensibili. Per ulteriori informazioni, vedi Dati sanitari .

Tipi di dati aggregati

Tipi di dati per leggere informazioni su salute e benessere, aggregate per data o ora tipo di attività. Per ulteriori informazioni, consulta la sezione Dati aggregati .

Tipi di dati personalizzati privati

Tipi di dati personalizzati definiti da un'app specifica. Solo l'app che definisce può leggere e scrivere dati di questo tipo. Per ulteriori informazioni, vedi Tipi di dati personalizzati.

Utilizzo dei tipi di dati

val nutritionSource = DataSource.Builder()
    .setDataType(DataType.TYPE_NUTRITION)
    ...
    .build()

val nutrients = mapOf(
    Field.NUTRIENT_TOTAL_FAT to 0.4f,
    Field.NUTRIENT_SODIUM to 1f,
    Field.NUTRIENT_POTASSIUM to 422f
)
val banana = DataPoint.builder(nutritionSource)
    .setTimestamp(now, TimeUnit.MILLISECONDS)
    .setField(Field.FIELD_FOOD_ITEM, "banana")
    .setField(Field.FIELD_MEAL_TYPE, Field.MEAL_TYPE_SNACK)
    .setField(Field.FIELD_NUTRIENTS, nutrients)
    .build()

{
"dataStreamId": "exampleDataSourceId",
...
"dataType": {
  "name": "com.google.step_count.delta"
},
...
}

Ambiti di autorizzazione

Gli ambiti di autorizzazione coprono gruppi di tipi di dati a cui un utente può autorizzare un'app l'accesso. Aiutano gli utenti a capire a quali tipi di dati vuole accedere un'app. Semplificano anche l'autorizzazione delle app a usare tali dati, in quanto per approvare ogni singolo tipo di dati. Gli utenti concedono queste autorizzazioni una volta che hanno scaricato l'app.

Dopo aver testato l'app con un numero ridotto di utenti, prima di lanciare l'app app devi richiedere la verifica in base ai pertinenti per quei tipi di dati. Leggi le pagine relative ai tipi di dati a cui rimanda un link descritti sopra per capire quali ambiti si applicano a ogni tipo di dati.

Ad esempio, se la tua app ha bisogno di leggere e scrivere la misurazione della pressione sanguigna, e deve dichiarare che sta eseguendo sia la lettura che la scrittura e richiede entrambi gli ambiti. Se si tratta di scrivere dati sulla pressione sanguigna nella piattaforma Google Fit, i dati devono richiedere l'ambito di scrittura.

Scegli i tipi di dati in modo responsabile. Non richiedere tutti i tipi di dati nel caso in cui la tua app potrebbe servirti. I tipi specificati determinano gli ambiti a cui viene richiesto l'utente per i quali concedere l'autorizzazione. Chiedi solo i tipi di dati di cui la tua app ha bisogno, in modo che gli utenti siano di concedere l'accesso. Gli utenti concedono più facilmente l'accesso a gli ambiti descritti.

Usa questa tabella per verificare se gli ambiti a cui la tua app deve accedere sono sensibili o limitato (che determina la verifica passaggi da seguire):

Aggiunta di nuovi ambiti a un'app esistente

Quando aggiorni l'app per richiedere un nuovo ambito (ad esempio, se aggiungi il nuovo sonno o battito cardiaco o aggiungi un ambito di lettura), agli utenti verrà chiesto la tua app richiede l'accesso a questi ambiti e può scegliere di concedere o rifiutare l'accesso.

Al momento, ti consigliamo di richiedere l'autorizzazione agli utenti per le risorse ne hai bisogno. Segui le linee guida per richiedere incrementi autorizzazione.

Gli utenti saranno più propensi a concedere l'accesso se capiscono perché/come la tua app utilizza questi dati:

• Valuta la possibilità di aggiungere una schermata che avvisa/informa gli utenti che verranno richiesti questi ambiti.
• Spiega chiaramente perché la tua app richiede l'accesso a questi ambiti/dati, in modo da possono prendere una decisione consapevole.

Scopri di più sulle best practice relative alle autorizzazioni app per Android.