st_translate Função

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

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)