Geo::OSM::MapFeatures -- Parses and represents OpenStreetMap Map Features

OpenStreetMap does not have any content restrictions on tags that can
be assigned to Nodes, Ways or Areas. You can use any tags you
like. However, there is benefit in agreeing a recommended set of
features and corresponding tags in order to create, interpret and
display a common basemap. Map Features contains a core recommended
feature set and corresponding tags.

This module downloads and parses map features and tries to make it
easy access for software, something the original wiki page is most
certainly not.

INSTALLATION

To install this module, run the following commands:

	perl Makefile.PL
	make
	make test
	make install

EXAMPLE

use Geo::OSM::MapFeatures;

my $mf = new Geo::OSM::MapFeatures;
$mf->download();
$mf->parse();

# To print a simple ascii representation:
foreach my $category ( $mf->categories() ){
    print "\n\n===== $category =====\n";
    foreach my $feature ( $mf->features($category) ){
        print "$feature\n";
    }
}

# Or you can choose not to use the string overloading and get the
# individual elements yourself:
foreach my $category ( $mf->categories() ){
    print "\n\n===== $category =====\n";
    foreach my $feature ( $mf->features($category) ){
        print "Key: ".$feature->key()."\n";
        print "Value(s): ". join("\n          ", @{$feature->values()})."\n";
        print "Description: ".$feature->description()."\n\n";
    }
}

SUPPORT AND DOCUMENTATION

After installing, you can find documentation for this module with the
perldoc command.

    perldoc Geo::OSM::MapFeatures

You can also look for information at:

    RT, CPAN's request tracker
        http://rt.cpan.org/NoAuth/Bugs.html?Dist=Geo-OSM-MapFeatures

    AnnoCPAN, Annotated CPAN documentation
        http://annocpan.org/dist/Geo-OSM-MapFeatures

    CPAN Ratings
        http://cpanratings.perl.org/d/Geo-OSM-MapFeatures

    Search CPAN
        http://search.cpan.org/dist/Geo-OSM-MapFeatures


COPYRIGHT AND LICENCE

Copyright (C) 2008 Knut Arne Bjørndal

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

