Condividi tramite

geo_line_simplify()

  • Articolo

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

Semplifica una linea o una multilinea sostituendo catene quasi dritte di archi corti con un singolo bordo lungo sulla Terra.

Sintassi

geo_line_simplify(Tolleranza lineString, )

Altre informazioni sulle convenzioni di sintassi.

Parametri

Nome Digita Obbligatorio Descrizione
lineString dynamic ✔️ LineString o MultiLineString nel formato GeoJSON.
tolerance int, long o real Definisce la distanza minima in metri tra due vertici. I valori supportati sono compresi nell'intervallo [0, ~7.800.000 metri]. Se non specificato, viene usato il valore predefinito 10.

Valori restituiti

Linea semplificata o multilinea nel formato GeoJSON e di un tipo di dati dinamico , senza due vertici con distanza inferiore alla tolleranza. Se la riga o la tolleranza non è valida, 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 misurare la distanza sulla Terra è una sfera. I bordi delle linee sono geodesici sulla sfera.
  • Se i bordi della linea di input sono linee cartesiane dritte, è consigliabile usare geo_line_densify() per convertire i bordi planari in geodesici.
  • Se l'input è una multilinea e contiene più righe, il risultato sarà la semplificazione dell'unione delle righe.
  • La tolleranza elevata può causare la scomparsa di una linea piccola.

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 dove la longitudine è un numero reale nell'intervallo [-180, +180] e latitudine è un numero reale nell'intervallo [-90, +90].
  • La lunghezza del bordo deve essere inferiore a 180 gradi. Verrà scelto il bordo più corto tra i due vertici.

Esempi

Nell'esempio seguente viene semplificata la linea rimuovendo i vertici che si trovano all'interno di una distanza di 10 metri l'una dall'altra.

let line = dynamic({"type":"LineString","coordinates":[[-73.97033169865608,40.789063020152824],[-73.97039607167244,40.78897975920816],[-73.9704617857933,40.78888837512432],[-73.97052884101868,40.7887949601531],[-73.9706052839756,40.788698498903564],[-73.97065222263336,40.78862640672032],[-73.97072866559029,40.78852791445617],[-73.97079303860664,40.788434498977836]]});
print simplified = geo_line_simplify(line, 10)

Output

simplified
{"type": "LineString", "coordinate": [[-73.97033169865608, 40.789063020152824], [-73.97079303860664, 40.7884498977836]]}

L'esempio seguente semplifica le linee e combina i risultati nella raccolta geometry GeoJSON.

NY_Manhattan_Roads
| project road = features.geometry
| project road_simplified = geo_line_simplify(road, 100)
| summarize roads_lst = make_list(road_simplified)
| project geojson = bag_pack("type", "Feature","geometry", bag_pack("type", "GeometryCollection", "geometries", roads_lst), "properties", bag_pack("name", "roads"))

Output

geojson
{"type": "Feature", "geometry": {"type": "GeometryCollection", "geometries": [ ... ]}, "properties": {"name": "roads"}}

L'esempio seguente semplifica le righe e unifica il risultato

NY_Manhattan_Roads
| project road = features.geometry
| project road_simplified = geo_line_simplify(road, 100)
| summarize roads_lst = make_list(road_simplified)
| project roads = geo_union_lines_array(roads_lst)

Output

strade
{"type": "MultiLineString", "coordinates": [ ... ]}

Nell'esempio seguente viene restituito True a causa della riga non valida.

print is_invalid_line = isnull(geo_line_simplify(dynamic({"type":"LineString","coordinates":[[1, 1]]})))

Output

is_invalid_line
Vero

Nell'esempio seguente viene restituito True a causa della tolleranza non valida.

print is_invalid_line = isnull(geo_line_simplify(dynamic({"type":"LineString","coordinates":[[1, 1],[2,2]]}), -1))

Output

is_invalid_line
Vero

Nell'esempio seguente viene restituito True perché la tolleranza elevata causa la scomparsa di una riga di piccole dimensioni.

print is_invalid_line = isnull(geo_line_simplify(dynamic({"type":"LineString","coordinates":[[1.1, 1.1],[1.2,1.2]]}), 100000))

Output

is_invalid_line
Vero