Интеграция с картами Визиком

Добрый день всем.

В последующем примере показано как получать сделать интеграцию с картами Визиком согласно ихнему API:
http://maps.visicom.ua/api-docs/

Описание функций:
GetCityListFromVisicom - получения списка городов по имени. Пока ищет только по имени населенного пункта. Визиком пока не поддерживает фильтрацию по областям/странам. Так что остальные параметры "на будущее".
Возвращает объект с такими свойствами:

• errorMessage - строка. Ошибка получения данных (если она была)
• warning - true/false. Если ошибка - не критичная (например, не было найдено городов). К сожалению, Визиком не позволяет различить предупреждения и возврат пустых данных.
• data - масив. Список городов. Возвращает список объектов с такими(строковыми) полями:

1. id - по этому идентификатору можно получить координаты объекта (см. ниже)
2. name - название города.
3. description - описание (из которого можна вытянуть область и район населенного пункта (см. ниже)

GetObjectPoint - получение координат объекта по его идентификатору(id).
Возвращает объект с такими свойствами:

• errorMessage - строка. Ошибка получения данных (если она была)
• warning - true/false. Если ошибка - не критичная (например, не было найдено координат). 
• point - объект. Координаты пункта. Содержит строковые поля lat и lng.

GetDatabases - возвращает список баз Визикома. В данном пример и спользуется русские названия городов. Для пролучения украинских названий - нужно расширить функциональность.

GetLayers - более глубокая функция. Возвращает список административных слоев(см. API).

ParseDescription - парсит полученное описание населенного пункта(description) для получения области и района. Возвращает либо null либо объект со строковыми полями stateRegion и state.

Для использования функциональности Вам нужен будет лицензионный ключ для API. В примере указана просто строка LICENSEKEY. Подробнее об этом - http://maps.visicom.ua/ru/api-docs/vxmlapi/

Вроде все. Подключайте scr_Utils и юзайте на здоровье.