Reduce (tipo de dados geometry)
Aplica-se a: 
SQL Server Banco de Dados SQL do Azure Instância Gerenciada de SQL do Azure Banco de Dados SQL no Microsoft Fabric
Retorna uma aproximação da instância de geometria fornecida. A aproximação é produzida pela execução de uma extensão do algoritmo Douglas-Peucker na instância com a tolerância especificada.
Sintaxe
.Reduce ( tolerance )
Argumentos
tolerance
É um valor do tipo float. tolerance é a tolerância de entrada para o algoritmo de aproximação.
Tipos de retorno
Tipo de retorno do SQL Server: geometry
Tipo de retorno do CLR: SqlGeometry
Comentários
Para os tipos de coleção, esse algoritmo opera de forma independente em cada geometria contida na instância.
Esse algoritmo não modifica as instâncias de Point.
Nas instâncias LineString, CircularString e CompoundCurve, o algoritmo de aproximação mantém os pontos originais de início e de término da instância. Em seguida, o algoritmo iterativamente adiciona de volta o ponto da instância original que mais desvia do resultado. Esse processo continua até que nenhum ponto desvie mais do que a tolerância especificada.
Reduce() retorna uma instância de LineString, CircularString ou CompoundCurve para instâncias de CircularString. Reduce() retorna um uma instância de CompoundCurve ou LineString para instâncias de CompoundCurve.
Em instâncias de polígono, o algoritmo de aproximação é aplicado de forma independente a cada anel. O método produzirá uma FormatException se a instância de polígono retornada não for válida. Por exemplo, uma instância inválida de MultiPolygon será criada se Reduce() for aplicado para simplificar cada anel na instância e se os anéis resultantes se sobrepuserem. Nas instâncias de CurvePolygon com um anel exterior e sem nenhum anel interior, Reduce() retorna uma instância de CurvePolygon, LineString ou Point. Se CurvePolygon tiver anéis interiores, uma instância de CurvePolygon ou MultiPoint será retornada.
Quando um segmento de arco circular é encontrado, o algoritmo de aproximação verifica se o arco pode ser aproximado por sua corda dentro de metade da tolerância dada. As cordas que satisfazem esses critérios, o arco circular é substituído nos cálculos pela corda. Se uma corda não satisfaz esses critérios, o arco circular é mantido e o algoritmo de aproximação é aplicado aos segmentos restantes.
Exemplos
a. Usando Reduce() para simplificar um LineString
O exemplo a seguir cria uma instância LineString e usa Reduce() para simplificar a instância.
DECLARE @g geometry;
SET @g = geometry::STGeomFromText('LINESTRING(0 0, 0 1, 1 0, 2 1, 3 0, 4 1)', 0);
SELECT @g.Reduce(.75).ToString();
B. Usando Reduce() com níveis de tolerância variados em um CircularString
O exemplo a seguir usa Reduce() com três níveis de tolerância em uma instância de CircularString:
DECLARE @g geometry = 'CIRCULARSTRING(0 0, 8 8, 16 0, 20 -4, 24 0)';
SELECT @g.Reduce(5).ToString();
SELECT @g.Reduce(15).ToString();
SELECT @g.Reduce(16).ToString();
Esse exemplo gera a saída a seguir:
CIRCULARSTRING (0 0, 8 8, 16 0, 20 -4, 24 0)
COMPOUNDCURVE (CIRCULARSTRING (0 0, 8 8, 16 0), (16 0, 24 0))
LINESTRING (0 0, 24 0)
Cada uma das instâncias retornadas contém os pontos de extremidade (0 0) e (24 0).
C. Usando Reduce() com níveis de tolerância variados em um CompoundCurve
O exemplo a seguir usa Reduce() com dois níveis de tolerância em uma instância de CompoundCurve:
DECLARE @g geometry = 'COMPOUNDCURVE(CIRCULARSTRING(0 0, 8 8, 16 0, 20 -4, 24 0),(24 0, 20 4, 16 0))';
SELECT @g.Reduce(15).ToString();
SELECT @g.Reduce(16).ToString();
Neste exemplo, observe que a segunda instrução SELECT retorna a instância de LineString: LineString(0 0, 16 0).
Mostrando um exemplo onde os pontos originais de início e de término são perdidos
O exemplo a seguir mostra como os pontos originais de início e de término talvez não sejam retidos pela instância resultante. Esse comportamento ocorre porque manter os pontos originais de início e de extremidade resultaria em uma instância de LineString inválida.
DECLARE @g geometry = 'LINESTRING(0 0, 4 0, 2 .01, 1 0)';
DECLARE @h geometry = @g.Reduce(1);
SELECT @g.STIsValid() AS Valid
SELECT @g.ToString() AS Original, @h.ToString() AS Reduced;