Source: https://gometry.monicz.dev/api/errors/

# Errors

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

**Related:** [Errors & exceptions](https://gometry.monicz.dev/guide/errors/)

## 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`

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

GeoParquet admission category, or `None` for other geometry errors.

### code `instance-attribute`

```python
code: str | None
```

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

### param `instance-attribute`

```python
param: str | None
```

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

### value `instance-attribute`

```python
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`

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

GeoParquet admission category, or `None` for other geometry errors.

### code `instance-attribute`

```python
code: str | None
```

Stable machine-readable validity code (else `None`).

### detail `instance-attribute`

```python
detail: str | None
```

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

### location `instance-attribute`

```python
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`

```python
operation: str | None
```

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

### param `instance-attribute`

```python
param: str | None
```

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

### path `instance-attribute`

```python
path: str | None
```

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

### row `instance-attribute`

```python
row: int | None
```

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

### value `instance-attribute`

```python
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`

```python
expected: str | None
```

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

### got `instance-attribute`

```python
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`

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

GeoParquet admission category, or `None` for other geometry errors.

### code `instance-attribute`

```python
code: str | None
```

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

### crs `instance-attribute`

```python
crs: str | None
```

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

### param `instance-attribute`

```python
param: str | None
```

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

### value `instance-attribute`

```python
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`

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

GeoParquet admission category, or `None` for other geometry errors.

### code `instance-attribute`

```python
code: str | None
```

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

### crs `instance-attribute`

```python
crs: str | None
```

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

### field `instance-attribute`

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

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

### index `instance-attribute`

```python
index: int | None
```

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

### left `instance-attribute`

```python
left: str | float | None
```

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

### param `instance-attribute`

```python
param: str | None
```

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

### right `instance-attribute`

```python
right: str | float | None
```

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

### value `instance-attribute`

```python
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`

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

GeoParquet admission category, or `None` for other geometry errors.

### code `instance-attribute`

```python
code: str | None
```

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

### crs `instance-attribute`

```python
crs: str | None
```

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

### param `instance-attribute`

```python
param: str | None
```

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

### source `instance-attribute`

```python
source: str | None
```

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

### target `instance-attribute`

```python
target: str | None
```

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

### value `instance-attribute`

```python
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`

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

GeoParquet admission category, or `None` for other geometry errors.

### code `instance-attribute`

```python
code: str | None
```

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

### format `instance-attribute`

```python
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`

```python
param: str | None
```

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

### path `instance-attribute`

```python
path: str | None
```

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

### position `instance-attribute`

```python
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`

```python
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`

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

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

### limit `instance-attribute`

```python
limit: int | None
```

The configured output limit (else `None`).

### operation `instance-attribute`

```python
operation: str | None
```

The operation that exceeded its budget (else `None`).

### parameter `instance-attribute`

```python
parameter: str | None
```

The parameter that controls generated output (else `None`).

### produced `instance-attribute`

```python
produced: int | None
```

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