Инфографика Инструменты Visualize! geoInf.js Контакты

Inf

Inf()

Конструктор объекта карты. Все дальнейшие манипуляции по добавлению слоёв проводятся именно с ним. При создании не забудьте оператор new !

Аргументы

holder DOM object div, в котором разместится карта

или

holderId string его атрибут id

Возвращает

object Inf-объект

Inf.draw()

Создает и добавляет на карту векторный слой из указанного файла в формате geojson.

Аргументы

url string url валидного geojson-файла, из которого будет взята геометрия для построения слоя

name string короткое описание слоя, которое будет видно только в окошке управления видимостью слоёв

options object объект вида {'latScale': number, 'lonScale': number, 'padding': number}

latScale и lonScale - масштабные коэфициенты для растяжения/сжатия изображения по широте и долготе соответственно. Коэфициенты, заданные для первого созданного слоя, применяются затем ко всем остальным слоям.

padding - минимальные отступы от края карты до изображения

Возвращает

object Layer-объект

Inf.choropleth()

Создает и добавляет на карту векторный слой-картограмму из указанного файла в формате geojson. Файл должен содержать описания полигональной/мультиполигональной геометрии, а также значения некоторого атрибута (атрибутов), по которым строится картограмма. Цветовую схему и разбиение значений на ступени шкалы задает разработчик.

Аргументы

url string url валидного geojson-файла, из которого будет взята геометрия для построения слоя

name string короткое описание слоя, которое будет видно только в окошке управления видимостью слоёв

propsAndYears object объект вида {'year': propertyName, ... } - набор имен атрибутов в geojson-файле, по которым строится картограмма на разные даты

year - число, представляющее собой дату, к которой относится показатель

propertyName - название атрибута, хранящего значение нужного показателя

colorScheme object объект вида {value: hexColor, ... } - ступенчатая шкала значений и цветов для картограммы

value - минимальное значение показателя для ступени (верхней границей для этой ступени станет следующее, большее value)

hexColor - цвет картограммы, соответствующий этой ступени

description string краткое описание слоя-картограммы, которое будет помещено в легенду к слою

options object объект вида {'latScale': number, 'lonScale': number, 'padding': number}

latScale и lonScale - масштабные коэфициенты для растяжения/сжатия изображения по широте и долготе соответственно. Коэфициенты, заданные для первого созданного слоя, применяются затем ко всем остальным слоям.

padding - минимальные отступы от края карты до изображения

Возвращает

object Layer-объект

Inf.dataLayer()

Создает и добавляет на карту векторный слой с картодиаграммами из указанного файла в формате geojson. Файл должен содержать описания точечной геометрии, а также значения некоторого атрибута (атрибутов), по которым строится картодиаграмма. Разбиение значений на ступени шкалы и размеры диаграмм, которые соответствуют каждой ступени, задает разработчик.

Аргументы

url string url валидного geojson-файла, из которого будет взята геометрия для построения слоя

name string короткое описание слоя, которое будет видно только в окошке управления видимостью слоёв

propsAndYears object объект вида {'year': propertyName, ... } - набор имен атрибутов в geojson-файле, по которым строится картодиаграммы на разные даты

year - число, представляющее собой дату, к которой относится показатель

propertyName - название атрибута, хранящего значение нужного показателя

dimScheme object объект вида {value: sizeInPx, ... } - ступенчатая шкала значений и размеров для картодиаграмм

value - минимальное значение показателя для ступени (верхней границей для этой ступени станет следующее, большее value)

sizeInPx - размер картодиаграммы в пикс, соответствующий этой ступени

description string краткое описание слоя с картодиаграммами, которое будет помещено в легенду к слою

iconUrl string url растрового изображения, которое будет использовано в качестве картодиаграмм. Если аргумент отсутствует, будут использованы векторные круги серого цвета.

Возвращает

object Layer-объект

Inf.addLegend()

Добавляет на карту легенду к переданным в качестве аргументов слоям (в случае, если слой является картограммой или содержит картодиаграммы; другие слои игнорируются).

Аргументы

layer object переменная, содержащая Layer-объект. Можно передать несколько слоёв через запятую

Возвращает

array Массив DOM-объектов div, которые содержат в себе легенды. Длина массива равна количеству созданных легенд

Inf.addSpinner()

Добавляет на карту простой элемент переключения слоёв по датам для слоёв-картограмм и картодиаграмм, для которых при создании было указано несколько атрибутов на разные даты.

Аргументы

layer object переменная, содержащая Layer-объект. Можно передать несколько слоёв через запятую

Возвращает

object DOM-объект div, в котором располагается элемент управления

Inf.addLayerControl()

Добавляет к карте окошко управления видимостью переданных слоёв с checkboxes.

Аргументы

layer object переменная, содержащая Layer-объект. Можно передать несколько слоёв через запятую

Возвращает

object DOM-объект div, в который было помещено созданное окошко переключения слоёв

Inf.addRadioControl()

Делает переданные слои "взаимоисключающими" - то есть одновременно может стать видимым только один из этих слоёв. Добавляет на карту окошко управления видимостью слоёв с radiobuttons.

Аргументы

layer object переменная, содержащая Layer-объект. Нужно передать несколько слоёв через запятую (передавать только один слой лишено смысла)

Возвращает

object DOM-объект div, в который было помещено созданное окошко переключения слоёв

Inf.disableLayer()

Делает невидимым переданный слой

Аргументы

layer object переменная, содержащая Layer-объект. Передать можно только один слой

Возвращает

null

Inf.enableLayer()

Делает видимым переданный слой

Аргументы

layer object переменная, содержащая Layer-объект. Передать можно только один слой

Возвращает

null

Layer

Layer.setStyle()

Задает объектам слоя стили отображения

Аргументы

style object объект вида {'poly': {}, 'line: {}, 'point': {}}. После ключевых слов - сами описания стилей для полигонов, линий и точек соответственно. Подробмнее см. пошаговое учебное пособие

Возвращает

null

Layer.setStyleByProp()

Задает каждому объекту в слое стиль отображения в зависимости от равенства какого-либо его атрибута заданноум значению

Аргументы

propName string название нужного атрибута объекта в geojson-файле

value string значение, которое должен принимать атрибут для того, чтобы стиль был задан

style object объект вида {'poly': {}, 'line: {}, 'point': {}}. После ключевых слов - сами описания стилей для полигонов, линий и точек соответственно. Подробмнее см. пошаговое учебное пособие

Возвращает

null

Layer.setFillByProp()

Задает каждому объекту в слое свой цвет заливки в зависимости от равенства какого-либо его атрибута заданноум значению

Аргументы

propName string название нужного атрибута объекта в geojson-файле

value string значение, которое должен принимать атрибут для того, чтобы стиль был задан

fillColor string цвет заливки в формате hex

Возвращает

null

Layer.disable()

Делает слой невидимым

Аргументы

аргументы не нужны null

Возвращает

null

Layer.enable()

Делает слой видимым

Аргументы

аргументы не нужны null

Возвращает

null

Layer.choropleth()

Конвертирует слой с полигональной/мультиполигональной геометрией в картограмму. Файл должен содержать значения некоторого атрибута (атрибутов), по которым строится картограмма. Цветовую схему и разбиение значений на ступени шкалы задает разработчик.

Аргументы

propsAndYears object объект вида {'year': propertyName, ... } - набор имен атрибутов в geojson-файле, по которым строится картограмма на разные даты

year - число, представляющее собой дату, к которой относится показатель

propertyName - название атрибута, хранящего значение нужного показателя

colorScheme object объект вида {value: hexColor, ... } - ступенчатая шкала значений и цветов для картограммы

value - минимальное значение показателя для ступени (верхней границей для этой ступени станет следующее, большее value)

hexColor - цвет картограммы, соответствующий этой ступени

description string краткое описание слоя-картограммы, которое будет помещено в легенду к слою

Возвращает

object Layer-объект