Skip navigation links
10.5.2.4 Funções de Análise das Propriedades de MultiLineString »
Section Navigation      [Toggle]

10.5.2.3. Funções de Análise das Propriedades de LineString

Uma LineString consiste de valores Point. Você pode extrair pontos particulares de uma LineString, contar o número de pontos que ela contém ou obter o seu tamanho.

  • EndPoint(ls)

    Retorna o Point que é o ponto final do valor LineString ls. 

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

  • GLength(ls)

    Returna como um número de precisão dupla o tamanho do valor LineString ls em sua referência espacial associada. 

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

  • IsClosed(ls)

    Returna 1 se o valor LineString ls é fechado (isto é, seus valores StartPoint() e EndPoint() são os mesmos). Returna 0 se ls não é fechado, e −1 se ele é NULL. 

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

  • NumPoints(ls)

    retorna o número de pontos no valor LineString ls. 

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

  • PointN(ls,n)

    Returna o n-ésimo ponto no valor Linestring ls. 

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

  • StartPoint(ls)

    Returna o Point que é o ponto inicial do valor LineString ls. 

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

A especificação OpenGIS também define as seguintes funções, que o MySQL ainda não implementou:

  • IsRing(ls)

    Retorna 1 se o valor LineString ls é fechado (isto é, seus valores StartPoinnt() e EndPoint() são os mesmos) e é simples (não passa pelo mesmo ponto mais de uma vez). Retorna 0 se ls não é um anel, −1 se é NULL.

This is a translation of the MySQL Reference Manual that can be found at dev.mysql.com. The original Reference Manual is in English, and this translation is not necessarily as up to date as the English version.