Partager via

Fonctions géospatiales ST

S’applique à :check marqué oui Databricks SQL vérifié marqué oui Databricks Runtime 17.1 et versions ultérieures

Important

Cette fonctionnalité est disponible en préversion publique.

Les fonctions géospatiales ST opèrent sur des objets de type GEOGRAPHY et/ou GEOMETRY, ou permettent de construire des valeurs GEOGRAPHY et GEOMETRY à partir de formats géospatiaux standard ou populaires, ou d’exporter des valeurs GEOGRAPHY et GEOMETRY vers des formats géospatiaux standard ou populaires.

Voir aussi :

Importer des fonctions Databricks pour obtenir des fonctions ST (Databricks Runtime)

Aucune importation n’est nécessaire pour Databricks SQL et Spark SQL.

Pour importer des fonctions ST pour Python ou Scala dans les notebooks, utilisez les commandes suivantes :

Python

from pyspark.databricks.sql import functions as dbf

Scala

import com.databricks.sql.functions._

Liste des fonctions géospatiales ST (Databricks SQL)

Import

Function Description
st_geogfromgeojson(geojsonExpr) Retourne une GEOGRAPHY(4326) valeur de sa représentation GeoJSON.
st_geogfromtext(wktExpr) Retourne une valeur GEOGRAPHY(4326) depuis sa représentation WKT.
st_geogfromwkb(wktExpr) Retourne une valeur GEOGRAPHY(4326) de sa représentation WKB.
st_geogfromwkt(wktExpr) Retourne une valeur GEOGRAPHY(4326) depuis sa représentation WKT.
st_geomfromewkb(wktExpr) Retourne la valeur GEOMETRY(ANY) de sa représentation EWKB.
st_geomfromgeohash(geohashExpr) Retourne la zone de grille geohash correspondant à la valeur geohash d’entrée sous la forme d’une valeur de polygone GEOMETRY 2D.
st_geomfromgeojson(geojsonExpr) Retourne une GEOMETRY(4326) valeur de sa représentation GeoJSON.
st_geomfromtext(wktExpr[, sridExpr]) Retourne une valeur GEOMETRY(srid) ou GEOMETRY(ANY) à partir de sa représentation WKT, et définit sa valeur SRID à celle de sridExpr, ou de 0 si sridExpr est omis.
st_geomfromwkb(wkbExpr[, sridExpr]) Retourne une valeur GEOMETRY(srid) ou GEOMETRY(ANY) de sa représentation WKB et définit sa valeur SRID à celle de sridExpr, ou de 0 si sridExpr est omise.
st_geomfromwkt(wktExpr[, sridExpr]) Retourne une valeur GEOMETRY(srid) ou GEOMETRY(ANY) à partir de sa représentation WKT, et définit sa valeur SRID à celle de sridExpr, ou de 0 si sridExpr est omis.
st_pointfromgeohash(geohash) Renvoie le centre de la zone de grille geohash correspondant à la valeur geohash d’entrée, sous forme de géométrie de type point en 2D.
to_geography(georepExpr) Renvoie une valeur GEOGRAPHY(ANY) à partir de sa représentation GeoJSON, WKB ou WKT.
to_geometry(georepExpr) Retourne une GEOMETRY(ANY) valeur à partir de sa représentation EWKB, GeoJSON, WKB ou WKT.
try_to_geography(georepExpr) Retourne une GEOGRAPHY(ANY) valeur de sa représentation GeoJSON, WKB ou WKT, ou NULL si la représentation d’entrée n’est pas valide.
try_to_geometry(georepExpr) Retourne une GEOMETRY(ANY) valeur de sa représentation EWKB, GeoJSON, WKB ou WKT, ou NULL si la représentation d’entrée n’est pas valide.

Export

Function Description
st_asbinary(geoExpr) Retourne la représentation WKB de l’entrée GEOGRAPHY ou GEOMETRY en tant que valeur de type BINARY.
st_asewkb(geoExpr) Retourne la représentation EWKB de la valeur d’entrée GEOMETRY sous forme de BINARY valeur.
st_asgeojson(geoExpr) Retourne la représentation GeoJSON de l’entrée GEOGRAPHY ou GEOMETRY comme une valeur STRING.
st_asewkt(geoExpr) Retourne la représentation EWKT de la valeur d'entrée GEOGRAPHY ou GEOMETRY en STRING.
st_astext(geoExpr) Retourne la représentation WKT de l’entrée GEOGRAPHY ou GEOMETRY en une valeur STRING.
st_aswkb(geoExpr) Retourne la représentation WKB de l’entrée GEOGRAPHY ou GEOMETRY en tant que valeur de type BINARY.
st_aswkt(geoExpr) Retourne la représentation WKT de l’entrée GEOGRAPHY ou GEOMETRY en une valeur STRING.
st_geohash(geoExpr [, precisionExpr]) Retourne le géohash de la géométrie d’entrée à la précision donnée.

Measurements

Function Description
st_area(geoExpr) Renvoie la surface de la valeur des entrées GEOGRAPHY ou GEOMETRY.
st_distance(geoExpr1, geoExpr2) Retourne la distance 2D cartesienne entre les deux valeurs d’entrée GEOMETRY .
st_distancesphere(geoExpr1, geoExpr2) Retourne la distance sphérique (en mètres) entre deux valeurs de point GEOMETRY , mesurées sur une sphère dont le rayon est le rayon moyen de l’ellipsoïde WGS84.
st_distancespheroid(geoExpr1, geoExpr2) Retourne la distance géodesique (en mètres) entre deux valeurs de point GEOMETRY sur l’ellipsoïde WGS84.
st_length(geoExpr) Retourne la longueur de la valeur d’entrée GEOGRAPHY ou GEOMETRY.
st_perimeter(geoExpr) Retourne le périmètre de la valeur d'entrée GEOGRAPHY ou GEOMETRY.

Constructors

Function Description
st_makeline(geoArray) Retourne une valeur de ligne géométrique GEOMETRY dont les points sont les points non vides des géométries dans le tableau de géométries en entrée, qui sont censées être des points, des lignes géométriques ou des multipoints.
st_makepolygon(outer[, innerArray]) Construit une valeur de polygone GEOMETRY à partir de la limite externe d’entrée et d’un tableau facultatif de limites internes, représentée sous forme de chaînes de ligne fermées.
st_point(x, y [, srid]) Retourne une valeur de point GEOMETRY avec les coordonnées X et Y données et la valeur SRID (le cas échéant).

Accessors

Function Description
st_dimension(geoExpr) Retourne la dimension topologique de la valeur projetée en 2D de GEOMETRY.
st_dump(geoExpr) Retourne un tableau contenant les géométries uniques dans la géométrie d’entrée.
st_endpoint(geoExpr) Retourne le dernier point de la valeur d'entrée GEOGRAPHY ou GEOMETRY, si la valeur géospatiale d'entrée est un linestring non vide.
st_envelope(geoExpr) Retourne une valeur 2D Cartesiane GEOMETRY représentant la zone de délimitation minimale alignée sur l’axe 2D (enveloppe) de la valeur d’entrée GEOMETRY .
st_envelope_agg(geoCol) Retourne l’enveloppe de toutes les géométries de la colonne, ou NULL si la colonne a zéro ligne ou contient uniquement des valeurs NULL.
st_exteriorring(geoExpr) Retourne l’anneau extérieur du polygone GEOGRAPHY d’entrée ou GEOMETRY sous forme de chaîne de ligne.
st_geometryn(geoExpr, nExpr) Retourne le n-ième élément basé sur 1 de la valeur d’entrée GEOMETRY sous forme GEOMETRY de valeur.
st_geometrytype(geoExpr) Retourne le type de la valeur d'entrée GEOGRAPHY ou GEOMETRY sous forme de chaîne.
st_interiorringn(geoExpr, indexExpr) Retourne l’anneau intérieur n-ième du polygone GEOGRAPHY d’entrée ou GEOMETRY sous forme de chaîne de ligne.
st_isempty(geoExpr) Retourne vrai si la valeur de l’entrée GEOGRAPHY ou GEOMETRY ne contient aucun point non vide.
st_m(geoExpr) Retourne la coordonnée M de la valeur du point GEOMETRY d’entrée, ou NULL si le point est vide ou n’a pas de coordonnée M.
st_ndims(geoExpr) Renvoie la dimension des coordonnées de la valeur GEOGRAPHY ou GEOMETRY d’entrée.
st_npoints(geoExpr) Retourne le nombre de points non vides dans la valeur GEOGRAPHY ou GEOMETRY d'entrée.
st_numgeometries(geoExpr) Retourne le nombre de géométries dans la valeur d’entrée GEOMETRY .
st_numinteriorrings(geoExpr) Retourne le nombre d’anneaux intérieurs dans le polygone GEOGRAPHY ou dans la valeur fournie GEOMETRY.
st_pointn(geoExpr, indexExpr) Retourne le n-ième point de la chaîne de segments GEOGRAPHY d’entrée ou de la valeur GEOMETRY.
st_startpoint(geoExpr) Retourne le premier point de la valeur d'entrée GEOGRAPHY ou GEOMETRY, si la valeur géospatiale d'entrée est un linestring non vide.
st_x(geoExpr) Retourne la coordonnée X de la valeur du point GEOMETRY d’entrée ou NULL si le point est vide.
st_xmax(geoExpr) Retourne la coordonnée X maximale de la valeur d’entrée GEOMETRY , ou NULL si la géométrie est vide.
st_xmin(geoExpr) Retourne la coordonnée X minimale de la valeur d’entrée GEOMETRY , ou NULL si la géométrie est vide.
st_y(geoExpr) Retourne la coordonnée Y de la valeur du point GEOMETRY d’entrée, ou NULL si le point est vide.
st_ymax(geoExpr) Retourne la coordonnée Y maximale de la valeur d’entrée GEOMETRY , ou NULL si la géométrie est vide.
st_ymin(geoExpr) Retourne la coordonnée Y minimale de la valeur d’entrée GEOMETRY , ou NULL si la géométrie est vide.
st_z(geoExpr) Retourne la coordonnée Z de la valeur du point GEOMETRY d’entrée, ou NULL si le point est vide ou n’a pas de coordonnée Z.
st_zmax(geoExpr) Retourne la coordonnée Z maximale de la valeur d’entrée GEOMETRY , ou NULL si la géométrie est vide ou n’a pas de coordonnée Z.
st_zmin(geoExpr) Retourne la coordonnée Z minimale de la valeur d’entrée GEOMETRY , ou NULL si la géométrie est vide ou n’a pas de coordonnée Z.

Editors

Function Description
st_addpoint(geo1Expr, geo2Expr[, indexExpr]) Ajoute un nouveau point à la n-ième position dans la chaîne de lignes de l'entrée GEOGRAPHY ou GEOMETRY.
st_flipcoordinates(geoExpr) Échange les coordonnées X et Y de la valeur d’entrée GEOMETRY .
st_multi(geoExpr) Retourne la valeur d'entrée GEOGRAPHY ou GEOMETRY en tant que valeur multispatiale équivalente.
st_removepoint(geoExpr, indexExpr) Supprime le n-ième point de la linestring GEOGRAPHY ou de la valeur GEOMETRY d’entrée.
st_reverse(geoExpr) Inverse la valeur de l’entrée GEOGRAPHY ou GEOMETRY.
st_setpoint(geo1Expr, indexExpr, geo2Expr) Définit le n-ième point de la chaîne GEOGRAPHY ou GEOMETRY de la valeur de ligne d’entrée.

Validation géométrique

Function Description
st_isvalid(geoExpr) Retourne true si la valeur d’entrée GEOMETRY est une géométrie valide dans le sens OGC.

Fonctions système de référence spatiale

Function Description
st_setsrid(geo, srid) Retourne une nouvelle GEOMETRY valeur dont le SRID est la valeur SRID spécifiée.
st_srid(geoExpr) Retourne le SRID de la valeur d'entrée GEOGRAPHY ou GEOMETRY.
st_transform(geo, srid) Transforme les coordonnées X et Y de l’entrée GEOMETRY du système de référence de coordonnées actuel en système de référence de coordonnées décrit par la valeur SRID fournie.

Relations de distance

Function Description
st_dwithin(geoExpr1, geoExpr2, distanceExpr) Retourne true si la distance 2D Cartesienne entre les deux valeurs d’entrée GEOMETRY est inférieure ou égale à la valeur de distance d’entrée.

Relations topologiques

Function Description
st_contains(geo1, geo2) Retourne true si la première GEOMETRY valeur contient la deuxième GEOMETRY valeur.
st_covers(geoExpr1, geoExpr2) Retourne true si la première GEOMETRY valeur couvre la deuxième GEOMETRY valeur.
st_disjoint(geoExpr1, geoExpr2) Retourne true si les deux valeurs d’entrée GEOMETRY sont disjointes.
st_equals(geoExpr1, geoExpr2) Retourne true si les deux valeurs d’entrée GEOMETRY sont géométriquement égales, ce qui signifie qu’elles correspondent au même jeu de points.
st_intersects(geoExpr1, geoExpr2) Retourne true si les deux valeurs d’entrée GEOMETRY se croisent.
st_touches(geo1, geo2) Retourne true si les deux valeurs d’entrée GEOMETRY se touchent les unes les autres.
st_within(geo1, geo2) Retourne true si la première GEOMETRY valeur se trouve dans la deuxième GEOMETRY valeur.

Fonctions de superposition

Function Description
st_difference(geoExpr1, geoExpr2) Retourne la différence de jeu de points des deux valeurs d’entrée GEOMETRY sous la forme d’une valeur 2D GEOMETRY .
st_intersection(geoExpr1, geoExpr2) Retourne l’intersection point-set des deux valeurs d’entrée GEOMETRY sous la forme d’une valeur 2D GEOMETRY .
st_union(geo1, geo2) Retourne l’union de l’ensemble de points des deux valeurs d’entrée GEOMETRY sous la forme d’une géométrie 2D.
st_union_agg(geoCol) Retourne l'union point par point de toutes les géométries de la colonne, ou NULL si la colonne ne contient aucune ligne ou contient uniquement les valeurs NULL.

Affine Transformations

Function Description
st_rotate(geoExpr, rotationAngle) Fait pivoter la valeur d’entrée GEOMETRY autour de l’axe Z par l’angle de rotation donné (en radians).
st_scale(geoExpr, xfactor, yfactor[, zfactor]) Met à l’échelle la valeur d’entrée GEOMETRY dans les directions X, Y et, si spécifiées, Z à l’aide des facteurs de mise à l’échelle fournis.
st_translate(geoExpr, xoffset, yoffset[, zoffset]) Traduit la valeur d’entrée GEOMETRY dans les directions X, Y et, si elle est spécifiée, les directions Z à l’aide des décalages fournis.

Traitement géométrique

Function Description
st_buffer(geoExpr, radiusExpr) Retourne la mémoire tampon de la valeur d’entrée GEOMETRY à l’aide du rayon spécifié.
st_centroid(geoExpr) Retourne le centroïde de la valeur d’entrée GEOMETRY sous la forme d’une valeur de point GEOMETRY 2D.
st_concavehull(geoExpr, lengthRatioExpr[, allowHolesExpr]) Retourne l'enveloppe concave de la valeur d’entrée GEOMETRY comme GEOMETRY à l’aide du ratio de longueur spécifié.
st_convexhull(geoExpr) Retourne l'enveloppe convexe de la valeur d'entrée GEOMETRY, sous forme de valeur GEOMETRY.
st_simplify(géo, tolérance) Simplifie la valeur d’entrée GEOMETRY à l’aide de l’algorithme Douglas-Peucker.
  • Last updated on