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

geo_simplify_polygons_array()

  • Статья

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

Упрощает многоугольники, заменив почти прямые цепи коротких ребер одним длинным краем на Земле.

Синтаксис

geo_simplify_polygons_array(допустимости многоугольников, )

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

Параметры

Имя (название) Type Обязательно Описание
многоугольник dynamic ✔️ Многоугольник или многополигон в формате GeoJSON.
tolerance int, long или real Определяет минимальное расстояние в метрах между двумя вершинами. Поддерживаемые значения находятся в диапазоне [0, ~7800 000 метров]. Если не задано, по умолчанию используется значение 10.

Возвраты

Упрощенное многоугольник или многоугольник в формате GeoJSON и динамического типа данных без двух вершин с расстоянием меньше допустимости. Если многоугольник или допустимость недопустимы, запрос создаст пустой результат.

Примечание.

  • Если входные данные являются одним многоугольником, см . geo_polygon_simplify().
  • Геопространственные координаты интерпретируются как представленные эталонной системой координат 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 может совместно использовать вершины.

Примеры

В следующем примере многоугольники упрощают взаимные границы (США состояния), удаляя вершины, находящиеся в пределах 100-метрового расстояния друг от друга.

US_States
| project polygon = features.geometry
| summarize lst = make_list(polygon)
| project polygons = geo_simplify_polygons_array(lst, 100)

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

Полигоны
{ "type": "MultiPolygon", "координаты": [ ... ]]}

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

datatable(polygons:dynamic)
[
    dynamic({"type":"Polygon","coordinates":[[[-73.9495,40.7969],[-73.95807,40.80068],[-73.98201,40.76825],[-73.97317,40.76455],[-73.9495,40.7969]]]}),
    dynamic({"type":"Polygon","coordinates":[[[-73.94622,40.79249]]]}),
    dynamic({"type":"Polygon","coordinates":[[[-73.97335,40.77274],[-73.9936,40.76630],[-73.97171,40.75655],[-73.97335,40.77274]]]})
]
| summarize arr = make_list(polygons)
| project is_invalid_polygon = isnull(geo_simplify_polygons_array(arr))

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

is_invalid_polygon
1

В следующем примере возвращается значение True из-за недопустимого допуска.

datatable(polygons:dynamic)
[
    dynamic({"type":"Polygon","coordinates":[[[-73.9495,40.7969],[-73.95807,40.80068],[-73.98201,40.76825],[-73.97317,40.76455],[-73.9495,40.7969]]]}),
    dynamic({"type":"Polygon","coordinates":[[[-73.94622,40.79249],[-73.96888,40.79282],[-73.9577,40.7789],[-73.94622,40.79249]]]}),
    dynamic({"type":"Polygon","coordinates":[[[-73.97335,40.77274],[-73.9936,40.76630],[-73.97171,40.75655],[-73.97335,40.77274]]]})
]
| summarize arr = make_list(polygons)
| project is_null = isnull(geo_simplify_polygons_array(arr, -1))

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

is_null
1

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

datatable(polygons:dynamic)
[
    dynamic({"type":"Polygon","coordinates":[[[-73.9495,40.7969],[-73.95807,40.80068],[-73.98201,40.76825],[-73.97317,40.76455],[-73.9495,40.7969]]]}),
    dynamic({"type":"Polygon","coordinates":[[[-73.94622,40.79249],[-73.96888,40.79282],[-73.9577,40.7789],[-73.94622,40.79249]]]}),
    dynamic({"type":"Polygon","coordinates":[[[-73.97335,40.77274],[-73.9936,40.76630],[-73.97171,40.75655],[-73.97335,40.77274]]]})
]
| summarize arr = make_list(polygons)
| project is_null = isnull(geo_simplify_polygons_array(arr, 10000))

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

is_null
1