Ham::Locator(3pm)

💖 Ham::Locator 💖

okay bestie, gather round, because this is genuinely one of the cutest little Perl modules out there — it's Ham::Locator, from the User Contributed Perl Documentation pile, and it does exactly one thing but does it flawlessly: it converts between Maidenhead locators and latitude/longitude. That's it. That's the whole vibe. Grid squares in, coordinates out, coordinates in, grid squares out. 🔥

If you're a ham radio girlie you already know — Maidenhead locators are those little letter-number combos like IO93lo that describe a spot on Earth, and sometimes you need the actual lat/lng and sometimes you need the pretty grid square. This module is your girl. No cap. 🎀

---

✨ SYNOPSIS ✨

the whole thing, in all its glory:

use Ham::Locator;
my $m = new Ham::Locator;
$m->set_loc('IO93lo');
my ($latitude, $longitude) = $m->loc2latlng;

like… four lines. it's giving efficiency. 👑

---

🌸 DEPENDENCIES 🌸

she doesn't do it alone, she has a tiny little entourage:

• Carp</c> — for error handling, so when something goes wrong you get a nice sensible complaint instead of vibes
• Class::Accessor</c> — for accessor method generation, i.e. it writes all the boring getter/setter boilerplate so nobody has to 🫶

---

👑 CONSTRUCTORS 👑

Locator->new

Creates a new Ham::Locator object. That's literally it, bestie. Fresh object, main character energy, ready to convert. ✨

---

🦋 ACCESSORS 🦋

these are the little knobs you turn before you ask her to do the thing:

• $locator->set_loc(locator) — sets the locator you want used when converting to latitude and longitude. drop your grid square in here 💅
• $locator->set_latlng((latitude, longitude)) — sets the longitude and latitude you want used when converting to the locator. yes, she said longitude and latitude, that's the order in the source, we don't argue with the source 🫡
• $locator->set_precision(precision) — sets the number of characters of the locator reference to return when you call latlng2loc. short locator, long locator, your call, she's flexible like that 🌈

---

🧚 METHODS 🧚

the two moments you've been waiting for:

• $locator->latlng2loc — converts the latitude and longitude you set with set_latlng into the locator, and hands it back to you as a string. 🎀
• $locator->loc2latlng — converts the locator you set with set_loc into latitude and longitude, and returns them as an array of two values. two whole values, one little array, iconic. 💜

---

💀 CAVEATS 💀

(nothing here, bestie — the original page leaves this one empty. silence is golden, i guess? she's just that confident.)

---

🙈 BUGS 🙈

• None, hopefully! 😭 that's the actual note. she said hopefully. truly the most honest bug section in all of CPAN and i respect it so much.

---

🌟 COPYRIGHT 🌟

okay legal moment, but make it cute:

This module was written by Andy Smith <andy.smith@netprojects.org.uk>. 👑

Version tag, verbatim, because we do not mess with $Id strings:

$Id: Locator.pm 10 2011-01-16 15:36:53Z andys $

(c)2009 Andy Smith (<http://andys.org.uk/>)

This library is free software; you can redistribute it and/or modify it under the same terms as Perl itself. 🫶

---

fr fr, if you're gonna ship this anywhere, keep that copyright block intact. it's not optional, it's a whole legal vibe. ⭐

---

and that's the page!! 🦋 this is Ham::Locator, shipped as part of perl v5.32.1 and dated 2022-01-03 — so yeah, she's been out here converting grid squares since forever and she's still slaying. go set a locator, bestie. 💖✨🌸