geo_polygon_perimeter()
Вычисляет длину границы многоугольника или многополигона на Земле.
Синтаксис
geo_polygon_perimeter(
Полигона)
Дополнительные сведения о соглашениях о синтаксисе.
Параметры
Имя | Тип | Обязательно | Описание |
---|---|---|---|
Полигона | dynamic |
✔️ | Многоугольник или многополигон в формате GeoJSON. |
Возвращаемое значение
Длина границы многоугольника или многополигона в метрах на Земле. Если многоугольник или многополигон недопустимы, запрос выдаст пустой результат.
Примечание
- Геопространственные координаты интерпретируются в виде системы координат WGS-84 .
- Для измерений на Земле используется географическая datum . Края многоугольников — это геодесика на шаре.
- Если края входных многоугольников являются прямыми декартовыми линиями, рассмотрите возможность использования 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 делит сферу на две области. Будет выбран меньший из двух регионов.
- Длина края LinearRing должна быть меньше 180 градусов. Будет выбран самый короткий край между двумя вершинами.
- LinearRings не должны пересекать границы и не должны совместно использовать ребра. LinearRings может совместно использовать вершины.
Примеры
В следующем примере вычисляется периметр центрального парка Нью-Йорка в метрах.
let central_park = dynamic({"type":"Polygon","coordinates":[[[-73.9495,40.7969],[-73.95807266235352,40.80068603561921],[-73.98201942443848,40.76825672305777],[-73.97317886352539,40.76455136505513],[-73.9495,40.7969]]]});
print perimeter = geo_polygon_perimeter(central_park)
Выходные данные
Периметра |
---|
9930.30149604938 |
В следующем примере выполняется объединение многоугольников в многополигоне и вычисляется периметр единого многоугольника.
let polygons = dynamic({"type":"MultiPolygon","coordinates":[[[[-73.9495,40.7969],[-73.95807266235352,40.80068603561921],[-73.98201942443848,40.76825672305777],[-73.97317886352539,40.76455136505513],[-73.9495,40.7969]]],[[[-73.94262313842773,40.775991804565585],[-73.98107528686523,40.791849155467695],[-73.99600982666016,40.77092185281977],[-73.96150588989258,40.75609977566361],[-73.94262313842773,40.775991804565585]]]]});
print perimeter = geo_polygon_perimeter(polygons)
Выходные данные
Периметра |
---|
15943.5384578745 |
В следующем примере возвращается значение True из-за недопустимого многоугольника.
print is_invalid = isnull(geo_polygon_perimeter(dynamic({"type": "Polygon","coordinates": [[[0,0],[10,10],[10,10],[0,0]]]})))
Выходные данные
is_invalid |
---|
True |
Обратная связь
https://aka.ms/ContentUserFeedback.
Ожидается в ближайшее время: в течение 2024 года мы постепенно откажемся от GitHub Issues как механизма обратной связи для контента и заменим его новой системой обратной связи. Дополнительные сведения см. в разделеОтправить и просмотреть отзыв по