Partager via


STGeomFromText (type de données geography)

S’applique à : SQL Server Azure SQL Database Azure SQL Managed Instance

Retourne une instance geography à partir d’une représentation OGC (Open Geospatial Consortium) WKT (Well-Known Text), à laquelle s’ajoutent les valeurs Z (élévation) et M (mesure) apportées par l’instance.

Cette méthode de type de données géographique prend en charge FullGlobe les instances ou les instances spatiales qui sont plus grandes qu’un hémisphère.

Syntaxe

STGeomFromText ( 'geography_tagged_text' , SRID )

Arguments

geography_tagged_text

Représentation WKT de l’instance geography à retourner. geography_tagged_text est nvarchar(max).

SRID

Expression int représentant l’ID de référence spatiale (SRID) de l’instance geography à retourner.

Types de retour

  • Type de retour SQL Server : geography
  • Type de retour CLR : SqlGeography

Notes

Le type OGC de l’instance geography retournée par STGeomFromText() a comme valeur l’entrée WKT correspondante.

Cette méthode lève une ArgumentException valeur si l’entrée contient un bord antipodal.

Remarque

L’ordre dans lequel les points sont énumérés est important pour les polygones géographiques. Il détermine si la zone du polygone se trouve à l’intérieur ou à l’extérieur de la boucle donnée. Pour plus d’informations, consultez Polygon.

Exemples

L’exemple suivant utilise STGeomFromText() pour créer une instance geography .

DECLARE @g geography;
-- Starting point: Lat. 47.656, Lon. -122.360
-- Ending point: Lat. 47.656, Lon. -122.343
SET @g = geography::STGeomFromText('LINESTRING(-122.360 47.656, -122.343 47.656)', 4326);
SELECT @g.ToString();