map::geocode::nominatim(3tcl) Mapping utilities map::geocode::nominatim(3tcl)
______________________________________________________________________________
NAME
map::geocode::nominatim - Resolving geographical names with a Nominatim
service
SYNOPSIS
package require Tcl 8.5
package require http
package require json
package require uri
package require snit
package require map::geocode::nominatim ?0.1?
::map::geocode::nominatim requestor ?-baseurl url? ?-callback callback?
?-error error callback?
$cmdprefix result
$cmdprefix errorstring
requestor search query
______________________________________________________________________________
DESCRIPTION
This package provides a class for accessing geocoding services which
implement the Nominatim interface (see References)
API
::map::geocode::nominatim requestor ?-baseurl url? ?-callback callback?
?-error error callback?
Creates a geocoding request object requestor, which will send
its requests to the Nominatim server.
The result of the command is name.
OPTIONS
-baseurl url
The base URL of the Nominatim service. Default value is Open-
StreetMap's service at http://nominatim.openstreetmap.org/search
A possible free alternative is at
http://open.mapquestapi.com//nominatim/v1/search
-callback cmdprefix
A command prefix to be invoked when search result become avail-
able. The default setting, active when nothing was specified on
object creation, is to print the result (see below) to stdout.
The result of the command prefix is ignored. Errors thrown by
the command prefix are caught and cause the invokation of the
error callback (see option -error below), with the error message
as argument.
The signature of the command prefix is:
$cmdprefix result
The result is a list of dictionaries, containing one item
per hit. Each dictionary will have the following en-
tries:
place_id
The place ID (FIXME: what's this?)
licence
The data licence string
osm_type
The OSM type of the location
osm_id FIXME
boundingbox
The coordinates of the bounding box (min and max
latitude, min and max longitude)
lat The location's latitude
lon The location's longitude
display_name
the location's human readable name
class FIXME
type FIXME
icon FIXME
-error cmdprefix
A command prefix to be invoked when encountering errors. Typi-
cally these are HTTP errors. The default setting, active when
nothing was specified on object creation, is to print the er-
rorstring (see below) to stderr. The result of the command pre-
fix is ignored. Errors thrown by the command prefix are passed
to higher levels.
The signature of the command prefix is:
$cmdprefix errorstring
METHODS
requestor search query
This method returns a list of dictionaries, one item per hit for
the specified query.
REFERENCES
[1] http://wiki.openstreetmap.org/wiki/Nominatim
[2] http://open.mapquestapi.com/nominatim/
KEYWORDS
geocoding, http, location, map, nominatim, server, url
tcllib 0.1 map::geocode::nominatim(3tcl)