Harmonize

Harmonize multiple vector datasets with different schemas, CRS projections, and field names into a single unified layer. Applies field mapping to rename and select columns, reprojects all inputs to a target CRS, and concatenates the results. Missing fields are filled with NULL. Optionally adds a source tag column to identify which input each row came from.

ID	vector_harmonize
Domain	geo
Category	vector
Type	vector-to-vector
Version	1.0.0

view yaml ◦view github ◦

Parameters

field_mapping: object · Mapping of output field names to lists of input field aliases. Example: {id: [parcel_id, pid, APN], area: [area_sqft, area_m2]}. Each output field is populated by the first matching alias found in each input. If no field_mapping is provided, all columns from all inputs are auto-unioned.
target_crs: string · default EPSG:4326 · required · Target CRS for output (e.g., EPSG:4326)
source_tag: string · If provided, adds a column with this name containing an identifier for which input layer each row came from (e.g., "source_0", "source_1").
source_crs: object · Optional per-source CRS overrides. Keys are source indices (as strings), values are CRS strings (e.g., {"1": "EPSG:32613"}).
crosswalk: string · Crosswalk ID to resolve from the registry. Resolved to a field_mapping at execution time via crosswalk_to_field_mapping(). If both crosswalk and field_mapping are provided, field_mapping takes precedence. Example: "era5-to-cf"
include_broad: boolean · default false · When using crosswalk, include broad-predicate mappings in addition to exact and close matches (default: only exact + close).