oracular (3) HTML::Microformats::Format::geo.3pm.gz

NAME

       HTML::Microformats::Format::geo - the geo microformat

SYNOPSIS

        use Data::Dumper;
        use HTML::Microformats::DocumentContext;
        use HTML::Microformats::Format::geo;

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

DESCRIPTION

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

   Additional Method
       •   "to_kml"

           This method exports the geo object as KML. It requires RDF::KML::Exporter to work, and will throw an
           error at run-time if it's not available.

MICROFORMAT

       HTML::Microformats::Format::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::Format, HTML::Microformats, HTML::Microformats::Format::hCard.

AUTHOR

       Toby Inkster <tobyink@cpan.org>.

COPYRIGHT AND LICENCE

       Copyright 2008-2012 Toby Inkster

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

DISCLAIMER OF WARRANTIES

       THIS PACKAGE IS PROVIDED "AS IS" AND WITHOUT ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, WITHOUT
       LIMITATION, THE IMPLIED WARRANTIES OF MERCHANTIBILITY AND FITNESS FOR A PARTICULAR PURPOSE.