GDAL-VECTOR-CHECK-GEOMETRY(1) GDAL GDAL-VECTOR-CHECK-GEOMETRY(1) (NAME) gdal-vector-check-geometry - 3.12. (SYNOPSIS) Usage: gdal vector check-geometry [OPTIONS] Check a dataset for invalid geometries Positional arguments: -i, --input Input vector datasets [required] [not available in pipelines] -o, --output Output vector dataset [required] [not available in pipelines] Common Options: -h, --help Display help message and exit --json-usage Display usage as JSON document and exit --config = Configuration option [may be repeated] -q, --quiet Quiet mode (no progress bar or warning message) [not available in pipelines] Options: -l, --layer, --input-layer Input layer name(s) [may be repeated] [not available in pipelines] -f, --of, --format, --output-format Output format ("GDALG" allowed) [not available in pipelines] --co, --creation-option = Creation option [may be repeated] [not available in pipelines] --lco, --layer-creation-option = Layer creation option [may be repeated] [not available in pipelines] --overwrite Whether overwriting existing output dataset is allowed [not available in pipelines] --update Whether to open existing dataset in update mode [not available in pipelines] --overwrite-layer Whether overwriting existing output layer is allowed [not available in pipelines] --append Whether appending to existing layer is allowed [not available in pipelines] Mutually exclusive with --upsert --output-layer Output layer name [not available in pipelines] --skip-errors Skip errors when writing features [not available in pipelines] --no-create-empty-layers Avoid creating layers to which no features will be written [not available in pipelines] --include-field Fields from input layer to include in output (special values: ALL and NONE) (default: NONE) [may be repeated] --include-valid Include valid inputs in output, with empty geometry --geometry-field Name of geometry field to check Advanced Options: --if, --input-format Input formats [may be repeated] [not available in pipelines] --oo, --open-option = Open options [may be repeated] [not available in pipelines] --output-oo, --output-open-option = Output open options [may be repeated] [not available in pipelines] --upsert Upsert features (implies 'append') [not available in pipelines] Mutually exclusive with --append (DESCRIPTION) gdal vector check-geometry OGC . . : o (Polygon) (MultiPolygon) . . o (LineString) (MultiLineString) . GDAL 3.14 GEOS (self-intersection) . . o (GeometryCollection) / . . o . / GEOS PostGIS QGIS shapely . GEOS . gdal vector check-geometry Geometry Validity . [] gdal vector check-geometry Polygon MultiPolygon LineString. : GEOS (linearize) . / . GDALG ( / ) (GDALG OUTPUT (ON-THE-FLY / STREAMED DATASET)) JSON GDALG . GDALG: GDAL Streamed Algorithm (on-the-fly) / (streamed) . : . . (PROGRAM-SPECIFIC OPTIONS) --geometry-field . . --include-field 3.12.1. () . GDAL 3.13 ALL . --include-valid / (1:1) . --input-layer . . --output-layer . "error_location" . "error_location_{INPUT_LAYER}" . (STANDARD OPTIONS) --append () . . --co, --creation-option = . GeoPackage . . . --formats . Vector drivers . . --if, --input-format / () . . . . . . --lco, --layer-creation-option = . GeoPackage . . . --formats . Vector drivers . . --no-create-empty-layers 3.13. . --oo, --open-option = ( ). . -f, --of, --format, --output-format . : gdal --formats | grep vector | grep rw | sort --output-open-option, --output-oo = 3.12. ( ). . --overwrite . gdal . --overwrite-layer . --skip-errors 3.12. () . . --update . --upsert 3.12. --append OGRLayer::CreateFeature() OGRLayer::UpsertFeature() . : GPKG -- GeoPackage vector Elasticsearch: Geographically Encoded Objects for Elasticsearch MongoDBv3 ( upsert GDAL_DCAP_UPSERT ). upsert FID ( FID) . FID . GPKG (upsert) FID ( --unset-fid gdal vector edit FID ) UNIQUE (integer primary key) . (EXIT STATUS) 0 ( ). (EXAMPLES) : $ gdal vector check-geometry ne_10m_admin_0_countries.shp \ --quiet \ -f CSV \ --lco GEOMETRY=AS_XY \ --lco SEPARATOR=TAB \ /vsistdout/ # X Y error # 35.6210871060001 23.1392929140001 Ring Self-intersection (AUTHORS) Dan Baston (COPYRIGHT) 1998-2026 August 18, 2026 GDAL-VECTOR-CHECK-GEOMETRY(1)