Skip to content
HALOWERK

Ortwerk

maidenhead

Implements the IARU Maidenhead locator grid: field 20°×10° (A–R), square 2°×1° (0–9), subsquare 5′×2.5′ (a–x), extended square (0–9) and extended subsquare (a–x). Encoding uses exact decimal arithmetic so points on cell borders fall into the correct cell; decoding returns the south-west and north-east corners and the cell centre. The optional path computes the ellipsoidal distance (Vincenty, WGS84) and initial and reverse bearing between the two cell centres.

POST https://ort.halowerk.com/v1/maidenhead

Inputs

Fields of the published input schema
FieldTypeRequiredDescription
pointsarrayNo
locatorsarrayNo
precisionintegerNoCharacters of the generated locators.
pathobjectNoTwo locators for distance and bearing.
Show full input schema
{
  "type": "object",
  "additionalProperties": false,
  "properties": {
    "points": {
      "type": "array",
      "maxItems": 1000,
      "items": {
        "type": "object",
        "additionalProperties": false,
        "required": [
          "lat",
          "lon"
        ],
        "properties": {
          "lat": {
            "type": "number",
            "minimum": -90,
            "maximum": 90
          },
          "lon": {
            "type": "number",
            "minimum": -180,
            "maximum": 180
          }
        }
      }
    },
    "locators": {
      "type": "array",
      "maxItems": 1000,
      "items": {
        "type": "string",
        "minLength": 2,
        "maxLength": 10
      }
    },
    "precision": {
      "type": "integer",
      "enum": [
        2,
        4,
        6,
        8,
        10
      ],
      "default": 6,
      "description": "Characters of the generated locators."
    },
    "path": {
      "type": "object",
      "additionalProperties": false,
      "required": [
        "from",
        "to"
      ],
      "properties": {
        "from": {
          "type": "string",
          "minLength": 2,
          "maxLength": 10
        },
        "to": {
          "type": "string",
          "minLength": 2,
          "maxLength": 10
        }
      },
      "description": "Two locators for distance and bearing."
    }
  }
}

Open original schema

Published input example

{
  "points": [
    {
      "lat": 52.212,
      "lon": 7.042
    }
  ],
  "path": {
    "from": "JO32",
    "to": "JN58td"
  }
}

Result & documentation

Machine-readable documentation of this hub

Source of this page: the published HALOWERK catalog. Updated: 2026-11-17 UTC.

More endpoints in this hub

All endpoints in this hub →