debian man page for html::microformats::format::geo

HTML::Microformats::Format::geo(3pm)			User Contributed Perl Documentation		      HTML::Microformats::Format::geo(3pm)

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
", $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
       o   "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:

       o   '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>

       o   '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
       Copyright 2008-2011 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.

perl v5.14.2							    2011-12-06				      HTML::Microformats::Format::geo(3pm)