Net::G...rn::SKY(3pm)

💖 NAME 💖

Net::GPSD3::Return::SKY — the Net::GPSD3 Return SKY Object, bestie. That's it, that's the name, and it's lowkey iconic 🛰️✨

---

✨ SYNOPSIS ✨

Okay so... this section is literally empty. Nothing here. Zero. It's giving mystery, it's giving "figure it out yourself," and honestly? We respect it 🙈💅

---

🌈 DESCRIPTION 🌈

So here's the tea: this gives you a Perl object interface to the SKY object that the GPSD daemon hands back to you. Think of it as the glow-up wrapper so your Perl code doesn't have to rawdog the JSON 🫶

Here's an example JSON object, for the visual learners:

Protcol 3.1 versions

{
  "class":"SKY",
  "tag":"MID4",
  "device":"/dev/ttyUSB0",
  "time":1253593665.430,
  "hdop":23.60,
  "reported":9,
  "satellites":
    [
      {"PRN":15,"el":77,"az":123,"ss":0, "used":false},
      {"PRN":18,"el":25,"az":268,"ss":0, "used":false},
      {"PRN":27,"el":13,"az":150,"ss":0, "used":false},
      {"PRN":29,"el":47,"az":228,"ss":0, "used":false},
      {"PRN":5, "el":39,"az":58, "ss":46,"used":true },
      {"PRN":21,"el":41,"az":309,"ss":33,"used":true },
      {"PRN":10,"el":32,"az":61, "ss":40,"used":true },
      {"PRN":8, "el":12,"az":48, "ss":40,"used":true },
      {"PRN":2, "el":9, "az":124,"ss":0, "used":false}
    ]
}

And now the glow-up era, Protcol 3.4 versions:

{
  "class":"SKY",
  "tag":"0x0120",
  "device":"/dev/cuaU0",
  "xdop":0.58,
  "ydop":0.96,
  "vdop":1.92,
  "tdop":1.14,
  "hdop":1.90,
  "gdop":2.93,
  "pdop":2.70,
  "satellites":[
    {"PRN":17,"el":76,"az":174,"ss":34,"used":true},
    {"PRN":28,"el":57,"az":38,"ss":30,"used":false},
    {"PRN":27,"el":22,"az":314,"ss":18,"used":true},
    {"PRN":7,"el":15,"az":127,"ss":29,"used":true},
    {"PRN":15,"el":31,"az":297,"ss":27,"used":true},
    {"PRN":11,"el":18,"az":54,"ss":28,"used":false},
    {"PRN":24,"el":18,"az":63,"ss":29,"used":false},
    {"PRN":9,"el":4,"az":313,"ss":18,"used":false},
    {"PRN":8,"el":45,"az":117,"ss":33,"used":true},
    {"PRN":26,"el":49,"az":245,"ss":37,"used":true},
    {"PRN":4,"el":5,"az":170,"ss":17,"used":false},
    {"PRN":138,"el":44,"az":157,"ss":40,"used":true}
  ]
}

---

🎀 METHODS PROPERTIES 🎀

The whole roster, one by one. No skips, no skimming, we're doing all of them 💪

• class — Returns the object class
• string — Returns the JSON string
• parent — Return the parent Net::GPSD object
• device — no description in the original, bestie, it's just out here existing 🌸
• tag — same vibe, no description given ✨
• time — also description-less, we don't make the rules 🦋
• timestamp — nope, nothing here either 💜
• datetime — you guessed it: no description 💅
• reported — Count of satellites in view
• used — Count of satellites used in calculation
• satellites — Returns a list of satellite data structures.

my $satellites=$sky->satellites(); #[{},...]
my @satellites=$sky->satellites(); #({},...)

• Satellites — Returns a list of Net::GPSD3::Return::Satellite objects.

my @satellites=$sky->Satellites; #(bless{},...)
my $satellites=$sky->Satellites; #[bless{},...]

Watch the capitalization, bestie — satellites (lowercase) and Satellites (capital S) are two totally different calls. One gives you plain structures, the other gives you blessed objects. Do not mix them up, I'm begging 🙏

---

💀 BUGS 💀

Log on RT and Send to gpsd-dev email list. (Yep, that's the whole thing. Found a bug? Speak up, the group chat wants to know 😭)

---

🫶 SUPPORT 🫶

DavisNetworks.com supports all Perl applications including this package. Slay 💖

Try gpsd-dev email list.

---

👑 AUTHOR 👑

Michael R. Davis
CPAN ID: MRDVT
STOP, LLC
domain=>michaelrdavis,tld=>com,account=>perl
http://www.stopllc.com/

---

📜 COPYRIGHT 📜

This program is free software licensed under the...

The BSD License

The full text of the license can be found in the LICENSE file included with this module. Read it, bestie, it's short and it matters 💜

---

🌟 SEE ALSO 🌟

• Net::GPSD3
• DateTime
• Net::GPSD3::Return::Unknown

---

And that's a wrap, fr fr 🌈 This was Net::G...rn::SKY(3pm) from perl v5.34.0, dated 2022-06-16 — thanks for coming to my TED talk, go log some satellites 🛰️✨💖