NAME

Geo::Coder::OpenCage - Geocode addresses with the OpenCage Geocoder API

DESCRIPTION

This module provides an interface to the OpenCage geocoding service.

For full details on the API visit https://opencagedata.com.

SYNOPSIS

my $geocoder = Geo::Coder::OpenCage.new: api_key => $my_api_key;
my $result = $geocoder.geocode("Donostia");

class Geo::Coder::OpenCage

That's the object you'll use to interface with the OpenCage API. It has a required attribute C, which you can obtain from http://geocoder.opencagedata.com.

method geocode

method geocode(
    Str $place-name,
    *%params
) returns Geo::Coder::OpenCage::Response

This method calls to the OpenCage API to obtain geocoding results for C<$place-name>. It returns an object with convenient access methods for all the data that the API returns. You can pass additional hints and requirements to the API through the slurpy C<%params> argument. The validity of these parameters will B be verified/enforced to ensure compatibility with potential API changes. Some of the supported arguments include: C – An IETF format language code (such as es for Spanish or pt-BR for Brazilian Portuguese); if this is omitted a code of en (English) will be assumed. C – Provides the geocoder with a hint to the country that the query resides in. This value will help the geocoder but will not restrict the possible results to the supplied country. The country code is a 3 character code as defined by the ISO 3166-1 Alpha 3 standard. As a full example: my $result = $geocoder.geocode( location => "Псковская улица, Санкт-Петербург, Россия", language => "ru", country => "rus", );

method reverse-geocode

method reverse-geocode(
    Numeric $lat,
    Numeric $lng,
    *%params
) returns Geo::Coder::OpenCage::Response

This method, as the name suggests, call the API to obtain information about places existing under the specified coordinates (C<$lat> for lattitude, C<$lng> for longtitude). Additional C<%params> can be passed according to the same rules as in the C<geocode()> method.

AUTHOR

Tadeusz Sośnierz

COPYRIGHT AND LICENSE

This library is free software; you can redistribute it and/or modify it under the Artistic License 2.0.