Geo::Coder::TomTom - Geocode addresses with the TomTom Map Toolkit API
use Geo::Coder::TomTom; my $geocoder = Geo::Coder::TomTom->new(apikey => 'Your API key'); my $location = $geocoder->geocode( location => 'De Ruijterkade 154, Amsterdam, NL' );
The Geo::Coder::TomTom module provides an interface to the TomTom Map Toolkit geocoding service.
Geo::Coder::TomTom
$geocoder = Geo::Coder::TomTom->new('Your API key') $geocoder = Geo::Coder::TomTom->new( apikey => 'Your API key', # debug => 1, )
Creates a new geocoding object.
Accepts the following named arguments:
apikey
An API key (required)
An API key can be obtained here: http://developer.tomtom.com/apps/mykeys
ua
A custom LWP::UserAgent object. (optional)
compress
Enable compression. (default: 1, unless debug is enabled)
debug
Enable debugging. This prints the headers and content for requests and responses. (default: 0)
$location = $geocoder->geocode(location => $location) @locations = $geocoder->geocode(location => $location)
In scalar context, this method returns the first location result; and in list context it returns all location results.
Each location result is a hashref; a typical example looks like:
{ "latitude": 52.3773852, "longitude": 4.9094794, "geohash": "u173zxnbrhm0", "mapName": "TomTomMap", "houseNumber": "154", "type": "house", "street": "De Ruijterkade", "alternativeStreetName": [], "city": "Amsterdam", "district": "Amsterdam", "country": "The Netherlands", "countryISO3": "NLD", "postcode": "1011 AC", "formattedAddress": "De Ruijterkade 154, 1011 AC Amsterdam, Amsterdam, NL", "isCensusMicropolitanFlag": false, "widthMeters": 1, "heightMeters": 1, "score": 1.0, "confidence": 0.40665394, "iteration": 0 },
$response = $geocoder->response()
Returns an HTTP::Response object for the last submitted request. Can be used to determine the details of an error.
$ua = $geocoder->ua() $ua = $geocoder->ua($ua)
Accessor for the UserAgent object.
http://developer.tomtom.com/docs/read/map_toolkit/web_services/geocoding_single_call
Please report any bugs or feature requests to http://rt.cpan.org/Public/Bug/Report.html?Queue=Geo-Coder-TomTom. I will be notified, and then you'll automatically be notified of progress on your bug as I make changes.
You can find documentation for this module with the perldoc command.
perldoc Geo::Coder::TomTom
You can also look for information at:
GitHub Source Repository
http://github.com/gray/geo-coder-tomtom
AnnoCPAN: Annotated CPAN documentation
http://annocpan.org/dist/Geo-Coder-TomTom
CPAN Ratings
http://cpanratings.perl.org/d/Geo-Coder-TomTom
RT: CPAN's request tracker
http://rt.cpan.org/Public/Dist/Display.html?Name=Geo-Coder-TomTom
Search CPAN
http://search.cpan.org/dist/Geo-Coder-TomTom/
Copyright (C) 2010-2015 gray <gray at cpan.org>, all rights reserved.
This library is free software; you can redistribute it and/or modify it under the same terms as Perl itself.
gray, <gray at cpan.org>
To install Geo::Coder::TomTom, copy and paste the appropriate command in to your terminal.
cpanm
cpanm Geo::Coder::TomTom
CPAN shell
perl -MCPAN -e shell install Geo::Coder::TomTom
For more information on module installation, please visit the detailed CPAN module installation guide.