CategoryEntry.cs

namespace JSONstat.Models;

/// <summary>
/// A flattened view of a single category within a dimension, returned by the
/// <c>Category</c> navigation family.
/// </summary>
public sealed class CategoryEntry
{
    /// <summary>Creates a category entry.</summary>
    public CategoryEntry(string id, string label, int index, double[]? coordinates, Unit? unit)
    {
        Id = id;
        Label = label;
        Index = index;
        Coordinates = coordinates;
        Unit = unit;
    }

    /// <summary>The category id.</summary>
    public string Id { get; }

    /// <summary>The category label (falls back to the id when absent).</summary>
    public string Label { get; }

    /// <summary>The category position within its dimension.</summary>
    public int Index { get; }

    /// <summary>Geographic coordinates [longitude, latitude], if any.</summary>
    public double[]? Coordinates { get; }

    /// <summary>Unit of measure, for metric-role categories.</summary>
    public Unit? Unit { get; }
}