Condividi tramite

geo_line_centroid()

  • Articolo

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

Calcola il centroide di una linea o di una multilinea sulla Terra.

Sintassi

geo_line_centroid(lineString)

Altre informazioni sulle convenzioni di sintassi.

Parametri

Nome Digita Obbligatorio Descrizione
lineString dynamic ✔️ LineString o MultiLineString nel formato GeoJSON.

Valori restituiti

Valori delle coordinate centroidi in formato GeoJSON e di un tipo di dati dinamico . Se la riga o la multilinea non è valida, la query produce 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à il centroide dell'unione delle righe.

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. Viene scelto il bordo più corto tra i due vertici.

Esempi

Nell'esempio seguente viene calcolato il centroide di riga.

let line = dynamic({"type":"LineString","coordinates":[[-73.95796, 40.80042], [-73.97317, 40.764486]]});
print centroid = geo_line_centroid(line);

Output

centroide
{"type": "Point", "coordinates": [-73.965567057230942, 40.782453249627416]}

Nell'esempio seguente viene calcolata la longitudine centroide di riga.

let line = dynamic({"type":"LineString","coordinates":[[-73.95807266235352,40.800426144169315],[-73.94966125488281,40.79691751000055],[-73.97317886352539,40.764486356930334],[-73.98210525512695,40.76786669510221],[-73.96004676818848,40.7980870753293]]});
print centroid = geo_line_centroid(line)
| project lng = centroid.coordinates[0]

Output

Lng
-73.9660675626837

Nell'esempio seguente viene visualizzato il centro della linea su una mappa.

let line = dynamic({"type":"MultiLineString","coordinates":[[[-73.95798683166502,40.800556090021466],[-73.98193359375,40.76819171855746]],[[-73.94940376281738,40.79691751000055],[-73.97317886352539,40.76435634049001]]]});
print centroid = geo_line_centroid(line)
| render scatterchart with (kind = map)

Screenshot del centro della riga di New York City Central Park.

L'esempio seguente restituisce true a causa della riga non valida.

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

Output

is_bad_line
true