geography 인스턴스 만들기, 구성 및 쿼리Create, Construct, and Query geography Instances

지리 공간 데이터 형식인 geography는 둥근 표면 좌표계로 데이터를 나타냅니다.The geography spatial data type, geography, represents data in a round-earth coordinate system. 이 형식은 SQL ServerSQL Server에서 .NET CLR(공용 언어 런타임) 데이터 형식으로 구현됩니다.This type is implemented as a .NET common language runtime (CLR) data type in SQL ServerSQL Server. SQL ServerSQL Server geography 데이터 형식은 GPS 위도 및 경도 좌표 등의 타원(둥근 표면) 데이터를 저장합니다.The SQL ServerSQL Server geography data type stores ellipsoidal (round-earth) data, such as GPS latitude and longitude coordinates.

geography 형식은 각 데이터베이스에서 미리 정의되고 사용할 수 있습니다.The geography type is predefined and available in each database. 다른 시스템 제공 형식을 사용할 때와 동일한 방식으로 geography 형식의 테이블 열을 만들고 geography 데이터에 대한 작업을 수행할 수 있습니다.You can create table columns of type geography and operate on geography data in the same manner as you would use other system-supplied types.

새 지리 인스턴스 만들기 또는 구성 Creating or constructing a new geography instance

기존 인스턴스에서 새 지리 인스턴스 만들기 Creating a New geography Instance from an Existing Instance

geography 데이터 형식은 수많은 기본 메서드를 제공합니다. 이러한 메서드를 사용하여 기존 인스턴스를 기반하여 새 geography 인스턴스를 만들 수 있습니다.The geography data type provides numerous built-in methods you can use to create new geography instances based on existing instances.

지리의 버퍼를 만들려면To create a buffer around a geography
STBuffer(geography 데이터 형식) STBuffer (geography Data Type)

허용 오차를 허용하는 지리의 버퍼를 만들려면To create a buffer around a geography, allowing for a tolerance
BufferWithTolerance(geography 데이터 형식) BufferWithTolerance (geography Data Type)

두 geography 인스턴스의 교집합에서 지리를 만들려면To create a geography from the intersection of two geography instances
STIntersection(geography 데이터 형식) STIntersection (geography Data Type)

두 geography 인스턴스의 합집합에서 지리를 만들려면To create a geography from the union of two geography instances
STUnion(geography 데이터 형식) STUnion (geography Data Type)

한 지리가 다른 지리와 겹치지 않는 점에서 지리를 만들려면To create a geography from the points where one geography does not overlap another
STDifference(geography 데이터 형식) STDifference (geography Data Type)

WKT 입력으로부터 지리 인스턴스 구성 Constructing a geography Instance from Well-Known Text Input

geography 데이터 형식은 OGC(Open Geospatial Consortium) WKT 표현에서 지리를 생성하는 여러 가지 기본 메서드를 제공합니다.The geography data type provides several built-in methods that generate a geography from the Open Geospatial Consortium (OGC) WKT representation. WKT 표준은 지리 데이터를 텍스트 형식으로 교환할 수 있는 텍스트 문자열입니다.The WKT standard is a text string that allows geography data to be exchanged in textual form.

WKT 입력으로부터 지리 인스턴스 유형을 구성하려면To construct any type of geography instance from WKT input
STGeomFromText(geography 데이터 형식) STGeomFromText (geography Data Type)

Parse(geography 데이터 형식)Parse (geography Data Type)

WKT 입력으로부터 지리 Point 인스턴스를 구성하려면To construct a geography Point instance from WKT input
STPointFromText(geography 데이터 형식) STPointFromText (geography Data Type)

WKT 입력으로부터 지리 MultiPoint 인스턴스를 구성하려면To construct a geography MultiPoint instance from WKT input
STMPointFromText(geography 데이터 형식) STMPointFromText (geography Data Type)

WKT 입력으로부터 지리 LineString 인스턴스를 구성하려면To construct a geography LineString instance from WKT input
STLineFromText(geography 데이터 형식)STLineFromText (geography Data Type)

WKT 입력으로부터 지리 MultiLineString 인스턴스를 구성하려면To construct a geography MultiLineString instance from WKT input
STMLineFromText(geography 데이터 형식) STMLineFromText (geography Data Type)

WKT 입력으로부터 지리 Polygon 인스턴스를 구성하려면To construct a geography Polygon instance from WKT input
STPolyFromText(geography 데이터 형식) STPolyFromText (geography Data Type)

WKT 입력으로부터 지리 MultiPolygon 인스턴스를 구성하려면To construct a geography MultiPolygon instance from WKT input
STMPolyFromText(geography 데이터 형식) STMPolyFromText (geography Data Type)

WKT 입력으로부터 지리 GeometryCollection 인스턴스를 구성하려면To construct a geography GeometryCollection instance from WKT input
STGeomCollFromText(geography 데이터 형식) STGeomCollFromText (geography Data Type)

WKB 입력으로부터 지리 인스턴스 구성 Constructing a geography Instance from Well-Known Binary Input

WKB는 클라이언트 응용 프로그램과 SQL 데이터베이스 간에 Geography 데이터를 교환할 수 있도록 OGC에서 지정하는 이진 형식입니다.WKB is a binary format specified by the OGC that permits Geography data to be exchanged between a client application and an SQL database. 다음 함수는 WKB 입력을 사용하여 geography 인스턴스를 생성합니다.The following functions accept WKB input to construct geography instances:

WKB 입력으로부터 지리 인스턴스 유형을 구성하려면To construct any type of geography instance from WKB input
STGeomFromWKB(geography 데이터 형식) STGeomFromWKB (geography Data Type)

WKB 입력으로부터 지리 Point 인스턴스를 구성하려면To construct a geography Point instance from WKB input
STPointFromWKB(geography 데이터 형식) STPointFromWKB (geography Data Type)

WKB 입력으로부터 지리 MultiPoint 인스턴스를 구성하려면To construct a geography MultiPoint instance from WKB input
STMPointFromWKB(geography 데이터 형식) STMPointFromWKB (geography Data Type)

WKB 입력으로부터 지리 LineString 인스턴스를 구성하려면To construct a geography LineString instance from WKB input
STLineFromWKB(geography 데이터 형식) STLineFromWKB (geography Data Type)

WKB 입력으로부터 지리 MultiLineString 인스턴스를 구성하려면To construct a geography MultiLineString instance from WKB input
STMLineFromWKB(geography 데이터 형식) STMLineFromWKB (geography Data Type)

WKB 입력으로부터 지리 Polygon 인스턴스를 구성하려면To construct a geography Polygon instance from WKB input
STPolyFromWKB(geography 데이터 형식) STPolyFromWKB (geography Data Type)

WKB 입력으로부터 지리 MultiPolygon 인스턴스를 구성하려면To construct a geography MultiPolygon instance from WKB input
STMPolyFromWKB(geography 데이터 형식) STMPolyFromWKB (geography Data Type)

WKB 입력으로부터 지리 GeometryCollection 인스턴스를 구성하려면To construct a geography GeometryCollection instance from WKB input
STGeomCollFromWKB(geography 데이터 형식)STGeomCollFromWKB(geography 데이터 형식) STGeomCollFromWKB (geography Data Type)STGeomCollFromWKB (geography Data Type)

GML 텍스트 입력으로부터 지리 인스턴스 구성 Constructing a geography Instance from GML Text Input

geography 데이터 형식은 geography 인스턴스의 XML 표현인 GML에서 geography 인스턴스를 생성하는 메서드를 제공합니다.The geography data type provides a method that generates a geography instance from GML, an XML representation of a geography instance. SQL ServerSQL Server 는 GML 하위 집합을 지원합니다. supports a subset of GML.

Geography Markup Language에 대한 자세한 내용은 OGC 사양: OGC 사양, Geography Markup Language를 참조하세요.For more information on Geography Markup Language, see the OGC Specification: OGC Specifications, Geography Markup Language.

GML 입력으로부터 지리 인스턴스 유형을 구성하려면To construct any type of geography instance from GML input
GeomFromGML(geography 데이터 형식) GeomFromGML (geography Data Type)

지리 인스턴스에서 WKT 및 WKB 반환 Returning Well-Known Text and Well-Known Binary from a geography Instance

다음 메서드를 사용하여 geography 인스턴스의 WKT 또는 WKB 형식을 반환할 수 있습니다.You can use the following methods to return either the WKT or WKB format of a geography instance:

지리 인스턴스의 WKT 표현을 반환하려면To return the WKT representation of a geography instance
STAsText(geography 데이터 형식) STAsText (geography Data Type)

ToString(geography 데이터 형식)ToString (geography Data Type)

Z 및 M 값을 포함하여 지리 인스턴스의 WKT 표현을 반환하려면To return the WKT representation of a geography instance including any Z and M values
AsTextZM(geography 데이터 형식) AsTextZM (geography Data Type)

지리 인스턴스의 WKB 표현을 반환하려면To return the WKB representation of a geography instance
STAsBinary(geography 데이터 형식) STAsBinary (geography Data Type)

지리 인스턴스의 GML 표현을 반환하려면To return a GML representation of a geography instance
AsGml(geography 데이터 형식) AsGml (geography Data Type)

지리 인스턴스의 속성 및 동작 쿼리 Querying the Properties and Behaviors of geography Instances

모든 geography 인스턴스에는 SQL ServerSQL Server 에서 제공하는 메서드를 통해 검색할 수 있는 여러 속성이 있습니다.All geography instances have a number of properties that can be retrieved through methods that SQL ServerSQL Server provides. 다음 항목에서는 geography 형식의 속성과 동작 및 각각을 쿼리하는 메서드를 정의합니다.The following topics define the properties and behaviors of geography types, and the methods for querying each one.

유효성, 인스턴스 유형 및 GeometryCollection 정보 Validity, Instance Type, and GeometryCollection Information

geography 인스턴스를 구성한 후 다음과 같은 방법으로 인스턴스 유형을 반환할 수 있습니다. GeometryCollection 인스턴스인 경우 특정 geography 인스턴스를 반환할 수 있습니다.After a geography instance is constructed, you can use the following methods to return the instance type, or if it is a GeometryCollection instance, return a specific geography instance.

geography 인스턴스 유형을 반환하려면To return the instance type of a geography
STGeometryType(geography 데이터 형식) STGeometryType (geography Data Type)

지리가 지정된 인스턴스 유형인지 확인하려면To determine if a geography is a given instance type
InstanceOf(geography 데이터 형식) InstanceOf (geography Data Type)

geography 인스턴스가 해당 인스턴스 유형에 대해 형식이 올바른지 확인하려면To determine if a geography instance is well-formed for its instance type
STNumGeometries(geography 데이터 형식) STNumGeometries (geography Data Type)

GeometryCollection 인스턴스에서 특정 지리를 반환하려면To return a specific geography in a GeometryCollection instance
STGeometryN(geography 데이터 형식)STGeometryN(geography 데이터 형식) STGeometryN (geography Data Type)STGeometryN (geography Data Type)

점 수 Number of Points

모든 비어 있지 않은 geography 인스턴스는 으로 구성됩니다.All nonempty geography instances are comprised of points. 이러한 점은 geography 인스턴스가 그려지는 지구의 위도 및 경도 좌표를 나타냅니다.These points represent the latitude and longitude coordinates of the earth on which the geography instances are drawn. geography 데이터 형식은 인스턴스의 점을 쿼리하는 데 필요한 수많은 기본 메서드를 제공합니다.The data type geography provides numerous built-in methods for querying the points of an instance.

인스턴스를 구성하는 점 개수를 반환하려면To return the number of points that comprise an instance
STNumPoints(geography 데이터 형식) STNumPoints (geography Data Type)

인스턴스의 특정 점을 반환하려면To return a specific point in an instance
STPointN(geometry 데이터 형식) STPointN (geometry Data Type)

인스턴스의 시작점을 반환하려면To return the start point of an instance
STStartPoint(geography 데이터 형식) STStartPoint (geography Data Type)

인스턴스의 끝점을 반환하려면To return the end point of an instance
STEndpoint(geography 데이터 형식) STEndpoint (geography Data Type)

차원 Dimension

비어 있지 않은 geography 인스턴스는 0, 1 또는 2차원이 될 수 있습니다.A nonempty geography instance can be 0-, 1-, or 2-dimensional. PointMultiPoint 와 같은 0차원 geography인스턴스에는 길이 또는 영역이 없습니다.Zero-dimensional geography instances, such as Point and MultiPoint, have no length or area. LineString, CircularString, CompoundCurveMultiLineString과 같은 1차원 개체에는 길이가 있습니다.One-dimensional objects, such as LineString, CircularString, CompoundCurve, and MultiLineString, have length. Polygon, CurvePolygonMultiPolygon과 같은 2차원 인스턴스에는 영역과 길이가 있습니다.Two-dimensional instances, such as Polygon, CurvePolygon, and MultiPolygon, have area and length. 비어 있는 인스턴스에서는 -1차원을 보고하고 GeometryCollection 에서는 해당 내용의 최대 차원을 보고합니다.Empty instances report a dimension of -1, and a GeometryCollection reports the maximum dimension of its contents.

인스턴스의 차원을 반환하려면To return the dimension of an instance
STDimension(geography 데이터 형식) STDimension (geography Data Type)

인스턴스의 길이를 반환하려면To return the length of an instance
STLength(geography 데이터 형식) STLength (geography Data Type)

인스턴스의 영역을 반환하려면To return the area of an instance
STArea(geography 데이터 형식) STArea (geography Data Type)

비어 있음 Empty

비어 있는geography 인스턴스에는 점이 하나도 없습니다.An emptygeography instance does not have any points. 비어 있는 LineString, CircularString, CompoundCurveMultiLineString 인스턴스의 길이는 0입니다.The length of empty LineString, CircularString, CompoundCurve, and MultiLineString instances is 0. 비어 있는 Polygon, CurvePolygonMultiPolygon 인스턴스의 영역은 0입니다.The area of empty Polygon, CurvePolygon and MultiPolygon instances is 0.

인스턴스가 비어 있는지 확인하려면To determine if an instance is empty
STIsEmpty(geography 데이터 형식) STIsEmpty (geography Data Type)

닫힘 Closure

닫혀 있는geography 인스턴스는 시작점과 끝점이 같은 도형입니다.A closedgeography instance is a figure whose start points and end points are the same. Polygon 인스턴스는 닫혀 있다고 간주되며,Polygon instances are considered closed. Point 인스턴스는 닫혀 있지 않습니다.Point instances are not closed.

링은 단순하고 닫혀 있는 LineString 인스턴스입니다.A ring is a simple, closed LineString instance.

인스턴스가 닫혀 있는지 확인하려면To determine if an instance is closed
STIsClosed(geography 데이터 형식) STIsClosed (geography Data Type)

Polygon 인스턴스에 있는 내부 링의 개수를 반환하려면To return the number of rings in a Polygon instance
NumRings(geography 데이터 형식) NumRings (geography Data Type)

geography 인스턴스에 지정된 링을 반환하려면To return a specified ring of a geography instance
RingN(geography 데이터 형식) RingN (geography Data Type)

SRID(Spatial Reference ID) Spatial Reference ID (SRID)

SRID(Spatial Reference ID)는 geography 인스턴스를 나타내는 타원 좌표계를 지정하는 식별자입니다.The spatial reference ID (SRID) is an identifier specifying which ellipsoidal coordinate system the geography instance is represented in. 다른 SRID를 사용하는 두 geography 인스턴스는 서로 비교할 수 없습니다.Two geography instances with different SRIDs cannot be compared.

인스턴스의 SRID를 설정하거나 반환하려면To set or return the SRID of an instance
STSrid(geography 데이터 형식) STSrid (geography Data Type)

이 속성은 수정할 수 있습니다.This property can be modified.

지리 인스턴스 간 관계 확인 Determining Relationships between geography Instances

geography 데이터 형식은 수많은 기본 메서드를 제공합니다. 이러한 메서드를 사용하여 두 개의 geography 인스턴스 간 관계를 확인할 수 있습니다.The geography data type provides many built-in methods you can use to determine relationships between two geography instances.

두 인스턴스가 동일한 점 집합으로 구성되었는지 확인하려면To determine if two instances comprise the same point set
STEquals(geometry 데이터 형식) STEquals (geometry Data Type)

두 인스턴스가 결합되지 않았는지 확인하려면To determine if two instances are disjoint
STDisjoint(geometry 데이터 형식) STDisjoint (geometry Data Type)

두 인스턴스가 교차하는지 확인하려면To determine if two instances intersect
STIntersects(geometry 데이터 형식) STIntersects (geometry Data Type)

두 인스턴스가 교차하는 점을 확인하려면To determine the point or points where two instances intersect
STIntersection(geography 데이터 형식) STIntersection (geography Data Type)

두 geography 인스턴스의 점 간 최단 길이를 확인하려면To determine the shortest distance between points in two geography instances
STDistance(geometry 데이터 형식) STDistance (geometry Data Type)

두 geography 인스턴스 간 점의 차이를 확인하려면To determine the difference in points between two geography instances
STDifference(geography 데이터 형식) STDifference (geography Data Type)

한 개의 지리 인스턴스를 다른 인스턴스와 비교하여 대칭 차이 또는 고유 점을 파생하려면To derive the symmetric difference, or unique points, of one geography instance compared with another instance
STSymDifference(geography 데이터 형식) STSymDifference (geography Data Type)

지원되는 SRID를 사용해야 하는 geography 인스턴스 geography Instances Must Use Supported SRID

SQL ServerSQL Server 에서는 EPSG 표준을 기준으로 하는 SRID를 지원합니다. supports SRIDs based on the EPSG standards. 계산을 수행하거나 지리 공간 데이터가 있는 메서드를 사용할 경우 SQL ServerSQL Servergeography 인스턴스에 지원 SRID가 사용되어야 합니다.A SQL ServerSQL Server-supported SRID for geography instances must be used when performing calculations or using methods with geography spatial data. SRID는 sys.spatial_reference_systems 카탈로그 뷰에 표시된 SRID 중 하나와 일치해야 합니다.The SRID must match one of the SRIDs displayed in the sys.spatial_reference_systems catalog view. 앞에서 설명한 대로 각 타원면에는 특정 SRID가 지정되므로 geography 데이터 형식을 사용하여 공간 데이터에서 계산을 수행할 경우 데이터를 만드는 데 사용된 타원면에 따라 결과가 달라집니다.As mentioned previously, when you perform calculations on your spatial data using the geography data type, your results will depend on which ellipsoid was used in the creation of your data, as each ellipsoid is assigned a specific spatial reference identifier (SRID).

SQL ServerSQL Server 인스턴스의 메서드를 사용할 경우 geography 인스턴스 간 관계를 확인할 수 있습니다. uses the default SRID of 4326, which maps to the WGS 84 spatial reference system, when using methods on geography instances. WGS 84(또는 SRID 4326)가 아닌 공간 참조 시스템의 데이터를 사용할 경우 지리 공간 데이터에 대해 특정 SRID를 결정해야 합니다.If you use data from a spatial reference system other than WGS 84 (or SRID 4326), you will need to determine the specific SRID for your geography spatial data.

Examples

다음 예에서는 geography 데이터를 추가하고 쿼리하는 방법을 보여 줍니다.The following examples show how to add and query geography data.

  • 첫 번째 예에서는 ID 열과 geographyGeogCol1이 있는 테이블을 만듭니다.The first example creates a table with an identity column and a geography column GeogCol1. 세 번째 열에서는 geography 열을 OGC(Open Geospatial Consortium) WKT(Well-Known Text) 표현으로 렌더링하고 STAsText() 메서드를 사용합니다.A third column renders the geography column into its Open Geospatial Consortium (OGC) Well-Known Text (WKT) representation, and uses the STAsText() method. 그러고 나면 두 개의 행이 삽입됩니다. 이 중 한 행에는 LineStringgeography인스턴스가 들어 있고, 다른 행에는 Polygon 인스턴스가 들어 있습니다.Two rows are then inserted: one row contains a LineString instance of geography, and one row contains a Polygon instance.

    IF OBJECT_ID ( 'dbo.SpatialTable', 'U' ) IS NOT NULL   
        DROP TABLE dbo.SpatialTable;  
    GO  
    
    CREATE TABLE SpatialTable   
        ( id int IDENTITY (1,1),  
        GeogCol1 geography,   
        GeogCol2 AS GeogCol1.STAsText() );  
    GO  
    
    INSERT INTO SpatialTable (GeogCol1)  
    VALUES (geography::STGeomFromText('LINESTRING(-122.360 47.656, -122.343 47.656)', 4326));  
    
    INSERT INTO SpatialTable (GeogCol1)  
    VALUES (geography::STGeomFromText('POLYGON((-122.358 47.653, -122.348 47.649, -122.348 47.658, -122.358 47.658, -122.358 47.653))', 4326));  
    GO  
    
  • 두 번째 예에서는 STIntersection() 메서드를 사용하여 앞서 삽입한 두 geography 인스턴스가 교차하는 지점을 반환합니다.The second example uses the STIntersection() method to return the points where the two previously inserted geography instances intersect.

    DECLARE @geog1 geography;  
    DECLARE @geog2 geography;  
    DECLARE @result geography;  
    
    SELECT @geog1 = GeogCol1 FROM SpatialTable WHERE id = 1;  
    SELECT @geog2 = GeogCol1 FROM SpatialTable WHERE id = 2;  
    SELECT @result = @geog1.STIntersection(@geog2);  
    SELECT @result.STAsText();  
    

참고 항목See Also

공간 데이터(SQL Server)Spatial Data (SQL Server)