Errors

Warnings and exceptions for geometry, CRS, transformation, and parsing failures.

Related: Errors & exceptions

Warnings

AccuracyWarning

A CRS transform used a lower-accuracy fallback because a required grid is unavailable.

Exceptions

GeometryError

A geometry, parameter value, or metadata value is invalid.

category instance-attribute

category: Literal['layout', 'metadata'] | None

GeoParquet admission category, or None for other geometry errors.

code instance-attribute

code: str | None

Stable machine-readable reason code when the error has one (else None).

param instance-attribute

param: str | None

The offending parameter's name, for value-lane errors (else None).

value instance-attribute

value: float | None

The offending numeric value, for value-lane errors (else None).

InvalidGeometryError

A geometry violates a structural or numeric rule.

category instance-attribute

category: Literal['layout', 'metadata'] | None

GeoParquet admission category, or None for other geometry errors.

code instance-attribute

code: str | None

Stable machine-readable validity code (else None).

detail instance-attribute

detail: str | None

Human-readable detail for the validity issue (else None).

location instance-attribute

location: tuple[float, float] | None

Coordinate witness for the validity issue (else None).

For quotient-topology issues, the location is a canonical coordinate of the issue's contact set, chosen deterministically by minimum latitude then longitude.

operation instance-attribute

operation: str | None

The operation for an empty-sequence or invalid-coverage error (else None).

param instance-attribute

param: str | None

The offending parameter's name, for value-lane errors (else None).

path instance-attribute

path: str | None

Structural path to the first validity issue (else None).

row instance-attribute

row: int | None

The failing array row, for row-wise validation (else None).

value instance-attribute

value: float | None

The offending numeric value, for value-lane errors (else None).

GeometryTypeError

An operation received a geometry of the wrong kind.

expected instance-attribute

expected: str | None

The expected geometry kind, for wrong-kind errors (else None).

got instance-attribute

got: str | None

The received geometry kind when known (else None).

CRSError

A CRS could not be created, identified, exported, or used.

category instance-attribute

category: Literal['layout', 'metadata'] | None

GeoParquet admission category, or None for other geometry errors.

code instance-attribute

code: str | None

Stable machine-readable reason code when the error has one (else None).

crs instance-attribute

crs: str | None

The offending CRS, for axis-unit-mismatch errors (else None).

param instance-attribute

param: str | None

The offending parameter's name, for value-lane errors (else None).

value instance-attribute

value: float | None

The offending numeric value, for value-lane errors (else None).

CRSMismatchError

Operands carry incompatible CRS or coordinate-epoch metadata.

category instance-attribute

category: Literal['layout', 'metadata'] | None

GeoParquet admission category, or None for other geometry errors.

code instance-attribute

code: str | None

Stable machine-readable reason code when the error has one (else None).

crs instance-attribute

crs: str | None

The offending CRS, for axis-unit-mismatch errors (else None).

field instance-attribute

field: Literal['crs', 'epoch'] | None

The incompatible frame field (else None for hand-built errors).

index instance-attribute

index: int | None

The offending collection item's index, for shared-frame errors (else None).

left instance-attribute

left: str | float | None

The left raw CRS string or coordinate epoch (else None).

param instance-attribute

param: str | None

The offending parameter's name, for value-lane errors (else None).

right instance-attribute

right: str | float | None

The right raw CRS string or coordinate epoch (else None).

value instance-attribute

value: float | None

The offending numeric value, for value-lane errors (else None).

TransformError

A coordinate transform could not be built or failed to run.

category instance-attribute

category: Literal['layout', 'metadata'] | None

GeoParquet admission category, or None for other geometry errors.

code instance-attribute

code: str | None

Stable machine-readable reason code when the error has one (else None).

crs instance-attribute

crs: str | None

The offending CRS, for axis-unit-mismatch errors (else None).

param instance-attribute

param: str | None

The offending parameter's name, for value-lane errors (else None).

source instance-attribute

source: str | None

The source CRS of the failed transform (else None).

target instance-attribute

target: str | None

The target CRS of the failed transform (else None).

value instance-attribute

value: float | None

The offending numeric value, for value-lane errors (else None).

ParseError

Serialized, grid-cell, or point-code input is malformed.

category instance-attribute

category: Literal['layout', 'metadata'] | None

GeoParquet admission category, or None for other geometry errors.

code instance-attribute

code: str | None

Stable machine-readable reason code when the error has one (else None).

format instance-attribute

format: Literal['wkt', 'wkb', 'geojson', 'geoarrow', 'geoparquet', 'h3', 's2', 'geohash', 'tile', 'quadkey', 'polyline', 'pluscode', 'osm_shortlink', 'pickle'] | None

Which codec rejected the input.

param instance-attribute

param: str | None

The offending parameter's name, for value-lane errors (else None).

path instance-attribute

path: str | None

JSONPath-like location of the malformed value, when available.

position instance-attribute

position: int | None

Zero-based UTF-8 byte offset where WKT/EWKT parsing detected the error; WKB reports a binary byte offset; otherwise None when unavailable.

value instance-attribute

value: float | None

The offending numeric value, for value-lane errors (else None).

ResourceLimitError

An operation exceeded its output or computation budget.

code instance-attribute

code: Literal['output_limit', 'work_limit'] | None

Which budget stopped the operation, or None for a hand-built error.

limit instance-attribute

limit: int | None

The configured output limit (else None).

operation instance-attribute

operation: str | None

The operation that exceeded its budget (else None).

parameter instance-attribute

parameter: str | None

The parameter that controls generated output (else None).

produced instance-attribute

produced: int | None

Prospective item count or a proven lower bound exceeding the output limit (else None).