geo_intersects_line_with_polygon()
Calcola se una linea o una multilinea si intersecano con un poligono o un multipolygon.
Sintassi
geo_intersects_line_with_polygon(
Linestring,
Poligono)
Altre informazioni sulle convenzioni di sintassi.
Parametri
Nome | Tipo | Obbligatoria | Descrizione |
---|---|---|---|
Linestring | dynamic |
✔️ | Valore LineString o MultiLineString nel formato GeoJSON. |
Poligono | dynamic |
✔️ | Poligono o MultiPolygon nel formato GeoJSON. |
Restituisce
Indica se la linea o la multilinea interseca con il poligono o un multipolygon. Se lineString o un multiLineString o un poligono o un multipolygon non sono validi, la query genererà un risultato Null.
Nota
- Le coordinate geospaziali vengono interpretate come rappresentate dal sistema di riferimento delle coordinate WGS-84 .
- Il datum geodetico usato per misurare la distanza sulla Terra è una sfera. I bordi della linea sono geodesici sulla sfera.
- Se le linee di input o un poligono sono linee cartesiane dritte, è consigliabile usare geo_line_densify() o un geo_polygon_densify() per convertire i bordi planari in geodesici.
Definizione e vincoli 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 matrice di coordinate LineString deve contenere almeno due voci.
- Le coordinate [longitudine, latitudine] devono essere valide quando la longitudine è un numero reale nell'intervallo [-180, +180] e la latitudine è un numero reale nell'intervallo [-90, +90].
- La lunghezza dei bordi deve essere inferiore a 180 gradi. Verrà scelto il bordo più corto tra i due vertici.
Definizione e vincoli del 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
counterclockwise
matrice ordinata di coordinate [[lng_1,lat_1], ...,[lng_i,lat_i], ...,[lng_j,lat_j], ...,[lng_1,lat_1]]. Può esserci una sola shell. - LinearRingHole è facoltativo e definito come
clockwise
matrice ordinata di coordinate [[lng_1,lat_1], ...,[lng_i,lat_i], ...,[lng_j,lat_j], ...,[lng_1,lat_1]]. Ci possono essere qualsiasi numero 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 la 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 condividere i bordi. LinearRings può condividere vertici.
- Il poligono non contiene necessariamente i vertici.
Suggerimento
Usare il valore letterale LineString o MultiLineString per ottenere prestazioni migliori.
Esempio
Nell'esempio seguente viene verificato se un valore letterale LineString interseca un oggetto Polygon.
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 intersects = geo_intersects_line_with_polygon(lineString, polygon)
Output
Interseca |
---|
Vero |
Nell'esempio seguente vengono trovate tutte le strade della tabella delle strade geoJSON di NYC che si intersecano con il poligono letterale area di interesse.
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
| where geo_intersects_line_with_polygon(road, area_of_interest)
| project name
Output
name |
---|
Central Park W |
Frederick Douglass Cir |
W 110th St |
Dr. Ovest |
Nell'esempio seguente vengono trovate tutte le contee negli Stati Uniti che si intersecano con l'area di interesse letterale 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
| where geo_intersects_line_with_polygon(area_of_interest, county)
| project name
Output
name |
---|
New York |
Nell'esempio seguente viene restituito un risultato Null perché LineString non è valido.
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 isnull(geo_intersects_2lines(lineString, polygon))
Output
print_0 |
---|
Vero |
L'esempio seguente restituirà un risultato Null perché il poligono non è valido.
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 isnull(geo_intersects_2lines(lineString, polygon))
Output
print_0 |
---|
True |
Commenti e suggerimenti
https://aka.ms/ContentUserFeedback.
Presto disponibile: Nel corso del 2024 verranno gradualmente disattivati i problemi di GitHub come meccanismo di feedback per il contenuto e ciò verrà sostituito con un nuovo sistema di feedback. Per altre informazioni, vedereInvia e visualizza il feedback per