O WKT (Well-Known Text) é um formato de texto que descreve uma geometria pelo seu tipo e pelas suas coordenadas. Ele permite examinar e trocar pontos, linhas ou polígonos entre programas que entendem essa sintaxe.
Como as coordenadas formam a geometria
Na expressão POINT(3 8), o nome POINT indica um ponto. Os números são as coordenadas X e Y, separadas por espaço. Uma linha reúne vários pontos e usa vírgulas entre eles, como em LINESTRING(0 0, 10 10), que liga a posição inicial à final. A pontuação faz parte do formato e indica como o programa deve agrupar os valores.
A documentação do MySQL mostra esta consulta para extrair a coordenada X de um ponto descrito em WKT:
SELECT ST_X(ST_GeomFromText('POINT(15 20)'));A função ST_GeomFromText converte o texto em uma geometria que ST_X recebe para ler a coordenada X, retornando 15. O exemplo confirma a leitura do ponto, mas não informa se os números representam metros ou graus. Você precisa conhecer o sistema de referência espacial para atribuir esse significado às coordenadas.
Referência espacial e precisão na exportação
O WKT padrão de geometria não inclui o SRID, identificador do sistema de referência espacial. Ao transferir uma geometria, envie também essa informação pelo meio aceito pelo destinatário. O PostGIS oferece a extensão EWKT para incluir o identificador na representação textual.
Outra limitação aparece na conversão de números para texto. A documentação de ST_AsText alerta que a saída pode perder precisão e que reduzir as casas decimais pode tornar a geometria inválida. Para transportar os valores com sua precisão numérica completa, confira o uso do formato binário WKB.
Dúvidas frequentes
Perguntas frequentes sobre WKT
- Como uma linha é escrita em WKT?
- A expressão LINESTRING(0 0, 10 10) descreve uma linha entre dois pontos. O espaço separa as coordenadas de cada ponto, enquanto a vírgula separa os pontos.
- O WKT informa o sistema de referência espacial?
- O WKT de geometria no formato padrão não inclui o SRID, identificador do sistema de referência espacial. No PostGIS, o EWKT é uma extensão que pode incluir esse identificador.
- Converter uma geometria para WKT preserva toda a precisão?
- A conversão para texto pode perder precisão numérica. O PostGIS recomenda o WKB para preservá-la no transporte e alerta que limitar casas decimais com ST_AsText pode produzir uma geometria inválida.
Para continuar
Recursos relacionados
Documentação
PostGIS: representação textual de geometrias
Explica a saída de ST_AsText, a ausência de SRID e os efeitos da redução de casas decimais.
Abrir recursoSite de referência
Dev Side Studio: desenvolvimento colaborativo
Sessão ao vivo para você investigar a conversão de coordenadas no banco com orientação durante o uso do editor e do terminal.
Abrir recursoAplicação na formação
Vibe Coding: Do Zero ao MVP
Ao desenvolver uma aplicação com coordenadas, você precisa conferir o formato da geometria e a referência espacial usada pelo banco.
Conhecer a formação
Fontes consultadas
Referências deste verbete
Este verbete ajudou você?
Obrigado pela resposta. Ela fica salva apenas neste navegador.