geo_intersection_line_with_polygon()

Článek
11/23/2024

Platí pro: ✅Microsoft Fabric✅Azure Data Explorer ✅Azure Monitor✅Microsoft Sentinel

Vypočítá průsečík čáry nebo víceřádkové čáry s mnohoúhelníkem nebo multipolygonem.

Syntaxe

geo_intersection_line_with_polygon(mnohoúhelník lineString,)

Přečtěte si další informace o konvencích syntaxe.

Parametry

Název	Type	Požadováno	Popis
lineString	`dynamic`	✔️	A LineString nebo MultiLineString ve formátu GeoJSON.
mnohoúhelník	`dynamic`	✔️	Polygon nebo MultiPolygon ve formátu GeoJSON.

Návraty

Průnik ve formátu GeoJSON a dynamického datového typu Pokud je řetězec lineString nebo multiLineString nebo mnohoúhelník nebo multipolygon neplatný, dotaz vytvoří výsledek null.

Poznámka:

Geoprostorové souřadnice jsou interpretovány jako reprezentované referenčním systémem souřadnic WGS-84 .
Geodetické datum použité k měření vzdálenosti na Zemi je sféra. Hrany čar jsou geodesics na kouli.
Pokud jsou vstupní čára nebo mnohoúhelníkové hrany rovné kartézské čáry, zvažte použití geo_line_densify() nebo geo_polygon_densify() k převodu planárních hran na geodesické čáry.

Definice a omezení řetězce řádků

dynamic({"type": "LineString";"souřadnice": [[lng_1;lat_1], [lng_2;lat_2], ...; [lng_N;lat_N]]})

dynamic({"type": "MultiLineString";"souřadnice": [[line_1; line_2; ..., line_N]})

Matice souřadnic linestringu musí obsahovat alespoň dvě položky.
Souřadnice [zeměpisná délka, zeměpisná šířka] musí být platné, pokud je zeměpisná délka skutečným číslem v rozsahu [-180, +180] a zeměpisná šířka je reálné číslo v rozsahu [-90, +90].
Délka okraje musí být menší než 180 stupňů. Vybere se nejkratší hrana mezi dvěma vrcholy.

Definice mnohoúhelníku a omezení

dynamic({"type": "Mnohoúhelník";"souřadnice": [LinearRingShell, LinearRingHole_1; ..., LinearRingHole_N]})

dynamic({"type": "MultiPolygon";"souřadnice": [[LinearRingShell, LinearRingHole_1; ..., LinearRingHole_N],..., [LinearRingShell, LinearRingHole_1; ...; LinearRingHole_M]})

LinearRingShell je povinný a definovaný jako seřazená counterclockwise matice souřadnic [[lng_1;lat_1],...,[lng_i;lat_i],...,[lng_j;lat_j],...,[lng_1;lat_1]]. Může existovat pouze jedno prostředí.
LinearRingHole je volitelný a definovaný jako clockwise uspořádané pole souřadnic [[lng_1;lat_1],...,[lng_i;lat_i],...,[lng_j;lat_j],...,[lng_1;lat_1]]. Může existovat libovolný počet vnitřních kroužků a otvorů.
Vrcholy linearring musí být odlišné s alespoň třemi souřadnicemi. První souřadnice musí být rovna poslední. Vyžaduje se aspoň čtyři položky.
Souřadnice [zeměpisná délka, zeměpisná šířka] musí být platné. Zeměpisná délka musí být reálné číslo v oblasti [-180, +180] a zeměpisná šířka musí být reálné číslo v oblasti [-90, +90].
LinearRingShell uzavře většinu poloviny sféry. LinearRing rozdělí sféru do dvou oblastí. Zvolí se menší ze dvou oblastí.
Délka hrany linearring musí být menší než 180 stupňů. Vybere se nejkratší hrana mezi dvěma vrcholy.
LinearRings nesmí křížovat a nesmí sdílet hrany. LinearRings může sdílet vrcholy.
Mnohoúhelník obsahuje jeho vrcholy.

Tip

K lepšímu výkonu použijte literál LineString nebo MultiLineString.

Příklady

Následující příklad vypočítá průnik mezi čárou a mnohoúhelníkem. V tomto případě je výsledkem řádek.

Spuštění dotazu

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)

Výstup

křižovatka
{"type": "LineString","coordinates": [-73.975611956578192,40.78060906714618],[-73.974552,40.779761]]}

Následující příklad vypočítá průnik mezi čárou a mnohoúhelníkem. V tomto případě je výsledkem víceřádkový.

Spuštění dotazu

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)

Výstup

křižovatka
{"type": "MultiLineString","souřadnice": [[[ -106.89353655881905, 39.769226209776306],[ -101.74448553679453, 40.373506008712525]],[-99.136499431328858, 40.589336512699994],[-95.2845277311791, 40.79906024246348]]]}

Následující řádek a mnohoúhelník se neprotínají.

Spuštění dotazu

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)

Výstup

křižovatka
{"type": "GeometryCollection","geometrie": []}

Následující příklad najde všechny cesty v tabulce cest NYC GeoJSON, která protíná oblast literálového mnohoúhelníku zájmu.

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

Výstup

name	křižovatka
CentralParkW	{"type":"MultiLineString","souřadnice":[[-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","souřadnice":[[-73.957828446036331,40.800476476316327],[-173.9578627,40.80048670000008]],[-73.958528282,40.8006155],[-73.958528282,40.8006155],[-73.9585282,40.8006155],[-73.958565492035873,40.800631133466972]],[-73.9584162000000 16,40.8007325],[-73.958446850928084,40,80074457746617]]]}
WestDr	{"type":"LineString","coordinates":[-73.9580543,40.8003616],[-73.958009693938735,40,800250494588468]]}

Následující příklad najde všechny okresy v USA, které protínají s oblastí zájmu literál LineString.

Spuštění dotazu

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

Výstup

name	křižovatka
New York	{"type": "LineString","coordinates": [-73.97159099578574, 40.79451338780895], [-73.967385292053223, 40.792758888618756],[-73.969788551330566, 40.789769718601512]]}

Následující příklad vrátí výsledek null, protože LineString je neplatný.

Spuštění dotazu

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

Výstup

is_invalid
0

Následující příklad vrátí výsledek null, protože mnohoúhelník je neplatný.

Spuštění dotazu

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

Výstup

is_invalid
0

Sdílet prostřednictvím

geo_intersection_line_with_polygon()

Syntaxe

Parametry

Návraty

Příklady

Váš názor

Další materiály