Поделиться через

geo_intersection_2polygons()

  • Статья

Область применения: ✅Microsoft Fabric✅Azure Data Explorer✅Azure Monitor✅Microsoft Sentinel

Вычисляет пересечение двух многоугольников или многоугольников.

Синтаксис

geo_intersection_2polygons(многоугольник1,многоугольник1)

Дополнительные сведения о соглашениях синтаксиса.

Параметры

Имя (название) Type Обязательно Описание
многоугольник1 dynamic ✔️ Многоугольник или многополигон в формате GeoJSON.
многоугольник2 dynamic ✔️ Многоугольник или многополигон в формате GeoJSON.

Возвраты

Пересечение в формате GeoJSON и динамического типа данных. Если Polygon или MultiPolygon недопустимы, запрос создаст результат NULL.

Примечание.

  • Геопространственные координаты интерпретируются как представленные эталонной системой координат WGS-84 .
  • Геопоток, используемый для измерений на Земле, является сферой. Границы многоугольников — геодесик на сфере.
  • Если ребра входных многоугольников являются прямыми декартовыми линиями, рассмотрите возможность использования geo_polygon_densify() для преобразования плановых ребер в геодесик.

Определение и ограничения многоугольника

dynamic({"type": "Polygon", "координаты": [LinearRingShell, LinearRingHole_1, ..., LinearRingHole_N ]})

dynamic({"type": "MultiPolygon","координаты": [[LinearRingShell, LinearRingHole_1, ..., LinearRingHole_N ],..., [LinearRingShell, LinearRingHole_1, ..., LinearRingHole_M]]})

  • LinearRingShell является обязательным и определяется как упорядоченный counterclockwise массив координат [[lng_1,lat_1]],...,[lng_i,lat_i],...,[lng_j;lat_j]],...,[lng_1,lat_1]]. Может быть только одна оболочка.
  • LinearRingHole является необязательным и определяется как упорядоченный clockwise массив координат [[lng_1,lat_1],...,[lng_i,lat_i],...,[lng_j;lat_j]],...,[lng_1,lat_1]]. Может быть любое количество внутренних колец и отверстий.
  • Вершины LinearRing должны отличаться по крайней мере тремя координатами. Первая координата должна быть равна последней. Требуются по крайней мере четыре записи.
  • Координаты [долгота, широта] должны быть допустимыми. Долгота должна быть реальным числом в диапазоне [-180, +180], а широта должна быть реальным числом в диапазоне [-90, +90].
  • LinearRingShell заключает в себя не более половины сферы. LinearRing делит сферу на два региона. Будет выбрано меньшее из двух регионов.
  • Длина края линейного ринга должна быть меньше 180 градусов. Будет выбран самый короткий край между двумя вершинами.
  • Линейные ринги не должны пересекать границы и не должны совместно использовать края. LinearRings может совместно использовать вершины.
  • Многоугольник содержит вершины.

Совет

  • Использование литерального многоугольника или MultiPolygon может привести к повышению производительности.

Примеры

В следующем примере вычисляется пересечение между двумя многоугольниками. В этом случае результатом является многоугольник.

let polygon1 = dynamic({"type":"Polygon","coordinates":[[[-73.9630937576294,40.77498840732385],[-73.963565826416,40.774383111780914],[-73.96205306053162,40.773745311181585],[-73.96160781383514,40.7743912365898],[-73.9630937576294,40.77498840732385]]]});
let polygon2 = dynamic({"type":"Polygon","coordinates":[[[-73.96213352680206,40.775045280447145],[-73.9631313085556,40.774578106920345],[-73.96207988262177,40.77416780398293],[-73.96213352680206,40.775045280447145]]]});
print intersection = geo_intersection_2polygons(polygon1, polygon2)

Выходные данные

intersection
{"type": "Polygon", "coordinates": [[[-73.962105776437156,40.774591360999679],[-73.962642403166868,40.774807020251778],[-73.9631313085556,40.774578106920352],[-73.962079882621765,40.774167803982927],[-73.962105776437156,40.774591360999679]]]}

В следующем примере вычисляется пересечение между двумя многоугольниками. В этом случае результатом является точка.

let polygon1 = dynamic({"type":"Polygon","coordinates":[[[2,45],[0,45],[1,44],[2,45]]]});
let polygon2 = dynamic({"type":"Polygon","coordinates":[[[3,44],[2,45],[2,43],[3,44]]]});
print intersection = geo_intersection_2polygons(polygon1, polygon2)

Выходные данные

intersection
{"type": "Point", "координаты": [2,45]}

Следующие два многоугольника являются коллекцией.

let polygon1 = dynamic({"type":"Polygon","coordinates":[[[2,45],[0,45],[1,44],[2,45]]]});
let polygon2 = dynamic({"type":"MultiPolygon","coordinates":[[[[3,44],[2,45],[2,43],[3,44]]],[[[1.192,45.265],[1.005,44.943],[1.356,44.937],[1.192,45.265]]]]});
print intersection = geo_intersection_2polygons(polygon1, polygon2)

Выходные данные

intersection
{"type": "GeometryCollection","geometries": [
{ "type": "Point", "координаты": [2, 45]},
{ "type": "Polygon", "координаты": [[[1.3227075526410679,45.003909145068739],[1.04045653774899824,45.004356403066552],[1.005,44.943],[1.356,44.937],[1.322707526410679,45.003909145068739]]}}

Следующие два многоугольника не пересекаются.

let polygon1 = dynamic({"type":"Polygon","coordinates":[[[2,45],[0,45],[1,44],[2,45]]]});
let polygon2 = dynamic({"type":"Polygon","coordinates":[[[3,44],[3,45],[2,43],[3,44]]]});
print intersection = geo_intersection_2polygons(polygon1, polygon2)

Выходные данные

intersection
{"type": GeometryCollection", "geometries": []}

В следующем примере все округа находятся в США, пересекающихся с областью интересующего многоугольника.

let area_of_interest = dynamic({"type":"Polygon","coordinates":[[[-73.96213352680206,40.775045280447145],[-73.9631313085556,40.774578106920345],[-73.96207988262177,40.77416780398293],[-73.96213352680206,40.775045280447145]]]});
US_Counties
| project name = features.properties.NAME, county = features.geometry
| project name, intersection = geo_intersection_2polygons(county, area_of_interest)
| where array_length(intersection.geometries) != 0

Выходные данные

name intersection
Нью-Йорк {"type": "Polygon","координаты": [[-73.96213352680206, 40.775045280447145], [-73.96313131308556, 40.774578106920345], [-73.96207988262177,40.77416780398293],[-73.96213352680206, 40.7750450480480447145]]] }

В следующем примере возвращается пустой результат, так как один из многоугольников недопустим.

let central_park_polygon = dynamic({"type":"Polygon","coordinates":[[[-73.9495,40.7969],[-73.95807266235352,40.80068603561921],[-73.98201942443848,40.76825672305777],[-73.97317886352539,40.76455136505513],[-73.9495,40.7969]]]});
let invalid_polygon = dynamic({"type":"Polygon"});
print isnull(geo_intersection_2polygons(invalid_polygon, central_park_polygon))

Выходные данные

print_0
1