geo_intersection_line_with_polygon()

Artículo
11/23/2024

Se aplica a: ✅Microsoft Fabric✅Azure Data Explorer ✅Azure Monitor✅Microsoft Sentinel

Calcula la intersección de una línea o una multilínea con un polígono o un multipolygon.

Sintaxis

geo_intersection_line_with_polygon(polígono lineString,)

Obtenga más información sobre las convenciones de sintaxis.

Parámetros

Nombre	Type	Obligatorio	Descripción
lineString	`dynamic`	✔️	LineString o MultiLineString en formato GeoJSON.
polígono	`dynamic`	✔️	Polígono o MultiPolygon en formato GeoJSON.

Devoluciones

Intersección en formato GeoJSON y de un tipo de datos dinámico . Si lineString o multiLineString o un polígono o un multipolygon no son válidos, la consulta generará un resultado nulo.

Nota:

Las coordenadas geoespaciales se interpretan como representadas por el sistema de referencia de coordenadas WGS-84 .
El dato geodético utilizado para medir la distancia en la Tierra es una esfera. Los bordes de línea son geodesics en la esfera.
Si la línea de entrada o los bordes de un polígono son líneas cartesianas rectas, considere la posibilidad de usar geo_line_densify() o un geo_polygon_densify() para convertir bordes planar a geodesics.

Definición y restricciones lineString

dynamic({"type": "LineString","coordinates": [[lng_1,lat_1], [lng_2,lat_2], ..., [lng_N,lat_N]]})

dynamic({"type": "MultiLineString","coordinates": [[line_1, line_2, ..., line_N]]})

La matriz de coordenadas LineString debe contener al menos dos entradas.
Las coordenadas [longitud, latitud] deben ser válidas donde la longitud es un número real en el intervalo [-180, +180] y la latitud es un número real en el intervalo [-90, +90].
La longitud del borde debe ser inferior a 180 grados. Se elegirá el borde más corto entre los dos vértices.

Definición y restricciones de polígono

dynamic({"type": "Polygon","coordinates": [LinearRingShell, LinearRingHole_1, ..., LinearRingHole_N]})

dynamic({"type": "MultiPolygon","coordinates": [[LinearRingShell, LinearRingHole_1, ..., LinearRingHole_N],..., [LinearRingShell, LinearRingHole_1, ..., LinearRingHole_M]]})

LinearRingShell es necesario y se define como una counterclockwise matriz ordenada de coordenadas [[lng_1,lat_1],...,[lng_i,lat_i],...,[lng_j,lat_j],...,[lng_1,lat_1]]. Solo puede haber un shell.
LinearRingHole es opcional y se define como una clockwise matriz ordenada de coordenadas [[lng_1,lat_1],...,[lng_i,lat_i],...,[lng_j,lat_j],...,[lng_1,lat_1]]. Puede haber cualquier número de anillos interiores y agujeros.
Los vértices linearRing deben ser distintos con al menos tres coordenadas. La primera coordenada debe ser igual a la última. Se requieren al menos cuatro entradas.
Las coordenadas [longitud, latitud] deben ser válidas. La longitud debe ser un número real en el intervalo [-180, +180] y la latitud debe ser un número real en el intervalo [-90, +90].
LinearRingShell incluye como máximo la mitad de la esfera. LinearRing divide la esfera en dos regiones. Se elegirá el menor de las dos regiones.
La longitud del borde LinearRing debe ser inferior a 180 grados. Se elegirá el borde más corto entre los dos vértices.
LinearRings no debe cruzar y no debe compartir bordes. LinearRings puede compartir vértices.
Polygon contiene sus vértices.

Sugerencia

Use lineString literal o MultiLineString para mejorar el rendimiento.

Ejemplos

En el ejemplo siguiente se calcula la intersección entre la línea y el polígono. En este caso, el resultado es una línea.

Ejecución de la consulta

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)

Salida

intersection
{"type": "LineString","coordinates": [[-73.975611956578192,40.78060906714618],[-73.974552,40.779761]]}

En el ejemplo siguiente se calcula la intersección entre la línea y el polígono. En este caso, el resultado es una línea múltiple.

Ejecución de la consulta

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)

Salida

intersection
{"type": "MultiLineString","coordinates": [[[ -106.89353655881905, 39.769226209776306],[ -101.7448553679453, 40.373506008712525]],[-99.136499431328858, 40.589336512699994],[-95.2845277311791, 40.79906024246348]]]]}

La siguiente línea y polígono no se intersecan.

Ejecución de la consulta

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)

Salida

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

En el ejemplo siguiente se buscan todas las carreteras de la tabla nyc GeoJSON roads que se intersecan con el área de interés literal polygon.

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

Salida

nombre	intersection
CentralParkW	{"type":"MultiLineString","coordinates":[[[-73.958295846836933,40.800316027289647],[-73.9582724,40.8003415]],[[-73.958413422194482,40.80037239620097],[-73.9584093,40.8003797]]]}
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","coordinates":[[[-73.957828446036331,40.800476476316327],[-73.9578627,40.800486700000008]],[[-73.9585282,40.8006155],[[-73.958528282,40.8006155],[[-73.958565492035873,40.800631133466972]],[[-73.958416200000000016,40.8007325],[-73.958446850928084,40.800744577466617]]]]}
WestDr	{"type":"LineString","coordinates":[[-73.9580543,40.8003616],[-73.95800969393938735,40.800250494588468]]}

En el ejemplo siguiente se buscan todos los condados de EE. UU. que se intersecan con el área de interés literal LineString.

Ejecución de la consulta

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

Salida

nombre	intersection
Nueva York	{"type": "LineString","coordinates": [[-73.971590995788574, 40.79451338780895], [-73.967385292053223, 40.7927588888618756],[-73.9697885130566, 40.789769718601512]]]}

En el ejemplo siguiente se devolverá un resultado NULO porque LineString no es válido.

Ejecución de la consulta

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))

Salida

is_invalid
1

En el ejemplo siguiente se devolverá un resultado NULO porque el polígono no es válido.

Ejecución de la consulta

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))

Salida

is_invalid
1

Compartir a través de

geo_intersection_line_with_polygon()

Sintaxis

Parámetros

Devoluciones

Ejemplos

Comentarios

Recursos adicionales