{
  "tool": "matric-nqf4.geo_map_scale",
  "name": "Map scale and gradient (CDU-GEN-NSC-400)",
  "answers": "The ground distance from a map measurement and a 1 : n scale, and the gradient as 1 : (run/rise).",
  "degree": {
    "id": "competency:matric-nqf4",
    "code": "CDU-GEN-NSC-400",
    "name": "Senior Certificate (Amended) — exam-readiness programme (NQF 4 matric)",
    "version": "1.0.0"
  },
  "reference": "Umalusi/NSC subject catalogue, worked reference (offline reconstruction); Geography row of §4 — a map scale distance and a gradient",
  "endpoint": "/faculty/matric-nqf4/geo_map_scale",
  "feeSt": 1,
  "inputSchema": {
    "type": "object",
    "required": [
      "pan",
      "mapDistanceCm",
      "scaleDenominator",
      "riseM"
    ],
    "properties": {
      "pan": {
        "type": "string",
        "description": "The student PAN — the degree must be held in one of its five slots",
        "pattern": "^[0-9 ]{16,19}$"
      },
      "mapDistanceCm": {
        "type": "number",
        "description": "measured map distance (cm, > 0) (cm)",
        "minimum": 0.001,
        "maximum": 10000
      },
      "scaleDenominator": {
        "type": "number",
        "description": "the n of 1 : n (> 0)",
        "minimum": 1,
        "maximum": 10000000
      },
      "riseM": {
        "type": "number",
        "description": "height gained over the distance (m, > 0) (m)",
        "minimum": 0.001,
        "maximum": 100000
      }
    },
    "additionalProperties": false
  },
  "outputSchema": {
    "type": "object",
    "required": [
      "groundDistanceKm",
      "gradientRun"
    ],
    "properties": {
      "groundDistanceKm": {
        "type": "number",
        "description": "ground distance (km, 3 d.p.)"
      },
      "gradientRun": {
        "type": "number",
        "description": "the n of gradient 1 : n (1 d.p.)"
      }
    },
    "additionalProperties": false
  },
  "example": {
    "mapDistanceCm": 4.5,
    "scaleDenominator": 50000,
    "riseM": 120
  }
}