Reduce (type de données geography)Reduce (geography Data Type )

S’APPLIQUE À : ouiSQL Server ouiAzure SQL Database nonAzure SQL Data Warehouse nonParallel Data Warehouse APPLIES TO: yesSQL Server yesAzure SQL Database noAzure SQL Data Warehouse noParallel Data Warehouse

Retourne une approximation de l’instance geography donnée en exécutant l’algorithme de Douglas-Peucker sur l’instance, avec la tolérance donnée.Returns an approximation of the given geography instance produced by running the Douglas-Peucker algorithm on the instance with the given tolerance.

Cette méthode de type de données geography prend en charge les instances FullGlobe ou les instances spatiales qui sont plus grandes qu’un hémisphère.This geography data type method supports FullGlobe instances or spatial instances that are larger than a hemisphere.

SyntaxeSyntax

  
.Reduce ( tolerance )  

ArgumentsArguments

TermeTerm DéfinitionDefinition
tolerancetolerance Valeur de type float.Is a value of type float. tolerance est la tolérance à entrer pour l’algorithme Douglas-Peucker.tolerance is the tolerance to input to the Douglas-Peucker algorithm. tolerance doit être un nombre positif.tolerance must be a positive number.

Types de retourReturn Types

Type de retour SQL ServerSQL Server : geographySQL ServerSQL Server return type: geography

Type de retour CLR : SqlGeographyCLR return type: SqlGeography

NotesRemarks

Pour les types de collection, cet algorithme fonctionne indépendamment sur chaque geography contenu dans l’instance.For collection types, this algorithm operates independently on each geography contained in the instance. Cet algorithme ne modifie pas les instances Point.This algorithm does not modify Point instances.

Cette méthode tente de conserver les points de terminaison des instances LineString, mais elle peut ne pas y parvenir si elle a pour but de conserver un résultat valide.This method will attempt to preserve the endpoints of LineString instances, but may fail to do so in order to preserve a valid result.

Si Reduce() est appelé avec une valeur négative, cette méthode lève ArgumentException.If Reduce() is called with a negative value, this method will produce an ArgumentException. Les tolérances utilisées dans Reduce() doivent être des nombres positifs.Tolerances used in Reduce() must be positive numbers.

L’algorithme Douglas-Peucker fonctionne sur chaque courbe ou anneau de l’instance geography en supprimant tous les points, à l’exception du point de départ et du point de terminaison.The Douglas-Peucker algorithm works on each curve or ring in the geography instance by removing all points except for the start point and end point. Chaque point supprimé est ensuite rajouté, en commençant par le point excentré le plus lointain, jusqu’à ce qu’aucun point ne soit à plus de la valeur tolerance du résultat.Each point removed is then added back, starting with the farthest outlying point, until no point is more than tolerance from the result. Le résultat est ensuite rendu valide si nécessaire, dans la mesure où un résultat valide est garanti.The result is then made valid if necessary, as a valid result is guaranteed.

Dans SQL Server 2012 (11.x)SQL Server 2012 (11.x), cette méthode a été étendue aux instances FullGlobe.In SQL Server 2012 (11.x)SQL Server 2012 (11.x), this method has been extended to FullGlobe instances.

Cette méthode n'est pas précise.This method is not precise.

ExemplesExamples

L'exemple suivant crée une instance LineString et utilise Reduce() afin de simplifier l'instance.The following example creates a LineString instance and uses Reduce() to simplify the instance.

DECLARE @g geography = 'LineString(120 45, 120.1 45.1, 199.9 45.2, 120 46)'  
SELECT @g.Reduce(10000).ToString()  

Voir aussiSee Also

Méthodes étendues sur des instances geographyExtended Methods on Geography Instances