Passer au contenu principal

WKT

Renvoie un objet géométrique WKT (Well Known Text) à partir de différents types de données Geo. Les objets WKT pris en charge sont :
  • POINT
  • POLYGON
  • MULTIPOLYGON
  • LINESTRING
  • MULTILINESTRING
Syntaxe
Paramètres geo_data peut être l’un des types de données Geo suivants, ou l’un de leurs types primitifs sous-jacents : Valeur renvoyée
  • L’objet géométrique WKT POINT est renvoyé pour un Point.
  • L’objet géométrique WKT POLYGON est renvoyé pour un Polygon.
  • L’objet géométrique WKT MULTIPOLYGON est renvoyé pour un MultiPolygon.
  • L’objet géométrique WKT LINESTRING est renvoyé pour un LineString.
  • L’objet géométrique WKT MULTILINESTRING est renvoyé pour un MultiLineString.
Exemples POINT à partir d’un tuple :
POLYGON à partir d’un tableau de tuples ou d’un tableau de tableaux de tuples :
MULTIPOLYGON à partir d’un tableau de tableaux de tuples multidimensionnels :

readWKTMultiPolygon

Convertit un MultiPolygon au format WKT (Well Known Text) en type MultiPolygon.

Exemple

Paramètres d’entrée

chaîne commençant par MULTIPOLYGON

valeur renvoyée

MultiPolygon

readWKTPolygon

Convertit un MultiPolygon WKT (Well Known Text) en objet de type Polygon.

Exemple

Paramètres d’entrée

Chaîne commençant par POLYGON

valeur renvoyée

Polygon

readWKTPoint

La fonction readWKTPoint de ClickHouse analyse la représentation Well-Known Text (WKT) d’une géométrie de type Point et renvoie un point dans le format interne de ClickHouse.

Syntaxe

Arguments

  • wkt_string : la chaîne WKT en entrée représentant une géométrie Point.

Valeur renvoyée

La fonction renvoie une représentation interne propre à ClickHouse de la géométrie de type Point.

Exemple

readWKTLineString

Analyse une représentation Well-Known Text (WKT) d’une géométrie LineString et la renvoie dans le format interne de ClickHouse.

Syntaxe

Arguments

  • wkt_string : la chaîne WKT en entrée représentant une géométrie LineString.

Valeur renvoyée

La fonction renvoie une représentation interne de ClickHouse de la géométrie LineString.

Exemple

readWKTMultiLineString

Analyse la représentation Well-Known Text (WKT) d’une géométrie MultiLineString et la renvoie dans le format interne de ClickHouse.

Syntaxe

Arguments

  • wkt_string : la chaîne WKT en entrée représentant une géométrie de type MultiLineString.

Valeur renvoyée

La fonction renvoie une représentation interne de ClickHouse pour la géométrie multilinestring.

Exemple

readWKTRing

Analyse une représentation d’une géométrie Polygon au format Well-Known Text (WKT) et renvoie un anneau (linestring fermé) dans le format interne de ClickHouse.

Syntaxe

Arguments

  • wkt_string : Chaîne WKT d’entrée représentant une géométrie de type Polygon.

Valeur renvoyée

La fonction renvoie une représentation interne ClickHouse de la géométrie de type anneau (linestring fermé).

Exemple

polygonsWithinSpherical

Renvoie true ou false selon qu’un polygone est entièrement contenu ou non dans un autre polygone. Référence https://www.boost.org/doc/libs/1_62_0/libs/geometry/doc/html/geometry/reference/algorithms/within/within_2.html

Exemple

readWKBMultiPolygon

Convertit un MultiPolygon WKB (Well Known Binary) en type MultiPolygon.

Exemple

Paramètres d’entrée

chaîne de caractères commençant par MULTIPOLYGON

Valeur renvoyée

MultiPolygon

readWKBPolygon

Convertit un MultiPolygon WKB (Well Known Binary) en type Polygon.

Exemple

Paramètres d’entrée

Chaîne commençant par POLYGON

Valeur renvoyée

Polygon

readWKBPoint

La fonction readWKBPoint de ClickHouse interprète une représentation Well-Known Binary (WKB) d’une géométrie de type Point et renvoie un point dans le format interne de ClickHouse.

Syntaxe

Arguments

  • wkb_string : la chaîne WKB en entrée représentant une géométrie Point.

Valeur renvoyée

La fonction renvoie la représentation interne de ClickHouse pour la géométrie Point.

Exemple

readWKBLineString

Analyse une représentation binaire bien connue (WKB) d’une géométrie LineString et la renvoie au format interne de ClickHouse.

Syntaxe

Arguments

  • wkb_string : la chaîne WKB en entrée représentant une géométrie LineString.

Valeur renvoyée

La fonction renvoie une représentation interne de ClickHouse de la géométrie de type linestring.

Exemple

readWKBMultiLineString

Analyse une représentation Well-Known Binary (WKB) d’une géométrie MultiLineString et la renvoie dans le format interne de ClickHouse.

Syntaxe

Arguments

  • wkb_string : La chaîne WKB en entrée représentant une géométrie MultiLineString.

Valeur renvoyée

La fonction renvoie une représentation interne à ClickHouse de la géométrie multilinestring.

Exemple

Paramètres d’entrée

Valeur renvoyée

UInt8, 0 pour false, 1 pour true

polygonsDistanceSpherical

Calcule la distance minimale entre deux points, l’un appartenant au premier polygone et l’autre à un second polygone. Spherical signifie que les coordonnées sont interprétées comme celles d’une sphère parfaite et idéale, ce qui n’est pas le cas de la Terre. L’utilisation de ce type de système de coordonnées accélère l’exécution, mais n’est bien sûr pas précise.

Exemple

Paramètres d’entrée

Deux polygones

Valeur renvoyée

Float64

polygonsDistanceCartesian

Calcule la distance entre deux polygones

Exemple

Paramètres d’entrée

Deux polygones

Valeur renvoyée

Float64

polygonsEqualsCartesian

Renvoie true lorsque deux polygones sont égaux

Exemple

Paramètres d’entrée

Deux polygones

Valeur renvoyée

UInt8, 0 pour false, 1 pour true

polygonsSymDifferenceSpherical

Calcule la différence symétrique spatiale en théorie des ensembles (XOR) entre deux polygones

Exemple

Paramètres d’entrée

Polygones

Valeur renvoyée

MultiPolygon

polygonsSymDifferenceCartesian

Identique à polygonsSymDifferenceSpherical, mais les coordonnées sont exprimées dans le système de coordonnées cartésien, qui se rapproche davantage du modèle réel de la Terre.

Exemple

Paramètres d’entrée

Polygones

valeur renvoyée

MultiPolygon

polygonsIntersectionSpherical

Calcule l’intersection (AND) entre des polygones ; les coordonnées sont sphériques.

Exemple

Paramètres d’entrée

Polygones

Valeur renvoyée

MultiPolygon

polygonsWithinCartesian

Renvoie true si le second polygone est contenu dans le premier.

Exemple

Paramètres d’entrée

Deux polygones

Valeur renvoyée

UInt8, 0 pour false, 1 pour true

polygonsIntersectCartesian

Renvoie true si les deux polygones se recoupent (partagent une zone ou une limite commune).

Exemple

Paramètres d’entrée

Deux polygones

valeur renvoyée

UInt8, 0 pour false, 1 pour true

polygonsIntersectSpherical

Renvoie true si les deux polygones se recoupent (partagent une zone ou une frontière communes). Référence : https://www.boost.org/doc/libs/1_62_0/libs/geometry/doc/html/geometry/reference/algorithms/intersects.html

Exemple

Paramètres d’entrée

Deux polygones

Valeur renvoyée

UInt8, 0 pour false, 1 pour true

polygonConvexHullCartesian

Calcule l’enveloppe convexe. Référence Les coordonnées sont exprimées dans le système de coordonnées cartésiennes.

Exemple

Paramètres d’entrée

MultiPolygon

Valeur renvoyée

Polygon

polygonAreaSpherical

Calcule l’aire d’un polygone.

Exemple

Paramètres d’entrée

Polygon

Valeur renvoyée

Float

polygonsUnionSpherical

Calcule l’union (OR).

Exemple

Paramètres d’entrée

Polygones

valeur renvoyée

MultiPolygon

polygonPerimeterSpherical

Calcule le périmètre du polygone.

Exemple

Polygone représentant le Zimbabwe

Voici le polygone représentant le Zimbabwe :

Utilisation de la fonction polygonPerimeterSpherical

Paramètres d’entrée

Valeur renvoyée

polygonsIntersectionCartesian

Calcule l’intersection de polygones.

Exemple

Paramètres d’entrée

Polygones

Valeur renvoyée

MultiPolygon

polygonAreaCartesian

Calcule l’aire d’un polygone

Exemple

Paramètres d’entrée

Polygon

valeur renvoyée

Float64

polygonPerimeterCartesian

Calcule le périmètre d’un polygone.

Exemple

Paramètres d’entrée

Polygon

Valeur renvoyée

Float64

polygonsUnionCartesian

Calcule l’union des polygones.

Exemple

Paramètres d’entrée

Polygones

Valeur renvoyée

MultiPolygon Pour en savoir plus sur les systèmes géométriques, consultez cette présentation de la bibliothèque Boost, utilisée par ClickHouse.
Dernière modification le 25 juin 2026