Partilhar via


st_translate Função

Aplica-se a:check marked yes Databricks SQL check marked yes Databricks Runtime 17.1 e superior

Important

Este recurso está no Public Preview.

Observação

Esse recurso não está disponível nos armazéns Databricks SQL Classic. Para saber mais sobre os armazéns SQL do Databricks, consulte Tipos de armazém SQL.

Traduz o valor de entrada GEOMETRY nas direções X, Y e, se especificado, Z usando os deslocamentos fornecidos.

Syntax

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

Arguments

  • geoExpr: Um GEOMETRY valor.
  • xfactor: Um DOUBLE valor que representa o deslocamento na direção X.
  • yfactor: Um DOUBLE valor que representa o deslocamento na direção Y.
  • zfactor: Um DOUBLE valor que representa o deslocamento na direção Z (opcional). O padrão é 0.

Returns

Um valor do tipo GEOMETRY, que representa a geometria traduzida.

O valor SRID do valor de saída GEOMETRY é igual ao valor de entrada.

A dimensão do valor de saída GEOMETRY é a mesma que a do valor de entrada.

A função retorna NULL se qualquer uma das entradas for 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)