NAME

HTML::Microformats::geo - the geo microformat

SYNOPSIS

use Data::Dumper;
use HTML::Microformats::_context;
use HTML::Microformats::geo;

my $context = HTML::Microformats::_context->new($dom, $uri);
my @geos    = HTML::Microformats::geo->extract_all(
                  $dom->documentElement, $context);
foreach my $geo (@geos)
{
  printf("%s;%s\n", $geo->get_latitude, $geo->get_longitude);
}

DESCRIPTION

HTML::Microformats::geo inherits from HTML::Microformats::BASE. See the base class definition for a description of property getter/setter methods, constructors, etc.

MICROFORMAT

HTML::Microformats::geo supports geo as described at http://microformats.org/wiki/geo, with the following additions:

  • 'altitude' property

    You may provide an altitude as either a number (taken to be metres above sea level) or an embedded hMeasure. e.g.:

    <span class="geo">
     lat:  <span class="latitude">12.34</span>,
     long: <span class="longitude">56.78</span>,
     alt:  <span class="altitude">90</span> metres.
    </span>
    
    <span class="geo">
     lat:  <span class="latitude">12.34</span>,
     long: <span class="longitude">56.78</span>,
     alt:  <span class="altitude hmeasure">
             <span class="num">90</span>
             <span class="unit">m</span>
           </span>.
    </span>
  • 'body' and 'reference-frame'

    The geo microformat is normally only defined for WGS84 co-ordinates on Earth. Using 'body' and 'reference-frame' properties (each of which take string values), you may give co-ordinates on other planets, asteroids, moons, etc; or on Earth but using a non-WGS84 system.

RDF OUTPUT

Data is returned using the W3C's vCard vocabulary (http://www.w3.org/2006/vcard/ns#) and the W3C's WGS84 vocabulary (http://www.w3.org/2003/01/geo/wgs84_pos#).

For non-WGS84 co-ordinates, UNGEO (http://buzzword.org.uk/rdf/ungeo#) is used instead.

BUGS

Please report any bugs to http://rt.cpan.org/.

SEE ALSO

HTML::Microformats::BASE, HTML::Microformats, HTML::Microformats::hCard.

AUTHOR

Toby Inkster <tobyink@cpan.org>.

COPYRIGHT

Copyright 2008-2010 Toby Inkster

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