Планы этажей

Для некоторых зданий доступны поэтажные планы. Они отображаются на стилевом масштабе 18 и выше.

События

При показе поэтажного плана вызывается событие floorplanshow (см. FloorPlanShowEvent). При скрытии поэтажного плана вызывается событие floorplanhide (см. FloorPlanHideEvent).

Если при показе поэтажного плана был изменён номер текущего этажа (используя кнопки этажей или метод setFloorPlanLevel()), то будет вызвано событие floorlevelchange (см. FloorLevelChangeEvent).

Чтобы подписаться на эти события, нужно использовать метод on().

map.on('floorplanshow', (e) => {
    alert(`План ${e.floorPlanId} показан.`);
});
map.on('floorplanhide', (e) => {
    alert(`План ${e.floorPlanId} скрыт.`);
});
map.on('floorlevelchange', (e) => {
    alert('Изменён номер этажа.');
});

Изменение этажа

Чтобы изменить номер отображаемого этажа, нужно вызвать метод setFloorPlanLevel() и указать два параметра: идентификатор плана и индекс этажа. Оба этих значения можно получить, подписавшись на событие FloorPlanShowEvent.

Пример ниже меняет поведение карты, чтобы при показе поэтажного плана первоначально отображался последний этаж здания. Для этого в обработчике события floorplanshow вызывается метод setFloorPlanLevel(), в который передаётся индекс последнего этажа.

map.on('floorplanshow', (e) => {
    const length = e.floorLevels.length;
    const { floorLevelIndex } = e.floorLevels[length - 1];
    map.setFloorPlanLevel(e.floorPlanId, floorLevelIndex);
});