/ 
HTML-OSM-0.01
River stage zero No dependents
/ HTML::OSM

NAME

HTML::OSM - A module to generate an interactive OpenStreetMap with customizable coordinates and zoom level.

VERSION

Version 0.01

SYNOPSIS

HTML::OSM is a Perl module for generating an interactive map using OpenStreetMap (OSM) and Leaflet. The module accepts a list of coordinates with optional labels and zoom level to create a dynamic HTML file containing an interactive map. The generated map allows users to view marked locations, zoom, and search for locations using the Nominatim API.

    use HTML::OSM;
    my $map = HTML::OSM->new();
    # ...

    $map = HTML::OSM->new(
	  coordinates => [
		  [34.0522, -118.2437, 'Los Angeles'],
		  [undef, undef, 'Paris'],
	  ],
	  zoom => 14,
    );
    my ($head, $map_div) = $map->onload_render();

SUBROUTINES/METHODS

new

    $map = HTML::OSM->new(
	  coordinates => [
		  [37.7749, -122.4194, 'San Francisco'],
		  [40.7128, -74.0060, 'New York'],
		  [51.5074, -0.1278, 'London'],
	  ],
	  zoom => 10,
    );

Creates a new HTML::OSM object with the provided coordinates and optional zoom level.

  • coordinates

    An array reference containing a list of coordinates. Each entry should be an array with latitude, longitude, and an optional label, in the format:

    [latitude, longitude, label, icon_url]

    If latitude and/or longitude is undefined, the label is taken to be a location to be added. If no coordinates are provided, an error will be thrown.

  • geocoder

    An optional geocoder object such as Geo::Coder::List or Geo::Coder::Free.

  • height

    Height (in pixels or using your own unit), the default is 500px.

  • width

    Width (in pixels or using your own unit), the default is 100%.

  • zoom

    An optional zoom level for the map, with a default value of 12.

add_marker

Add a marker to the map at the given point. A point can be a unique place name, like an address, an object that understands latitude() and longitude(), or a pair of coordinates passed in as an arrayref: [ longitude, latitude ]. Will return 0 if the point is not found and 1 on success.

It takes two optional arguments:

  • html

    Add a popup info window as well.

  • icon

    A url to the icon to be added

center

Center the map at a given point. Returns 1 on success, 0 if the point could not be found.

zoom

Get/set the new zoom level (0 is corsest)

$map->zoom(10);

onload_render

Renders the map and returns a two element list. The first element needs to be placed in the head section of your HTML document. The second in the body where you want the map to appear.

AUTHOR

Nigel Horne, <njh at bandsman.co.uk>

BUGS

SEE ALSO

You can find documentation for this module with the perldoc command.

perldoc HTML::OSM

You can also look for information at:

SUPPORT

This module is provided as-is without any warranty.

Please report any bugs or feature requests to bug-html-osm at rt.cpan.org, or through the web interface at http://rt.cpan.org/NoAuth/ReportBug.html?Queue=HTML-OSM. I will be notified, and then you'll automatically be notified of progress on your bug as I make changes.

TODO

Allow dynamic addition/removal of markers via user input.

LICENSE AND COPYRIGHT

Copyright 2025 Nigel Horne.

This program is released under the following licence: GPL2