--- metadata: - name: generator content: Diplodoc Platform v5.39.1 alternate: - https://yandex.com.tr/dev/jsapi-v2-1/doc/en/v2-1/ref/reference/RemoteObjectManager.md - https://yandex.com.tr/dev/jsapi-v2-1/doc/ru/v2-1/ref/reference/RemoteObjectManager.md --- > **Documentation Index:** Fetch the complete configuration index at https://yandex.com.tr/dev/jsapi-v2-1/doc/ru/llms.txt # RemoteObjectManager Расширяет [ICustomizable](https://yandex.com.tr/dev/jsapi-v2-1/doc/ru/v2-1/ref/reference/ICustomizable.md), [IEventEmitter](https://yandex.com.tr/dev/jsapi-v2-1/doc/ru/v2-1/ref/reference/IEventEmitter.md), [IGeoObject](https://yandex.com.tr/dev/jsapi-v2-1/doc/ru/v2-1/ref/reference/IGeoObject.md), [IParentOnMap](https://yandex.com.tr/dev/jsapi-v2-1/doc/ru/v2-1/ref/reference/IParentOnMap.md). Менеджер объектов, осуществляющий их оптимальную подгрузку с сервера. Менеджер отправляет запросы за данными по указанному url в JSONP-формате. Описание формата соответствует формату добавляемых в ObjectManager объектов (см. [ObjectManager.add](https://yandex.com.tr/dev/jsapi-v2-1/doc/ru/v2-1/ref/reference/ObjectManager.md#add)). Также поддерживаются объекты типа 'Cluster', содержащие поля: - type — тип объекта, для кластеров всегда 'Cluster'; - id - уникальный идентификатор кластера; - geometry - геометрия кластера в JSON-формате; - features - массив объектов в составе кластера. Необязательное поле; - bbox — массив координат, описывающих прямоугольную область, содержащую все объекты в составе кластера; - number - количество объектов в кластере; - properties - данные кластера. Данный модуль рассчитан на загрузку и отображение данных, предварительно обработанных на сервере. В частности, рекомендуется использовать модуль для отображения результатов серверной кластеризации. Данные перезапрашиваются заново при изменении коэффициента масштабирования карты. Модуль не осуществляет кластеризацию объектов или фильтрацию по области видимости на клиенте. Чтобы кластеризовать объекты после их загрузки на сторону клиента, используйте [LoadingObjectManager](https://yandex.com.tr/dev/jsapi-v2-1/doc/ru/v2-1/ref/reference/LoadingObjectManager.md). Обратите внимание, что у объектов, отрисованных на карте через данный менеджер, нельзя включать режимы редактирования и перетаскивания. [Конструктор](#constructor-summary) | [Поля ](#properties-summary) | [События ](#events-summary) | [Методы ](#methods-summary) ## Конструктор {#constructor-summary} ```javascript RemoteObjectManager(urlTemplate[, options]) ``` **Параметры:** #| || **Параметр** | **Значение по умолчанию** | **Описание** || || [`urlTemplate`](#param-urlTemplate)[*](*star) | — | Тип: String шаблон URL данных. Поддерживаются специальные конструкции по аналогии с [Layer](https://yandex.com.tr/dev/jsapi-v2-1/doc/ru/v2-1/ref/reference/Layer.md). Также поддерживаются подстановки: - %b заменяется на массив географических координат, описывающих прямоугольную область, для которой требуется загрузить данные. - %t заменяется на массив номеров тайлов, описывающих прямоугольную область, для которой требуется загрузить данные. || || [`options`](#param-options) | — | Тип: Object Опции. - Можно задавать все опции, указанные в описании [Clusterer](https://yandex.com.tr/dev/jsapi-v2-1/doc/ru/v2-1/ref/reference/Clusterer.md), за исключением опций hasBalloon и hasHint. - Опции для кластеров задаются с префиксом cluster. Список опций указан в описании класса [ClusterPlacemark](https://yandex.com.tr/dev/jsapi-v2-1/doc/ru/v2-1/ref/reference/ClusterPlacemark.md); - Опции для одиночных объектов задаются с префиксом geoObject. Список опций определен в классе [GeoObject](https://yandex.com.tr/dev/jsapi-v2-1/doc/ru/v2-1/ref/reference/GeoObject.md). Обратите внимание, менеджер не учитывает опцию 'visible'. || || [`options.loadTileSize`](#param-options.loadTileSize) | 256 | Тип: Number Размер тайла для загрузки данных. || || [`options.paddingParamName`](#param-options.paddingParamName) | 'callback' | Тип: Boolean Имя GET-параметра, который содержит значение jsonp-колбека. || || [`options.paddingTemplate`](#param-options.paddingTemplate) | null | Тип: String Шаблон для jsonp-колбека. Поддерживает те же подстановки, что и urlTemplate. Все символы, не являющиеся буквой или цифрой, будут заменены на '_'. Если параметр не задан, то имя jsonp-колбека будет сгенерировано автоматически. Примеры преобразований при tileNumber=[3, 1], zoom=9: - 'myCallback=%x' => 'myCallback_3' - '%c' => 'x_3_y_1_z_9' - 'callback2_%c' => 'callback2_x_3_y_1_z_9' - 'callback%test' => 'callback_test' - 'callback_%b' => 'callback_85_0841__180_0000_85_0841_180_0000' Обратите внимание, что если не использовать в значении опции подстановки, то это может привести к ошибке. Все запросы будут обращаться к одной callback-функции. || || [`options.splitRequests`](#param-options.splitRequests) | false | Тип: Boolean Разделять запросы за данными на запросы за одиночными тайлами. По умолчанию запросы делаются за данными для прямоугольной области, содержащей несколько тайлов. || || [`options.syncOverlayInit`](#param-options.syncOverlayInit) | false | Тип: Boolean Флаг, разрешающий создавать оверлеи для объектов синхронно. Обратите внимание, что при синхронном создании оверлея нужно самостоятельно обеспечить загрузку нужного класса, реализующего интерфейс IOverlay. По умолчанию оверлеи создаются асинхронно, при этом класс оверлея загружается по требованию. || |# \* Обязательный параметр/опция. **Примеры:** **1.** ```javascript var objectManager = new ymaps.RemoteObjectManager('http://myServer.com/tile?bbox=%b', { // Опции кластеров задаются с префиксом 'cluster'. clusterHasBalloon: false, // Опции геообъектов задаются с префиксом 'geoObject'. geoObjectOpenBalloonOnClick: false }); // Опции можно задавать напрямую в дочерние коллекции. objectManager.clusters.options.set({ preset: 'islands#grayClusterIcons', hintContentLayout: ymaps.templateLayoutFactory.createClass('Группа объектов') }); objectManager.objects.options.set('preset', 'islands#grayIcon'); ``` **2.** ```javascript Пример ответа для RemoteObjectManager. jsonp_callback({ // Ответ содержит поля error и data. Если возникает ошибка, то поле "error" // содержит код ошибки или описание. error: null, data: { type: 'FeatureCollection', features: [ { type: 'Feature', geometry: { type: 'Point', coordinates: [55, 35] }, id: 23, properties: { balloonContent: 'Placemark balloon content', iconContent: 'Placemark content' }, options: { preset: 'islands#yellowIcon' } }, { type: 'Cluster', id: 24, bbox: [[35, 46], [46, 57]], number: 34, // Массив, описывающий 34 объекта в кластере. // Необязательное поле; // Если этот параметр опущен, то при щелчке по кластеру открывается пустой балун. features: [{ type: 'Feature', id: 512, properties: { balloonContent: 'Placemark balloon content', clusterCaption: 'Placemark title in the cluster balloon' }, // ... ], geometry: { type: 'Point', coordinates: [40.5, 51] }, properties: { iconContent: 34 } } ] } }); ``` ## Поля {#properties-summary} #| || **Имя** | **Тип** | **Описание** || || [clusters](https://yandex.com.tr/dev/jsapi-v2-1/doc/ru/v2-1/ref/reference/RemoteObjectManager.md#clusters) | [objectManager.ClusterCollection](https://yandex.com.tr/dev/jsapi-v2-1/doc/ru/v2-1/ref/reference/objectManager.ClusterCollection.md) | Коллекция кластеров, сгенерированных менеджером. || || [events](https://yandex.com.tr/dev/jsapi-v2-1/doc/ru/v2-1/ref/reference/IDomEventEmitter.md#events) | [IEventManager](https://yandex.com.tr/dev/jsapi-v2-1/doc/ru/v2-1/ref/reference/IEventManager.md) | Менеджер событий. Унаследовано от [IDomEventEmitter](https://yandex.com.tr/dev/jsapi-v2-1/doc/ru/v2-1/ref/reference/IDomEventEmitter.md#events). || || [geometry](https://yandex.com.tr/dev/jsapi-v2-1/doc/ru/v2-1/ref/reference/IGeoObject.md#geometry) | [IGeometry](https://yandex.com.tr/dev/jsapi-v2-1/doc/ru/v2-1/ref/reference/IGeometry.md)\|null | Геометрия геообъекта. Унаследовано от [IGeoObject](https://yandex.com.tr/dev/jsapi-v2-1/doc/ru/v2-1/ref/reference/IGeoObject.md#geometry). || || [objects](https://yandex.com.tr/dev/jsapi-v2-1/doc/ru/v2-1/ref/reference/RemoteObjectManager.md#objects) | [objectManager.ObjectCollection](https://yandex.com.tr/dev/jsapi-v2-1/doc/ru/v2-1/ref/reference/objectManager.ObjectCollection.md) | Коллекция объектов, добавленных в слой. || || [options](https://yandex.com.tr/dev/jsapi-v2-1/doc/ru/v2-1/ref/reference/ICustomizable.md#options) | [IOptionManager](https://yandex.com.tr/dev/jsapi-v2-1/doc/ru/v2-1/ref/reference/IOptionManager.md) | Менеджер опций. Унаследовано от [ICustomizable](https://yandex.com.tr/dev/jsapi-v2-1/doc/ru/v2-1/ref/reference/ICustomizable.md#options). || || [properties](https://yandex.com.tr/dev/jsapi-v2-1/doc/ru/v2-1/ref/reference/IGeoObject.md#properties) | [IDataManager](https://yandex.com.tr/dev/jsapi-v2-1/doc/ru/v2-1/ref/reference/IDataManager.md) | Данные геообъекта. Унаследовано от [IGeoObject](https://yandex.com.tr/dev/jsapi-v2-1/doc/ru/v2-1/ref/reference/IGeoObject.md#properties). || || [state](https://yandex.com.tr/dev/jsapi-v2-1/doc/ru/v2-1/ref/reference/IGeoObject.md#state) | [IDataManager](https://yandex.com.tr/dev/jsapi-v2-1/doc/ru/v2-1/ref/reference/IDataManager.md) | Состояние геообъекта. Унаследовано от [IGeoObject](https://yandex.com.tr/dev/jsapi-v2-1/doc/ru/v2-1/ref/reference/IGeoObject.md#state). || |# ## События {#events-summary} #| || **Имя** | **Описание** || || [click](https://yandex.com.tr/dev/jsapi-v2-1/doc/ru/v2-1/ref/reference/IDomEventEmitter.md#event-click) | Однократное нажатие левой кнопки мыши на объекте. При использовании следует иметь в виду, что при сенсорном вводе события мыши будут эмулироваться. Экземпляр класса [MapEvent](https://yandex.com.tr/dev/jsapi-v2-1/doc/ru/v2-1/ref/reference/MapEvent.md). Более детальное описание доступно в [domEvent.manager](https://yandex.com.tr/dev/jsapi-v2-1/doc/ru/v2-1/ref/reference/domEvent.manager.md). Унаследовано от [IDomEventEmitter](https://yandex.com.tr/dev/jsapi-v2-1/doc/ru/v2-1/ref/reference/IDomEventEmitter.md#event-click). || || [contextmenu](https://yandex.com.tr/dev/jsapi-v2-1/doc/ru/v2-1/ref/reference/IDomEventEmitter.md#event-contextmenu) | Вызов контекстного меню на элементе. При использовании следует иметь в виду, что при сенсорном вводе события мыши будут эмулироваться. Экземпляр класса [MapEvent](https://yandex.com.tr/dev/jsapi-v2-1/doc/ru/v2-1/ref/reference/MapEvent.md). Более детальное описание доступно в [domEvent.manager](https://yandex.com.tr/dev/jsapi-v2-1/doc/ru/v2-1/ref/reference/domEvent.manager.md). Унаследовано от [IDomEventEmitter](https://yandex.com.tr/dev/jsapi-v2-1/doc/ru/v2-1/ref/reference/IDomEventEmitter.md#event-contextmenu). || || [dataloaderror](https://yandex.com.tr/dev/jsapi-v2-1/doc/ru/v2-1/ref/reference/RemoteObjectManager.md#event-dataloaderror) | Во время загрузки данных произошла ошибка. Экземпляр класса [Event](https://yandex.com.tr/dev/jsapi-v2-1/doc/ru/v2-1/ref/reference/Event.md). || || [dblclick](https://yandex.com.tr/dev/jsapi-v2-1/doc/ru/v2-1/ref/reference/IDomEventEmitter.md#event-dblclick) | Двойное нажатие левой кнопки мыши на объекте. При использовании следует иметь в виду, что при сенсорном вводе события мыши будут эмулироваться. Экземпляр класса [MapEvent](https://yandex.com.tr/dev/jsapi-v2-1/doc/ru/v2-1/ref/reference/MapEvent.md). Более детальное описание доступно в [domEvent.manager](https://yandex.com.tr/dev/jsapi-v2-1/doc/ru/v2-1/ref/reference/domEvent.manager.md). Унаследовано от [IDomEventEmitter](https://yandex.com.tr/dev/jsapi-v2-1/doc/ru/v2-1/ref/reference/IDomEventEmitter.md#event-dblclick). || || [geometrychange](https://yandex.com.tr/dev/jsapi-v2-1/doc/ru/v2-1/ref/reference/IGeoObject.md#event-geometrychange) | Изменение геометрии геообъекта. Экземпляр класса [Event](https://yandex.com.tr/dev/jsapi-v2-1/doc/ru/v2-1/ref/reference/Event.md). Имена полей, доступных через метод [Event.get](https://yandex.com.tr/dev/jsapi-v2-1/doc/ru/v2-1/ref/reference/Event.md#get): - originalEvent: [IEvent](https://yandex.com.tr/dev/jsapi-v2-1/doc/ru/v2-1/ref/reference/IEvent.md) - оригинальное событие геометрии. Унаследовано от [IGeoObject](https://yandex.com.tr/dev/jsapi-v2-1/doc/ru/v2-1/ref/reference/IGeoObject.md#event-geometrychange). || || [mapchange](https://yandex.com.tr/dev/jsapi-v2-1/doc/ru/v2-1/ref/reference/IParentOnMap.md#event-mapchange) | Сменилась карта. Поля данных: - oldMap - старая карта; - newMap - новая карта. Унаследовано от [IParentOnMap](https://yandex.com.tr/dev/jsapi-v2-1/doc/ru/v2-1/ref/reference/IParentOnMap.md#event-mapchange). || || [mousedown](https://yandex.com.tr/dev/jsapi-v2-1/doc/ru/v2-1/ref/reference/IDomEventEmitter.md#event-mousedown) | Нажатие кнопки мыши над объектом. При использовании следует иметь в виду, что при сенсорном вводе события мыши будут эмулироваться. Экземпляр класса [MapEvent](https://yandex.com.tr/dev/jsapi-v2-1/doc/ru/v2-1/ref/reference/MapEvent.md). Более детальное описание доступно в [domEvent.manager](https://yandex.com.tr/dev/jsapi-v2-1/doc/ru/v2-1/ref/reference/domEvent.manager.md). Унаследовано от [IDomEventEmitter](https://yandex.com.tr/dev/jsapi-v2-1/doc/ru/v2-1/ref/reference/IDomEventEmitter.md#event-mousedown). || || [mouseenter](https://yandex.com.tr/dev/jsapi-v2-1/doc/ru/v2-1/ref/reference/IDomEventEmitter.md#event-mouseenter) | Наведение курсора на объект. При использовании следует иметь в виду, что при сенсорном вводе события мыши будут эмулироваться. Экземпляр класса [MapEvent](https://yandex.com.tr/dev/jsapi-v2-1/doc/ru/v2-1/ref/reference/MapEvent.md). Более детальное описание доступно в [domEvent.manager](https://yandex.com.tr/dev/jsapi-v2-1/doc/ru/v2-1/ref/reference/domEvent.manager.md). Унаследовано от [IDomEventEmitter](https://yandex.com.tr/dev/jsapi-v2-1/doc/ru/v2-1/ref/reference/IDomEventEmitter.md#event-mouseenter). || || [mouseleave](https://yandex.com.tr/dev/jsapi-v2-1/doc/ru/v2-1/ref/reference/IDomEventEmitter.md#event-mouseleave) | Вывод курсора за пределы объекта. При использовании следует иметь в виду, что при сенсорном вводе события мыши будут эмулироваться. Экземпляр класса [MapEvent](https://yandex.com.tr/dev/jsapi-v2-1/doc/ru/v2-1/ref/reference/MapEvent.md). Более детальное описание доступно в [domEvent.manager](https://yandex.com.tr/dev/jsapi-v2-1/doc/ru/v2-1/ref/reference/domEvent.manager.md). Унаследовано от [IDomEventEmitter](https://yandex.com.tr/dev/jsapi-v2-1/doc/ru/v2-1/ref/reference/IDomEventEmitter.md#event-mouseleave). || || [mousemove](https://yandex.com.tr/dev/jsapi-v2-1/doc/ru/v2-1/ref/reference/IDomEventEmitter.md#event-mousemove) | Перемещение курсора над объектом. При использовании следует иметь в виду, что при сенсорном вводе события мыши будут эмулироваться. Экземпляр класса [MapEvent](https://yandex.com.tr/dev/jsapi-v2-1/doc/ru/v2-1/ref/reference/MapEvent.md). Более детальное описание доступно в [domEvent.manager](https://yandex.com.tr/dev/jsapi-v2-1/doc/ru/v2-1/ref/reference/domEvent.manager.md). Унаследовано от [IDomEventEmitter](https://yandex.com.tr/dev/jsapi-v2-1/doc/ru/v2-1/ref/reference/IDomEventEmitter.md#event-mousemove). || || [mouseup](https://yandex.com.tr/dev/jsapi-v2-1/doc/ru/v2-1/ref/reference/IDomEventEmitter.md#event-mouseup) | Отпускание кнопки мыши над объектом. При использовании следует иметь в виду, что при сенсорном вводе события мыши будут эмулироваться. Экземпляр класса [MapEvent](https://yandex.com.tr/dev/jsapi-v2-1/doc/ru/v2-1/ref/reference/MapEvent.md). Более детальное описание доступно в [domEvent.manager](https://yandex.com.tr/dev/jsapi-v2-1/doc/ru/v2-1/ref/reference/domEvent.manager.md). Унаследовано от [IDomEventEmitter](https://yandex.com.tr/dev/jsapi-v2-1/doc/ru/v2-1/ref/reference/IDomEventEmitter.md#event-mouseup). || || [multitouchend](https://yandex.com.tr/dev/jsapi-v2-1/doc/ru/v2-1/ref/reference/IDomEventEmitter.md#event-multitouchend) | Окончание мультисенсорного управления. Данное событие доступно только на устройствах, которые поддерживают множественные сенсорные прикосновения. Возвращает реализацию интерфейса IMultiTouchEvent. Унаследовано от [IDomEventEmitter](https://yandex.com.tr/dev/jsapi-v2-1/doc/ru/v2-1/ref/reference/IDomEventEmitter.md#event-multitouchend). || || [multitouchmove](https://yandex.com.tr/dev/jsapi-v2-1/doc/ru/v2-1/ref/reference/IDomEventEmitter.md#event-multitouchmove) | Повторящееся событие при мультисенсорном управлении. Данное событие доступно только на устройствах, которые поддерживают множественные сенсорные прикосновения. Возвращает реализацию интерфейса IMultiTouchEvent c информацией о прикосновениях. Определяет свойство touches, которое содержит список прикосновений. Каждое прикосновение описано объектом, которое содержит поля: - clientX - координата касания X относительно видимой области браузера; - clientY - координата касания Y относительно видимой области браузера; - pageX - координата касания X касания относительно начала документа; - pageY - координата касания Y касания относительно начала документа. Унаследовано от [IDomEventEmitter](https://yandex.com.tr/dev/jsapi-v2-1/doc/ru/v2-1/ref/reference/IDomEventEmitter.md#event-multitouchmove). || || [multitouchstart](https://yandex.com.tr/dev/jsapi-v2-1/doc/ru/v2-1/ref/reference/IDomEventEmitter.md#event-multitouchstart) | Начало мультисенсорного управления. Данное событие доступно только на устройствах, которые поддерживают множественные сенсорные прикосновения. Возвращает реализацию интерфейса IMultiTouchEvent c информацией о прикосновениях. Определяет свойство touches, которое содержит список прикосновений. Каждое прикосновение описано объектом, которое содержит поля: - clientX - координата касания X относительно видимой области браузера; - clientY - координата касания Y относительно видимой области браузера; - pageX - координата касания X касания относительно начала документа; - pageY - координата касания Y касания относительно начала документа. Унаследовано от [IDomEventEmitter](https://yandex.com.tr/dev/jsapi-v2-1/doc/ru/v2-1/ref/reference/IDomEventEmitter.md#event-multitouchstart). || || [optionschange](https://yandex.com.tr/dev/jsapi-v2-1/doc/ru/v2-1/ref/reference/ICustomizable.md#event-optionschange) | Изменение в опциях объекта. Унаследовано от [ICustomizable](https://yandex.com.tr/dev/jsapi-v2-1/doc/ru/v2-1/ref/reference/ICustomizable.md#event-optionschange). || || [overlaychange](https://yandex.com.tr/dev/jsapi-v2-1/doc/ru/v2-1/ref/reference/IGeoObject.md#event-overlaychange) | Изменение оверлея геообъекта. Экземпляр класса [Event](https://yandex.com.tr/dev/jsapi-v2-1/doc/ru/v2-1/ref/reference/Event.md). Имена полей, доступных через метод [Event.get](https://yandex.com.tr/dev/jsapi-v2-1/doc/ru/v2-1/ref/reference/Event.md#get): - overlay: [IOverlay](https://yandex.com.tr/dev/jsapi-v2-1/doc/ru/v2-1/ref/reference/IOverlay.md)\|null - ссылка на оверлей; - oldOverlay: [IOverlay](https://yandex.com.tr/dev/jsapi-v2-1/doc/ru/v2-1/ref/reference/IOverlay.md)\|null - предыдущий оверлей геообъекта. Унаследовано от [IGeoObject](https://yandex.com.tr/dev/jsapi-v2-1/doc/ru/v2-1/ref/reference/IGeoObject.md#event-overlaychange). || || [parentchange](https://yandex.com.tr/dev/jsapi-v2-1/doc/ru/v2-1/ref/reference/IChild.md#event-parentchange) | Сменился родительский объект. Поля данных: - oldParent - старый родитель; - newParent - новый родитель. Унаследовано от [IChild](https://yandex.com.tr/dev/jsapi-v2-1/doc/ru/v2-1/ref/reference/IChild.md#event-parentchange). || || [propertieschange](https://yandex.com.tr/dev/jsapi-v2-1/doc/ru/v2-1/ref/reference/IGeoObject.md#event-propertieschange) | Изменение данных геообъекта. Экземпляр класса [Event](https://yandex.com.tr/dev/jsapi-v2-1/doc/ru/v2-1/ref/reference/Event.md). Имена полей, доступных через метод [Event.get](https://yandex.com.tr/dev/jsapi-v2-1/doc/ru/v2-1/ref/reference/Event.md#get): - originalEvent: [IEvent](https://yandex.com.tr/dev/jsapi-v2-1/doc/ru/v2-1/ref/reference/IEvent.md) - оригинальное событие менеджера данных. Унаследовано от [IGeoObject](https://yandex.com.tr/dev/jsapi-v2-1/doc/ru/v2-1/ref/reference/IGeoObject.md#event-propertieschange). || || [wheel](https://yandex.com.tr/dev/jsapi-v2-1/doc/ru/v2-1/ref/reference/IDomEventEmitter.md#event-wheel) | Скролл мышкой. При использовании следует иметь в виду, что при сенсорном вводе события мыши будут эмулироваться. Экземпляр класса [MapEvent](https://yandex.com.tr/dev/jsapi-v2-1/doc/ru/v2-1/ref/reference/MapEvent.md). Более детальное описание доступно в [domEvent.manager](https://yandex.com.tr/dev/jsapi-v2-1/doc/ru/v2-1/ref/reference/domEvent.manager.md). Унаследовано от [IDomEventEmitter](https://yandex.com.tr/dev/jsapi-v2-1/doc/ru/v2-1/ref/reference/IDomEventEmitter.md#event-wheel). || |# ## Методы {#methods-summary} #| || **Имя** | **Возвращает** | **Описание** || || [getBounds](https://yandex.com.tr/dev/jsapi-v2-1/doc/ru/v2-1/ref/reference/RemoteObjectManager.md#getBounds)() | Number[][]\|null | Вычисляет границы области в геокоординатах, охватывающей все загруженные объекты в составе менеджера. || || [getMap](https://yandex.com.tr/dev/jsapi-v2-1/doc/ru/v2-1/ref/reference/IParentOnMap.md#getMap)() | [Map](https://yandex.com.tr/dev/jsapi-v2-1/doc/ru/v2-1/ref/reference/Map.md) | Возвращает ссылку на карту. Унаследован от [IParentOnMap](https://yandex.com.tr/dev/jsapi-v2-1/doc/ru/v2-1/ref/reference/IParentOnMap.md#getMap). || || [getObjectState](https://yandex.com.tr/dev/jsapi-v2-1/doc/ru/v2-1/ref/reference/RemoteObjectManager.md#getObjectState)([id](https://yandex.com.tr/dev/jsapi-v2-1/doc/ru/v2-1/ref/reference/RemoteObjectManager.md#getObjectState-param-id)) | Object | Получение информации о текущем состоянии объекта, добавленного в менеджер. || || [getOverlay](https://yandex.com.tr/dev/jsapi-v2-1/doc/ru/v2-1/ref/reference/IGeoObject.md#getOverlay)() | [vow.Promise](https://yandex.com.tr/dev/jsapi-v2-1/doc/ru/v2-1/ref/reference/vow.Promise.md) | Возвращает объект-обещание, который подтверждается объектом оверлея в момент его фактического создания, либо отклоняется с передачей соответствующей ошибки. Унаследован от [IGeoObject](https://yandex.com.tr/dev/jsapi-v2-1/doc/ru/v2-1/ref/reference/IGeoObject.md#getOverlay). || || [getOverlaySync](https://yandex.com.tr/dev/jsapi-v2-1/doc/ru/v2-1/ref/reference/IGeoObject.md#getOverlaySync)() | [IOverlay](https://yandex.com.tr/dev/jsapi-v2-1/doc/ru/v2-1/ref/reference/IOverlay.md)\|null | Метод предоставляет синхронный доступ к оверлею. Унаследован от [IGeoObject](https://yandex.com.tr/dev/jsapi-v2-1/doc/ru/v2-1/ref/reference/IGeoObject.md#getOverlaySync). || || [getParent](https://yandex.com.tr/dev/jsapi-v2-1/doc/ru/v2-1/ref/reference/IChildOnMap.md#getParent)() | [IParentOnMap](https://yandex.com.tr/dev/jsapi-v2-1/doc/ru/v2-1/ref/reference/IParentOnMap.md)\|null | Возвращает ссылку на родительский объект или null, если родительский элемент не был установлен. Унаследован от [IChildOnMap](https://yandex.com.tr/dev/jsapi-v2-1/doc/ru/v2-1/ref/reference/IChildOnMap.md#getParent). || || [getPixelBounds](https://yandex.com.tr/dev/jsapi-v2-1/doc/ru/v2-1/ref/reference/RemoteObjectManager.md#getPixelBounds)() | Number[][]\|null | Вычисляет границы области в глобальных пиксельных координатах, охватывающей все загруженные объекты в составе менеджера. || || [getTileUrl](https://yandex.com.tr/dev/jsapi-v2-1/doc/ru/v2-1/ref/reference/RemoteObjectManager.md#getTileUrl)() | String\|null | Возвращает URL тайла с данными. || || [getUrlTemplate](https://yandex.com.tr/dev/jsapi-v2-1/doc/ru/v2-1/ref/reference/RemoteObjectManager.md#getUrlTemplate)() | String | Возвращает URL шаблона данных. || || [reloadData](https://yandex.com.tr/dev/jsapi-v2-1/doc/ru/v2-1/ref/reference/RemoteObjectManager.md#reloadData)() | | Метод, удаляющий все загруженные ранее данные и отправляющий запрос за новыми данными. || || [setFilter](https://yandex.com.tr/dev/jsapi-v2-1/doc/ru/v2-1/ref/reference/RemoteObjectManager.md#setFilter)([filterFunction](https://yandex.com.tr/dev/jsapi-v2-1/doc/ru/v2-1/ref/reference/RemoteObjectManager.md#setFilter-param-filterFunction)) | | Устанавливает функцию-фильтр для объектов. Фильтрует как одиночные объекты, так и кластеры. || || [setParent](https://yandex.com.tr/dev/jsapi-v2-1/doc/ru/v2-1/ref/reference/IChildOnMap.md#setParent)([parent](https://yandex.com.tr/dev/jsapi-v2-1/doc/ru/v2-1/ref/reference/IChildOnMap.md#setParent-param-parent)) | [IChildOnMap](https://yandex.com.tr/dev/jsapi-v2-1/doc/ru/v2-1/ref/reference/IChildOnMap.md) | Устанавливает родительский объект. Если передать значение null, то элемент управления будет только удален из текущего родительского объекта. Унаследован от [IChildOnMap](https://yandex.com.tr/dev/jsapi-v2-1/doc/ru/v2-1/ref/reference/IChildOnMap.md#setParent). || || [setUrlTemplate](https://yandex.com.tr/dev/jsapi-v2-1/doc/ru/v2-1/ref/reference/RemoteObjectManager.md#setUrlTemplate)([urlTemplate](https://yandex.com.tr/dev/jsapi-v2-1/doc/ru/v2-1/ref/reference/RemoteObjectManager.md#setUrlTemplate-param-urlTemplate)) | | || |# ## Описание полей {#field_detail} ### clusters {#clusters} ```javascript {objectManager.ClusterCollection} clusters ``` Коллекция кластеров, сгенерированных менеджером. **Пример:** ```javascript objectManager.objects.events.add('click', function (e) { var objectId = e.get('objectId'); objectManager.objects.balloon.open(objectId); }); ``` ### objects {#objects} ```javascript {objectManager.ObjectCollection} objects ``` Коллекция объектов, добавленных в слой. **Пример:** ```javascript objectManager.objects.events.add('click', function (e) { var objectId = e.get('objectId'); objectManager.objects.balloon.open(objectId);}); ``` ## Описание событий {#event_detail} ### dataloaderror {#dataloaderror} Во время загрузки данных произошла ошибка. Экземпляр класса [Event](https://yandex.com.tr/dev/jsapi-v2-1/doc/ru/v2-1/ref/reference/Event.md). ## Описание методов {#method_detail} ### getBounds {#getBounds} ```javascript {Number[][]|null} getBounds() ``` Вычисляет границы области в геокоординатах, охватывающей все загруженные объекты в составе менеджера. **Возвращает** массив координат области или null, если менеджер не добавлен на карту. ### getObjectState {#getObjectState} ```javascript {Object} getObjectState(id) ``` Получение информации о текущем состоянии объекта, добавленного в менеджер. **Возвращает** объект, содержащий следующие поля: - found - признак, указывающий, существует ли объект с переданным идентификатором в загруженных данных. Type: Boolean. - isShown - признак, указывающий, находится ли объект в видимой области карты. Type: Boolean. - isFilteredOut - признак, указывающий, прошел ли объект фильтрацию. Если фильтр не задан или объект прошел фильтрацию, значение поля будет false. Type: Boolean. **Параметры:** #| || **Параметр** | **Значение по умолчанию** | **Описание** || || [`id`](#getObjectState-param-id)[*](*star) | — | Тип: Object Идентификатор объекта, для которого нужно получить состояние. || |# \* Обязательный параметр/опция. **Пример:** ```javascript remoteObjectManager.setFilter('properties.type == "shop"'); // ... if (!remoteObjectManager.getObjectState(7).isFilteredOut) { remoteObjectManager.objects.balloon.open(7); } ``` ### getPixelBounds {#getPixelBounds} ```javascript {Number[][]|null} getPixelBounds() ``` Вычисляет границы области в глобальных пиксельных координатах, охватывающей все загруженные объекты в составе менеджера. **Возвращает** массив координат области или null, если менеджер не добавлен на карту. ### getTileUrl {#getTileUrl} ```javascript {String|null} getTileUrl() ``` **Возвращает** URL тайла с данными. **Параметры:** #| || **Параметр** | **Значение по умолчанию** | **Описание** || || [`parameters`](#getTileUrl-param-parameters)[*](*star) | — | Тип: || |# \* Обязательный параметр/опция. **Пример:** ```javascript var objectManager = new ymaps.RemoteObjectManager('http://myServer.com/tile?bbox=%b'); objectManager.getTileUrl = function (parameters) { var boundingBox = parameters.boundingBox.join('~'); return this.getUrlTemplate().replace(/%b/g, boundingBox); }; ``` ### getUrlTemplate {#getUrlTemplate} ```javascript {String} getUrlTemplate() ``` **Возвращает** URL шаблона данных. ### reloadData {#reloadData} ```javascript {} reloadData() ``` Метод, удаляющий все загруженные ранее данные и отправляющий запрос за новыми данными. ### setFilter {#setFilter} ```javascript {} setFilter(filterFunction) ``` Устанавливает функцию-фильтр для объектов. Фильтрует как одиночные объекты, так и кластеры. **Параметры:** #| || **Параметр** | **Значение по умолчанию** | **Описание** || || [`filterFunction`](#setFilter-param-filterFunction)[*](*star) | — | Тип: Function\|String функция-фильтр. Получает на вход единичный объект, добавленный в ObjectManager. Если функция возвращает true, объект будет обработан. Если false - объект будет исключен из дальнейшей обработки. Также в качестве фильтра можно передавать строку. В строке-фильтре доступны следующие ключевые слова: - options – обращение к опциям объекта; - properties – обращение к данным объекта; - geometry – обращение к геометрии объекта; - id – обращение к идентификатору объекта. В качестве фильтра можно указывать выражение, возвращающее true или false. || |# \* Обязательный параметр/опция. **Примеры:** **1.** ```javascript // Выбрать кластеры с id > 100. objectManager.setFilter('object.type == "Cluster" && id > 100'); ``` **2.** ```javascript // На карте будут отображаться только объекты с заданными типами. objectManager.setFilter('properties.type == "кафе" || properties.type == "аптека"'); ``` **3.** ```javascript // Можно задавать функцию-фильтр. objectManager.setFilter(function (object) { return object.properties.name != 'Тот, кого нельзя показать.';}); ``` ### setUrlTemplate {#setUrlTemplate} ```javascript {} setUrlTemplate(urlTemplate) ``` **Параметры:** #| || **Параметр** | **Значение по умолчанию** | **Описание** || || [`urlTemplate`](#setUrlTemplate-param-urlTemplate)[*](*star) | — | Тип: String шаблон URL данных. || |# \* Обязательный параметр/опция. [*star]: Обязательный параметр.