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

geo_intersects_line_with_polygon()

  • Статья

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

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

Синтаксис

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

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

Параметры

Имя (название) Type Обязательно Описание
lineString dynamic ✔️ LineString или MultiLineString в формате GeoJSON.
многоугольник dynamic ✔️ Многоугольник или MultiPolygon в формате 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 для повышения производительности.

Примеры

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

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 intersects = geo_intersects_line_with_polygon(lineString, polygon)

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

Пересекает
Истина

В следующем примере находятся все дороги в таблице дорог Нью-Йорка 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
| where geo_intersects_line_with_polygon(road, area_of_interest)
| project name

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

name
Центральный парк W
Фредерик Дугласс Чир
W 110th St
Западная д-р

В следующем примере обнаруживаются все округа в США, пересекающихся с областью интересующего литерала 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
| where geo_intersects_line_with_polygon(area_of_interest, county)
| project name

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

name
Нью-Йорк

В следующем примере возвращается пустой результат, так как 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 isnull(geo_intersects_2lines(lineString, polygon))

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

print_0
Истина

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

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 isnull(geo_intersects_2lines(lineString, polygon))

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

print_0
Истина