map::geocode::nominatim

ИМЯ

map::geocode::nominatim - Разрешение географических названий с помощью сервиса Nominatim

Содержание

• Содержание

• Синопсис

• Описание

• API

  • Опции
  • Методы

• Ссылки

СИНОПСИС

package require Tcl 8.6 9
package require http
package require json
package require uri
package require snit
package require map::geocode::nominatim ?0.3?

::map::geocode::nominatim requestor ?-baseurl url? ?-callback callback? ?-error error callback?
$cmdprefix result
$cmdprefix errorstring
requestor search query

ОПИСАНИЕ

Этот пакет предоставляет класс для доступа к сервисам геокодирования, реализующим интерфейс Nominatim (см. Ссылки)

API

• ::map::geocode::nominatim requestor ?-baseurl url? ?-callback callback? ?-error error callback?

  Создает объект запроса геокодирования requestor, который будет отправлять свои запросы к серверу Nominatim.

  Результатом выполнения команды является name.

Опции

• -baseurl url

  Базовый URL сервиса Nominatim. Значение по умолчанию — сервис OpenStreetMap по адресу http://nominatim.openstreetmap.org/search Возможная бесплатная альтернатива находится по адресу http://open.mapquestapi.com//nominatim/v1/search

• -callback cmdprefix

  Префикс команды, вызываемый при получении результатов поиска. Настройка по умолчанию, активная, если при создании объекта ничего не было указано, выводит result (см. ниже) в stdout. Результат выполнения префикса команды игнорируется. Ошибки, сгенерированные префиксом команды, перехватываются и вызывают вызов callback-функции обработки ошибок (см. опцию -error ниже) с сообщением об ошибке в качестве аргумента.

  Сигнатура префикса команды:

  • $cmdprefix result

    Параметр result представляет собой список словарей, содержащий по одному элементу на каждое совпадение. Каждый словарь содержит следующие записи:

    • place_id

      Идентификатор места (FIXME: what's this?)

    • licence

      Строка лицензии данных

    • osm_type

      Тип местоположения OSM

    • osm_id

      FIXME

    • boundingbox

      Координаты ограничивающего прямоугольника (минимальная и максимальная широта, минимальная и максимальная долгота)

    • lat

      Широта местоположения

    • lon

      Долгота местоположения

    • display_name

      Удобочитаемое название местоположения

    • class

      FIXME

    • type

      FIXME

    • icon

      FIXME

• -error cmdprefix

  Префикс команды, вызываемый при возникновении ошибок. Обычно это ошибки HTTP. Настройка по умолчанию, активная, если при создании объекта ничего не было указано, выводит errorstring (см. ниже) в stderr. Результат выполнения префикса команды игнорируется. Ошибки, сгенерированные префиксом команды, передаются на более высокие уровни.

  Сигнатура префикса команды:

  • $cmdprefix errorstring

Методы

• requestor search query

  Этот метод возвращает список словарей, по одному элементу на каждое совпадение для указанного запроса query.

Ссылки

1. http://wiki.openstreetmap.org/wiki/Nominatim

2. http://open.mapquestapi.com/nominatim/