Maiden-Location

About

This provides an agent and some functions to perform geolocation. It allows retrieving the address of an ambiguous location, as well as getting the exact geological latitude and longitude coordinates of a place. This is done through the Google Maps geocoding API.

Copyright

maiden-location is licensed under the Artistic license. © Nicolas Hafner <shinmera@tymoon.eu> . This library can be obtained on https://github.com/Shinmera/maiden.

Package Index

MAIDEN-LOCATION (ORG.SHIRAKUMO.MAIDEN.AGENTS.LOCATION)

class

`LOCATION`

This agent helps with location information such as geocoding using the Google Maps API.

function (

`ADDRESS`

LOCATION)

Attempt to find the closes address for the location.

See GEO-INFORMATION

function (

`COORDINATES`

LOCATION)

Return the coordinates of a location.

Returns two values:
- A list of the latitude and longitude of the location
- The long name of the resolved address of the location

See GEO-INFORMATION

function (

`GEO-INFORMATION`

LOCATION)

Retrieve geolocation information about the given location.

Errors are signalled in the following cases:
- No results could be found for the location
- You exceeded the maximum number of queries allowed
- Some other failure on behalf of the Google API.

See *GEOCODE-API*