Units of Measurement

Plan & Token Requirements

Feature available in the following LogMeal Plans:

Accessible by the following User Types:

What It Does

The Units of Measurement feature lists and describes all supported units for ingredients and dishes. Each unit includes its type (weight, volume, portion), symbol, and conversion factors when applicable. These units help standardize how ingredient amounts and dish amounts are recorded and displayed across the platform. They also help users visualize the quantities of any food item in they way they are more conformable with (e.g. portions, cooking measures, metric system, imperial system, etc.).

✕

✕

When to Use It / Outcomes

• You want to show or allow selection of measurement units for ingredient editing, or intake edition.
• You need to convert automatically between units (e.g., cups → grams, teaspoons → milliliters).
• You wish to maintain consistency in data across various measurement systems.
• You want to improve user experience by letting users choose measures that feel natural (e.g., “1 cup of rice” instead of “200 grams of rice”).
• Output: JSON listing all available units, their categories, symbols, conversion ratios, and system associations (metric, imperial, or custom cooking systems).

Feature-Specific Details

• Personalization: Each user is able to personalize the default food measurements units to be displayed when listing their intakes in their food diary.
• Categories: Units are grouped under Weight, Volume, and Portion.
• Examples: grams (g), kilograms (kg), milliliters (ml), liters (l), cups, tablespoons (tbsp), teaspoons (tsp), slices, and portions.
• Conversion factors: Each unit includes data that allows conversion to a base unit (grams or milliliters). This ensures accurate nutrient calculations regardless of how quantities are expressed.
• Localization: Unit names and symbols adapt automatically to supported languages and regional formats.
• Integration: Units are used in Custom Recipes, Manual Intakes, Ingredient Editing, and Meal Reporting.
• System awareness: Supports Metric, Imperial, and Cooking Measure Systems. The appropriate set is automatically selected based on the user preferences.

Related Endpoints

Use the following endpoints to access and manage measurement data and related systems:

• GET /dataset/weightMeasures/dishes → ⚫ 🔴 🔵 Returns information about all weight measures and units used to display dish weights.
• GET /dataset/weightMeasures/ingredients → ⚫ 🔴 🔵 Returns information about all weight measures and units used to display ingredient weights.
• GET /dataset/ingredients → ⚫ 🔴 🔵 Retrieves the complete list of ingredients that could appear in recipes, including measurement units.
• GET /dataset/dishes → ⚫ 🔴 🔵 Retrieves all dishes/classes recognized by LogMeal’s recognition algorithms, including their standard measurement units.

Personalization and preferences:

• POST /profile/modifyUserProfileInfo → 🔴 Allows users to customize their preferred measurement system (e.g., metric or cooking-based) for all visualizations.
  This affects how data is shown in endpoints like GET /intake or GET /getIntakesList, ensuring reported measurements match the user’s saved preferences.

Related Use Cases