geo_line_centroid()
Calcula el centroide de una línea o una multilínea en la Tierra.
Syntax
geo_line_centroid(
Linestring)
Más información sobre las convenciones de sintaxis.
Parámetros
Nombre | Tipo | Requerido | Descripción |
---|---|---|---|
Linestring | dynamic |
✔️ | LineString o MultiLineString en formato GeoJSON. |
Devoluciones
Valores de coordenadas centroide en formato GeoJSON y de un tipo de datos dinámico . Si la línea o la multilínea no son válidas, la consulta genera un resultado nulo.
Nota
- Las coordenadas geoespaciales se interpretan como representadas por el sistema de referencia de coordenadas WGS-84 .
- La referencia geodética utilizada para medir la distancia en la Tierra es una esfera. Los bordes de línea son geodesics en la esfera.
- Si los bordes de la línea de entrada son líneas cartesianas rectas, considere la posibilidad de usar geo_line_densify() para convertir bordes planores a geodesics.
- Si la entrada es una línea múltiple y contiene más de una línea, el resultado será el centroide de la unión de líneas.
Definición y restricciones de 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 matriz de coordenadas LineString debe contener al menos dos entradas.
- Las coordenadas [longitud, latitud] deben ser válidas donde la longitud es un número real en el intervalo [-180, +180] y la latitud es un número real en el intervalo [-90, +90].
- La longitud del borde debe ser inferior a 180 grados. Se elige el borde más corto entre los dos vértices.
Ejemplos
En el ejemplo siguiente se calcula el centroide de línea.
let line = dynamic({"type":"LineString","coordinates":[[-73.95796, 40.80042], [-73.97317, 40.764486]]});
print centroid = geo_line_centroid(line);
Salida
Centroide |
---|
{"type": "Point", "coordinates": [-73.965567057230942, 40.782453249627416]} |
En el ejemplo siguiente se calcula la longitud centroide de línea.
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]
Salida
Gnl |
---|
-73.9660675626837 |
En el ejemplo siguiente se visualiza el centroide de línea en un mapa.
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)
En el ejemplo siguiente se devuelve true
debido a la línea no válida.
print is_bad_line = isnull(geo_line_centroid(dynamic({"type":"LineString","coordinates":[[1, 1]]})))
Salida
is_bad_line |
---|
true |
Comentarios
https://aka.ms/ContentUserFeedback.
Próximamente: A lo largo de 2024 iremos eliminando gradualmente GitHub Issues como mecanismo de comentarios sobre el contenido y lo sustituiremos por un nuevo sistema de comentarios. Para más información, vea:Enviar y ver comentarios de