geo_intersection_line_with_polygon()
적용 대상: ✅Microsoft Fabric✅Azure Data Explorer✅Azure Monitor✅Microsoft Sentinel
다각형 또는 다각형을 사용하여 선 또는 여러 줄의 교집합을 계산합니다.
구문
geo_intersection_line_with_polygon(lineString,다각형)
구문 규칙에 대해 자세히 알아봅니다.
매개 변수
| 이름 | Type | 필수 | 설명 |
|---|---|---|---|
| lineString | dynamic |
✔️ | GeoJSON 형식의 LineString 또는 MultiLineString입니다. |
| 다각형 | dynamic |
✔️ | GeoJSON 형식의 다각형 또는 MultiPolygon입니다. |
반품
GeoJSON 형식 및 동적 데이터 형식의 교집합입니다. lineString 또는 multiLineString 또는 다각형 또는 다각형이 잘못된 경우 쿼리는 null 결과를 생성합니다.
참고 항목
- 지리 공간적 좌표는 WGS-84 좌표 참조 시스템에서 나타내는 것으로 해석됩니다.
- 지구 거리를 측정하는 데 사용되는 측지 데이텀은 구입니다. 선 가장자리는 구의 측지식 입니다.
- 입력 선 또는 다각형 가장자리가 직선 카티전 선인 경우 평면 가장자리를 측지로 변환하기 위해 geo_line_densify() 또는 geo_polygon_densify()를 사용하는 것이 좋습니다.
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]]})
- LineString 좌표 배열에는 두 개 이상의 항목이 포함되어야 합니다.
- 좌표 [경도, 위도]는 경도가 [-180, +180] 범위의 실수이고 위도는 [-90, +90] 범위의 실수인 경우 유효해야 합니다.
- 가장자리 길이는 180도 미만이어야 합니다. 두 꼭짓점 사이의 가장 짧은 가장자리가 선택됩니다.
다각형 정의 및 제약 조건
dynamic({"type": "Polygon","coordinates": [LinearRingShell, LinearRingHole_1, ..., LinearRingHole_N]})
dynamic({"type": "MultiPolygon","coordinates": [[LinearRingShell, LinearRingHole_1, ..., LinearRingHole_N],..., [LinearRingShell, LinearRingHole_1, ..., LinearRingHole_M]]})
- LinearRingShell은 [[lng_1,lat_1],...,[lng_i,lat_i],...,[lng_j,lat_j],...,[lng_1,lat_1]] 순서가 지정된 좌표 배열로 정의
counterclockwise됩니다. 셸은 하나만 있을 수 있습니다. - LinearRingHole은 선택 사항이며 [[lng_1,lat_1],...,[lng_i,lat_i],...,[lng_j,lat_j],...,[lng_1,lat_1]]의 정렬된 배열로 정의
clockwise됩니다. 내부 링과 구멍이 있을 수 있습니다. - LinearRing 꼭짓점은 세 개 이상의 좌표로 구분되어야 합니다. 첫 번째 좌표는 마지막 좌표와 같아야 합니다. 4개 이상의 항목이 필요합니다.
- 좌표 [경도, 위도]는 유효해야 합니다. 경도는 [-180, +180] 범위의 실수여야 하며 위도는 [-90, +90] 범위의 실수여야 합니다.
- LinearRingShell은 구의 최대 절반을 묶습니다. LinearRing은 구를 두 영역으로 나눕니다. 두 지역 중 더 작은 지역이 선택됩니다.
- 선형 가장자리 길이는 180도 미만이어야 합니다. 두 꼭짓점 사이의 가장 짧은 가장자리가 선택됩니다.
- LinearRings는 교차해서는 안 되며 가장자리를 공유해서는 안 됩니다. LinearRings는 꼭짓점을 공유할 수 있습니다.
- 다각형은 꼭짓점을 포함합니다.
팁
성능을 향상시키려면 리터럴 LineString 또는 MultiLineString을 사용합니다.
예제
다음 예제에서는 선과 다각형 간의 교집합을 계산합니다. 이 경우 결과는 선입니다.
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)
출력
| intersection |
|---|
| {"type": "LineString","coordinates": [-73.975611956578192,40.78060906714618],[-73.974552,40.779761]]} |
다음 예제에서는 선과 다각형 간의 교집합을 계산합니다. 이 경우 결과는 여러 줄입니다.
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)
출력
| intersection |
|---|
| {"type": "MultiLineString","coordinates": [[[ -106.89353655881905, 39.769226209776306],[ -101.74448553679453, 40.3735060087125255],[[-99.136499431328858, 40.589336512699994],[-95.284527737311791, 40.799060242246348]]]} |
다음 줄과 다각형은 교차하지 않습니다.
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)
출력
| intersection |
|---|
| {"type": "GeometryCollection","geometries": []} |
다음 예제에서는 관심 영역 리터럴 다각형과 교차하는 NYC GeoJSON 도로 테이블의 모든 도로를 찾습니다.
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
출력
| name | 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],[-7 3.9578627,40.800486700000008],[[-73.9585282,40.8006155],[[-73.958565492035873,40.800631133466972],[-73.9584162000000 16,40.8007325],[-73.958446850928084,40.80074457466617]]]} |
| WestDr | {"type":"LineString","coordinates":[[-73.9580543,40.8003616],[-73.958009693938735,40.800250494588468]]} |
다음 예제에서는 관심 영역 리터럴 LineString과 교차하는 미국의 모든 카운티를 찾습니다.
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
출력
| name | intersection |
|---|---|
| 뉴욕 | {"type": "LineString","coordinates": [[-73.97159095788574, 40.794513338880895], [-73.967385292053223, 40.792758888618756],[-73.96978551330566, 40.78976971860151512]} |
다음 예제에서는 LineString이 잘못되었기 때문에 null 결과를 반환합니다.
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))
출력
| is_invalid |
|---|
| 1 |
다음 예제에서는 다각형이 유효하지 않으므로 null 결과를 반환합니다.
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))
출력
| is_invalid |
|---|
| 1 |