Geo::G...cemark(3pm)

πŸ“¦
version 0.17 Β· 2 versions
, in debian bookworm, debian trixie, ubuntu jammy, ubuntu noble, ubuntu resolute

πŸ’– NAME πŸ’–

Geo::GoogleEarth::Pluggable::Placemark β€” the Base Object for all the Geo::GoogleEarth::Pluggable Placemarks. it's giving founding mother energy, fr fr πŸ‘‘

this one lives in the User Contributed Perl Documentation section of your manual pages, bestie, so you already know it's community-made and iconic for it ✨


πŸŽ€ SYNOPSIS πŸŽ€

use base qw{Geo::GoogleEarth::Pluggable::Placemark};

that's literally it. you inherit and suddenly you're a placemark. no cap. πŸ¦‹


🌸 DESCRIPTION 🌸

okay so listen. this package? it's the base of ALL the Geo::GoogleEarth::Pluggable packages. every single one. it's the mom friend of the module family and we respect her πŸ’…


✨ USAGE ✨

(the original just says "USAGE" and then moves on to methods β€” so here we are, vibing, moving on to methods) πŸ™ˆ


πŸ’œ METHODS πŸ’œ

🌈 type

(no description given in the original β€” it's just out here existing, mysterious main character energy) ⭐

πŸ“ style

Sets or returns the Placemark Style or StyleMap object.

and here's the tea: style=>$style is a little shortcut for styleUrl=>$style->url. cute, right? πŸŽ€

πŸ¦‹ styleUrl

This one overrides style->url if it's defined. so if both are hanging around, styleUrl wins. periodt. πŸ‘‘

🌸 LookAt

Sets or returns the LookAt Object. that's the whole description. iconic brevity honestly ✨

πŸ’– visibility

Sets or returns visibility. the value is either 1 or 0, but it defaults to undef β€” and undef is the same as 1, bestie. don't let the undef scare you, it's friendly πŸ’…

my $visibility=$placemark->visibility;

⭐ node

(no description in the original β€” it's just there, standing in the corner, being a node) 🫢

🧚 coordinates

The coordinates array is used consistantly (yes, that's the original's spelling, we keep the facts EXACTLY as they are, no cap) for all placemark objects. so you can hand it a bunch of different kinds of things and it just gets it:

my $coordinates=$placemark->coordinates(
                            [
                              [$lon, $lat, $alt],
                              {lat=>$lat, lon=>$lon, alt=>$alt},
                              GPS::Point,
                              Geo::Point,
                              Net::GPSD::Point,
                            ]
                          );

my $coordinates=$placemark->coordinates(
                           Geo::Line,          #TODO
                          );
πŸ‘€ note that Geo::Line has a #TODO next to it in the original β€” so like, it's noted but not done. we're just reporting the vibes, not fixing them πŸŽ€

πŸ’œ coordinates_stringify

(no description in the original β€” a quiet queen) πŸŒ™

🌈 point_stringify

my $string=$placemark->point_stringify($point); #returns "$lon,$lat,$alt"

hands you back a string in "$lon,$lat,$alt" order. chef's kiss formatting πŸ“

✨ point_normalize

Most of this code was taken from GPS::Point->initializeMulti. credit where credit is due, bestie 🫢

my $data=$placemark->point_normalize($point); #returns {lat=>$lat,lon=>$lon,alt=>$alt}

returns you a hashref like {lat=>$lat,lon=>$lon,alt=>$alt}. slay. πŸ’…


πŸ’€ BUGS πŸ’€

Please log on RT and send to the geo-perl email list.

that's it. that's the bug policy. they're not playing, they want the receipts filed properly πŸ“


🫢 SUPPORT 🫢

DavisNetworks.com supports all Perl applications including this package. shoutout to them honestly, that's a lot of Perl πŸ’–


πŸ‘‘ AUTHOR πŸ‘‘

Michael R. Davis (mrdvt92)
CPAN ID: MRDVT

put some respect on the name ✨


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. go read it, it's important, fr fr πŸ“–


🌟 SEE ALSO 🌟

  • Geo::GoogleEarth::Pluggable
  • Scalar::Util
  • XML::LibXML::LazyBuilder

go check 'em out, they're the extended universe πŸ’«


and that's the whole page, bestie!! this one's from perl v5.32.1, dated 2021-11-28, filed under the User Contributed Perl Documentation section of the manual. mwah, take care of her πŸ’…πŸ’–βœ¨

πŸ“¦ where this page comes from