Skip navigation links
18.5.2.4 Funciones MultiLineString »
Section Navigation      [Toggle]

18.5.2.3. Funciones LineString

Un LineString se compone de valores Point. Puede extraer valores particulares de dentro de una LineString, contar los puntos que contiene u obtener su longitud.

  • EndPoint(ls)

    Devuelve el Point que es el punto final del valor LineString ls. 

    mysql> SET @ls = 'LineString(1 1,2 2,3 3)';
mysql> SELECT AsText(EndPoint(GeomFromText(@ls)));
+-------------------------------------+
| AsText(EndPoint(GeomFromText(@ls))) |
+-------------------------------------+
| POINT(3 3)                          |
+-------------------------------------+

  • GLength(ls)

    Devuelve la longitud del valor LineString ls como un número de doble precisión en su sistema de referencia espacial asociado. 

    mysql> SET @ls = 'LineString(1 1,2 2,3 3)';
mysql> SELECT GLength(GeomFromText(@ls));
+----------------------------+
| GLength(GeomFromText(@ls)) |
+----------------------------+
|            2.8284271247462 |
+----------------------------+

  • IsClosed(ls)

    Retorna 1 si el valor LineString ls es cerrado (es decir, su punto inicial StartPoint() y punto final EndPoint() tienen el mismo valor). Retorna 0 si ls es no cerrado, y -1 si es NULL. 

    mysql> SET @ls = 'LineString(1 1,2 2,3 3)';
mysql> SELECT IsClosed(GeomFromText(@ls));
+-----------------------------+
| IsClosed(GeomFromText(@ls)) |
+-----------------------------+
|                           0 |
+-----------------------------+

  • NumPoints(ls)

    Retorna el número de puntos en el valor LineString ls. 

    mysql> SET @ls = 'LineString(1 1,2 2,3 3)';
mysql> SELECT NumPoints(GeomFromText(@ls));
+------------------------------+
| NumPoints(GeomFromText(@ls)) |
+------------------------------+
|                            3 |
+------------------------------+

  • PointN(ls,n)

    Retorna el punto e-n-ésimo en el valor Linestring ls. Los números de punto comienzan por 1. 

    mysql> SET @ls = 'LineString(1 1,2 2,3 3)';
mysql> SELECT AsText(PointN(GeomFromText(@ls),2));
+-------------------------------------+
| AsText(PointN(GeomFromText(@ls),2)) |
+-------------------------------------+
| POINT(2 2)                          |
+-------------------------------------+

  • StartPoint(ls)

    Retorna el Point que es el punto inicial del valor LineString ls. 

    mysql> SET @ls = 'LineString(1 1,2 2,3 3)';
mysql> SELECT AsText(StartPoint(GeomFromText(@ls)));
+---------------------------------------+
| AsText(StartPoint(GeomFromText(@ls))) |
+---------------------------------------+
| POINT(1 1)                            |
+---------------------------------------+

La especificación OpenGIS también define la siguiente función, que MySQL no implementa:

  • IsRing(ls)

    Retorna 1 si el valor LineString ls es cerrado (es decir, que sus puntos inicial y final tienen el mismo valor) y es simple (no pasa a través del mismo punto más de una vez). Retorna 0 si ls no es un anillo, y -1 si es NULL.

Ésta es una traducción del manual de referencia de MySQL, que puede encontrarse en dev.mysql.com. El manual de referencia original de MySQL está escrito en inglés, y esta traducción no necesariamente está tan actualizada como la versión original. Para cualquier sugerencia sobre la traducción y para señalar errores de cualquier tipo, no dude en dirigirse a mysql-es@vespito.com.