STGeomFromText (type de données geography)

  • Article

S’applique à :SQL ServerAzure SQL DatabaseAzure 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 geography prend en charge les instances FullGlobe ou les instances spatiales qui sont plus grandes qu’un hémisphère.

Syntaxe

  
STGeomFromText ( 'geography_tagged_text' , SRID )

Remarque

Pour afficher la syntaxe Transact-SQL pour SQL Server 2014 (12.x) et versions antérieures, consultez la Documentation sur les versions antérieures.

Arguments

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

SRID
Expression int qui représente le SRID (ID de référence spatiale) 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 ArgumentException si l’entrée contient une arête antipodale.

Notes

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 Polygone.

Exemples

L'exemple suivant utilise la méthode STGeomFromText() pour créer une instance geography.

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

Voir aussi

Méthodes geography statiques de l’OGC