find( %args )

Takes any number of the named parameters below.

Optionally applies set operations on the result set.

Returns a new App::PortDistances::DB object containing filtered results.

name => $name

Find port by exact name match.

aname => $aname

Find port(s) by approximate name match using String::Approx.

country => $country

Find port by exact country match.

quadrant => NE|NW|SW|SE

hemisphere => N|S

Find port(s) by broad region.

latitude => $lat

longitude => $lon

radius => $radius

Find port(s) by proximity within given radius, in miles (using GIS::Distance), and given latitude and longitude coordinates, in decimal degree format.

intersect => 0|1

Compute intersection instead of union of results if more than one search criteria is specified.

complement => 0|1

Return set difference between ports in DB and ports computed by find()