geo_intersects_2polygons()

Si applica a: ✅Microsoft Fabric✅Azure Esplora dati✅ Azure Monitor✅Microsoft Sentinel

Calcola se due poligoni o multipolygon si intersecano.

Sintassi

geo_intersects_2polygons(poligono1 poligono1,)

Altre informazioni sulle convenzioni di sintassi.

Parametri

Nome	Digita	Obbligatorio	Descrizione
poligono1	dynamic	✔️	Poligono o multipolygon nel formato GeoJSON.
poligono2	dynamic	✔️	Poligono o multipolygon nel formato GeoJSON.

Valori restituiti

Indica se due poligoni o multipolygoni si intersecano. Se Polygon o MultiPolygon non sono validi, la query genererà un risultato Null.

Nota

• Le coordinate geospaziali vengono interpretate come rappresentate dal sistema di riferimento di coordinate WGS-84 .
• Il datum geodetico usato per le misurazioni sulla Terra è una sfera. I bordi poligoni sono geodesici sulla sfera.
• Se i bordi del poligono di input sono linee cartesiane dritte, è consigliabile usare geo_polygon_densify() per convertire i bordi planari in geodesici.

Definizione e vincoli poligono

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

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

• LinearRingShell è obbligatorio e definito come matrice counterclockwise ordinata di coordinate [[lng_1,lat_1], ..., [lng_i,lat_i], ...,[lng_j,lat_j], ...,[lng_1,lat_1]]. Può essere presente una sola shell.
• LinearRingHole è facoltativo e definito come matrice clockwise ordinata di coordinate [[lng_1,lat_1], ...,[lng_i,lat_i], ...,[lng_j,lat_j], ...,[lng_1,lat_1]]. Ci può essere un numero qualsiasi di anelli interni e fori.
• I vertici LinearRing devono essere distinti con almeno tre coordinate. La prima coordinata deve essere uguale all'ultima. Sono necessarie almeno quattro voci.
• Le coordinate [longitudine, latitudine] devono essere valide. La longitudine deve essere un numero reale nell'intervallo [-180, +180] e latitudine deve essere un numero reale nell'intervallo [-90, +90].
• LinearRingShell racchiude al massimo la metà della sfera. LinearRing divide la sfera in due aree. Verranno scelte le dimensioni più piccole delle due aree.
• La lunghezza del bordo LinearRing deve essere inferiore a 180 gradi. Verrà scelto il bordo più corto tra i due vertici.
• LinearRings non deve attraversare e non deve condividere i bordi. LinearRings può condividere vertici.
• Il poligono contiene i vertici.

Suggerimento

Usare il valore letterale LineString o MultiLineString per ottenere prestazioni migliori.

Esempi

Nell'esempio seguente viene verificato se alcuni poligoni letterali si intersecano.

Eseguire la query

let polygon1 = dynamic({"type":"Polygon","coordinates":[[[-73.9630937576294,40.77498840732385],[-73.963565826416,40.774383111780914],[-73.96205306053162,40.773745311181585],[-73.96160781383514,40.7743912365898],[-73.9630937576294,40.77498840732385]]]});
let polygon2 = dynamic({"type":"Polygon","coordinates":[[[-73.96213352680206,40.775045280447145],[-73.9631313085556,40.774578106920345],[-73.96207988262177,40.77416780398293],[-73.96213352680206,40.775045280447145]]]});
print geo_intersects_2polygons(polygon1, polygon2)

Output

print_0
Vero

Nell'esempio seguente vengono trovate tutte le contee negli Stati Uniti che si intersecano con il poligono letterale area di interesse.

Eseguire la query

let area_of_interest = dynamic({"type":"Polygon","coordinates":[[[-73.96213352680206,40.775045280447145],[-73.9631313085556,40.774578106920345],[-73.96207988262177,40.77416780398293],[-73.96213352680206,40.775045280447145]]]});
US_Counties
| project name = features.properties.NAME, county = features.geometry
| where geo_intersects_2polygons(county, area_of_interest)
| project name

Output

name
New York

Nell'esempio seguente viene restituito un risultato Null perché uno dei poligoni non è valido.

Eseguire la query

let central_park_polygon = dynamic({"type":"Polygon","coordinates":[[[-73.9495,40.7969],[-73.95807266235352,40.80068603561921],[-73.98201942443848,40.76825672305777],[-73.97317886352539,40.76455136505513],[-73.9495,40.7969]]]});
let invalid_polygon = dynamic({"type":"Polygon"});
print isnull(geo_intersects_2polygons(invalid_polygon, central_park_polygon))

Output

print_0
Vero