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

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

Retourne un objet qui représente l’union entre une instance geography et une autre instance geography.Returns an object that represents the union of a geography instance with another geography instance.

SyntaxeSyntax

  
.STUnion ( other_geography )  

ArgumentsArguments

other_geographyother_geography
Autre instance geography permettant de former une union avec l’instance sur laquelle STUnion() est appelé.Is another geography instance to form a union with the instance on which STUnion() is being invoked.

Types de retourReturn Types

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

Type de retour CLR : SqlGeographyCLR return type: SqlGeography

ExceptionsExceptions

Cette méthode lève ArgumentException si l’instance contient une arête antipodale.This method throws an ArgumentException if the instance contains an antipodal edge.

Notes Remarks

Cette méthode retourne toujours une valeur Null si les SRID (identificateurs de référence spatiale) des instances geography ne correspondent pas.This method always returns null if the spatial reference identifiers (SRIDs) of the geography instances do not match.

SQL ServerSQL Server prend en charge des instances spatiales qui sont plus grandes qu'un hémisphère.supports spatial instances that are larger than a hemisphere. Dans SQL ServerSQL Server, le jeu de résultats possibles retourné sur le serveur a été étendu aux instances FullGlobe.In SQL ServerSQL Server, the set of possible results returned on the server has been extended to FullGlobe instances.

Le résultat peut contenir des segments d'arc de cercle uniquement si les instances d'entrée contiennent des segments d'arc de cercle.The result may contain circular arc segments only if the input instances contain circular arc segments.

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

ExemplesExamples

A.A. Calcul de l'union de deux polygonesComputing the union of two polygons

L'exemple suivant utilise STUnion() pour calculer l'union de deux instances Polygon.The following example uses STUnion() to compute the union of two Polygon instances.

DECLARE @g geography;  
DECLARE @h geography;  
SET @g = geography::STGeomFromText('POLYGON((-122.358 47.653, -122.348 47.649, -122.348 47.658, -122.358 47.658, -122.358 47.653))', 4326);  
SET @h = geography::STGeomFromText('POLYGON((-122.351 47.656, -122.341 47.656, -122.341 47.661, -122.351 47.661, -122.351 47.656))', 4326);  
SELECT @g.STUnion(@h).ToString();  

b.B. Génération d'un résultat FullGlobeProducing a FullGlobe result

L'exemple suivant produit un FullGlobe lorsque STUnion() combine deux instances Polygon.The following example produces a FullGlobe when STUnion() combines two Polygon instances.

 DECLARE @g geography = 'POLYGON ((-122.358 47.653, -122.358 47.658,-122.348 47.658, -122.348 47.649, -122.358 47.653))';  
 DECLARE @h geography = 'POLYGON ((-122.358 47.653, -122.348 47.649, -122.348 47.658, -122.358 47.658, -122.358 47.653))';  
 SELECT @g.STUnion(@h).ToString();

C.C. Génération d’un trou triagonal d’une union d’un CurvePolygon et d’un trou triagonal.Producing a triagonal hole from a union of a CurvePolygon and a triagonal hole.

L'exemple suivant produit un trou triagonal de l'union d'un CurvePolygon avec une instance Polygon.The following example produces a triagonal hole from the union of a CurvePolygon with a Polygon instance.

 DECLARE @g geography = 'POLYGON ((-0.5 0, 0 1, 0.5 0.5, -0.5 0))';  
 DECLARE @h geography = 'CURVEPOLYGON(COMPOUNDCURVE(CIRCULARSTRING(0 0, 0.7 0.7, 0 1), (0 1, 0 0)))';  
 SELECT @g.STUnion(@h).ToString();

 Voir aussiSee Also

Méthodes OGC sur des instances geographyOGC Methods on Geography Instances