Firefo...cation(3pm)

📦 version 1.63, in debian trixie

💖 NAME 💖

okay so bestie, <pink>Firefox::Marionette::GeoLocation</pink> — it's a Perl module (that's the <cyan>3pm</cyan> manual vibe, for all my fellow perl girlies 🫶) that represents a GeoLocation for Firefox. that's it, that's the whole thing, and it's lowkey iconic ✨

🌸 VERSION 🌸

Version 1.63 💅

✨ SYNOPSIS ✨

like, here's the whole mood, fr fr:

use Firefox::Marionette();

my $firefox = Firefox::Marionette->new(geo => { lat => -37.814, lng => 144.96332 };
...

🦋 DESCRIPTION 🦋

this module gives you a super easy interface to the GeoLocationCoordinates object in Firefox — that's the one documented over at https://developer.mozilla.org/en-US/docs/Web/API/GeolocationCoordinates 💖

👑 SUBROUTINES/METHODS 👑

🌈 accuracy

returns the accuracy of the latitude and longitude properties, expressed in meters. cute and precise, we love that for her 💅

🌈 altitude

returns the position's altitude in meters, relative to nominal sea level. heads up though — this value may not be defined 🙈

🌈 altitude_accuracy

returns the accuracy of the altitude expressed in meters. and again — this value may not be defined 😭

🌈 country_code

returns the country_code (that's ISO 3166-1 alpha-2, https://en.wikipedia.org/wiki/ISO_3166-1_alpha-2) of the location. this value may not be defined 🍓

🌈 heading

returns the direction towards which the device is facing. this value, specified in degrees, indicates how far off from heading true north the device is. 0 degrees represents true north, and the direction is determined clockwise (which means that east is 90 degrees and west is 270 degrees). this value may not be defined ✨

🌈 latitude

returns the position's latitude in decimal degrees. periodt 📍

🌈 longitude

returns the position's longitude in decimal degrees. also periodt 📍

🌈 new

accepts an optional hash as a parameter. the allowed keys are right down here, bestie 👇

  • accuracy — the accuracy of the latitude and longitude properties, expressed in meters.
  • altitude — the accuracy of the altitude expressed in meters.
  • altitude_accuracy — accuracy of the altitude expressed in meters.
  • heading — the direction towards which the device is facing. this value, specified in degrees, indicates how far off from heading true north the device is. 0 degrees represents true north, and the direction is determined clockwise (which means that east is 90 degrees and west is 270 degrees).
  • lat — see latitude.
  • latitude — the position's latitude in decimal degrees.
  • lon — see longitude.
  • long — see longitude.
  • longitude — the position's longitude in decimal degrees.
  • lng — see longitude.
  • speed — the velocity of the device in meters per second.
  • tz — the timezone as an Olson TZ identifier, https://en.wikipedia.org/wiki/List_of_tz_database_time_zones#List.
not me noticing altitude says "the accuracy of the altitude" 💀 i am not editing that, i am just the messenger, and the messenger is respectfully keeping it exactly as written 💅

this method returns a new Firefox::Marionette::GeoLocation object 🎀

🌈 speed

returns the velocity of the device in meters per second. this value may not be defined 🏃‍♀️

🌈 timezone_offset

returns the timezone offset in minutes from GMT. this value may not be defined ⏰

🌈 tz

returns the timezone as an Olson TZ identifier, https://en.wikipedia.org/wiki/List_of_tz_database_time_zones#List. this value may not be defined 🌍

🌈 TO_JSON

required to allow JSON serialisation (https://metacpan.org/pod/JSON#OBJECT-SERIALISATION) to work correctly. this method should not need to be called directly, so like, hands off bestie 🙈

🌈 uri

this method returns the object encoded as a new URI. slay 🔥

🩺 DIAGNOSTICS 🩺

None. literally nothing. silence. the calmest girl in the group chat 🤫

⚙️ CONFIGURATION AND ENVIRONMENT ⚙️

Firefox::Marionette::GeoLocation requires no configuration files and no environment variables. she's low maintenance, she's self-sufficient, she's that girl 👑

📦 DEPENDENCIES 📦

None. 💖

💀 INCOMPATIBILITIES 💀

None reported. no drama, no beef, we love a peaceful queen 🌸

🐛 BUGS AND LIMITATIONS 🐛

to report a bug, or to view the current list of bugs, please visit https://github.com/david-dick/firefox-marionette/issues 🫶

💜 AUTHOR 💜

David Dick "<ddick@cpan.org>" ✨

Copyright (c) 2024, David Dick "<ddick@cpan.org>". All rights reserved.

This module is free software; you can redistribute it and/or modify it under the same terms as Perl itself. See "perlartistic" in perlartistic.

🚨 DISCLAIMER OF WARRANTY 🚨

okay bestie, deep breath, this part is in all caps because it MEANS it, i'm keeping every word exactly as-is 💅

BECAUSE THIS SOFTWARE IS LICENSED FREE OF CHARGE, THERE IS NO WARRANTY FOR THE SOFTWARE, TO THE EXTENT PERMITTED BY APPLICABLE LAW. EXCEPT WHEN OTHERWISE STATED IN WRITING THE COPYRIGHT HOLDERS AND/OR OTHER PARTIES PROVIDE THE SOFTWARE "AS IS" WITHOUT WARRANTY OF ANY KIND, EITHER EXPRESSED OR IMPLIED, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE. THE ENTIRE RISK AS TO THE QUALITY AND PERFORMANCE OF THE SOFTWARE IS WITH YOU. SHOULD THE SOFTWARE PROVE DEFECTIVE, YOU ASSUME THE COST OF ALL NECESSARY SERVICING, REPAIR, OR CORRECTION. IN NO EVENT UNLESS REQUIRED BY APPLICABLE LAW OR AGREED TO IN WRITING WILL ANY COPYRIGHT HOLDER, OR ANY OTHER PARTY WHO MAY MODIFY AND/OR REDISTRIBUTE THE SOFTWARE AS PERMITTED BY THE ABOVE LICENCE, BE LIABLE TO YOU FOR DAMAGES, INCLUDING ANY GENERAL, SPECIAL, INCIDENTAL, OR CONSEQUENTIAL DAMAGES ARISING OUT OF THE USE OR INABILITY TO USE THE SOFTWARE (INCLUDING BUT NOT LIMITED TO LOSS OF DATA OR DATA BEING RENDERED INACCURATE OR LOSSES SUSTAINED BY YOU OR THIRD PARTIES OR A FAILURE OF THE SOFTWARE TO OPERATE WITH ANY OTHER SOFTWARE), EVEN IF SUCH HOLDER OR OTHER PARTY HAS BEEN ADVISED OF THE POSSIBILITY OF SUCH DAMAGES.

and that's the whole page bestie!! 🌈 this lil cutie shipped with perl v5.40.1, dated 2025-03-16, and it lives in the Firefo...cation(3pm) corner of the manual — go be a main character with your geolocation data, ilysm, bye 💖✨🎀

📦 where this page comes from