geo_intersection_line_with_polygon()

Статья
11/23/2024

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

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

Синтаксис

geo_intersection_line_with_polygon(многоугольник lineString,)

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

Параметры

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

Возвраты

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

Примечание.

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

Определение и ограничения LineString

dynamic({"type": "LineString","координаты": [[lng_1,lat_1], [lng_2,lat_2], ..., [lng_N,lat_N]]})

dynamic({"type": "MultiLineString","координаты": [[line_1, line_2, ..., line_N]})

Массив координат LineString должен содержать не менее двух записей.
Координаты [долгота, широта] должны быть допустимыми, где долгота является реальным числом в диапазоне [-180, +180] и широта является реальным числом в диапазоне [-90, +90].
Длина края должна быть меньше 180 градусов. Будет выбран самый короткий край между двумя вершинами.

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

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 может совместно использовать вершины.
Многоугольник содержит вершины.

Совет

Используйте литерал LineString или MultiLineString для повышения производительности.

Примеры

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

Выполнить запрос

let lineString = dynamic({"type":"LineString","coordinates":[[-73.985195,40.788275],[-73.974552,40.779761]]});
let polygon = dynamic({"type":"Polygon","coordinates":[[[-73.9712905883789,40.78580561168767],[-73.98004531860352,40.775276834803655],[-73.97000312805176,40.77852663535664],[-73.9712905883789,40.78580561168767]]]});
print intersection = geo_intersection_line_with_polygon(lineString, polygon)

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

intersection
{"type": "LineString","координаты": [[-73.97561956578192,40.78060906714618],[-73.974552,40.779761]]}

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

Выполнить запрос

let lineString = dynamic({"type":"LineString","coordinates":[[-110.522, 39.198],[-91.428, 40.880]]});
let polygon = dynamic({"type":"Polygon","coordinates":[[[-90.263,36.738],[-102.041,45.274],[-109.335,36.527],[-90.263,36.738]],[[-100.393,41.705],[-103.139,38.925],[-97.558,39.113],[-100.393,41.705]]]});
print intersection = geo_intersection_line_with_polygon(lineString, polygon)

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

intersection
{"type": "MultiLineString","координаты": [[[ -106.89353655881905, 39.76926209776306],[ -101.7448553679453, 40.373506008712525]],[[-99.136499431328858, 40.5893365126999994],[-95.2845277311791, 40.79906024246348]]

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

Выполнить запрос

let lineString = dynamic({"type":"LineString","coordinates":[[1, 1],[2, 2]]});
let polygon = dynamic({"type":"Polygon","coordinates":[[[-73.9712905883789,40.78580561168767],[-73.98004531860352,40.775276834803655],[-73.97000312805176,40.77852663535664],[-73.9712905883789,40.78580561168767]]]});
print intersection = geo_intersection_line_with_polygon(lineString, polygon)

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

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

В следующем примере находятся все дороги в таблице дорог Нью-Йорка GeoJSON, пересекающейся с областью интересующего литерального многоугольника.

let area_of_interest = dynamic({"type":"Polygon","coordinates":[[[-73.95768642425537,40.80065354924362],[-73.9582872390747,40.80089719667298],[-73.95869493484497,40.80050736035672],[-73.9580512046814,40.80019873831593],[-73.95768642425537,40.80065354924362]]]});
NY_Manhattan_Roads
| project name = features.properties.Label, road = features.geometry
| project name, intersection = geo_intersection_line_with_polygon(road, area_of_interest)
| where array_length(intersection.geometries) != 0

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

name	intersection
CentralParkW	{"type":"MultiLineString","координаты":[[-73.958295846836933,40.800316027289647],[-73.95827244,40.80.8003415]],[[-73.9584134219482 40.40037239620097],[-73.9584093,40.800377]]}
FrederickDouglassCir	{"type":"LineString","coordinates":[[-73.9579272943862,40.800751229494182],[-73.9579019,40.8007238],[-73.9578688,40.8006749],[-73.9578508,40.8006203],[-73.9578459,40.800570199999996],[-73.9578484,40.80053310000001],[-73.9578627,40.800486700000008],[-73.957913,40.800421100000008],[-73.9579668,40.8003923],[-73.9580189,40.80037260000001],[-73.9580543,40.8003616],[-73.9581237,40.8003395],[-73.9581778,40.8003365],[-73.9582724,40.8003415],[- 73.958308,40.8003466],[-73.9583328,40.8003517],[-73.9583757,40.8003645],[-73.9584093,40.8003797],[-73.9584535,40.80041099999999],[-73.9584818,40.8004536],[-73.958507000000012,40.8004955],[-73.9585217,40.800562400000004],[-73.9585282,40.8006155],[-73.958416200000016,40.8007325],[-73.9583541,40.8007785],[-73.9582772,40.800811499999995],[-73.9582151,40.8008285],[-73.958145918999392,40.800839887820239]]}
W110thSt	{"type":"MultiLineString","координаты":[[-73.9578284460363631,40.800476476316316327],[-173.9578627,40.80048670000000008],[[-73.9585282,40.800615],],[-73.958565492035873 40.8006313466972]],[[[-73.958416200000016,40.8007325],[-73.958446850928084,40.8007457466617]]]}
WestDr	{"type":"LineString","координаты":[-73.9580543,40.8003616],[-73.9580096939393935,40.800250494588468]]}

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

Выполнить запрос

let area_of_interest = dynamic({"type":"LineString","coordinates":[[-73.97159099578857,40.794513338780895],[-73.96738529205322,40.792758888618756],[-73.96978855133057,40.789769718601505]]});
US_Counties
| project name = features.properties.NAME, county = features.geometry
| project name, intersection = geo_intersection_line_with_polygon(area_of_interest, county)
| where array_length(intersection.geometries) != 0

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

name	intersection
Нью-Йорк	{"type": "LineString","координаты": [[-73.97159099578574, 40.794513338080895], [-73.96738529205323, 40.792758888618756],[-73.96978551330566, 40.78976971860151512]] }

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

Выполнить запрос

let lineString = dynamic({"type":"LineString","coordinates":[[-73.985195,40.788275]]});
let polygon = dynamic({"type":"Polygon","coordinates":[[[-73.95768642425537,40.80065354924362],[-73.9582872390747,40.80089719667298],[-73.95869493484497,40.80050736035672],[-73.9580512046814,40.80019873831593],[-73.95768642425537,40.80065354924362]]]});
print is_invalid = isnull(geo_intersection_2lines(lineString, polygon))

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

is_invalid
1

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

Выполнить запрос

let lineString = dynamic({"type":"LineString","coordinates":[[-73.97159099578857,40.794513338780895],[-73.96738529205322,40.792758888618756],[-73.96978855133057,40.789769718601505]]});
let polygon = dynamic({"type":"Polygon","coordinates":[]});
print is_invalid = isnull(geo_intersection_2lines(lineString, polygon))

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

is_invalid
1

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

geo_intersection_line_with_polygon()

Синтаксис

Параметры

Возвраты

Примеры

Обратная связь

Дополнительные ресурсы