---
metadata:
  - name: generator
    content: Diplodoc Platform v5.39.1
alternate:
  - https://yandex.com/dev/jsapi-v2-1/doc/en/v2-1/ref/reference/Panorama.md
  - https://yandex.com/dev/jsapi-v2-1/doc/ru/v2-1/ref/reference/Panorama.md
---
> **Documentation Index:** Fetch the complete configuration index at https://yandex.com/dev/jsapi-v2-1/doc/ru/llms.txt

# Panorama

{% note info %}

Конструктор класса Panorama скрыт, так как данный класс не предназначен для самостоятельной инициализации.

{% endnote %}

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

Объект, описывающий панораму.

**См.:** [panorama.locate](https://yandex.com/dev/jsapi-v2-1/doc/ru/v2-1/ref/reference/panorama.locate.md)

[Методы ](#methods-summary)

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

#|
|| **Имя** | **Возвращает** | **Описание** ||
|| [createPlayer](https://yandex.com/dev/jsapi-v2-1/doc/ru/v2-1/ref/reference/Panorama.md#createPlayer)([element](https://yandex.com/dev/jsapi-v2-1/doc/ru/v2-1/ref/reference/Panorama.md#createPlayer-param-element)[, [options](https://yandex.com/dev/jsapi-v2-1/doc/ru/v2-1/ref/reference/Panorama.md#createPlayer-param-options)]) | [vow.Promise](https://yandex.com/dev/jsapi-v2-1/doc/ru/v2-1/ref/reference/vow.Promise.md) | Создает новый экземпляр класса [panorama.Player](https://yandex.com/dev/jsapi-v2-1/doc/ru/v2-1/ref/reference/panorama.Player.md) и открывает в нем панораму. ||
|| [getAngularBBox](https://yandex.com/dev/jsapi-v2-1/doc/ru/v2-1/ref/reference/IPanorama.md#getAngularBBox)() | Number[] | Возвращает сферические координаты, которые задают на панорамной сфере область, занимаемую изображением. Координаты указываются в формате `[thetaTop, phiRight, thetaBottom, phiLeft]` (аналогично CSS).

Унаследован от [IPanorama](https://yandex.com/dev/jsapi-v2-1/doc/ru/v2-1/ref/reference/IPanorama.md#getAngularBBox). ||
|| [getConnectionArrows](https://yandex.com/dev/jsapi-v2-1/doc/ru/v2-1/ref/reference/IPanorama.md#getConnectionArrows)() | [IPanoramaConnectionArrow](https://yandex.com/dev/jsapi-v2-1/doc/ru/v2-1/ref/reference/IPanoramaConnectionArrow.md)[] | Возвращает массив связей панорамы.

Унаследован от [IPanorama](https://yandex.com/dev/jsapi-v2-1/doc/ru/v2-1/ref/reference/IPanorama.md#getConnectionArrows). ||
|| [getConnectionMarkers](https://yandex.com/dev/jsapi-v2-1/doc/ru/v2-1/ref/reference/IPanorama.md#getConnectionMarkers)() | [IPanoramaConnectionMarker](https://yandex.com/dev/jsapi-v2-1/doc/ru/v2-1/ref/reference/IPanoramaConnectionMarker.md)[] | Возвращает массив маркеров-переходов на панораме.

Унаследован от [IPanorama](https://yandex.com/dev/jsapi-v2-1/doc/ru/v2-1/ref/reference/IPanorama.md#getConnectionMarkers). ||
|| [getCoordSystem](https://yandex.com/dev/jsapi-v2-1/doc/ru/v2-1/ref/reference/IPanorama.md#getCoordSystem)() | [ICoordSystem](https://yandex.com/dev/jsapi-v2-1/doc/ru/v2-1/ref/reference/ICoordSystem.md) | Возвращает систему координат, в которой заданы позиции панорамы и всех её маркеров и связей.

Унаследован от [IPanorama](https://yandex.com/dev/jsapi-v2-1/doc/ru/v2-1/ref/reference/IPanorama.md#getCoordSystem). ||
|| [getDefaultDirection](https://yandex.com/dev/jsapi-v2-1/doc/ru/v2-1/ref/reference/IPanorama.md#getDefaultDirection)() | Number[] | Возвращает направление взгляда по умолчанию. Будет использовано плеером при открытии панорамы.

Унаследован от [IPanorama](https://yandex.com/dev/jsapi-v2-1/doc/ru/v2-1/ref/reference/IPanorama.md#getDefaultDirection). ||
|| [getDefaultSpan](https://yandex.com/dev/jsapi-v2-1/doc/ru/v2-1/ref/reference/IPanorama.md#getDefaultSpan)() | Number[] | Возвращает размер области обзора по умолчанию. Будет использовано плеером при открытии панорамы.

Унаследован от [IPanorama](https://yandex.com/dev/jsapi-v2-1/doc/ru/v2-1/ref/reference/IPanorama.md#getDefaultSpan). ||
|| [getGraph](https://yandex.com/dev/jsapi-v2-1/doc/ru/v2-1/ref/reference/IPanorama.md#getGraph)() | [IPanoramaGraph](https://yandex.com/dev/jsapi-v2-1/doc/ru/v2-1/ref/reference/IPanoramaGraph.md)\|null | Возвращает граф панорам, связанных с текущей панорамой, для осуществления быстрых переходов.

Унаследован от [IPanorama](https://yandex.com/dev/jsapi-v2-1/doc/ru/v2-1/ref/reference/IPanorama.md#getGraph). ||
|| [getLayer](https://yandex.com/dev/jsapi-v2-1/doc/ru/v2-1/ref/reference/Panorama.md#getLayer)() | String | Возвращает слой, которому принадлежит панорама. ||
|| [getMarkers](https://yandex.com/dev/jsapi-v2-1/doc/ru/v2-1/ref/reference/IPanorama.md#getMarkers)() | [IPanoramaMarker](https://yandex.com/dev/jsapi-v2-1/doc/ru/v2-1/ref/reference/IPanoramaMarker.md)[] | Возвращает массив маркеров на панораме.

Унаследован от [IPanorama](https://yandex.com/dev/jsapi-v2-1/doc/ru/v2-1/ref/reference/IPanorama.md#getMarkers). ||
|| [getName](https://yandex.com/dev/jsapi-v2-1/doc/ru/v2-1/ref/reference/IPanorama.md#getName)() | String | Возвращает название панорамы, отображаемое плеером в интерфейсе.

Унаследован от [IPanorama](https://yandex.com/dev/jsapi-v2-1/doc/ru/v2-1/ref/reference/IPanorama.md#getName). ||
|| [getPosition](https://yandex.com/dev/jsapi-v2-1/doc/ru/v2-1/ref/reference/IPanorama.md#getPosition)() | Number[] | Возвращает положение панорамы в указанной в опциях системе координат. Задается в формате `[lon, lat, height]`, `[lat, lon, height]` или `[x, y, height]` в зависимости от системы и порядка координат. `height` – высота панорамы, заданная относительно некоторого уровня (не обязательно уровня моря).

Унаследован от [IPanorama](https://yandex.com/dev/jsapi-v2-1/doc/ru/v2-1/ref/reference/IPanorama.md#getPosition). ||
|| [getTileLevels](https://yandex.com/dev/jsapi-v2-1/doc/ru/v2-1/ref/reference/IPanorama.md#getTileLevels)() | [IPanoramaTileLevel](https://yandex.com/dev/jsapi-v2-1/doc/ru/v2-1/ref/reference/IPanoramaTileLevel.md)[] | Возвращает массив уровней масштабирования панорамного изображения.

Унаследован от [IPanorama](https://yandex.com/dev/jsapi-v2-1/doc/ru/v2-1/ref/reference/IPanorama.md#getTileLevels). ||
|| [getTileSize](https://yandex.com/dev/jsapi-v2-1/doc/ru/v2-1/ref/reference/IPanorama.md#getTileSize)() | Number[] | Возвращает размер тайлов, на которые нарезано панорамное изображение.

Унаследован от [IPanorama](https://yandex.com/dev/jsapi-v2-1/doc/ru/v2-1/ref/reference/IPanorama.md#getTileSize). ||
|#

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

### createPlayer {#createPlayer}

```javascript
{vow.Promise} createPlayer(element[, options])
```

Создает новый экземпляр класса [panorama.Player](https://yandex.com/dev/jsapi-v2-1/doc/ru/v2-1/ref/reference/panorama.Player.md) и открывает в нем панораму.

**Возвращает** Promise объект, который будет разрешен экземпляром класса [panorama.Player](https://yandex.com/dev/jsapi-v2-1/doc/ru/v2-1/ref/reference/panorama.Player.md) с открытой текущей панорамой.

**Параметры:**

#|
|| **Параметр** | **Значение по умолчанию** | **Описание**  ||
|| [`element`](#createPlayer-param-element)[*](*star) | — | Тип: HTMLElement\|String

Ссылка на HTML-элемент, в котором будет размещен плеер, или идентификатор этого HTML-элемента. ||
|| [`options`](#createPlayer-param-options) | — | Тип: Object

Опции. ||
|| [`options.direction`](#createPlayer-param-options.direction) | 'auto' | Тип: Number[]\|String

Направление взгляда в формате `[bearing, pitch]`, где `bearing` – азимут направления в градусах, `pitch` – угол подъема над линией горизонта в градусах. Специальное строковое значение `auto` означает, что после открытия панорамы будет применено направление, указанное в метаданных панорамы. ||
|| [`options.span`](#createPlayer-param-options.span) | 'auto' | Тип: Number[]\|String

Угловые размеры поля обзора в формате `[horizontalSpan, verticalSpan]`, где `horizontalSpan` — горизонтальный размер поля, `verticalSpan` — вертикальный. ||
|#

\* Обязательный параметр/опция.

### getLayer {#getLayer}

```javascript
{String} getLayer()
```

**См.:** [panorama.locate](https://yandex.com/dev/jsapi-v2-1/doc/ru/v2-1/ref/reference/panorama.locate.md)

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

<!-- XLIFF_FARM_NDFiZTNm_CACHING -->

[*star]: Обязательный параметр.