Skip to content
gapline
Source code

Validation rules

The catalogue below lists every validation rule compiled into gapline. Filter by severity, by stage, or search a rule ID to find what you are looking for. Use the matching rule_id as the argument to --disable-rule when you want to silence a rule for a specific run.

Some rules emit several finding codes (for example speed_validation emits zero_speed and unrealistic_speed). Each code is listed with its parent rule: disable the code to silence only it, or the parent to silence all of its codes.

232 rules
153 errors
74 warnings
5 infos
Severity
Stage
Rule ID Severity Stage
alert_target_not_in_schedule Warning Realtime
alert_without_target Warning Realtime
block_id_trip_overlap Error Semantic
calendar_dates_coherence Warning Semantic
calendar_dates_service_not_in_calendar Warning Semantic
calendar_ranges Error Semantic
case_sensitive_name Error Structural
consecutive_same_stop_id Error Realtime
control_character Error Structural
conveyal_trip_without_shape Warning Semantic
coordinate_out_of_range Error Semantic
coordinates_near_origin Warning Semantic
coordinates_near_pole Warning Semantic
decreasing_shape_dist code of time_sequence Error Semantic
decreasing_time code of time_sequence Error Semantic
degenerate_shape code of shape_geometry Warning Semantic
departure_before_arrival code of time_sequence Error Semantic
duplicate_coordinates Warning Semantic
duplicate_entity_id Warning Realtime
duplicate_feature_id Error Semantic
duplicate_key Error Semantic
duplicate_shape_point code of shape_geometry Warning Semantic
duplicated_column Error Structural
empty_column_name Error Structural
empty_file Error Structural
empty_row Warning Structural
etalab_missing_contact Warning Semantic
exception_date_out_of_range code of calendar_dates_coherence Warning Semantic
excessive_delay Warning Realtime
expired_feed code of feed_coverage Warning Semantic
extended_route_type code of route_type_semantics Warning Semantic
fares_circular_transfer Warning Semantic
fares_empty_area Warning Semantic
fares_invalid_transfer_count Error Semantic
fares_negative_amount Error Semantic
fares_timeframe_overlap Warning Semantic
fares_unused_product Warning Semantic
fares_zero_amount Warning Semantic
fares_zero_duration_limit Error Semantic
feed_coverage Warning Semantic
feed_expiring_soon code of feed_coverage Warning Semantic
feed_not_fresh Warning Realtime
field_definition_agency Error Semantic
field_definition_attributions Error Semantic
field_definition_booking_rules Error Semantic
field_definition_fares_v2 Error Semantic
field_definition_feed_info Warning Semantic
field_definition_pathways Error Semantic
field_definition_routes Error Semantic
field_definition_stop_times Error Semantic
field_definition_stop_times_flex Error Semantic
field_definition_stops Error Semantic
field_definition_transfers Error Semantic
field_definition_translations Error Semantic
field_definition_trips Error Semantic
field_type_validator Error Semantic
first_stop_times_differ code of time_sequence Error Semantic
fk_attributions_agency_id code of fk_attributions_refs Error Semantic
fk_attributions_refs Error Semantic
fk_attributions_route_id code of fk_attributions_refs Error Semantic
fk_attributions_trip_id code of fk_attributions_refs Error Semantic
fk_fare_attributes_agency_id Error Semantic
fk_fare_leg_join_rules_from_network_id Error Semantic
fk_fare_leg_join_rules_from_stop_id Error Semantic
fk_fare_leg_join_rules_to_network_id Error Semantic
fk_fare_leg_join_rules_to_stop_id Error Semantic
fk_fare_leg_rules_fare_product_id Error Semantic
fk_fare_leg_rules_from_area_id Error Semantic
fk_fare_leg_rules_from_timeframe_group_id Error Semantic
fk_fare_leg_rules_network_id Error Semantic
fk_fare_leg_rules_to_area_id Error Semantic
fk_fare_leg_rules_to_timeframe_group_id Error Semantic
fk_fare_products_fare_media_id Error Semantic
fk_fare_products_rider_category_id Error Semantic
fk_fare_rules_contains_id code of fk_fare_rules_zones Error Semantic
fk_fare_rules_destination_id code of fk_fare_rules_zones Error Semantic
fk_fare_rules_fare_id Error Semantic
fk_fare_rules_origin_id code of fk_fare_rules_zones Error Semantic
fk_fare_rules_route_id Error Semantic
fk_fare_rules_zones Error Semantic
fk_fare_transfer_rules_fare_product_id Error Semantic
fk_fare_transfer_rules_from_leg_group_id Error Semantic
fk_fare_transfer_rules_to_leg_group_id Error Semantic
fk_frequencies_trip_id Error Semantic
fk_pathways_from_stop_id code of fk_pathways_stops Error Semantic
fk_pathways_stops Error Semantic
fk_pathways_to_stop_id code of fk_pathways_stops Error Semantic
fk_route_networks_network_id Error Semantic
fk_route_networks_route_id Error Semantic
fk_routes_agency_id Error Semantic
fk_stop_areas_area_id Error Semantic
fk_stop_areas_stop_id Error Semantic
fk_stop_times_stop_id Error Semantic
fk_stop_times_trip_id Error Semantic
fk_stops_level_id Error Semantic
fk_stops_parent_station Error Semantic
fk_timeframes_service_id Error Semantic
fk_transfers_from_route_id Error Semantic
fk_transfers_from_stop_id Error Semantic
fk_transfers_from_trip_id Error Semantic
fk_transfers_to_route_id Error Semantic
fk_transfers_to_stop_id Error Semantic
fk_transfers_to_trip_id Error Semantic
fk_translations_record Error Semantic
fk_translations_record_id code of fk_translations_record Error Semantic
fk_translations_record_sub_id code of fk_translations_record Error Semantic
fk_trips_route_id Error Semantic
fk_trips_service_id Error Semantic
fk_trips_shape_id Error Semantic
flex_empty_location_group Warning Semantic
flex_incomplete_prior_notice_last Warning Semantic
flex_inconsistent_booking Warning Semantic
flex_insufficient_service_coverage Warning Semantic
flex_invalid_duration_factor Error Semantic
flex_invalid_prior_notice Error Semantic
flex_invalid_prior_notice_range Error Semantic
flex_invalid_window Error Semantic
flex_unsafe_duration Warning Semantic
forbidden_content code of control_character Error Structural
foreign_key_violation Error Semantic
frequencies_coherence Error Semantic
future_timestamp Warning Realtime
google_coordinates_in_stop_name Warning Semantic
google_identical_route_colors Warning Semantic
inactive_service code of calendar_ranges Error Semantic
invalid_character code of text_validator Warning Semantic
invalid_color code of field_type_validator Error Semantic
invalid_currency code of field_type_validator Error Semantic
invalid_date not disableable Error Parse
invalid_delimiter Error Structural
invalid_email code of field_type_validator Error Semantic
invalid_encoding Error Structural
invalid_float not disableable Error Parse
invalid_geojson not disableable Error Parse
invalid_headway code of frequencies_coherence Error Semantic
invalid_inner_quotes code of invalid_quoting Error Structural
invalid_input_files_in_subfolder Error Structural
invalid_integer not disableable Error Parse
invalid_language_code code of field_type_validator Error Semantic
invalid_parent_type Error Semantic
invalid_phone_number code of field_type_validator Error Semantic
invalid_quoting Error Structural
invalid_row_encoding not disableable Error Parse
invalid_row_length Error Structural
invalid_time not disableable Error Parse
invalid_time_range code of frequencies_coherence Error Semantic
invalid_timezone code of field_type_validator Error Semantic
invalid_traversal_time code of pathway_validation Error Semantic
invalid_url code of field_type_validator Error Semantic
inverted_date_range code of calendar_ranges Error Semantic
low_trip_activity Warning Semantic
missing_agency_email Info Semantic
missing_bikes_info Info Semantic
missing_calendar_and_calendar_date_files Error Structural
missing_direction_id Warning Semantic
missing_feature_id Error Semantic
missing_header Error Structural
missing_or_zero_timestamp Error Realtime
missing_recommended_file Warning Structural
missing_recommended_property Warning Semantic
missing_required_column Error Structural
missing_required_field not disableable Error Parse
missing_required_file Error Structural
missing_route_colors Info Semantic
missing_schedule_relationship Warning Realtime
missing_stop_sequence_for_repeated_stop Error Realtime
missing_vehicle_id Warning Realtime
missing_wheelchair_info Warning Semantic
mixed_case_recommended_field code of text_validator Warning Semantic
new_line_in_value Error Structural
non_ascii_or_non_printable_char code of text_validator Warning Semantic
non_increasing_stop_sequence code of time_sequence Error Semantic
number_out_of_range Error Semantic
one_way_pathway_without_return code of pathway_validation Error Semantic
otp_missing_feed_version Warning Semantic
otp_trip_too_few_stops Error Semantic
overlapping_frequencies code of frequencies_coherence Error Semantic
pathway_validation Error Semantic
polygon_too_few_points Error Semantic
position_outside_feed_bounds Warning Realtime
redundant_route_name Warning Semantic
route_short_name_too_long Warning Semantic
route_type_semantics Warning Semantic
rt_missing_header Error Realtime
rt_route_not_in_schedule Error Realtime
rt_stop_not_in_schedule Error Realtime
rt_stop_wrong_location_type Error Realtime
rt_trip_not_in_schedule Error Realtime
self_intersecting_polygon Warning Semantic
self_transfer code of transfer_validation Error Semantic
service_never_active code of calendar_dates_coherence Warning Semantic
shape_dist_traveled_incoherent code of shape_geometry Warning Semantic
shape_geometry Warning Semantic
shape_points_too_close code of shape_geometry Warning Semantic
short_feed_coverage code of feed_coverage Warning Semantic
speed_validation Warning Semantic
start_time_mismatch_first_arrival Error Realtime
station_without_entrance_pathway code of pathway_validation Error Semantic
stop_name_all_caps Warning Semantic
stop_time_sequence_unsorted Error Realtime
stop_time_update_times_not_increasing Error Realtime
stop_too_far_from_shape Warning Semantic
superfluous_whitespace Warning Structural
text_validator Warning Semantic
time_sequence Error Semantic
too_many_rows Error Structural
transfer_distance_suspicious code of transfer_validation Error Semantic
transfer_distance_too_large code of transfer_validation Error Semantic
transfer_validation Error Semantic
translations_unknown_field Warning Semantic
translations_unknown_table Error Semantic
trip_too_long code of time_sequence Error Semantic
unclosed_polygon Error Semantic
unexpected_enum_value not disableable Warning Parse
unknown_column Info Structural
unknown_file Info Structural
unknown_route_type code of route_type_semantics Warning Semantic
unordered_stop_times Error Realtime
unreadable_file not disableable Error Parse
unrealistic_speed code of speed_validation Warning Semantic
unsupported_geometry_type Error Semantic
unsupported_version Warning Realtime
unused_agency Warning Semantic
unused_fare Warning Semantic
unused_route Warning Semantic
unused_service Warning Semantic
unused_shape Warning Semantic
unused_station Warning Semantic
unused_stop Warning Semantic
zero_area_polygon Warning Semantic
zero_speed code of speed_validation Warning Semantic
zero_transfer_time code of transfer_validation Error Semantic

How this table is built

Section titled “How this table is built”

The rules are dumped from the Rust registry with gapline rules list --format json:

Terminal window
gapline rules list --format json -o validation-rules.json

The JSON is committed to the documentation repository and must be regenerated with the command above on each release. A CI-style check in the gapline test suite (rules_list_matches_disable_rule_accepted_ids) guarantees the listing and the IDs accepted by --disable-rule stay identical.

Severity policy

Section titled “Severity policy”
  • Error — the feed is not compliant. Downstream consumers will reject the offending rows.
  • Warning — the feed is compliant but likely broken. Investigate.
  • Info — a best-practice suggestion.

See concepts / severities for the full policy and how --min-severity promotes warnings to gate failures.

Stage

Section titled “Stage”
  • Structural — the feed’s shape: required files, CSV parseability, header presence, column validity. Run first; nothing meaningful runs downstream if these fail.
  • Semantic — everything that requires the parsed data model: field values, foreign keys, schedule coherence, best practices.
  • Realtime — GTFS-Realtime feed rules.
  • Parse — codes produced while parsing field values (invalid_integer, invalid_float, invalid_date, invalid_time, unexpected_enum_value, missing_required_field, invalid_geojson). They are always emitted and cannot be disabled; only --min-severity can hide the warning-level one.

See also

Section titled “See also”