Spec

Αποσπάσματα κώδικα

curl "https://api.oanor.com/maidenhead-api/v1/meta" \
  -H "x-oanor-key: oanor_test_..."

await fetch("https://api.oanor.com/maidenhead-api/v1/meta", {
  headers: { "x-oanor-key": "oanor_test_..." }
});

$ch = curl_init("https://api.oanor.com/maidenhead-api/v1/meta");
curl_setopt($ch, CURLOPT_HTTPHEADER, ["x-oanor-key: oanor_test_..."]);
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
$out = curl_exec($ch);

import requests
requests.get(
    "https://api.oanor.com/maidenhead-api/v1/meta",
    headers={"x-oanor-key": "oanor_test_..."}
)

Παράδειγμα απόκρισης

Πραγματική απόκριση αυτού του endpoint, από τον τελευταίο έλεγχο υγείας.

{
    "data": {
        "name": "Maidenhead Locator API",
        "notes": "Field 20°×10°, square 2°×1°, subsquare 5′×2.5′. Distance uses the great-circle between grid centres. Nothing is stored.",
        "version": "v1",
        "endpoints": [
            {
                "path": "/v1/encode",
                "params": {
                    "lat": "latitude",
                    "lon": "longitude",
                    "precision": "4|6|8|10 (default 6)"
                },
                "returns": "the Maidenhead locator"
            },
            {
                "path": "/v1/decode",
                "params": {
                    "locator": "a Maidenhead locator, e.g. JN58td"
                },
                "returns": "the centre, south-west corner and grid size"
            },
            {
                "path": "/v1/distance",
                "params": {
                    "to": "a locator",
                    "from": "a locator"
                },
                "returns": "great-circle distance and bearing between the grids"
            },
            {
                "path": "/v1/meta",
                "params": [],
                "returns": "this document"
            }
        ],
        "description": "Convert between latitude/longitude and the Maidenhead Locator System — the grid-square \"QTH locator\" (like JN58td or IO91wm) used by amateur radio, APRS and contesting to describe a position compactly. The encode endpoint turns a latitude and longitude into a locator at 4-, 6-, 8- or 10-character precision. The decode endpoint turns a locator back into the centre coordinates, the south-west corner and the size of the grid square. The distance endpoint gives the great-circle distance (km and miles) and bearing between the centres of two locators — the classic \"how far and which way is that station\". Everything is computed locally and deterministically, so it is instant and private. Ideal for amateur-radio and APRS tools, contest logging, antenna aiming, and grid-based mapping. Pure local computation — no key, no third-party service, instant. Live, nothing stored. 3 endpoints. This is the Maidenhead system; for Plus Codes, MGRS, UTM and DMS use a geo-convert API and for precise geodesic distance use a geodesy API."
    },
    "meta": {
        "timestamp": "2026-06-03T17:42:03.967Z",
        "request_id": "ec7cc89d-45d2-465d-ae12-4ae4db9af39e"
    },
    "status": "ok",
    "message": "Meta",
    "success": true
}