NAME

Geo::Walkabout::Utils - Utility functions for Geo::Walkabout.

DESCRIPTION

These are functions I'm playing around with. Most likely they will be broken up into other libraries and reworked, so don't be surprised if all this changes.

Functions

find_address

  my $line = find_address({fedirp       => $dirp,
                           fename       => $name,
                           fetype       => $type,
                           fedirs       => $dirs,

                           addr_num     => $num,
                           zip          => $zip,
                          });

Finds a line feature from its name and zip. (Eventually city and state instead of zip).

NOTE fedirs and fedirp are currently ignored.

in_range

  my @lines = in_range([$long, $lat], $range);

Returns all line features in a circular $range of the given point ($long, $lat).

get_line_feature

  my @feature = get_line_feature({
                                  fedirp => $fedirp,
                                  fename => $fename,
                                  fetype => $fetype,
                                  fedirs => $fedirs,

                                  zip    => $zip,
                                 }); 

Returns all connected line features of the feature which passes through the given zip code.

NOTE I don't think this quite gets the entire road.

NOTE zip, fedirp and fedirs are currently ignored.

get_zip

  my @lines = get_zip($zip);

Get all lines in a given zip code.

bounding_box

  my $box = bounding_box_zip($zip);

Returns the two point box bounding this zip code. $box->[0] upper-right, $box->[1] is lower-left.

find_intersection

  @lines = find_intersection({fename => $fe_name,
                              fetype => $fe_type,
                             },
                             {fename => $fe_name,
                              fetype => $fe_type,
                             },
                             $zip
                            );

Finds the given cross-street, returning all lines which share in this intersection.

AUTHOR

Michael G Schwern <schwern@pobox.com>