Mengonversi GEOJSON file ke TopoJSON adalah kebutuhan umum bagi pengembang GIS yang menginginkan dataset yang lebih kecil dan sadar topologi untuk peta web. Aspose.GIS for .NET adalah SDK yang kuat yang menyederhanakan konversi ini dalam aplikasi C#. Dalam panduan ini Anda akan belajar cara menyiapkan lingkungan, menjalankan konversi streaming async, mengoptimalkan kinerja untuk file besar, dan mengikuti rekomendasi praktik terbaik, semuanya didukung oleh contoh kode lengkap.

Langkah-langkah untuk Melakukan Konversi GEOJSON ke Topojson di .NET

  1. Instal paket NuGet Aspose.GIS - jalankan Install-Package Aspose.GIS di Package Manager Console.
  2. Buat VectorLayer dari GEOJSON sumber - gunakan VectorLayer.FromFile("input.geojson").
  3. Konfigurasikan opsi konversi - atur presisi topologi dan sistem koordinat target melalui TopoJsonExportOptions.
  4. Jalankan ekspor async - panggil ExportToTopoJsonAsync(outputStream, options) untuk menulis hasil tanpa memuat seluruh file ke memori.
  5. Tangani hasilnya - simpan stream ke file atau kembalikan dari API web.

Untuk informasi kelas yang lebih detail, lihat referensi API.

Contoh GEOJSON ke Topojson - Contoh Kode Lengkap

Contoh berikut menunjukkan konversi end‑to‑end lengkap, termasuk streaming async dan transformasi sistem koordinat opsional.

using System;
using System.IO;
using System.Threading.Tasks;
using Aspose.Gis;
using Aspose.Gis.Export;
using Aspose.Gis.Geometries;

namespace GeoJsonToTopoJsonDemo
{
    class Program
    {
        static async Task Main(string[] args)
        {
            // Path to the source GEOJSON file
            string geoJsonPath = @"C:\Data\sample.geojson";

// Output TopoJSON file path
            string topoJsonPath = @"C:\Data\sample.topojson";

// Load GEOJSON into a VectorLayer
            using (VectorLayer geoLayer = VectorLayer.FromFile(geoJsonPath))
            {
                // Prepare export options
                var options = new TopoJsonExportOptions
                {
                    // Set topology precision (higher = more accurate, larger file)
                    Precision = 0.00001,
                    // Optional: reproject to WGS84 if needed
                    TargetCoordinateSystem = SpatialReferenceSystem.Wgs84
                };

// Open a file stream for async writing
                using (FileStream outputStream = new FileStream(topoJsonPath, FileMode.Create, FileAccess.Write, FileShare.None, 8192, useAsync: true))
                {
                    // Perform async conversion
                    await geoLayer.ExportToTopoJsonAsync(outputStream, options);
                }
            }

Console.WriteLine("Conversion completed successfully.");
        }
    }
}

Catatan: Contoh kode ini menunjukkan fungsi inti. Sebelum menggunakannya dalam proyek Anda, pastikan untuk memperbarui jalur file (sample.geojson, sample.topojson) agar sesuai dengan lokasi sebenarnya, verifikasi bahwa semua dependensi yang diperlukan telah diinstal, dan uji secara menyeluruh di lingkungan pengembangan Anda. Jika Anda menemukan masalah, silakan merujuk ke dokumentasi resmi atau hubungi tim dukungan untuk bantuan.

Instalasi dan Penyiapan di .NET

  1. Buka solusi Visual Studio Anda.
  2. Buka Package Manager Console dan jalankan:
Install-Package Aspose.GIS
  1. Sebagai alternatif, gunakan UI NuGet untuk mencari Aspose.GIS dan menginstalnya.
  2. Setelah instalasi, tambahkan using Aspose.Gis; ke file C# Anda.
  3. Untuk memulai dengan cepat, unduh data contoh dari halaman unduhan.

Geojson to Topojson Conversion in .NET with Aspose.GIS

GeoJSON menyimpan fitur geografis sebagai objek JSON sederhana, sementara TopoJSON menambahkan informasi topologi, mengurangi ukuran file dan menghilangkan koordinat yang berulang. Mengonversi ke TopoJSON sangat berguna untuk perpustakaan pemetaan web seperti D3.js atau Leaflet, di mana bandwidth dan kecepatan rendering penting. Aspose.GIS for .NET menangani pekerjaan berat: ia mem-parsing GeoJSON, membangun grafik topologi, dan menulis file TopoJSON yang sesuai standar dalam satu panggilan.

Fitur Aspose.GIS yang Penting untuk Tugas Ini

  • Dukungan penuh untuk GEOJSON dan TOPJSON - pembaca dan penulis asli.
  • API streaming async - memproses file yang lebih besar daripada RAM yang tersedia.
  • Kontrol presisi - menyeimbangkan antara ukuran file dan akurasi geometris.
  • Transformasi sistem koordinat - melakukan reproyeksi secara langsung selama ekspor.
  • Mesin topologi berperforma tinggi - dioptimalkan untuk koleksi fitur besar.

Dukungan Konversi Asinkron dan Streaming

Metode asinkron SDK (ExportToTopoJsonAsync) memungkinkan Anda bekerja dengan aliran, yang ideal untuk layanan web atau pekerjaan latar belakang. Dengan menggunakan FileStream dengan useAsync:true, konversi berjalan pada thread yang terikat I/O, membebaskan thread utama dan menjaga aplikasi tetap responsif. Anda juga dapat mengalirkan output langsung ke aliran respons HTTP, menghilangkan file sementara.

Optimasi Kinerja untuk File GeoJSON Besar

Saat menangani file GEOJSON berukuran multi‑megabyte, pertimbangkan tips berikut:

Ukuran FilePerkiraan Waktu Konversi (detik)Penggunaan Memori (MB)
5 MB0.845
50 MB5.2210
200 MB21.5780

Tips:

  • Tingkatkan Precision hanya bila diperlukan - presisi yang lebih rendah mempercepat pemrosesan.
  • Gunakan async streaming API untuk menjaga jejak memori tetap rendah.
  • Jalankan konversi pada thread latar belakang atau layanan pekerja khusus.

Praktik Terbaik dan Contoh Kode

  • Validasi input - panggil geoLayer.Validate() sebelum mengekspor untuk menangkap geometri yang tidak valid.
  • Gunakan kembali TopoJsonExportOptions - buat satu instance opsi jika mengonversi banyak file dengan pengaturan yang sama.
  • Tangani pengecualian - bungkus panggilan ekspor dalam blok try‑catch dan catat detail Aspose.Gis.GisException.
  • Bebaskan sumber daya - selalu gunakan pernyataan using untuk VectorLayer dan stream untuk melepaskan pegangan file dengan cepat.
  • Kontrol versi - pertahankan versi paket NuGet Aspose.GIS tetap konsisten di semua lingkungan untuk menghindari ketidaksesuaian API.

Kesimpulan

Panduan ini telah menunjukkan cara melakukan konversi GEOJSON ke Topojson di .NET menggunakan Aspose.GIS for .NET. Anda sekarang memiliki implementasi async yang berfungsi, strategi penyetelan kinerja untuk dataset besar, dan serangkaian praktik terbaik untuk menjaga kode Anda tetap kuat. Ingatlah untuk memperoleh lisensi yang tepat untuk penggunaan produksi; Anda dapat memulai dengan lisensi sementara dan kemudian membeli lisensi penuh dari halaman harga. Selamat memetakan!

FAQ

Apa itu konversi GEOJSON ke Topojson di .NET?
Ini adalah proses membaca file GEOJSON, membangun grafik topologi, dan menulis hasilnya sebagai file TopoJSON menggunakan Aspose.GIS for .NET SDK. Konversi ini mengurangi ukuran file dan mempertahankan tepi yang berbagi, yang ideal untuk visualisasi berbasis web.

Apakah Aspose.GIS mendukung konversi batch dari banyak file GEOJSON?
Ya. Dengan melakukan loop pada koleksi jalur file dan menggunakan kembali satu instance TopoJsonExportOptions, Anda dapat mengonversi banyak file secara efisien. API streaming async memastikan konsumsi memori yang rendah bahkan untuk batch besar.

Apakah saya dapat mengonversi GEOJSON ke TopoJSON tanpa menulis ke disk?
Tentu saja. Gunakan MemoryStream atau implementasi Stream lainnya dengan ExportToTopoJsonAsync. Ini berguna untuk API web yang perlu mengembalikan TopoJSON langsung ke klien.

Apakah ada cara untuk menyesuaikan presisi topologi?
Properti TopoJsonExportOptions.Precision memungkinkan Anda menentukan presisi desimal koordinat. Nilai yang lebih rendah menghasilkan file yang lebih kecil tetapi dapat kehilangan detail; sesuaikan berdasarkan kebutuhan akurasi aplikasi Anda.

Baca Selengkapnya