|
|
Tor 0.2.0.32 (Default branch)
12-05-2008
Tor is a network of virtual tunnels that allows people and groups to improve their privacy and security on the Internet. It also enables software developers to create new communication tools with built-in privacy features. It provides the foundation for a range of applications that allow organizations and individuals to share information over public networks without compromising their privacy. Individuals can use it to keep remote Websites from tracking them and their family members. They can also use it to connect to resources such as news sites or instant messaging services that are blocked by their local Internet service providers (ISPs). License: BSD License (revised)Changes:|
|
Geo::Coder::Googlev3(3pm) User Contributed Perl Documentation Geo::Coder::Googlev3(3pm) NAME
Geo::Coder::Googlev3 - Google Maps v3 Geocoding API SYNOPSIS
use Geo::Coder::Googlev3; my $geocoder = Geo::Coder::Googlev3->new; my $location = $geocoder->geocode(location => 'Brandenburger Tor, Berlin'); my @locations = $geocoder->geocode(location => 'Berliner Strasse, Berlin, Germany'); DESCRIPTION
Use this module just like Geo::Coder::Google. Note that no "apikey" is used in Google's v3 API, and the returned data structure differs. Please check also <http://code.google.com/intl/en/apis/maps/documentation/geocoding/> for more information about Google's Geocoding API and especially usage limits. CONSTRUCTOR new $geocoder = Geo::Coder::Googlev3->new; $geocoder = Geo::Coder::Googlev3->new(language => 'de', gl => 'es'); Creates a new geocoding object. The "ua" parameter may be supplied to override the default LWP::UserAgent object. The default "LWP::UserAgent" object sets the "timeout" to 15 seconds and enables the "env_proxy" option. The Geo::Coder::Google's "oe" and "apikey" parameters are not supported. The parameters "region", "language", and "bounds" are also accepted. The "bounds" parameter should be in the form: [{lat => ..., lng => ...}, {lat => ..., lng => ...}] METHODS geocode $location = $geocoder->geocode(location => $location); @locations = $geocoder->geocode(location => $location); Queries $location to Google Maps geocoding API. In scalar context it returns a hash reference of the first (best matching?) location. In list context it returns a list of such hash references. The returned data structure looks like this: { "formatted_address" => "Brandenburger Tor, Pariser Platz 7, 10117 Berlin, Germany", "types" => [ "point_of_interest", "establishment" ], "address_components" => [ { "types" => [ "point_of_interest", "establishment" ], "short_name" => "Brandenburger Tor", "long_name" => "Brandenburger Tor" }, { "types" => [ "street_number" ], "short_name" => 7, "long_name" => 7 }, { "types" => [ "route" ], "short_name" => "Pariser Platz", "long_name" => "Pariser Platz" }, { "types" => [ "sublocality", "political" ], "short_name" => "Mitte", "long_name" => "Mitte" }, { "types" => [ "locality", "political" ], "short_name" => "Berlin", "long_name" => "Berlin" }, { "types" => [ "administrative_area_level_2", "political" ], "short_name" => "Berlin", "long_name" => "Berlin" }, { "types" => [ "administrative_area_level_1", "political" ], "short_name" => "Berlin", "long_name" => "Berlin" }, { "types" => [ "country", "political" ], "short_name" => "DE", "long_name" => "Germany" }, { "types" => [ "postal_code" ], "short_name" => 10117, "long_name" => 10117 } ], "geometry" => { "viewport" => { "southwest" => { "lat" => "52.5094785", "lng" => "13.3617711" }, "northeast" => { "lat" => "52.5230586", "lng" => "13.3937859" } }, "location" => { "lat" => "52.5162691", "lng" => "13.3777785" }, "location_type" => "APPROXIMATE" } }; The raw option may be set to a true value to get the uninterpreted, raw result from the API. Just the JSON data will be translated into a perl hash. $raw_result = $geocoder->geocode(location => $location, raw => 1); region Accessor for the "region" parameter. The value should be a country code ("es", "dk", "us", etc). Use this to tell the webservice to prefer matches from that region. See the Google documentation for more information. language Accessor for the "language" parameter. bounds Accessor for the "bounds" parameter. AUTHOR
Slaven Rezic <srezic@cpan.org> This package is free software; you can redistribute it and/or modify it under the same terms as Perl itself. SEE ALSO
Geo::Coder::Google, Geo::Coder::Many. perl v5.14.2 2011-12-22 Geo::Coder::Googlev3(3pm)