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

S’APPLIQUE À : ouiSQL Server (à partir de 2012) ouiAzure SQL Database nonAzure SQL Data Warehouse nonParallel Data Warehouse APPLIES TO: yesSQL Server (starting with 2012) yesAzure SQL Database noAzure SQL Data Warehouse noParallel Data Warehouse

Retourne un objet geography qui représente l’union de tous les points dont la distance par rapport à une instance geography est inférieure ou égale à une valeur spécifique.Returns a geography object that represents the union of all points whose distance from a geography instance is less than or equal to a specified value.

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

  
.STBuffer ( distance )  

ArgumentsArguments

distancedistance
Valeur de type float (double dans le .NET Framework), qui spécifie la distance de l’instance geography autour de laquelle calculer la mémoire tampon.Is a value of type float (double in the .NET Framework) specifying the distance from the geography instance around which to calculate the buffer.

La distance maximale du tampon ne peut pas dépasser 0,999 * π * minorAxis * minorAxis / majorAxis (~0,999 * 1/2 de la circonférence de la Terre) ou le globe complet.The maximum distance of the buffer cannot exceed 0.999 * π * minorAxis * minorAxis / majorAxis (~0.999 * 1/2 Earth's circumference) or the full globe.

Types de retourReturn Types

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

Type de retour CLR : SqlGeographyCLR return type: SqlGeography

Notes Remarks

STBuffer() calcule une mémoire tampon de la même manière que BufferWithTolerance, en spécifiant tolerance = abs(distance) * 0,001 et relative = false.STBuffer() calculates a buffer in the same manner as BufferWithTolerance, specifying tolerance = abs(distance) * .001 and relative = false.

Une mémoire tampon négative supprime tous les points dans la distance donnée de la limite de l’instance geography.A negative buffer removes all points within the given distance of the boundary of the geography instance.

STBuffer() retourne une instance FullGlobe dans certains cas ; par exemple STBuffer() retourne une instance FullGlobe quand la distance de mémoire tampon est supérieure à la distance entre l’équateur et les pôles.STBuffer() will return a FullGlobe instance in certain cases; for example, STBuffer() returns a FullGlobe instance when the buffer distance is greater than the distance from the equator to the poles. Une mémoire tampon ne peut pas dépasser le globe complet.A buffer cannot exceed the full globe.

Cette méthode lève ArgumentException dans les instances FullGlobe où la distance de mémoire tampon dépasse la limite suivante :This method will throw an ArgumentException in FullGlobe instances where the distance of the buffer exceeds the following limitation:

0,999 * π * minorAxis * minorAxis / majorAxis (~0,999 * 1/2 de la circonférence de la Terre)0.999 * π * minorAxis * minorAxis / majorAxis (~0.999 * 1/2 Earth's circumference)

La limite de distance maximale permet à la construction de la mémoire tampon d'être aussi flexible que possible.The maximum distance limit allows the construction of the buffer to be as flexible as possible.

L’erreur entre la mémoire tampon théorique et la mémoire tampon calculée correspond à max (tolérance, étendues * 1E-7), où tolérance = distance * 0,001.The error between the theoretical and computed buffer is max(tolerance, extents * 1.E-7) where tolerance = distance * .001. Pour plus d’informations sur les étendues, consultez Référence de méthodes de type de données geography.For more information on extents, see geography Data Type Method Reference.

ExemplesExamples

L’exemple suivant crée une instance LineString``geography.The following example creates a LineString``geography instance. Il utilise ensuite STBuffer() pour retourner la région située à une proximité d'un mètre de l'instance.It then uses STBuffer() to return the region within 1 meter of the instance.

DECLARE @g geography;  
SET @g = geography::STGeomFromText('LINESTRING(-122.360 47.656, -122.343 47.656)', 4326);  
SELECT @g.STBuffer(1).ToString();  

 Voir aussiSee Also

BufferWithTolerance (type de données geography) BufferWithTolerance (geography Data Type)
Méthodes OGC sur des instances geographyOGC Methods on Geography Instances