---
metadata:
  - name: generator
    content: Diplodoc Platform v5.64.2
alternate:
  - https://yandex.com/dev/jsapi-v2-1/doc/en/v2-1/ref/reference/panorama.Base.md
  - https://yandex.com/dev/jsapi-v2-1/doc/ru/v2-1/ref/reference/panorama.Base.md
  - href: https://yandex.com/dev/jsapi-v2-1/doc/ru/v2-1/ref/reference/panorama.Base.md
    type: text/markdown
    title: Markdown version
  - href: https://yandex.com/dev/jsapi-v2-1/doc/ru/llms.txt?revision=r21950234
    rel: describedby
---
> **Documentation Index:** Fetch the complete configuration index at https://yandex.com/dev/jsapi-v2-1/doc/ru/llms.txt?revision=r21950234

# panorama.Base

Расширяет [IPanorama](https://yandex.com/dev/jsapi-v2-1/doc/ru/v2-1/ref/reference/IPanorama.md).

[Конструктор](#constructor-summary) | [Методы ](#methods-summary)

## Конструктор {#constructor-summary}

```javascript
panorama.Base()
```

Инициализирует панораму со стандартными параметрами.

**Пример:**

```javascript
function Panorama () {
    ymaps.panorama.Base.call(this);
    // Проверяем, что с нашей панорамой все в порядке.
    this.validate();
}

ymaps.util.defineClass(Panorama, ymaps.panorama.Base, {
    getPosition: function () {
        // Давайте поместим нашу панораму в центр системы координат.
        return [0, 0, 0];
    },

    getCoordSystem: function () {
        return ymaps.coordSystem.cartesian;
    },

    getAngularBBox: function () {
        //  Мы сделаем нашу панораму полностью сферической.
        return [0.5 * Math.PI, 2 * Math.PI, -0.5 * Math.PI, 0];
    },

    getTileSize: function () {
        return [512, 512];
    },

    getTileLevels: function () {
        // Наша панорама будет иметь только одно изображение.
        return [{
            getTileUrl: function (x, y) {
                return '/' + x + '/' + y + '.jpg';
            },

            getImageSize: function () {
                return [4096, 2048];
            }
        }];
    }
});
```

## Методы {#methods-summary}

#|
|| **Имя** | **Возвращает** | **Описание** ||
|| [getAngularBBox](https://yandex.com/dev/jsapi-v2-1/doc/ru/v2-1/ref/reference/panorama.Base.md#getAngularBBox)() | | Обязательный к переопределению метод. ||
|| [getConnectionArrows](https://yandex.com/dev/jsapi-v2-1/doc/ru/v2-1/ref/reference/panorama.Base.md#getConnectionArrows)() | [IPanoramaConnectionArrow](https://yandex.com/dev/jsapi-v2-1/doc/ru/v2-1/ref/reference/IPanoramaConnectionArrow.md)[] | Возвращает пустой массив, как будто на панораме нет ни одной связи в виде стрелок. ||
|| [getConnectionMarkers](https://yandex.com/dev/jsapi-v2-1/doc/ru/v2-1/ref/reference/panorama.Base.md#getConnectionMarkers)() | [IPanoramaConnectionMarker](https://yandex.com/dev/jsapi-v2-1/doc/ru/v2-1/ref/reference/IPanoramaConnectionMarker.md)[] | Возвращает пустой массив, как будто на панораме нет ни одной связи в виде маркера. ||
|| [getConnections](https://yandex.com/dev/jsapi-v2-1/doc/ru/v2-1/ref/reference/panorama.Base.md#getConnections)() | [IPanoramaConnectionMarker](https://yandex.com/dev/jsapi-v2-1/doc/ru/v2-1/ref/reference/IPanoramaConnectionMarker.md)[] |

{% note alert %}

Данный метод является устаревшим.

{% endnote %}

Данный метод является **устаревшим**. Вместо него переопределяйте метод panorama.Base.getConnectionMarkers. ||
|| [getCoordSystem](https://yandex.com/dev/jsapi-v2-1/doc/ru/v2-1/ref/reference/panorama.Base.md#getCoordSystem)() | [ICoordSystem](https://yandex.com/dev/jsapi-v2-1/doc/ru/v2-1/ref/reference/ICoordSystem.md) | Возвращает географическую систему координат. ||
|| [getDefaultDirection](https://yandex.com/dev/jsapi-v2-1/doc/ru/v2-1/ref/reference/panorama.Base.md#getDefaultDirection)() | Number[] | Возвращает направление на "север" в горизонт. ||
|| [getDefaultSpan](https://yandex.com/dev/jsapi-v2-1/doc/ru/v2-1/ref/reference/panorama.Base.md#getDefaultSpan)() | Number[] | Возвращает область обзора 130 на 80 градусов в радианах. ||
|| [getGraph](https://yandex.com/dev/jsapi-v2-1/doc/ru/v2-1/ref/reference/panorama.Base.md#getGraph)() | null | `Возвращает` null, как будто на панораме нет быстрых переходов на другие панорамы (по графу). ||
|| [getMarkers](https://yandex.com/dev/jsapi-v2-1/doc/ru/v2-1/ref/reference/panorama.Base.md#getMarkers)() | [IPanoramaMarker](https://yandex.com/dev/jsapi-v2-1/doc/ru/v2-1/ref/reference/IPanoramaMarker.md)[] | Возвращает пустой массив, как будто в панораме нет ни одного маркера. ||
|| [getName](https://yandex.com/dev/jsapi-v2-1/doc/ru/v2-1/ref/reference/panorama.Base.md#getName)() | String | Возвращает пустую строку. ||
|| [getPosition](https://yandex.com/dev/jsapi-v2-1/doc/ru/v2-1/ref/reference/panorama.Base.md#getPosition)() | | Обязательный к переопределению метод. ||
|| [getThoroughfares](https://yandex.com/dev/jsapi-v2-1/doc/ru/v2-1/ref/reference/panorama.Base.md#getThoroughfares)() | [IPanoramaConnectionArrow](https://yandex.com/dev/jsapi-v2-1/doc/ru/v2-1/ref/reference/IPanoramaConnectionArrow.md)[] |

{% note alert %}

Данный метод является устаревшим.

{% endnote %}

Данный метод является **устаревшим**. Вместо него переопределяйте метод panorama.Base.getConnectionArrows. ||
|| [getTileLevels](https://yandex.com/dev/jsapi-v2-1/doc/ru/v2-1/ref/reference/panorama.Base.md#getTileLevels)() | | Обязательный к переопределению метод. ||
|| [getTileSize](https://yandex.com/dev/jsapi-v2-1/doc/ru/v2-1/ref/reference/panorama.Base.md#getTileSize)() | | Обязательный к переопределению метод. ||
|| [validate](https://yandex.com/dev/jsapi-v2-1/doc/ru/v2-1/ref/reference/panorama.Base.md#validate)() | | Проверяет консистентность и корректность данных, возвращаемых методами объекта панорамы. Условия, которые проверяет этот метод:
- позиции всех объектов имеют три компоненты (включая высоту);
- размер тайла должен быть степенью двойки (например, 128, 256, 512 пикселей);
- панорама является полным кругом (то есть ширина угловой области должна быть 2π);
- каждый уровень масштабирования панорамного изображения содержит целое число тайлов по горизонтали (по вертикали это не обязательно).
Если вызов этого метода гененирует ошибку для объекта панорамы, стабильная работа плеера с такой панорамой не гарантируется. ||
|#

## Описание методов {#method_detail}

### getAngularBBox {#getAngularBBox}

```javascript
{} getAngularBBox()
```

Обязательный к переопределению метод.

### getConnectionArrows {#getConnectionArrows}

```javascript
{IPanoramaConnectionArrow[]} getConnectionArrows()
```

**Возвращает** пустой массив, как будто на панораме нет ни одной связи (в виде стрелок).

### getConnectionMarkers  {#getConnectionMarkers}

```javascript
{IPanoramaConnectionMarker[]} getConnectionMarkers()
```

**Возвращает** пустой массив, как будто на панораме нет ни одной связи (в виде маркера).

### getConnections {#getConnections}

```javascript
{IPanoramaConnectionMarker[]} getConnections()
```

Данный метод является **устаревшим**. Вместо него переопределяйте метод panorama.Base.getConnectionMarkers.

**Данный метод является устаревшим. **

**Возвращает** пустой массив, как будто в панораме нет ни одной связи.

### getCoordSystem {#getCoordSystem}

```javascript
{ICoordSystem} getCoordSystem()
```

**Возвращает** географическую систему координат.

### getDefaultDirection {#getDefaultDirection}

```javascript
{Number[]} getDefaultDirection()
```

**Возвращает** направление на "север" в горизонт.

### getDefaultSpan {#getDefaultSpan}

```javascript
{Number[]} getDefaultSpan()
```

**Возвращает** область обзора 130 на 80 градусов в радианах.

### getGraph {#getGraph}

```javascript
{null} getGraph()
```

**Возвращает**`null`, как будто на панораме нет ни одного быстрого перехода (по графу) на другие панорамы.

### getMarkers {#getMarkers}

```javascript
{IPanoramaMarker[]} getMarkers()
```

**Возвращает** пустой массив, как будто в панораме нет ни одного маркера.

### getName {#getName}

```javascript
{String} getName()
```

**Возвращает** пустую строку.

### getPosition {#getPosition}

```javascript
{} getPosition()
```

Обязательный к переопределению метод.

### getThoroughfares {#getThoroughfares}

```javascript
{IPanoramaConnectionArrow[]} getThoroughfares()
```

Данный метод является **устаревшим**. Вместо него переопределяйте метод panorama.Base.getConnectionArrows.

**Данный метод является устаревшим. **

**Возвращает** пустой массив, как будто в панораме нет ни одного перехода.

### getTileLevels {#getTileLevels}

```javascript
{} getTileLevels()
```

Обязательный к переопределению метод.

### getTileSize {#getTileSize}

```javascript
{} getTileSize()
```

Обязательный к переопределению метод.

### validate {#validate}

```javascript
{} validate()
```

Проверяет консистентность и корректность данных, возвращаемых методами объекта панорамы. Условия, которые проверяет этот метод:
- позиции всех объектов имеют три компоненты (включая высоту);
- размер тайла должен быть степенью двойки (например, 128, 256, 512 пикселей);
- панорама является полным кругом (то есть ширина угловой области должна быть 2π);
- каждый уровень масштабирования панорамного изображения содержит целое число тайлов по горизонтали (по вертикали это не обязательно).
Если вызов этого метода гененирует ошибку для объекта панорамы, стабильная работа плеера с такой панорамой не гарантируется.

<!-- XLIFF_FARM_NTI5ZWY1_CACHING -->