TopoJSON은 브라우저에 컴팩트한 기하 정보를 전달하기 위한 훌륭한 포맷이지만, QGIS, ArcGIS 및 WFS 서비스와 같은 도구는 일반적으로 GML을 기대합니다. 이 게시물에서는 Aspose.GIS for .NET을 사용하여 C#에서 TopoJSON을 GML로 변환하는 방법을 보여줍니다. 파일을 한 번의 호출로 변환하고, 스키마 복원을 통해 결과를 다시 읽으며, 각 피처의 기하 유형, 차원 및 길이를 확인하여 파이프라인을 떠나기 전에 변환이 기대한 대로 수행되었는지 확인할 수 있습니다.

이 기능이 중요한 이유

TopoJSON은 토폴로지를 인코딩하는 GeoJSON의 확장입니다. 각 피처마다 좌표를 반복하는 대신, 각 경계를 공유 아크로 한 번만 저장하며, 종종 양자화되고 델타 인코딩된 좌표를 사용합니다. 이렇게 하면 압축 효율이 높아지고 D3와 같은 웹 매핑 라이브러리에 자연스럽게 맞습니다. GML(Geography Markup Language)은 스펙트럼의 반대쪽에 위치합니다: 이는 지리 데이터를 위한 OGC의 XML 표준이며, WFS 서비스의 표준 페이로드, INSPIRE 데이터 교환의 기본 인코딩, 그리고 QGIS, ArcGIS, FME 모두가 읽을 수 있는 형식입니다.

이 격차는 실제 프로젝트에서 나타납니다. 웹 팀은 TopoJSON을 게시하고, 백오피스 시스템, 규제 기관 및 파트너는 GML을 요구합니다. 데스크톱 GIS에서 수작업으로 이 격차를 메우는 것은 한 번은 작동하지만, 예약 작업이나 API 엔드포인트에 대해서는 확장되지 않습니다. 코드에서 변환을 수행하면 다음과 같은 이점을 얻을 수 있습니다:

  • 데스크톱 GIS가 루프에 없습니다. Aspose.GIS는 100% 관리되는 코드이므로 변환이 ASP.NET 앱, 백그라운드 워커, 컨테이너 및 CI 작업에서 실행됩니다.
  • 지오메트리와 함께 이동하는 속성. 피처 속성이 GML 출력에 포함되며, 스키마 복원을 통해 XSD가 없을 때도 다시 읽을 수 있습니다.
  • 내장 검증. 파일을 쓰는 동일한 API가 지오메트리 메트릭을 노출하여 출력이 정상인지 확인할 수 있습니다.

.NET TopoJSON to GML 변환 라이브러리

Aspose.GIS for .NET은 형식에 구애받지 않는 객체 모델을 제공합니다. VectorLayer는 피처를 보유하며, 각 피처는 속성과 IGeometry를 포함하고, 드라이버 객체는 각 파일 형식을 캡슐화합니다. 이 라이브러리는 **NuGet**을 통해 배포됩니다:

Install-Package Aspose.GIS

또는 .NET CLI를 사용하여:

dotnet add package Aspose.GIS

이 가이드의 모든 내용을 포괄하는 세 개의 네임스페이스:

  • Aspose.Gis에는 VectorLayer, ConversionOptions 및 Drivers 클래스가 포함되어 있으며, 여기에는 Drivers.TopoJson 및 Drivers.Gml과 같은 각 형식에 대한 정적 드라이버 인스턴스가 노출됩니다.
  • Aspose.Gis.Formats.Gml에는 GML에 대한 읽기 및 쓰기 설정인 GmlOptions가 포함됩니다.
  • Aspose.Gis.Geometries에는 IGeometry, GeometryCollection 및 나머지 지오메트리 모델이 포함됩니다.

자세한 내용은 제품 페이지, 공식 문서, 및 API 참조를 확인하십시오.

1. SDK 설치 및 프로젝트 준비

콘솔 애플리케이션으로 시작하고 패키지를 추가합니다:

dotnet new console -n TopoJsonToGml
cd TopoJsonToGml
dotnet add package Aspose.GIS

GML 쓰기 기능은 Aspose.GIS 25.4에 추가되었습니다. 이전 버전에서는 GML 드라이버가 읽기 전용이며 다음 단계의 변환이 작동하지 않으므로, 기존 프로젝트에 이 기능을 추가하는 경우 먼저 패키지 버전을 확인하십시오.

다음으로, Program.cs 파일 상단에 필요한 using 지시문을 추가합니다:

using System;
using Aspose.Gis;               // VectorLayer, Drivers, ConversionOptions
using Aspose.Gis.Formats.Gml;   // GmlOptions
using Aspose.Gis.Geometries;    // IGeometry, GeometryCollection

TopoJSON 파일을 애플리케이션 작업 디렉터리에 배치하거나 아래 샘플에서 절대 경로를 사용하십시오. 다른 구성은 필요하지 않습니다.

2. TopoJSON 파일을 GML로 변환

다음 예제는 VectorLayer.Convert를 사용하여 직접 형식 변환을 수행하는 방법을 보여줍니다. 메서드는 소스 경로, 소스 드라이버, 대상 경로 및 대상 드라이버를 입력으로 받습니다.

string sourcePath = "2047_5248_topojson1.json";
string destinationPath = "2047_5248_topojson1_restored_schema_out.gml";

// Read the TopoJSON file and write its features to GML in a single call.
VectorLayer.Convert(sourcePath, Drivers.TopoJson, destinationPath, Drivers.Gml);

내부적으로 TopoJSON 드라이버는 공유된 아크를 다시 완전한 기하학으로 디코딩하고, GML 드라이버는 각 피처를 자체 좌표와 속성으로 기록합니다. 출력물을 배포하기 전에 알아두면 좋은 두 가지 결과가 있습니다:

  • 공유 토폴로지가 보존되지 않습니다. GML은 각 피처의 기하를 독립적으로 저장하므로, 두 인접 폴리곤이 공유하는 경계가 각각 한 번씩 기록됩니다. GML 파일이 TopoJSON 소스보다 훨씬 크게 될 것으로 예상됩니다.
  • 명명된 객체가 하나의 레이어로 평탄화됩니다. TopoJSON에 counties 및 states와 같은 여러 객체가 포함된 경우, 해당 피처들은 단일 레이어에 배치되며 각 피처는 topojson_object_name 속성에 원본을 유지합니다.

호출이 드라이버 기반이기 때문에 동일한 패턴이 지원되는 모든 형식 쌍에 대해 작동합니다: Drivers.TopoJson을 Drivers.GeoJson 또는 Drivers.Shapefile로 교체하면 나머지 코드는 동일하게 유지됩니다. 더 많은 제어가 필요할 때, ConversionOptions를 받아들이는 오버로드를 사용하면 DestinationSpatialReferenceSystem을 통해 변환 중에 재투영할 수 있거나 DestinationDriverOptions를 통해 GML 라이터 설정을 전달할 수 있습니다.

3. 스키마 복원을 사용하여 생성된 GML 파일 열기

GML은 스키마 기반 형식입니다. 리더는 일반적으로 파일의 xsi:schemaLocation에 참조된 XSD에서 피처 유형과 속성 정의를 학습합니다. 해당 스키마가 없거나 로드할 수 없는 경우, Aspose.GIS는 추측하지 않고 오류와 함께 중지합니다. 데이터에서 스키마를 재구성하도록 허용하지 않는 한 말이죠. 이것이 GmlOptions.RestoreSchema가 수행하는 작업입니다.

다음 코드는 스키마 복원을 활성화한 상태에서 GML 파일을 여는 방법을 보여줍니다:

var options = new GmlOptions
{
    // Infer feature classes and attributes from the data when no XSD is available.
    RestoreSchema = true,
};

using (var layer = VectorLayer.Open(destinationPath, Drivers.Gml, options))
{
    Console.WriteLine("Feature count: " + layer.Count);
    Console.WriteLine("Attribute count: " + layer.Attributes.Count);

// Access the geometry of the first feature.
    var geometry = (GeometryCollection)layer[0].Geometry;
    Console.WriteLine("Geometry type: " + geometry.GeometryType);
    Console.WriteLine("Geometry dimension: " + geometry.Dimension);
    Console.WriteLine("Geometry length: " + geometry.GetLength());
}

RestoreSchema = true와 함께, 드라이버는 문서에서 알려진 GML 구조를 스캔하고 데이터 자체에서 피처 클래스와 해당 속성을 추론합니다. 이는 XSD를 손에 넣지 못한 GML 파일을 읽을 때 신뢰성을 높이며, 파일이 시스템 간에 전달될 때 흔히 발생합니다. 두 가지 점을 기억하십시오:

4. 기하학 정보 검사

성공적인 변환 호출이 기하학이 온전하게 유지되었다는 것을 증명하지는 않습니다. 출력물을 다시 읽고 검사하면 저렴하고 자동화 가능한 검사를 할 수 있습니다. 위 샘플은 세 가지 속성을 출력하며, 각각은 특정한 의미를 가집니다:

  • GeometryType은 GeometryType 값(예: Polygon, MultiPolygon, GeometryCollection)을 반환합니다. 소스 데이터에 포함되어야 하는 내용과 비교하십시오.
  • Dimension은 위상 차원을 GeometryDimension 값으로 반환합니다: 포인트는 0, 곡선은 1, 표면은 2입니다. 좌표 축의 수가 아니라; Z 또는 M 값을 확인하려면 HasZ와 HasM을 사용하십시오.
  • **GetLength()**은 기하학의 길이를 반환합니다: 폴리곤의 경우 둘레, 컬렉션의 경우 구성원 길이의 합계입니다. 값은 데이터 좌표계의 단위로 표현되므로 WGS 84의 경도/위도 데이터인 경우 미터가 아니라 도 단위입니다.

이 세 가지 외에도, geometry API는 GetArea(), GetExtent(), GetCentroid(), 그리고 IsValid를 제공하며, 이는 자동화 테스트에서 경계 상자 검사와 유효성 검증에 유용합니다.

다음 전체 프로그램은 세 단계를 연결하고 출력에서 모든 기능을 요약합니다:

using System;
using Aspose.Gis;
using Aspose.Gis.Formats.Gml;
using Aspose.Gis.Geometries;

namespace TopoJsonToGml
{
    internal static class Program
    {
        private static void Main()
        {
            // Optional: apply a license to remove evaluation limitations.
            // new License().SetLicense("Aspose.GIS.lic");

const string sourcePath = "2047_5248_topojson1.json";
            const string destinationPath = "2047_5248_topojson1_restored_schema_out.gml";

// Step 1: convert TopoJSON to GML.
            VectorLayer.Convert(sourcePath, Drivers.TopoJson, destinationPath, Drivers.Gml);

// Step 2: read the GML back, inferring the attribute schema from the data.
            var options = new GmlOptions { RestoreSchema = true };

using (var layer = VectorLayer.Open(destinationPath, Drivers.Gml, options))
            {
                Console.WriteLine($"Features: {layer.Count}, attributes: {layer.Attributes.Count}");

// Step 3: summarize every feature without assuming its geometry type.
                int index = 0;
                double totalLength = 0;

foreach (var feature in layer)
                {
                    IGeometry geometry = feature.Geometry;
                    double length = geometry.GetLength();
                    totalLength += length;

Console.WriteLine(
                        $"#{index++}: {geometry.GeometryType}, " +
                        $"dimension={geometry.Dimension}, hasZ={geometry.HasZ}, length={length:F2}");
                }

Console.WriteLine($"Total length: {totalLength:F2}");
            }
        }
    }
}

루프는 IGeometry를 직접 사용하므로 폴리곤, 라인, 포인트 및 컬렉션을 모두 처리합니다. 여기에서 인쇄된 값을 단언문으로 변환하는 것은 작은 단계에 불과합니다. 예를 들어 단위 테스트에서 소스 TopoJSON 레이어와 기능 개수 및 전체 길이를 비교하여 변환할 수 있습니다.

무료 라이선스 받기

라이선스가 없으면 Aspose.GIS는 평가 제한이 있는 평가 모드로 실행됩니다. 빌드 및 테스트 중에 전체 API를 사용하려면 Aspose 임시 라이선스 페이지에서 무료 라이선스를 요청하고 애플리케이션 시작 시 한 번 적용하십시오:

var license = new Aspose.Gis.License();
license.SetLicense("Aspose.GIS.lic");

무료 추가 리소스

결론

Aspose.GIS for .NET를 사용하여 TopoJSON을 GML로 변환하는 것은 단일 VectorLayer.Convert 호출만 필요합니다. 프로덕션 환경에 적합하게 만드는 부분은 해당 호출 이후에 이루어집니다: GmlOptions.RestoreSchema를 사용해 출력을 다시 읽어 XSD에 의존하지 않도록 검사하고, 기하 유형, 위상 차원 및 길이를 확인하여 데이터가 온전하게 도착했는지 확인합니다. GML은 TopoJSON의 공유 위상을 보존하지 않으며, 명명된 객체들은 하나의 레이어로 병합되고 원본은 속성에 기록된다는 점을 기억하십시오. 이러한 동작을 이해하면 이 워크플로를 배치 작업, 웹 서비스 또는 CI 파이프라인에 적용하고 GML을 하위 시스템에 자신 있게 전달할 수 있습니다.

자주 묻는 질문

  1. 변환 코드를 실행하려면 라이선스가 필요합니까?
    아니요. 라이선스가 없으면 Aspose.GIS는 평가 모드로 실행되며 평가 제한이 적용됩니다. 이를 제거하려면 라이선스를 적용하십시오; 무료 임시 라이선스는 Aspose의 임시 라이선스 페이지에서 제공됩니다.

  2. Aspose.GIS가 대용량 TopoJSON 파일을 처리할 수 있나요?
    예, 하지만 먼저 실제 규모의 데이터로 테스트하십시오. TopoJSON 피처는 공유 아크 테이블에서 재구성되며, GML은 훨씬 더 자세한 인코딩이므로 메모리 사용량과 출력 크기가 입력 크기에 따라 눈에 띄게 증가합니다. 대량 배치를 실행하기 전에 대표 파일로 프로파일링하십시오.

  3. TopoJSON 파일에 여러 객체(레이어)가 포함된 경우 어떻게 되나요?
    Aspose.GIS는 모든 명명된 객체의 피처를 단일 레이어에 읽어들이고 각 피처의 원본 객체를 topojson_object_name 속성에 기록합니다. 이 속성은 TopoJsonOptions.ObjectNameAttribute를 통해 이름을 변경할 수 있습니다. 해당 속성은 다른 속성처럼 GML 출력에 포함되므로 원본 객체별로 피처를 필터링하거나 그룹화할 수 있습니다.

  4. 변환 중에 GML 스키마를 사용자 정의할 수 있나요?
    예. GML 라이터는 GmlOptions를 지원하며, 여기서 ApplicationNamespace와 SchemaLocation을 사용해 자체 애플리케이션 스키마를 참조할 수 있습니다. VectorLayer.Convert를 호출할 때 ConversionOptions.DestinationDriverOptions를 통해 전달하십시오. RestoreSchema는 읽기 전용 옵션으로, 스키마가 없거나 로드할 수 없는 GML 파일을 열 때만 의미가 있습니다.

  5. Aspose.GIS가 지원하는 .NET 버전은 무엇인가요?
    NuGet 패키지는 .NET Framework 4.7, .NET Standard 2.0, .NET 6, .NET 8, .NET 10용 빌드를 포함하므로 .NET Framework 4.7 이상, .NET Core 2.0 이상 및 최신 .NET 릴리스에서 실행됩니다. GML 작성을 위해서는 Aspose.GIS 25.4 이상이 필요합니다.

자세히 보기