Compartir vía


st_translate Función

Se aplica a:check marcado yes Databricks SQL check marcado yes Databricks Runtime 17.1 y versiones posteriores

Important

Esta característica está en versión preliminar pública.

Nota:

Esta característica no está disponible en almacenes clásicos de Databricks SQL. Para más información sobre los almacenes de SQL de Databricks, consulte Tipos de almacenamiento de SQL.

Traduce el valor de entrada GEOMETRY en las direcciones X, Y y, si se especifica, Z utilizando los desplazamientos proporcionados.

Syntax

st_translate ( geoExpr, xfactor, yfactor[, zfactor] )

Arguments

  • geoExpr: Un GEOMETRY valor.
  • xfactor DOUBLE: valor que representa el desplazamiento en la dirección X.
  • yfactor DOUBLE: valor que representa el desplazamiento en la dirección Y.
  • zfactor DOUBLE: valor que representa el desplazamiento en la dirección Z (opcional). El valor predeterminado es 0.

Returns

Valor de tipo GEOMETRY, que representa la geometría traducida.

El valor SRID del valor de salida GEOMETRY es igual al del valor de entrada.

La dimensión del valor de salida GEOMETRY es la misma que la del valor de entrada.

La función devuelve NULL si alguna de las entradas es NULL.

Examples

-- Translates a point by 10 in the X direction and 20 in the Y direction.
> SELECT st_astext(_FUNC_(st_geomfromtext('MULTIPOINT ZM (1 2 3 -4,5 6 7 -8,EMPTY)'), 10.0, 20.0));
  MULTIPOINT ZM ((11 22 3 -4),(15 26 7 -8),EMPTY)
-- Translates a point by 10 in the X direction, 20 in the Y direction, and 3 in the Z direction.
> SELECT st_astext(_FUNC_(st_geomfromtext('MULTIPOINT ZM (1 2 3 -4,5 6 7 -8,EMPTY)'), 10.0, 20.0, 30.0));
  MULTIPOINT ZM ((11 22 33 -4),(15 26 37 -8),EMPTY)