geo_intersection_line_with_polygon()

Artikel
11/23/2024

Gilt für: ✅Microsoft Fabric ✅Azure Data Explorer✅Azure Monitor ✅Microsoft Sentinel

Berechnet die Schnittmenge einer Linie oder einer mehrzeiligen Linie mit einem Polygon oder einem Multipolygon.

Syntax

geo_intersection_line_with_polygon(lineString-Polygon,)

Erfahren Sie mehr über Syntaxkonventionen.

Parameter

Name	Type	Erforderlich	Beschreibung
lineString	`dynamic`	✔️	Eine LineString- oder MultiLineString-Eigenschaft im GeoJSON-Format.
Polygon	`dynamic`	✔️	Ein Polygon oder MultiPolygon im GeoJSON-Format.

Gibt zurück

Schnittmenge im GeoJSON-Format und eines dynamischen Datentyps. Wenn lineString oder ein MultiLineString oder ein Polygon oder ein Multipolygon ungültig sind, erzeugt die Abfrage ein NULL-Ergebnis.

Hinweis

Die Geospatialkoordinaten werden durch das WGS-84-Koordinatenverweissystem interpretiert.
Das geodetische Datum , das zum Messen der Entfernung auf der Erde verwendet wird, ist eine Kugel. Linienränder sind geodätische Ränder auf der Kugel.
Wenn eingabelinie oder polygonale Kanten gerade kartesische Linien sind, sollten Sie geo_line_densify() oder eine geo_polygon_densify() verwenden, um planare Kanten in Geodesics zu konvertieren.

LineString-Definition und -Einschränkungen

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

LineString-Koordinatenarray muss mindestens zwei Einträge enthalten.
Koordinaten [Längengrad, Breitengrad] müssen gültig sein, wobei Längengrad eine reelle Zahl im Bereich [-180, +180] und Breitengrad eine reelle Zahl im Bereich [-90, +90] ist.
Die Kantenlänge muss kleiner als 180 Grad sein. Der kürzeste Rand zwischen den beiden Scheitelpunkten wird ausgewählt.

Polygondefinition und Einschränkungen

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

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

LinearRingShell ist erforderlich und definiert als ein counterclockwise sortiertes Array von Koordinaten [[lng_1,lat_1],...,[lng_i,lat_i],...,[lng_j,lat_j],...,[lng_1,lat_1]]. Es kann nur eine Shell vorhanden sein.
LinearRingHole ist optional und definiert als ein clockwise sortiertes Array von Koordinaten [[lng_1,lat_1],...,[lng_i,lat_i],...,[lng_j,lat_j],...,[lng_1,lat_1]]. Es kann eine beliebige Anzahl von Innenringen und Löchern geben.
LinearRing-Scheitelpunkte müssen mit mindestens drei Koordinaten unterschieden werden. Die erste Koordinate muss mit der letzten koordinate gleich sein. Mindestens vier Einträge sind erforderlich.
Koordinaten [Längengrad, Breitengrad] müssen gültig sein. Längengrad muss eine reelle Zahl im Bereich [-180, +180] sein, und breitengrad muss eine reelle Zahl im Bereich [-90, +90] sein.
LinearRingShell schließt höchstens die Hälfte der Kugel ein. LinearRing teilt die Kugel in zwei Bereiche auf. Die kleineren der beiden Regionen werden ausgewählt.
Die Länge des LinearRing-Rands muss kleiner als 180 Grad sein. Der kürzeste Rand zwischen den beiden Scheitelpunkten wird ausgewählt.
LinearRinge dürfen nicht kreuzen und dürfen keine Kanten teilen. LinearRinge können Scheitelpunkte teilen.
Polygon enthält seine Scheitelpunkte.

Tipp

Verwenden Sie Literal LineString oder MultiLineString, um eine bessere Leistung zu erzielen.

Beispiele

Im folgenden Beispiel wird die Schnittmenge zwischen Linie und Polygon berechnet. In diesem Fall ist das Ergebnis eine Linie.

Abfrage ausführen

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)

Output

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

Im folgenden Beispiel wird die Schnittmenge zwischen Linie und Polygon berechnet. In diesem Fall ist das Ergebnis eine mehrteilige.

Abfrage ausführen

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)

Output

intersection
{"type": "MultiLineString","coordinates": [[[ -106.89353655881905, 39.769226209776306],[ -101.74448553679453, 40.373506008712525]],[[-99.136499431328858, 40.58933651269994],[-95.284527737311791, 40.799060242246348]]]}

Die folgende Linie und das Polygon schneiden sich nicht.

Abfrage ausführen

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)

Output

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

Im folgenden Beispiel werden alle Straßen im NyC GeoJSON Straßentabelle gefunden, die sich mit dem Bereich des interessanten Literal polygons überschneiden.

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

Output

name	intersection
CentralParkW	{"type":"MultiLineString","coordinates":[[-73.958295846836933,40.800316027289647],[-73.9582724,40.8003415]],[[-73.958413422194482,40.80037239620097],[-73.9584093,40.8003797]]]}
FriedrichDouglassCir	{"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],[-173.9578627,40.800486700000008]],[-73.9585282,40.8006155],[-73.958565492035873,40.800631133466972]],[[-73.9584162000000016,40.8007325],[-73.9584446850928084,40.8007457746617]]]}
WestDr	{"type":"LineString","coordinates":[-73.9580543,40.8003616],[-73.958009693938735,40.80025049458468]]}

Im folgenden Beispiel werden alle Counties in den USA gefunden, die sich mit einem Interessanten-Literal LineString überschneiden.

Abfrage ausführen

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

Output

name	intersection
New York	{"type": "LineString","coordinates": [[-73.97159095788574, 40.794513338780895], [-73.967385292053223, 40.792758888618756],[-73.969788551330566, 40.789769718601512]]}

Im folgenden Beispiel wird ein NULL-Ergebnis zurückgegeben, da die LineString ungültig ist.

Abfrage ausführen

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

Output

is_invalid
1

Im folgenden Beispiel wird ein NULL-Ergebnis zurückgegeben, da das Polygon ungültig ist.

Abfrage ausführen

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

Output

is_invalid
1

Freigeben über

geo_intersection_line_with_polygon()

Syntax

Parameter

Gibt zurück

Beispiele

Feedback

Zusätzliche Ressourcen