--- metadata: - name: generator content: Diplodoc Platform v5.64.2 alternate: - https://yandex.ru/dev/jsapi-v2-1/doc/en/v2-1/ref/reference/geometry.Circle.md - https://yandex.ru/dev/jsapi-v2-1/doc/ru/v2-1/ref/reference/geometry.Circle.md - href: https://yandex.ru/dev/jsapi-v2-1/doc/ru/v2-1/ref/reference/geometry.Circle.md type: text/markdown title: Markdown version - href: https://yandex.ru/dev/jsapi-v2-1/doc/ru/llms.txt?revision=r21950234 rel: describedby --- > **Documentation Index:** Fetch the complete configuration index at https://yandex.ru/dev/jsapi-v2-1/doc/ru/llms.txt?revision=r21950234 # geometry.Circle Расширяет [ICircleGeometry](https://yandex.ru/dev/jsapi-v2-1/doc/ru/v2-1/ref/reference/ICircleGeometry.md). Геометрия "Круг". **См.:** [Circle](https://yandex.ru/dev/jsapi-v2-1/doc/ru/v2-1/ref/reference/Circle.md) [Конструктор](#constructor-summary) | [Поля ](#properties-summary) | [События ](#events-summary) | [Методы ](#methods-summary) ## Конструктор {#constructor-summary} ```javascript geometry.Circle([coordinates[, radius[, options]]]) ``` **Параметры:** #| || **Параметр** | **Значение по умолчанию** | **Описание** || || [`coordinates`](#param-coordinates) | null | Тип: Number[]\|null Координаты центра круга. || || [`radius`](#param-radius) | 0 | Тип: Number Радиус круга в метрах. || || [`options`](#param-options) | — | Тип: Object Опции геометрии. || || [`options.geodesic`](#param-options.geodesic) | false | Тип: Boolean Включает отображение с использованием геодезических линий. || || [`options.pixelRendering`](#param-options.pixelRendering) | "jumpy" | Тип: String Метод расчета пиксельных координат отображения в зацикленных проекциях. Опция может принимать одно из следующих значений: - jumpy - отображение располагается как можно ближе к центру области показа карты и может скачкообразно перемещается во время движения карты; - static - отображение всегда располагается в начальном мире и не перемещается при движении карты. || || [`options.projection`](#param-options.projection) | — | Тип: [IProjection](https://yandex.ru/dev/jsapi-v2-1/doc/ru/v2-1/ref/reference/IProjection.md) Проекция. || |# **Пример:** ```javascript // Создаем экземпляр класса геометрии круга (указываем координаты и радиус в метрах). var circleGeometry = new ymaps.geometry.Circle([30, 50], 10), // Создаем экземпляр класса геообъекта и передаем нашу геометрию в конструктор. circleGeoObject = new ymaps.GeoObject({ geometry: circleGeometry }); // Изменяем радиус геометрии через свойство geometry геообъекта. circleGeoObject.geometry.setRadius(5) // Или напрямую. circleGeometry.setRadius(5); // Также доступ к circleGeometry можно получить через circleGeoObject.geometry. ``` ## Поля {#properties-summary} #| || **Имя** | **Тип** | **Описание** || || [events](https://yandex.ru/dev/jsapi-v2-1/doc/ru/v2-1/ref/reference/IEventEmitter.md#events) | [IEventManager](https://yandex.ru/dev/jsapi-v2-1/doc/ru/v2-1/ref/reference/IEventManager.md) | Менеджер событий. Унаследовано от [IEventEmitter](https://yandex.ru/dev/jsapi-v2-1/doc/ru/v2-1/ref/reference/IEventEmitter.md#events). || || [options](https://yandex.ru/dev/jsapi-v2-1/doc/ru/v2-1/ref/reference/ICustomizable.md#options) | [IOptionManager](https://yandex.ru/dev/jsapi-v2-1/doc/ru/v2-1/ref/reference/IOptionManager.md) | Менеджер опций. Унаследовано от [ICustomizable](https://yandex.ru/dev/jsapi-v2-1/doc/ru/v2-1/ref/reference/ICustomizable.md#options). || |# ## События {#events-summary} #| || **Имя** | **Описание** || || [change](https://yandex.ru/dev/jsapi-v2-1/doc/ru/v2-1/ref/reference/ICircleGeometryAccess.md#event-change) | Изменение координат. Экземпляр класса [Event](https://yandex.ru/dev/jsapi-v2-1/doc/ru/v2-1/ref/reference/Event.md). Имена полей, доступных через метод [Event.get](https://yandex.ru/dev/jsapi-v2-1/doc/ru/v2-1/ref/reference/Event.md#get): - oldCoordinates - старые координаты центра; - newCoordinates - новые координаты центра; - oldRadius - старый радиус; - newRadius - новый радиус. Унаследовано от [ICircleGeometryAccess](https://yandex.ru/dev/jsapi-v2-1/doc/ru/v2-1/ref/reference/ICircleGeometryAccess.md#event-change). || || [mapchange](https://yandex.ru/dev/jsapi-v2-1/doc/ru/v2-1/ref/reference/IGeometry.md#event-mapchange) | Сменилась карта. Экземпляр класса [Event](https://yandex.ru/dev/jsapi-v2-1/doc/ru/v2-1/ref/reference/Event.md). Имена полей, доступных через метод [Event.get](https://yandex.ru/dev/jsapi-v2-1/doc/ru/v2-1/ref/reference/Event.md#get): - oldMap - старая карта; - newMap - новая карта. Унаследовано от [IGeometry](https://yandex.ru/dev/jsapi-v2-1/doc/ru/v2-1/ref/reference/IGeometry.md#event-mapchange). || || [optionschange](https://yandex.ru/dev/jsapi-v2-1/doc/ru/v2-1/ref/reference/ICustomizable.md#event-optionschange) | Изменение в опциях объекта. Унаследовано от [ICustomizable](https://yandex.ru/dev/jsapi-v2-1/doc/ru/v2-1/ref/reference/ICustomizable.md#event-optionschange). || || [pixelgeometrychange](https://yandex.ru/dev/jsapi-v2-1/doc/ru/v2-1/ref/reference/IGeometry.md#event-pixelgeometrychange) | Изменилась пиксельная геометрия. Экземпляр класса [Event](https://yandex.ru/dev/jsapi-v2-1/doc/ru/v2-1/ref/reference/Event.md). Имена полей, доступных через метод [Event.get](https://yandex.ru/dev/jsapi-v2-1/doc/ru/v2-1/ref/reference/Event.md#get): - pixelGeometry - новая пиксельная геометрия [IPixelGeometry](https://yandex.ru/dev/jsapi-v2-1/doc/ru/v2-1/ref/reference/IPixelGeometry.md). Унаследовано от [IGeometry](https://yandex.ru/dev/jsapi-v2-1/doc/ru/v2-1/ref/reference/IGeometry.md#event-pixelgeometrychange). || |# ## Методы {#methods-summary} #| || **Имя** | **Возвращает** | **Описание** || || [contains](https://yandex.ru/dev/jsapi-v2-1/doc/ru/v2-1/ref/reference/ICircleGeometryAccess.md#contains)([position](https://yandex.ru/dev/jsapi-v2-1/doc/ru/v2-1/ref/reference/ICircleGeometryAccess.md#contains-param-position)) | Boolean | Проверяет, лежит ли переданная точка внутри круга. Унаследован от [ICircleGeometryAccess](https://yandex.ru/dev/jsapi-v2-1/doc/ru/v2-1/ref/reference/ICircleGeometryAccess.md#contains). || || [freeze](https://yandex.ru/dev/jsapi-v2-1/doc/ru/v2-1/ref/reference/IFreezable.md#freeze)() | [IFreezable](https://yandex.ru/dev/jsapi-v2-1/doc/ru/v2-1/ref/reference/IFreezable.md) | Переводит объект в "замороженный" режим. Унаследован от [IFreezable](https://yandex.ru/dev/jsapi-v2-1/doc/ru/v2-1/ref/reference/IFreezable.md#freeze). || || [getBounds](https://yandex.ru/dev/jsapi-v2-1/doc/ru/v2-1/ref/reference/IGeometry.md#getBounds)() | Number[][]\|null | Возвращает координаты двух противоположных углов области, охватывающей геометрию. Первый элемент массива - юго-западный угол области; второй элемент - северо-восточный угол соответственно. Унаследован от [IGeometry](https://yandex.ru/dev/jsapi-v2-1/doc/ru/v2-1/ref/reference/IGeometry.md#getBounds). || || [getClosest](https://yandex.ru/dev/jsapi-v2-1/doc/ru/v2-1/ref/reference/ICircleGeometryAccess.md#getClosest)([anchorPosition](https://yandex.ru/dev/jsapi-v2-1/doc/ru/v2-1/ref/reference/ICircleGeometryAccess.md#getClosest-param-anchorPosition)) | Object | Ищет на окружности точку, ближайшую к anchorPosition. Унаследован от [ICircleGeometryAccess](https://yandex.ru/dev/jsapi-v2-1/doc/ru/v2-1/ref/reference/ICircleGeometryAccess.md#getClosest). || || [getCoordinates](https://yandex.ru/dev/jsapi-v2-1/doc/ru/v2-1/ref/reference/ICircleGeometryAccess.md#getCoordinates)() | Number[]\|null | Возвращает координаты центра круга. Унаследован от [ICircleGeometryAccess](https://yandex.ru/dev/jsapi-v2-1/doc/ru/v2-1/ref/reference/ICircleGeometryAccess.md#getCoordinates). || || [getMap](https://yandex.ru/dev/jsapi-v2-1/doc/ru/v2-1/ref/reference/IGeometry.md#getMap)() | [Map](https://yandex.ru/dev/jsapi-v2-1/doc/ru/v2-1/ref/reference/Map.md)\|null | Возвращает текущую карту. Унаследован от [IGeometry](https://yandex.ru/dev/jsapi-v2-1/doc/ru/v2-1/ref/reference/IGeometry.md#getMap). || || [getPixelGeometry](https://yandex.ru/dev/jsapi-v2-1/doc/ru/v2-1/ref/reference/IGeometry.md#getPixelGeometry)(\[[options](https://yandex.ru/dev/jsapi-v2-1/doc/ru/v2-1/ref/reference/IGeometry.md#getPixelGeometry-param-options)]) | [IPixelGeometry](https://yandex.ru/dev/jsapi-v2-1/doc/ru/v2-1/ref/reference/IPixelGeometry.md) | Возвращает пиксельную геометрию, соответствующую данной геометрии, ее опциям и состоянию карты. Унаследован от [IGeometry](https://yandex.ru/dev/jsapi-v2-1/doc/ru/v2-1/ref/reference/IGeometry.md#getPixelGeometry). || || [getRadius](https://yandex.ru/dev/jsapi-v2-1/doc/ru/v2-1/ref/reference/ICircleGeometryAccess.md#getRadius)() | Number | Возвращает радиус круга. Унаследован от [ICircleGeometryAccess](https://yandex.ru/dev/jsapi-v2-1/doc/ru/v2-1/ref/reference/ICircleGeometryAccess.md#getRadius). || || [getType](https://yandex.ru/dev/jsapi-v2-1/doc/ru/v2-1/ref/reference/ICircleGeometry.md#getType)() | String | Возвращает строку "Circle". Унаследован от [ICircleGeometry](https://yandex.ru/dev/jsapi-v2-1/doc/ru/v2-1/ref/reference/ICircleGeometry.md#getType). || || [isFrozen](https://yandex.ru/dev/jsapi-v2-1/doc/ru/v2-1/ref/reference/IFreezable.md#isFrozen)() | Boolean | Возвращает true, если объект находится в "замороженном" режиме, иначе false. Унаследован от [IFreezable](https://yandex.ru/dev/jsapi-v2-1/doc/ru/v2-1/ref/reference/IFreezable.md#isFrozen). || || [setCoordinates](https://yandex.ru/dev/jsapi-v2-1/doc/ru/v2-1/ref/reference/ICircleGeometryAccess.md#setCoordinates)([coordinates](https://yandex.ru/dev/jsapi-v2-1/doc/ru/v2-1/ref/reference/ICircleGeometryAccess.md#setCoordinates-param-coordinates)) | [ICircleGeometryAccess](https://yandex.ru/dev/jsapi-v2-1/doc/ru/v2-1/ref/reference/ICircleGeometryAccess.md) | Задает координаты центра круга. Унаследован от [ICircleGeometryAccess](https://yandex.ru/dev/jsapi-v2-1/doc/ru/v2-1/ref/reference/ICircleGeometryAccess.md#setCoordinates). || || [setMap](https://yandex.ru/dev/jsapi-v2-1/doc/ru/v2-1/ref/reference/IGeometry.md#setMap)([map](https://yandex.ru/dev/jsapi-v2-1/doc/ru/v2-1/ref/reference/IGeometry.md#setMap-param-map)) | | Задает карту. Унаследован от [IGeometry](https://yandex.ru/dev/jsapi-v2-1/doc/ru/v2-1/ref/reference/IGeometry.md#setMap). || || [setRadius](https://yandex.ru/dev/jsapi-v2-1/doc/ru/v2-1/ref/reference/ICircleGeometryAccess.md#setRadius)([radius](https://yandex.ru/dev/jsapi-v2-1/doc/ru/v2-1/ref/reference/ICircleGeometryAccess.md#setRadius-param-radius)) | [ICircleGeometryAccess](https://yandex.ru/dev/jsapi-v2-1/doc/ru/v2-1/ref/reference/ICircleGeometryAccess.md) | Задает радиус круга. Унаследован от [ICircleGeometryAccess](https://yandex.ru/dev/jsapi-v2-1/doc/ru/v2-1/ref/reference/ICircleGeometryAccess.md#setRadius). || || [unfreeze](https://yandex.ru/dev/jsapi-v2-1/doc/ru/v2-1/ref/reference/IFreezable.md#unfreeze)() | [IFreezable](https://yandex.ru/dev/jsapi-v2-1/doc/ru/v2-1/ref/reference/IFreezable.md) | Переводит объект в активный режим. Унаследован от [IFreezable](https://yandex.ru/dev/jsapi-v2-1/doc/ru/v2-1/ref/reference/IFreezable.md#unfreeze). || |#