{"openapi":"3.1.0","info":{"title":"UTM Coordinate API","version":"1.0.0","description":"UTM ↔ geographic coordinate conversion as an API, computed locally and deterministically on the WGS84 ellipsoid. The from-latlon endpoint projects a latitude and longitude into the Universal Transverse Mercator grid — returning the zone (1–60), the hemisphere, the latitude band letter, and the easting and northing in metres — using the Snyder/USGS Transverse Mercator series, which is accurate to a few millimetres within a zone; New York (40.7128, −74.0060) maps to zone 18N at about 583960 E, 4507351 N, and the canonical 45°N on a central meridian gives a northing of exactly 4982950.40 m. The to-latlon endpoint inverts it, recovering the latitude and longitude from a zone, hemisphere, easting and northing. Each zone is 6° of longitude wide with a 500000 m false easting on its central meridian and a 10000000 m false northing in the southern hemisphere. Latitude is valid from −80° to 84°. Everything is computed locally and deterministically, so it is instant and private. Ideal for GIS, surveying, mapping, geospatial, drone-mapping and location app developers, coordinate-conversion and grid-reference tools, and spatial software. Pure local computation — no key, no third-party service, instant. Live, nothing stored. 2 endpoints. This is UTM on WGS84; for the polar regions use UPS and for an EPSG-code lookup use an EPSG API.","contact":{"name":"PremiumApi","url":"https://www.oanor.com/by/premiumapi"}},"servers":[{"url":"https://api.oanor.com/utm-api","description":"oanor gateway"}],"tags":[{"name":"UTM"},{"name":"Meta"}],"components":{"securitySchemes":{"oanorKey":{"type":"apiKey","in":"header","name":"x-oanor-key","description":"Get your key at https://www.oanor.com/developer/keys"}}},"security":[{"oanorKey":[]}],"paths":{"/v1/from-latlon":{"get":{"operationId":"get_v1_from_latlon","tags":["UTM"],"summary":"Latitude/longitude → UTM","description":"","parameters":[{"name":"latitude","in":"query","required":true,"description":"Latitude (−80…84)","schema":{"type":"string"},"example":"40.7128"},{"name":"longitude","in":"query","required":true,"description":"Longitude (−180…180)","schema":{"type":"string"},"example":"-74.0060"},{"name":"zone","in":"query","required":false,"description":"Force a UTM zone (1–60)","schema":{"type":"string"}}],"security":[{"oanorKey":[]}],"responses":{"200":{"description":"OK","content":{"application/json":{"example":{"data":{"band":"T","note":"UTM (WGS84, Snyder series). Zone 1–60, 6° wide; the central-meridian easting is 500000. New York (40.7128, −74.0060) → zone 18N, ≈583960 E, ≈4507523 N.","zone":18,"inputs":{"latitude":40.7128,"longitude":-74.006},"easting":583959.372,"northing":4507350.998,"hemisphere":"N","central_meridian":-75},"meta":{"timestamp":"2026-06-05T19:50:16.198Z","request_id":"2e8f4b69-f855-4cf0-a303-1f22bee01b3b"},"status":"ok","message":"Lat/lon to UTM","success":true}}}},"401":{"description":"Missing or invalid x-oanor-key header"},"402":{"description":"Active subscription required"},"429":{"description":"Rate-limit or monthly quota reached"},"502":{"description":"Upstream did not respond"}}}},"/v1/to-latlon":{"get":{"operationId":"get_v1_to_latlon","tags":["UTM"],"summary":"UTM → latitude/longitude","description":"","parameters":[{"name":"easting","in":"query","required":true,"description":"Easting (m)","schema":{"type":"string"},"example":"583960"},{"name":"northing","in":"query","required":true,"description":"Northing (m)","schema":{"type":"string"},"example":"4507351"},{"name":"zone","in":"query","required":true,"description":"UTM zone (1–60)","schema":{"type":"string"},"example":"18"},{"name":"hemisphere","in":"query","required":false,"description":"N or S (default N)","schema":{"type":"string"},"example":"N"}],"security":[{"oanorKey":[]}],"responses":{"200":{"description":"OK","content":{"application/json":{"example":{"data":{"note":"UTM → geographic (WGS84, Snyder inverse series). Provide the zone and hemisphere (N/S).","inputs":{"zone":18,"easting":583960,"northing":4507351,"hemisphere":"N"},"latitude":40.71279995,"longitude":-74.00599257},"meta":{"timestamp":"2026-06-05T19:50:16.304Z","request_id":"aa05881e-e179-4db2-946f-10e3e9fdeb18"},"status":"ok","message":"UTM to lat/lon","success":true}}}},"401":{"description":"Missing or invalid x-oanor-key header"},"402":{"description":"Active subscription required"},"429":{"description":"Rate-limit or monthly quota reached"},"502":{"description":"Upstream did not respond"}}}},"/v1/meta":{"get":{"operationId":"get_v1_meta","tags":["Meta"],"summary":"Spec","description":"","parameters":[],"security":[{"oanorKey":[]}],"responses":{"200":{"description":"OK","content":{"application/json":{"example":{"data":{"notes":"Latitude −80…84°, longitude −180…180°. UTM has 60 zones of 6° longitude each. Snyder/USGS series, accurate to a few mm within a zone; use UPS for the poles.","service":"utm-api","ellipsoid":{"a":6378137,"f":0.003352810665,"k0":0.9996,"name":"WGS84"},"endpoints":{"GET /v1/meta":"This document.","GET /v1/to-latlon":"UTM (zone, hemisphere, easting, northing) → latitude/longitude.","GET /v1/from-latlon":"Latitude/longitude → UTM zone, easting, northing."},"description":"UTM ↔ geographic (latitude/longitude) coordinate conversion on the WGS84 ellipsoid."},"meta":{"timestamp":"2026-06-05T19:50:16.411Z","request_id":"9e626c11-317c-4c32-b7bc-3467e4d461fa"},"status":"ok","message":"Meta","success":true}}}},"401":{"description":"Missing or invalid x-oanor-key header"},"402":{"description":"Active subscription required"},"429":{"description":"Rate-limit or monthly quota reached"},"502":{"description":"Upstream did not respond"}}}}},"x-oanor-pricing":[{"slug":"free","name":"Free","price_cents_month":0,"monthly_call_quota":3800,"rps_limit":2,"hard_limit":true},{"slug":"starter","name":"Starter","price_cents_month":630,"monthly_call_quota":38000,"rps_limit":6,"hard_limit":true},{"slug":"pro","name":"Pro","price_cents_month":1820,"monthly_call_quota":180000,"rps_limit":15,"hard_limit":true},{"slug":"mega","name":"Mega","price_cents_month":5500,"monthly_call_quota":1075000,"rps_limit":40,"hard_limit":true}],"x-oanor-marketplace-url":"https://www.oanor.com/api/utm-api"}