NAME

WWW::MetaForge::GameMapData::Result::MapMarker - Base map marker result object for MetaForge Game Map Data API

VERSION

version 0.002

SYNOPSIS

my $markers = $api->map_data(map => 'dam');
for my $marker (@$markers) {
    say "Marker at " . $marker->lng . ", " . $marker->lat;
}

DESCRIPTION

Base class for map marker objects from the MetaForge Game Map Data API. Contains only generic fields common to all games.

Game-specific distributions should subclass this to add game-specific attributes (like category, subcategory for ARC Raiders).

id

Unique marker identifier (UUID).

lat

Latitude (Y coordinate) on the map.

lng

Longitude (X coordinate) on the map.

zlayers

Z-layer value for elevation/floor.

mapID

Map identifier (e.g., "dam", "spaceport").

updated_at

ISO timestamp of last update.

added_by

Username who added this marker.

last_edited_by

Username who last edited this marker.

from_hashref

my $marker = WWW::MetaForge::GameMapData::Result::MapMarker->from_hashref(\%data);

Construct from API response hash. Subclasses should override this to handle game-specific fields.

x

Alias for lng.

y

Alias for lat.

z

Alias for zlayers.

coordinates

my $coords = $marker->coordinates;
# { x => 123.5, y => 78.1 }

Returns HashRef of coordinates.

SUPPORT

Issues

Please report bugs and feature requests on GitHub at https://github.com/Getty/p5-www-metaforge/issues.

IRC

You can reach Getty on irc.perl.org for questions and support.

CONTRIBUTING

Contributions are welcome! Please fork the repository and submit a pull request.

AUTHOR

Torsten Raudssus <torsten@raudssus.de>

COPYRIGHT AND LICENSE

This software is copyright (c) 2026 by Torsten Raudssus.

This is free software; you can redistribute it and/or modify it under the same terms as the Perl 5 programming language system itself.