st_makepolygon Função

Aplica-se a: Databricks SQL Databricks Runtime 17.1 and above

Constrói um valor de polígono GEOMETRY a partir do limite externo de entrada e de uma matriz opcional de limites internos, representados como linestrings fechados.

Syntax

st_makepolygon ( outer[, innerArray] )

Arguments

• outer: valor de GEOMETRY.
• innerArray: uma matriz de GEOMETRY valores.

Returns

Um valor de tipo GEOMETRY, representando um polígono.

Todos NULL os valores na matriz de limites internos são ignorados.

O valor SRID do polígono de saída é o valor SRID comum das geometrias de entrada.

A dimensão do polígono de saída é a dimensão máxima comum das linhas de entrada.

A função retornará NULL se qualquer uma das entradas for NULL.

Condições de erro

• Se qualquer uma das geometrias de entrada não for linestring, a função retornará ST_INVALID_ARGUMENT. INVALID_TYPE.
• Se as geometrias de entrada não tiverem o mesmo valor SRID, a função retornará ST_DIFFERENT_SRID_VALUES.
• Se o limite externo for um linestring vazio, espera-se que a matriz de limites internos seja uma matriz vazia. Caso contrário, a função retorna ST_INVALID_ARGUMENT.EMPTY_OUTER_BOUNDARY.
• Se o limite externo tiver menos de quatro vértices, a função retornará ST_INVALID_ARGUMENT. TOO_FEW_VERTICES_IN_OUTER_BOUNDARY.
• Se o limite externo não estiver fechado, a função retornará ST_INVALID_ARGUMENT. OUTER_BOUNDARY_NOT_CLOSED.
• Se qualquer um dos limites internos tiver menos de quatro vértices, a função retornará ST_INVALID_ARGUMENT. TOO_FEW_VERTICES_IN_INNER_BOUNDARY.
• Se qualquer um dos limites internos não estiver fechado, a função retornará ST_INVALID_ARGUMENT. INNER_BOUNDARY_NOT_CLOSED.

Examples

-- Returns a polygon constructed from the outer boundary.
> SELECT st_astext(st_makepolygon(st_geomfromtext('LINESTRING(0 0,10 0,10 10,0 10,0 0)')));
  POLYGON((0 0,10 0,10 10,0 10,0 0))
-- Returns a polygon constructed from the outer boundary and an inner boundary.
> SELECT st_astext(st_makepolygon(st_geomfromtext('LINESTRING(0 0,10 0,10 10,0 10,0 0)'), array(st_geomfromtext('LINESTRING(1 1,2 1,1 2,1 1)'))));
  POLYGON((0 0,10 0,10 10,0 10,0 0),(1 1,2 1,1 2,1 1))

Funções relacionadas

• st_exteriorring função
• st_interiorringn função
• st_makeline função
• st_numinteriorrings função
• st_point função