Der erste Teil dieser Blogserie liefert Hintergrundinformationen und schafft die Grundlage für die Arbeit mit File-Geodatabases, dem Geodatenformat von ESRI.
Der erste Teil dieser Blogserie liefert Hintergrundinformationen und schafft die Grundlage für die Arbeit mit File-Geodatabases, dem Geodatenformat von ESRI.
Die Arbeit mit Geodaten kann ohne geeignete Tools und Richtlinien schwierig sein. Vor Jahren arbeiteten wir an einem Projekt mit der Aufgabe, Raster- und Vektordatensätze zu analysieren und zu verarbeiten. Damals war das einzige unterstützte Vektorformat ESRI Shapefile, daher sah die .NET-Bibliothek DotSpatial recht vielversprechend aus und funktionierte bis jetzt gut. Allerdings wurde dieses Paket in den letzten Jahren nicht mehr aktualisiert; zudem erforderten neue Anforderungen wie .NET Core, möglicherweise Linux-Unterstützung und die Unterstützung von File-Geodatabases ein Umdenken.
Wir konzentrieren uns hier auf die Unterstützung von File-Geodatabases. Die File-Geodatabase ist ein von ESRI entwickeltes Datenformat, das mehr oder weniger das ältere, auf Microsoft Access basierende Personal-Geodatabase-Format ersetzt. Es handelt sich um ein Containerformat zum Speichern von Vektor- und Rasterdaten. Typischerweise liegt eine File-Geodatabase als Ordner mit der Endung .gdb vor, sie kann aber auch als Zip-Archiv komprimiert sein.
Diese Tutorialreihe ist in drei separate Beiträge unterteilt und gibt Ihnen einige Einblicke in den Umgang mit File-Geodatabases in Ihren C#-Lösungen.
Hinweis: Als Testdaten für die folgenden Beispiele verwenden wir den Urban Atlas 2012 für Österreich, den Sie auch im Beispielcode dieses Blogbeitrags finden. Alle Screenshots und Ausgaben in diesem Beitrag stammen aus dieser File-Geodatabase; bei anderen Datensätzen sollten die Ergebnisse aber sehr ähnlich aussehen.
GDAL/OGR ist die De-facto-Standard-Open-Source-Bibliothek zum Lesen und Schreiben von Geodatenformaten. Die Geospatial Data Abstraction Library (GDAL) ist in drei Hauptkomponenten unterteilt:
GDAL ist in C geschrieben, daher benötigen wir einen Wrapper, um es in unserer .NET-Anwendung verwenden zu können. Die Suche nach NuGet-Paketen führt zu zwei möglichen Lösungen:
Wir beginnen mit einer neuen .NET-Core-Konsolenanwendung und installieren die NuGet-Pakete von MaxRev (wählen Sie das Runtime-Paket passend zu Ihrem Zielbetriebssystem):
dotnet add package MaxRev.Gdal.Core
dotnet add package MaxRev.Gdal.WindowsRuntime.Minimal
Der nächste Schritt besteht darin, die using-Direktive hinzuzufügen und die Methode ConfigureAll aufzurufen:
namespace FileGeodatabaseSample
{
using MaxRev.Gdal.Core;
public class Program
{
public static void Main(string[] args)
{
GdalBase.ConfigureAll();
// GDAL is ready.
}
}
}
In den folgenden Kapiteln erledigen wir einige typische Aufgaben im Umgang mit File-Geodatabases: vom einfachen Öffnen und Untersuchen des Inhalts über eine tiefergehende Analyse einzelner Layer, Attribute und geometrischer Eigenschaften bis hin zu einigen konkreten Anwendungsfällen.
Um eine File-Geodatabase zu öffnen, müssen wir den entsprechenden OGR-Treiber auswählen. Es gibt zwei Möglichkeiten:
Da wir in diesem Beitrag Daten nur lesen und analysieren, entscheiden wir uns für die einfachere, integrierte Option und heben uns die zweite Option für einen späteren Blogbeitrag auf.
Nachdem wir den richtigen Treiber ausgewählt haben, können wir die GDB einfach öffnen. Hinweis: Die gezippte Geodatabase muss nicht entpackt werden. Der Treiber funktioniert sowohl mit der gezippten als auch mit der entpackten Version.
Danach können wir die enthaltenen Layer durchlaufen und ihre Namen in der Konsole ausgeben.
private static void Open(string dataSetPath)
{
var fileGdbDriver = Ogr.GetDriverByName("OpenFileGDB");
var dataSource = fileGdbDriver.Open(dataSetPath, 0);
var layerCount = dataSource.GetLayerCount();
for (var i = 0; i < layerCount; i++)
{
var layer = dataSource.GetLayerByIndex(i);
Console.WriteLine($"Layer: {layer.GetName()}");
}
}
In unserem Fall sieht die Ausgabe so aus:
Layer: UA2012_AT_Merge
Nachdem wir nun die File-Geodatabase geöffnet und die enthaltenen Layer erfolgreich identifiziert haben, können wir uns den Layer genauer ansehen. Im folgenden Beispiel ermitteln wir:
private static void Details(string dataSetPath)
{
var fileGdbDriver = Ogr.GetDriverByName("OpenFileGDB");
var dataSource = fileGdbDriver.Open(dataSetPath, 0);
var layer = dataSource.GetLayerByIndex(0);
var shapeType = layer.GetGeomType().ToString("G").Substring(3);
Console.WriteLine($"Shape Type: {shapeType}");
var spatialReference = layer.GetSpatialRef();
var projectionName = spatialReference.GetName();
Console.WriteLine($"Projection: {projectionName}");
var extent = new Envelope();
layer.GetExtent(extent, 0);
var dataSetExtent = new
{
XMin = extent.MinX,
XMax = extent.MaxX,
YMin = extent.MinY,
YMax = extent.MaxY,
};
Console.WriteLine($"Extent: {JsonSerializer.Serialize(dataSetExtent, new JsonSerializerOptions { WriteIndented = true })}");
var featureCount = (int)layer.GetFeatureCount(0);
Console.WriteLine($"Feature Count: {featureCount}");
var columns = new List<dynamic>();
var layerDefinition = layer.GetLayerDefn();
for (var j = 0; j < layerDefinition.GetFieldCount(); j++)
{
var field = layerDefinition.GetFieldDefn(j);
columns.Add(new
{
Name = field.GetName(),
DataType = field.GetFieldTypeName(field.GetFieldType()),
});
}
Console.WriteLine($"Columns: {JsonSerializer.Serialize(columns, new JsonSerializerOptions { WriteIndented = true })}");
}
Ausgabe:
Shape Type: MultiPolygon
Projection: ETRS89 / LAEA Europe
Extent: {
"XMin": 4382010.8362,
"XMax": 4854633.2937,
"YMin": 2595132.8378,
"YMax": 2879685.3701
}
Feature Count: 304122
Columns: [
{
"Name": "COUNTRY",
"DataType": "String"
},
{
"Name": "CITIES",
"DataType": "String"
},
{
"Name": "FUA_OR_CIT",
"DataType": "String"
},
{
"Name": "CODE2012",
"DataType": "String"
},
{
"Name": "ITEM2012",
"DataType": "String"
},
{
"Name": "PROD_DATE",
"DataType": "String"
},
{
"Name": "IDENT",
"DataType": "String"
},
{
"Name": "Shape_Leng",
"DataType": "Real"
},
{
"Name": "Shape_Length",
"DataType": "Real"
},
{
"Name": "Shape_Area",
"DataType": "Real"
}
]
Da wir nun eine File-Geodatabase öffnen, über ihre Layer iterieren und einige Metadaten auslesen können, ist es an der Zeit für die eigentlichen Daten. In Teil 2 unserer Serie sehen wir uns die Daten im Layer genauer an.