NAME

Geo::Routing::Driver::Gosmore - Gosmore driver for Geo::Routing

SYNOPSIS

First install gosmore(1), e.g. on Debian:

    sudo aptitude install gosmore

Then build a gosmore.pak file:

    wget http://download.geofabrik.de/osm/europe/british_isles.osm.bz2
    # pv(1) is not needed, it just shows you the import progress
    bzcat british_isles.osm.bz2 | pv | gosmore rebuild

Then use this library, with gosmore_path being the full path to your new gosmore.pak.

    my $gosmore = Geo::Routing->new(
        gosmore_path => $gosmore_path,
    );

    my $query = Geo::Gosmore::Query->new(
        flat => '51.5425',
        flon => '-0.111',
        tlat => '51.5614',
        tlon => '-0.0466',
        fast => 1,
        v    => 'motorcar',
    );

    # Returns false if we can't find a route
    my $route = $gosmore->route($query);
    my $distance = $route->distance;

DESCRIPTION

Provides an interface to the headless version of the gosmore routing library. When compiled with headless support it provides a simple interface to do routing. This library just parses its simple output and provides accessors for it.

We also support accessing the headless gosmore(1) program through a remote CGI interface.

ATTRIBUTES

gosmore_method

Either binary or http. If binary "gosmore_path" is a path to a gosmore.pak and we'll invoke gosmore(1) from your $PATH.

If it's http "gosmore_path" is a URL to an online gosmore router.

gosmore_path

Either a path to a gosmore.pak (see "gosmore_method") or a HTTP URL to a gosmore CGI routing script without query parameters.