Reo.Core.Elastic.Geo 10.0.210

Reo.Core.Elastic.Geo

Описание пакета

Пакет Reo.Core.Elastic.Geo предоставляет набор утилит для работы с геоспacialными данными в контексте Elasticsearch. Он позволяет выполнять операции, такие как вычисление расстояния между точками, проверка вхождения точки в полигон и работа с мультиполигонами. Пакет ориентирован на разработчиков, которые интегрируют геосpatial-функциональность в приложения, например, для решения задач региональных операторов, управления зонами и областями.

Основные функции:

• Вычисление расстояния между географическими точками.
• Проверка, находится ли точка внутри полигонов (многоугольников).
• Поддержка работы с мультиполигонами через интерфейс IMultiPolygon.

Основные компоненты

1. GeoUtilities

• Описание: Класс с утилитными методами для геосpatial-операций.
• Методы:
  • CalculateDistance(GeoLocation point1, GeoLocation point2): Вычисляет расстояние между двумя точками в метрах.
  • IsPointInPolygon(GeoLocation point, MultiPolygonGeoShape polygon): Проверяет, находится ли точка внутри заданного полигонов.

2. IMultiPolygon

• Описание: Интерфейс, определяющий структуру мультиполигонов.
• Свойства:
  • MultiPolygonGeoShape MultiPolygon: Представляет мультиполигон в формате, совместимом с Elasticsearch.

3. RegionGeoDoc, ZoneGeoDoc, RegOperatorAreaGeoDoc

• Описание: Классы, моделирующие географические объекты (регионы, зоны, области) с поддержкой мультиполигонов.
• Свойства:
  • GeoLocation Centroid: Центральная точка объекта (используется для центрирования карты).
  • MultiPolygonGeoShape MultiPolygon: Геометрическое представление объекта.

Требования

Совместимость

• .NET: .NET 8.0

Зависимости

• NetTopologySuite: Для работы с геометрическими объектами.
• Elasticsearch.Client (не указан в проекте, но может быть неявной зависимостью для работы с Elasticsearch).

Установка

NuGet Package Manager

Install-Package Reo.Core.Elastic.Geo

.NET CLI

dotnet add package Reo.Core.Elastic.Geo

Настройка

Регистрация в DI-контейнере (ASP.NET Core)

Если пакет предоставляет сервисы, их можно зарегистрировать в Startup.cs или Program.cs:

services.AddSingleton<GeoUtilities>();

⚠️ Если сервисы не требуются, настройка может быть необязательной.

Использование

Пример 1: Проверка вхождения точки в полигон

var point = new GeoLocation(55.7558, 37.6176); // Москва
var polygon = new MultiPolygonGeoShape(new[] { new[] { new GeoLocation(55.75, 37.60), new GeoLocation(55.76, 37.62) } });

bool isInside = GeoUtilities.IsPointInPolygon(point, polygon);
Console.WriteLine($"Точка находится внутри полигона: {isInside}");

Пример 2: Вычисление расстояния между точками

var point1 = new GeoLocation(55.7558, 37.6176); // Москва
var point2 = new GeoLocation(59.9343, 30.3351); // Санкт-Петербург

double distance = GeoUtilities.CalculateDistance(point1, point2);
Console.WriteLine($"Расстояние между точками: {distance} метров");

Лицензия

Данный пакет распространяется под лицензией MIT.