YMapFeature

Класс YMapFeature — объектный компонент на карте. В зависимости от типа геометрии может отображаться как ломаная линия или полигон.

Пример использования

Ломаная линия

Тип: LineString.

Пример использования:

const lineStringFeature = new YMapFeature({
  id: 'line',
  source: 'featureSource',
  geometry: {
    type: 'LineString',
    coordinates: [
      [25.1229762, 55.189311],
      [25.329762, 55.389311]
    ]
  },
  style: {
    stroke: [{width: 12, color: 'rgb(14, 194, 219)'}]
  }
});

map.addChild(lineStringFeature);

Полигон

Тип: Polygon.

Пример использования:

const polygonFeature = new YMapFeature({
  id: 'polygon',
  source: 'featureSource',
  geometry: {
    type: 'Polygon',
    coordinates: [
      [
        [25.029762, 55.189311],
        [25.229762, 55.289311],
        [25.329762, 55.389311]
      ]
    ]
  },
  style: {
    stroke: [{width: 6, color: 'rgb(14, 194, 219)'}],
    fill: 'rgba(56, 56, 219, 0.5)'
  }
});

map.addChild(polygonFeature);

Круг

Для создания круга в GeoJSON можно использовать библиотеку Turf.

Пример использования:

<!DOCTYPE html>
<html>
  <head>
    <meta charset="UTF-8" />
    <meta name="viewport" content="width=device-width, initial-scale=1, minimum-scale=1" />
    <script crossorigin src="https://cdn.jsdelivr.net/npm/@babel/standalone@7/babel.min.js"></script>

    <script crossorigin src="https://cdn.jsdelivr.net/npm/@turf/turf@7"></script>

    <!-- Чтобы карта появилась, вы должны добавить свой api-ключ -->
    <script src="https://api-maps.yandex.ru/v3/?apikey=<YOUR_APIKEY>&lang=en_US" type="text/javascript"></script>

    <script
      data-plugins="transform-modules-umd"
      data-presets="typescript"
      type="text/babel"
      src="../variables.ts"
    ></script>
    <script data-plugins="transform-modules-umd" data-presets="typescript" type="text/babel">
      import {
        CIRCLE_CENTER,
        CIRCLE_DASHED_CENTER,
        CIRCLE_DASHED_STYLE,
        CIRCLE_RADIUS,
        CIRCLE_STYLE,
        CIRCLE_WITHOUT_STROKE_CENTER,
        CIRCLE_WITHOUT_STROKE_STYLE,
        LOCATION,
        getCircleGeoJSON
      } from '../variables';

      window.map = null;

      main();
      async function main() {
        // Ожидание загрузки всех элементов api
        await ymaps3.ready;
        const {YMap, YMapDefaultSchemeLayer, YMapDefaultFeaturesLayer, YMapFeature} = ymaps3;

        // Инициализируйте карту
        map = new YMap(
          // Передайте ссылку на HTML-элемент контейнера
          document.getElementById('app'),
          // Передайте параметры инициализации карты
          {location: LOCATION, showScaleInCopyrights: true},
          // Добавьте слой схемы карты
          [new YMapDefaultSchemeLayer({}), new YMapDefaultFeaturesLayer({})]
        );

        // Создать круг по умолчанию
        const circle = new YMapFeature({
          geometry: getCircleGeoJSON(CIRCLE_CENTER, CIRCLE_RADIUS),
          style: CIRCLE_STYLE
        });
        map.addChild(circle);

        // Создайте круг с помощью пользовательских стилей
        const circleDashed = new YMapFeature({
          geometry: getCircleGeoJSON(CIRCLE_DASHED_CENTER, CIRCLE_RADIUS),
          style: CIRCLE_DASHED_STYLE
        });
        map.addChild(circleDashed);

        // Создайте круг без обводки
        const circleWithoutStroke = new YMapFeature({
          geometry: getCircleGeoJSON(CIRCLE_WITHOUT_STROKE_CENTER, CIRCLE_RADIUS),
          style: CIRCLE_WITHOUT_STROKE_STYLE
        });

        map.addChild(circleWithoutStroke);
      }
    </script>

    <style> html, body, #app { width: 100%; height: 100%; margin: 0; padding: 0; font-family: Arial, Helvetica, sans-serif; } .toolbar { position: absolute; z-index: 1000; top: 0; left: 0; display: flex; align-items: center; padding: 16px; } .toolbar a { padding: 16px; }  </style>
  </head>
  <body>
    <div id="app"></div>
  </body>
</html>

<!DOCTYPE html>
<html>
  <head>
    <meta charset="UTF-8" />
    <meta name="viewport" content="width=device-width, initial-scale=1, minimum-scale=1" />
    <script crossorigin src="https://cdn.jsdelivr.net/npm/react@17/umd/react.production.min.js"></script>
    <script crossorigin src="https://cdn.jsdelivr.net/npm/react-dom@17/umd/react-dom.production.min.js"></script>
    <script crossorigin src="https://cdn.jsdelivr.net/npm/@babel/standalone@7/babel.min.js"></script>

    <script crossorigin src="https://cdn.jsdelivr.net/npm/@turf/turf@7"></script>

    <!-- Чтобы карта появилась, вы должны добавить свой api-ключ -->
    <script src="https://api-maps.yandex.ru/v3/?apikey=<YOUR_APIKEY>&lang=en_US" type="text/javascript"></script>

    <script
      data-plugins="transform-modules-umd"
      data-presets="react, typescript"
      type="text/babel"
      src="../variables.ts"
    ></script>
    <script data-plugins="transform-modules-umd" data-presets="react, typescript" type="text/babel">
      import {
        CIRCLE_CENTER,
        CIRCLE_DASHED_CENTER,
        CIRCLE_DASHED_STYLE,
        CIRCLE_RADIUS,
        CIRCLE_STYLE,
        CIRCLE_WITHOUT_STROKE_CENTER,
        CIRCLE_WITHOUT_STROKE_STYLE,
        LOCATION,
        getCircleGeoJSON
      } from '../variables';

      window.map = null;

      main();
      async function main() {
        // Для каждого объекта в JS API существует аналог React
        // Чтобы использовать React-версию API, включите модуль @yandex/ymaps3-reactify
        const [ymaps3React] = await Promise.all([ymaps3.import('@yandex/ymaps3-reactify'), ymaps3.ready]);
        const reactify = ymaps3React.reactify.bindTo(React, ReactDOM);
        const {YMap, YMapDefaultSchemeLayer, YMapDefaultFeaturesLayer, YMapFeature} = reactify.module(ymaps3);
        const {useMemo} = React;

        function App() {
          const circleGeometry = useMemo(() => getCircleGeoJSON(CIRCLE_CENTER, CIRCLE_RADIUS), []);
          const circleDashedGeometry = useMemo(() => getCircleGeoJSON(CIRCLE_DASHED_CENTER, CIRCLE_RADIUS), []);
          const circleWithoutStrokeGeometry = useMemo(
            () => getCircleGeoJSON(CIRCLE_WITHOUT_STROKE_CENTER, CIRCLE_RADIUS),
            []
          );
          return (
            // Инициализируйте карту и передайте параметры инициализации
            <YMap location={LOCATION} showScaleInCopyrights={true} ref={(x) => (map = x)}>
              {/* Добавьте слой схемы карты */}
              <YMapDefaultSchemeLayer />
              <YMapDefaultFeaturesLayer />
              <YMapFeature geometry={circleGeometry} style={CIRCLE_STYLE} />
              <YMapFeature geometry={circleDashedGeometry} style={CIRCLE_DASHED_STYLE} />
              <YMapFeature geometry={circleWithoutStrokeGeometry} style={CIRCLE_WITHOUT_STROKE_STYLE} />
            </YMap>
          );
        }

        ReactDOM.render(
          <React.StrictMode>
            <App />
          </React.StrictMode>,
          document.getElementById('app')
        );
      }
    </script>

    <style> html, body, #app { width: 100%; height: 100%; margin: 0; padding: 0; font-family: Arial, Helvetica, sans-serif; } .toolbar { position: absolute; z-index: 1000; top: 0; left: 0; display: flex; align-items: center; padding: 16px; } .toolbar a { padding: 16px; }  </style>
  </head>
  <body>
    <div id="app"></div>
  </body>
</html>

<!DOCTYPE html>
<html>
  <head>
    <meta charset="UTF-8" />
    <meta name="viewport" content="width=device-width, initial-scale=1, minimum-scale=1" />
    <script crossorigin src="https://cdn.jsdelivr.net/npm/vue@3/dist/vue.global.js"></script>
    <script crossorigin src="https://cdn.jsdelivr.net/npm/@babel/standalone@7/babel.min.js"></script>

    <script crossorigin src="https://cdn.jsdelivr.net/npm/@turf/turf@7"></script>

    <script src="https://api-maps.yandex.ru/v3/?apikey=<YOUR_APIKEY>&lang=en_US" type="text/javascript"></script>

    <script
      data-plugins="transform-modules-umd"
      data-presets="typescript"
      type="text/babel"
      src="../variables.ts"
    ></script>
    <script data-plugins="transform-modules-umd" data-presets="typescript" type="text/babel">
      import {
        CIRCLE_CENTER,
        CIRCLE_DASHED_CENTER,
        CIRCLE_DASHED_STYLE,
        CIRCLE_RADIUS,
        CIRCLE_STYLE,
        CIRCLE_WITHOUT_STROKE_CENTER,
        CIRCLE_WITHOUT_STROKE_STYLE,
        LOCATION,
        getCircleGeoJSON
      } from '../variables';

      window.map = null;

      async function main() {
        // Для каждого объекта в JS API существует аналог Vue
        // Чтобы использовать версию API Vue, включите модуль @yandex/ymaps3-vuefy
        const [ymaps3Vue] = await Promise.all([ymaps3.import('@yandex/ymaps3-vuefy'), ymaps3.ready]);
        const vuefy = ymaps3Vue.vuefy.bindTo(Vue);
        const {YMap, YMapDefaultSchemeLayer, YMapDefaultFeaturesLayer, YMapFeature} = vuefy.module(ymaps3);

        const app = Vue.createApp({
          components: {YMap, YMapDefaultSchemeLayer, YMapDefaultFeaturesLayer, YMapFeature},
          setup() {
            const refMap = (ref) => {
              window.map = ref?.entity;
            };
            const circleGeometry = Vue.ref(getCircleGeoJSON(CIRCLE_CENTER, CIRCLE_RADIUS));
            const circleDashedGeometry = Vue.ref(getCircleGeoJSON(CIRCLE_DASHED_CENTER, CIRCLE_RADIUS));
            const circleWithoutStrokeGeometry = Vue.ref(
              getCircleGeoJSON(CIRCLE_WITHOUT_STROKE_CENTER, CIRCLE_RADIUS)
            );
            return {
              LOCATION,
              CIRCLE_CENTER,
              CIRCLE_DASHED_CENTER,
              CIRCLE_DASHED_STYLE,
              CIRCLE_WITHOUT_STROKE_STYLE,
              CIRCLE_WITHOUT_STROKE_CENTER,
              CIRCLE_STYLE,
              circleGeometry,
              circleDashedGeometry,
              circleWithoutStrokeGeometry,
              refMap
            };
          },
          template: `
            <YMap :location="LOCATION" :showScaleInCopyrights="true" :ref="refMap">
                <YMapDefaultSchemeLayer />
                <YMapDefaultFeaturesLayer />
                <YMapFeature :geometry="circleGeometry" :style="CIRCLE_STYLE" />
                <YMapFeature :geometry="circleDashedGeometry" :style="CIRCLE_DASHED_STYLE" />
                <YMapFeature :geometry="circleWithoutStrokeGeometry" :style="CIRCLE_WITHOUT_STROKE_STYLE" />
            </YMap>`
        });
        app.mount('#app');
      }
      main();
    </script>

    <style> html, body, #app { width: 100%; height: 100%; margin: 0; padding: 0; font-family: Arial, Helvetica, sans-serif; } .toolbar { position: absolute; z-index: 1000; top: 0; left: 0; display: flex; align-items: center; padding: 16px; } .toolbar a { padding: 16px; }  </style>
  </head>
  <body>
    <div id="app"></div>
  </body>
</html>

import type {DrawingStyle, LngLat, PolygonGeometry, YMapLocationRequest} from '@yandex/ymaps3-types';

declare global {
  const turf: typeof import('@turf/turf');
}

export const LOCATION: YMapLocationRequest = {
  center: [37.588144, 55.733842], // исходное положение [lng, lat]
  zoom: 12 // начальный масштаб
};

export const CIRCLE_CENTER: LngLat = [37.618536, 55.760257];
export const CIRCLE_RADIUS = 1500;
export const CIRCLE_STYLE: DrawingStyle = {simplificationRate: 0};

export const CIRCLE_DASHED_CENTER: LngLat = [37.608301, 55.738633];
export const CIRCLE_DASHED_STYLE: DrawingStyle = {
  simplificationRate: 0,
  stroke: [{color: '#006efc', width: 4, dash: [5, 10]}],
  fill: 'rgba(56, 56, 219, 0.5)'
};

export const CIRCLE_WITHOUT_STROKE_CENTER: LngLat = [37.660536, 55.730257];
export const CIRCLE_WITHOUT_STROKE_STYLE: DrawingStyle = {simplificationRate: 0, stroke: []};

export const getCircleGeoJSON = (center: LngLat, radiusMeters: number): PolygonGeometry => {
  const {geometry} = turf.circle(center, radiusMeters, {units: 'meters'});
  return geometry as PolygonGeometry;
};

Конструктор

new YMapFeature(props)

Параметры конструктора

Параметр

Тип

props

YMapFeatureProps

Переопределяет

YMapEntity.constructor

Props

YMapFeatureProps: {
	disableRoundCoordinates?: boolean;
	geometry: Geometry;
	hideOutsideViewport?: HideOutsideRule;
	id?: string;
	properties?: Record<string, unknown>;
	source?: string;
	style?: DrawingStyle
} & DraggableProps<YMapFeatureEventHandler> & BlockingProps & FeatureClickEvents

Методы

update

update(changedProps): void

Параметры

Параметр

Тип

Описание

changedProps

Partial<YMapFeatureProps>

Новые значения props.

Возвращается

void

Унаследовано от

YMapEntity.update

Предыдущая
Геообъекты
Следующая
Маркеры