Добрый день всем.
В последующем примере показано как получать сделать интеграцию с картами Визиком согласно ихнему API:
http://maps.visicom.ua/api-docs/
Описание функций:
GetCityListFromVisicom - получения списка городов по имени. Пока ищет только по имени населенного пункта. Визиком пока не поддерживает фильтрацию по областям/странам. Так что остальные параметры "на будущее".
Возвращает объект с такими свойствами:
- errorMessage - строка. Ошибка получения данных (если она была)
- warning - true/false. Если ошибка - не критичная (например, не было найдено городов). К сожалению, Визиком не позволяет различить предупреждения и возврат пустых данных.
- data - масив. Список городов. Возвращает список объектов с такими(строковыми) полями:
- id - по этому идентификатору можно получить координаты объекта (см. ниже)
- name - название города.
- 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 и юзайте на здоровье.