st_makepolygon Função

Aplica-se a: Databricks SQL Databricks Runtime 17.1 e superior

Constrói um valor de polígono GEOMETRY a partir do limite externo de entrada e da matriz opcional de limites internos, representados como cadeias de caracteres de linha fechadas.

Syntax

st_makepolygon ( outer[, innerArray] )

Arguments

• outer: Um GEOMETRY valor.
• innerArray: Uma matriz de GEOMETRY valores.

Returns

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

Todos os NULL 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 comum máxima das cadeias de caracteres de linha de entrada.

A função retorna 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 uma cadeia de caracteres de linha vazia, espera-se que a matriz de limites internos seja uma matriz vazia. Caso contrário, a função retornará 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