public final class NutritionSample

A logged food or meal, carrying whichever nutrients are known about it.

Sparse by design

A NutritionSample holds only the nutrients actually set. A logged apple sets four fields; a packaged food scanned from a barcode might set thirty. Modelling this as forty nullable fields – which is roughly what both platforms do – would make every consumer write forty null checks, so this exposes a map instead and getNutrients() returns only what is present.

NutritionSample lunch = NutritionSample.create(start, end);
lunch.setTitle("Chicken salad");
lunch.setNutrient(Nutrient.ENERGY, 420);
lunch.setNutrient(Nutrient.PROTEIN, 35);
lunch.setNutrient(Nutrient.SODIUM, 610);

Meal type

Health Connect records which meal an entry belongs to and HealthKit does not, so getMealType() round-trips through the local store and would ride in sample metadata on iOS once that mapping exists.

Local and simulator only in this release

Neither phone carries this shape yet – see the package documentation. A read or write of HealthDataType.NUTRITION on iOS or Android is refused with HealthError.TYPE_NOT_SUPPORTED; everything here works against the local store.