Pular para o conteúdo principal

WKT

Retorna um objeto geométrico em WKT (Well Known Text) a partir de vários tipos de dados Geo. Os objetos WKT compatíveis são:
  • POINT
  • POLYGON
  • MULTIPOLYGON
  • LINESTRING
  • MULTILINESTRING
Sintaxe
Parâmetros geo_data pode ser um dos seguintes Tipos de dados Geo ou um de seus tipos primitivos subjacentes: Valor retornado
  • O objeto geométrico WKT POINT é retornado para Point.
  • O objeto geométrico WKT POLYGON é retornado para Polygon
  • O objeto geométrico WKT MULTIPOLYGON é retornado para MultiPolygon.
  • O objeto geométrico WKT LINESTRING é retornado para LineString.
  • O objeto geométrico WKT MULTILINESTRING é retornado para MultiLineString.
Exemplos POINT a partir de Tuple:
POLYGON a partir de um array de tuplas ou de um array de arrays de tuplas:
MULTIPOLYGON a partir de um array com arrays de tuplas multidimensionais:

readWKTMultiPolygon

Converte um MultiPolygon em WKT (Well Known Text) em um tipo MultiPolygon.

Exemplo

Parâmetros de entrada

String que começa com MULTIPOLYGON

Valor retornado

MultiPolygon

readWKTPolygon

Converte um MultiPolygon em WKT (Well Known Text) para o tipo Polygon.

Exemplo

Parâmetros de entrada

String que começa com POLYGON

Valor de retorno

Polygon

readWKTPoint

A função readWKTPoint do ClickHouse analisa uma representação em Well-Known Text (WKT) de uma geometria do tipo Point e retorna um ponto no formato interno do ClickHouse.

Sintaxe

Argumentos

  • wkt_string: A String WKT de entrada que representa uma geometria Point.

Valor retornado

A função retorna uma representação interna do ClickHouse para a geometria Point.

Exemplo

readWKTLineString

Analisa uma representação em Well-Known Text (WKT) de uma geometria LineString e a retorna no formato interno do ClickHouse.

Sintaxe

Argumentos

  • wkt_string: a string WKT de entrada que representa uma geometria LineString.

Valor retornado

A função retorna a representação interna do ClickHouse para a geometria LineString.

Exemplo

readWKTMultiLineString

Analisa uma representação em Well-Known Text (WKT) de uma geometria MultiLineString e a retorna no formato interno do ClickHouse.

Sintaxe

Argumentos

  • wkt_string: a string WKT de entrada que representa uma geometria MultiLineString.

Valor retornado

A função retorna uma representação interna do ClickHouse para a geometria MultiLineString.

Exemplo

readWKTRing

Analisa uma representação em Well-Known Text (WKT) da geometria Polygon e retorna um anel (linestring fechada) no formato interno do ClickHouse.

Sintaxe

Argumentos

  • wkt_string: A string WKT de entrada que representa uma geometria do tipo Polygon.

Valor retornado

A função retorna uma representação interna do ClickHouse para a geometria do anel (linestring fechada).

Exemplo

polygonsWithinSpherical

Retorna true ou false, dependendo de um polígono estar ou não completamente dentro de outro polígono. Referência: https://www.boost.org/doc/libs/1_62_0/libs/geometry/doc/html/geometry/reference/algorithms/within/within_2.html

Exemplo

readWKBMultiPolygon

Converte um MultiPolygon em WKB (Well Known Binary) em um valor do tipo MultiPolygon.

Exemplo

Parâmetros de entrada

String que começa com MULTIPOLYGON

Valor retornado

MultiPolygon

readWKBPolygon

Converte um MultiPolygon em WKB (Well Known Binary) no tipo Polygon.

Exemplo

Parâmetros de entrada

String que começa com POLYGON

Valor retornado

Polygon

readWKBPoint

A função readWKBPoint no ClickHouse interpreta uma representação em Well-Known Binary (WKB) de uma geometria Point e retorna um ponto no formato interno do ClickHouse.

Sintaxe

Argumentos

  • wkb_string: A string WKB de entrada que representa uma geometria do tipo Point.

Valor retornado

A função retorna uma representação interna do ClickHouse para a geometria Point.

Exemplo

readWKBLineString

Analisa uma representação em Well-Known Binary (WKB) de uma geometria LineString e a retorna no formato interno do ClickHouse.

Sintaxe

Argumentos

  • wkb_string: A string WKB de entrada que representa uma geometria do tipo LineString.

Valor retornado

A função retorna uma representação interna do ClickHouse para a geometria LineString.

Exemplo

readWKBMultiLineString

Analisa a representação Well-Known Binary (WKB) de uma geometria MultiLineString e a retorna no formato interno do ClickHouse.

Sintaxe

Argumentos

  • wkb_string: A string WKB de entrada que representa uma geometria do tipo MultiLineString.

Valor retornado

A função retorna uma representação interna do ClickHouse da geometria MultiLineString.

Exemplo

Parâmetros de entrada

Valor retornado

UInt8, 0 para false, 1 para true

polygonsDistanceSpherical

Calcula a distância mínima entre dois pontos, em que um ponto pertence ao primeiro polígono e o segundo, a outro polígono. Esférico significa que as coordenadas são interpretadas como coordenadas em uma esfera pura e ideal, o que não corresponde à Terra. O uso desse tipo de sistema de coordenadas acelera a execução, mas, naturalmente, não é preciso.

Exemplo

Parâmetros de entrada

Dois polígonos

Valor retornado

Float64

polygonsDistanceCartesian

Calcula a distância entre dois polígonos

Exemplo

Parâmetros de entrada

Dois polígonos

Valor de retorno

Float64

polygonsEqualsCartesian

Retorna true se dois polígonos forem iguais

Exemplo

Parâmetros de entrada

Dois polígonos

Valor retornado

UInt8, 0 para false, 1 para true

polygonsSymDifferenceSpherical

Calcula a diferença simétrica espacial da teoria dos conjuntos (XOR) entre dois polígonos

Exemplo

Parâmetros de entrada

Polígonos

Valor retornado

MultiPolygon

polygonsSymDifferenceCartesian

O mesmo que polygonsSymDifferenceSpherical, mas as coordenadas estão em um sistema de coordenadas cartesianas, que é mais próximo do modelo da Terra real.

Exemplo

Parâmetros de entrada

Polígonos

Valor retornado

MultiPolygon

polygonsIntersectionSpherical

Calcula a interseção (AND) entre polígonos; as coordenadas são esféricas.

Exemplo

Parâmetros de entrada

Polígonos

Valor de retorno

MultiPolygon

polygonsWithinCartesian

Retorna true se o segundo polígono estiver contido no primeiro polígono.

Exemplo

Parâmetros de entrada

Dois polígonos

Valor retornado

UInt8, 0 para falso, 1 para true

polygonsIntersectCartesian

Retorna true se os dois polígonos se intersectam (compartilham alguma área ou borda em comum).

Exemplo

Parâmetros de entrada

Dois polígonos

Valor retornado

UInt8, 0 para false, 1 para true

polygonsIntersectSpherical

Retorna true se os dois polígonos se intersectam (compartilham alguma área ou fronteira em comum). Referência https://www.boost.org/doc/libs/1_62_0/libs/geometry/doc/html/geometry/reference/algorithms/intersects.html

Exemplo

Parâmetros de entrada

Dois polígonos

Valor retornado

UInt8, 0 para false, 1 para true

polygonConvexHullCartesian

Calcula um fecho convexo. Referência As coordenadas estão em um sistema de coordenadas cartesianas.

Exemplo

Parâmetros de entrada

MultiPolygon

Valor retornado

Polygon

polygonAreaSpherical

Calcula a área de um polígono na superfície da esfera.

Exemplo

Parâmetros de entrada

Polygon

Valor retornado

Float

polygonsUnionSpherical

Calcula a união (OR).

Exemplo

Parâmetros de entrada

Polígonos

Valor retornado

MultiPolygon

polygonPerimeterSpherical

Calcula o perímetro do polígono.

Exemplo

Polígono que representa o Zimbábue

Este é o polígono que representa o Zimbábue:

Uso da função polygonPerimeterSpherical

Parâmetros de entrada

Valor retornado

polygonsIntersectionCartesian

Calcula a interseção entre polígonos.

Exemplo

Parâmetros de entrada

Polígonos

Valor retornado

MultiPolygon

polygonAreaCartesian

Calcula a área de um polígono

Exemplo

Parâmetros de entrada

Polygon

Valor retornado

Float64

polygonPerimeterCartesian

Calcula o perímetro de um polígono.

Exemplo

Parâmetros de entrada

Polygon

Valor retornado

Float64

polygonsUnionCartesian

Calcula a união de polígonos.

Exemplo

Parâmetros de entrada

Polígonos

Valor retornado

MultiPolygon Para mais informações sobre sistemas geométricos, veja esta apresentação sobre a biblioteca Boost, que é a usada pelo ClickHouse.
Última modificação em 2 de julho de 2026