model

type Actions interface {
	StaticFetch(context.Context, string, io.Reader, string) (*FeedVersionFetchResult, error)
	RTFetch(context.Context, string, string, string, string) error
	GbfsFetch(context.Context, string, string) error
	ValidateUpload(context.Context, io.Reader, *string, []string) (*ValidationReport, error)
	FeedVersionUnimport(context.Context, int) (*FeedVersionUnimportResult, error)
	FeedVersionImport(context.Context, int) (*FeedVersionImportResult, error)
	FeedVersionUpdate(context.Context, FeedVersionSetInput) (int, error)
	FeedVersionDelete(context.Context, int) (*FeedVersionDeleteResult, error)
}

type Agency struct {
	OnestopID       string      `json:"onestop_id"`
	FeedOnestopID   string      `json:"feed_onestop_id"`
	FeedVersionSHA1 string      `json:"feed_version_sha1"`
	Geometry        *tt.Polygon `json:"geometry"`
	SearchRank      *string
	CoifID          *int
	gtfs.Agency
}

type AgencyFilter struct {
	// Search for agencies with this operator OnestopID
	OnestopID *string `json:"onestop_id,omitempty"`
	// Search for agencies with this feed version SHA1 hash
	FeedVersionSha1 *string `json:"feed_version_sha1,omitempty"`
	// Search for agencies with this feed OnestopID
	FeedOnestopID *string `json:"feed_onestop_id,omitempty"`
	// Search for agencies with this GTFS agency_id
	AgencyID *string `json:"agency_id,omitempty"`
	// Search for records with this GTFS agency_name
	AgencyName *string `json:"agency_name,omitempty"`
	// Full text search
	Search *string `json:"search,omitempty"`
	// Search for agencies by city name (provided by Natural Earth)
	CityName *string `json:"city_name,omitempty"`
	// Search for agencies by country name (provided by Natural Earth)
	Adm0Name *string `json:"adm0_name,omitempty"`
	// Search for agencies by state/province/division name (provided by Natural Earth)
	Adm1Name *string `json:"adm1_name,omitempty"`
	// Search for agencies by country 2 letter ISO 3166 code (provided by Natural Earth)
	Adm0Iso *string `json:"adm0_iso,omitempty"`
	// Search for agencies by state/province/division ISO 3166-2 code (provided by Natural Earth)
	Adm1Iso *string `json:"adm1_iso,omitempty"`
	// Search for agencies with these license details
	License *LicenseFilter `json:"license,omitempty"`
	// Location
	Location *AgencyLocationFilter `json:"location,omitempty"`
	// Backwards compat: Search for agencies within this bounding box
	Bbox *BoundingBox `json:"bbox,omitempty"`
	// Backwards compat: Search for agencies within this geographic polygon
	Within *tt.Polygon `json:"within,omitempty"`
	// Backwards compat: Search for agencies within specified radius of a point
	Near *PointRadius `json:"near,omitempty"`
}

type AgencyLocationFilter struct {
	// Search for agencies within this bounding box
	Bbox *BoundingBox `json:"bbox,omitempty"`
	// Search for agencies within this geographic polygon
	Polygon *tt.Polygon `json:"polygon,omitempty"`
	// Search for agencies within specified radius of a point
	Near *PointRadius `json:"near,omitempty"`
	// Focus search on this point; results will be sorted by distance
	Focus *FocusPoint `json:"focus,omitempty"`
}

type AgencyPlace struct {
	// Best-matched city name
	CityName *string `json:"city_name,omitempty"`
	// Best-matched state or province name
	Adm1Name *string `json:"adm1_name,omitempty"`
	// Best-matched state or province ISO code
	Adm1Iso *string `json:"adm1_iso,omitempty"`
	// Best-matched country name
	Adm0Name *string `json:"adm0_name,omitempty"`
	// Best-mached country ISO code
	Adm0Iso *string `json:"adm0_iso,omitempty"`
	// Relative weight of this place association
	Rank     *float64 `json:"rank,omitempty"`
	AgencyID int      `json:"-"`
}

type AgencyPlaceFilter struct {
	// Search for associations with at least this rank value
	MinRank *float64 `json:"min_rank,omitempty"`
}

type Alert struct {
	// GTFS-RT Alert active alert period. See https://gtfs.org/realtime/reference/#message-timerange
	ActivePeriod []*RTTimeRange `json:"active_period,omitempty"`
	// GTFS-RT Alert [cause](https://gtfs.org/realtime/reference/#enum-cause)
	Cause *string `json:"cause,omitempty"`
	// GTFS-RT Alert [effect](https://gtfs.org/realtime/reference/#enum-effect)
	Effect *string `json:"effect,omitempty"`
	// GTFS-RT Alert header text
	HeaderText []*RTTranslation `json:"header_text"`
	// GTFS-RT Alert description text
	DescriptionText []*RTTranslation `json:"description_text"`
	// GTFS-RT Alert TTS header text
	TtsHeaderText []*RTTranslation `json:"tts_header_text,omitempty"`
	// GTFS-RT Alert TTS description text
	TtsDescriptionText []*RTTranslation `json:"tts_description_text,omitempty"`
	// GTFS-RT Alert uRL for more information
	URL []*RTTranslation `json:"url,omitempty"`
	// GTFS-RT Alert severity level
	SeverityLevel *string `json:"severity_level,omitempty"`
}

type BookingRule struct {
	FeedOnestopID   string
	FeedVersionSHA1 string
	gtfs.BookingRule
}

type BookingRuleFilter struct {
	// Restrict to specific ids
	Ids []int `json:"ids,omitempty"`
	// Search for booking rules with this booking_rule_id
	BookingRuleID *string `json:"booking_rule_id,omitempty"`
}

type BoundingBox struct {
	// Minimum longitude
	MinLon float64 `json:"min_lon"`
	// Minimum latitude
	MinLat float64 `json:"min_lat"`
	// Maximum longitude
	MaxLon float64 `json:"max_lon"`
	// Maximum latitude
	MaxLat float64 `json:"max_lat"`
}

type Calendar struct {
	gtfs.Calendar
}

type CalendarDate struct {
	gtfs.CalendarDate
}

type CalendarDateFilter struct {
	// Search for calendar date exceptions on this date
	Date *tt.Date `json:"date,omitempty"`
	// Search for calendar date exceptions with this GTFS exception_type
	ExceptionType *int `json:"exception_type,omitempty"`
}

type CensusDataset struct {
	// Internal integer ID
	ID int `json:"id"`
	// Dataset name, e.g. acsdt5y2022
	Name string `json:"name"`
	// Dataset description
	Description *string `json:"description,omitempty"`
	// Dataset url
	URL *tt.Url `json:"url,omitempty"`
	// Minimum year of data in this dataset
	YearMin *int `json:"year_min,omitempty"`
	// Maximum year of data in this dataset
	YearMax     *int               `json:"year_max,omitempty"`
	Sources     []*CensusSource    `json:"sources,omitempty"`
	Geographies []*CensusGeography `json:"geographies,omitempty"`
	Tables      []*CensusTable     `json:"tables,omitempty"`
	Layers      []*CensusLayer     `json:"layers,omitempty"`
}

type CensusDatasetFilter struct {
	// Search for datasets with this name
	Name *string `json:"name,omitempty"`
	// Search for datasets matching this string
	Search *string `json:"search,omitempty"`
}

type CensusDatasetGeographyFilter struct {
	// Geographies with these integer IDs
	Ids []int `json:"ids,omitempty"`
	// Search within this dataset
	Dataset *string `json:"dataset,omitempty"`
	// Search within this layer
	Layer *string `json:"layer,omitempty"`
	// Search for geographies matching this string
	Search *string `json:"search,omitempty"`
	// Location search
	Location *CensusDatasetGeographyLocationFilter `json:"location,omitempty"`
}

type CensusDatasetGeographyLocationFilter struct {
	// Search within this bounding box
	Bbox *BoundingBox `json:"bbox,omitempty"`
	// Search within this geographic polygon
	Within *tt.Polygon `json:"within,omitempty"`
	// Search within specified radius of a point
	Near *PointRadius `json:"near,omitempty"`
	// Focus search on this point; results will be sorted by distance
	Focus *FocusPoint `json:"focus,omitempty"`
	// Search based on a buffer around these stop ids
	StopBuffer *StopBuffer `json:"stop_buffer,omitempty"`
}

type CensusField struct {
	// Internal integer ID
	ID int `json:"id"`
	// Census field name
	FieldName string `json:"field_name"`
	// Census field title
	FieldTitle string `json:"field_title"`
	// Census field column order
	ColumnOrder *float64 `json:"column_order,omitempty"`
	TableID     int      `json:"-"`
}

type CensusGeography struct {
	// Internal integer ID
	ID int `json:"id"`
	// Dataset name, e.g. acsdt5y2022
	DatasetName string `json:"dataset_name"`
	// Source name, e.g. tl_2024_01_tract.zip
	SourceName string `json:"source_name"`
	// Census geography source layer
	LayerName string `json:"layer_name"`
	// Census geography GEOID
	Geoid *string `json:"geoid,omitempty"`
	// Census geography name
	Name *string `json:"name,omitempty"`
	// Geometry total area, in square meters
	GeometryArea *float64 `json:"geometry_area,omitempty"`
	// Land area, in square meters
	Aland *float64 `json:"aland,omitempty"`
	// Water area, in square meters
	Awater *float64 `json:"awater,omitempty"`
	// State or province name
	Adm1Name *string `json:"adm1_name,omitempty"`
	// State or province ISO code
	Adm1Iso *string `json:"adm1_iso,omitempty"`
	// Country name
	Adm0Name *string `json:"adm0_name,omitempty"`
	// Country ISO code
	Adm0Iso *string `json:"adm0_iso,omitempty"`
	// Census geography polygon
	Geometry *tt.MultiPolygon `json:"geometry,omitempty"`
	// Intersection area with a given geometry, in square meters
	IntersectionArea     *float64     `json:"intersection_area,omitempty"`
	IntersectionGeometry *tt.Geometry `json:"intersection_geometry,omitempty"`
	// Census tables containing data for this geography
	Values []*CensusValue `json:"values"`
	// Layer
	Layer *CensusLayer `json:"layer,omitempty"`
	// Source
	Source        *CensusSource `json:"source,omitempty"`
	DatasetID     int           `json:"-"`
	LayerID       int           `json:"-"`
	MatchEntityID int           `json:"-"`
	SourceID      int           `json:"-"`
}

type CensusGeographyFilter struct {
	Dataset *string  `json:"dataset,omitempty"`
	Layer   *string  `json:"layer,omitempty"`
	Radius  *float64 `json:"radius,omitempty"`
	Search  *string  `json:"search,omitempty"`
}

type CensusLayer struct {
	// Internal integer ID
	ID int `json:"id"`
	// Layer name, e.g. tl_2024_01_tract
	Name string `json:"name"`
	// Layer description
	Description *string            `json:"description,omitempty"`
	Geographies []*CensusGeography `json:"geographies,omitempty"`
	DatasetID   int                `json:"-"`
}

type CensusSource struct {
	// Internal integer ID
	ID int `json:"id"`
	// Source name, e.g. tl_2024_01_tract.zip
	Name string `json:"name"`
	// Source description
	Description *string `json:"description,omitempty"`
	// Source url
	URL tt.Url `json:"url"`
	// Source checksum
	Sha1        string             `json:"sha1"`
	Geographies []*CensusGeography `json:"geographies,omitempty"`
	Tables      []*CensusTable     `json:"tables,omitempty"`
	Layers      []*CensusLayer     `json:"layers,omitempty"`
	DatasetID   int                `json:"-"`
}

type CensusSourceFilter struct {
	Name   *string `json:"name,omitempty"`
	Search *string `json:"search,omitempty"`
}

type CensusSourceGeographyFilter struct {
	// Geographies with these integer IDs
	Ids []int `json:"ids,omitempty"`
	// Search for geographies matching this string
	Search *string `json:"search,omitempty"`
	// Location search
	Location *CensusDatasetGeographyLocationFilter `json:"location,omitempty"`
}

type CensusTable struct {
	// Internal integer ID
	ID int `json:"id"`
	// Census table name
	TableName string `json:"table_name"`
	// Census table title
	TableTitle string `json:"table_title"`
	// Census table group
	TableGroup *string `json:"table_group,omitempty"`
	// Additional details, e.g. population universe
	TableDetails *string `json:"table_details,omitempty"`
	// Individial field definitions for this table
	Fields    []*CensusField `json:"fields"`
	DatasetID int            `json:"-"`
}

type CensusTableFilter struct {
	Search *string `json:"search,omitempty"`
}

type CensusValue struct {
	// Dataset name, e.g. acsdt5y2022
	DatasetName string `json:"dataset_name"`
	// Source name, e.g. tl_2024_01_tract.zip
	SourceName string `json:"source_name"`
	// Source table
	Table *CensusTable `json:"table"`
	// Column:Value for this table
	Values tt.Map `json:"values"`
	// GEOID of associated census geography
	Geoid       string `json:"geoid"`
	GeographyID int    `json:"-"`
	TableID     int    `json:"-"`
}

type Checker interface {
	authz.CheckerServer
}

type Config struct {
	Finder                  Finder
	RTFinder                RTFinder
	GbfsFinder              GbfsFinder
	Checker                 Checker
	Actions                 Actions
	JobQueue                jobs.JobQueue
	Clock                   clock.Clock
	Secrets                 []dmfr.Secret
	ValidateLargeFiles      bool
	DisableImage            bool
	UseMaterialized         bool
	RestPrefix              string
	Storage                 string
	RTStorage               string
	LoaderBatchSize         int
	LoaderStopTimeBatchSize int
	MaxRadius               float64
}

type Cursor struct {
	FeedVersionID int
	ID            int
	Valid         bool
}

type DirectionRequest struct {
	To       *WaypointInput `json:"to"`
	From     *WaypointInput `json:"from"`
	Mode     StepMode       `json:"mode"`
	DepartAt *time.Time     `json:"depart_at,omitempty"`
}

type Directions struct {
	Success     bool         `json:"success"`
	Exception   *string      `json:"exception,omitempty"`
	DataSource  *string      `json:"data_source,omitempty"`
	Origin      *Waypoint    `json:"origin,omitempty"`
	Destination *Waypoint    `json:"destination,omitempty"`
	Duration    *Duration    `json:"duration,omitempty"`
	Distance    *Distance    `json:"distance,omitempty"`
	StartTime   *time.Time   `json:"start_time,omitempty"`
	EndTime     *time.Time   `json:"end_time,omitempty"`
	Itineraries []*Itinerary `json:"itineraries,omitempty"`
}

type Distance struct {
	Distance float64      `json:"distance"`
	Units    DistanceUnit `json:"units"`
}

type DistanceUnit string

type Duration struct {
	Duration float64      `json:"duration"`
	Units    DurationUnit `json:"units"`
}

type DurationUnit string

type EntityDeleteResult struct {
	// ID of deleted entity
	ID int `json:"id"`
}

type EntityFinder interface {
	FindAgencies(context.Context, *int, *Cursor, []int, *AgencyFilter) ([]*Agency, error)
	FindRoutes(context.Context, *int, *Cursor, []int, *RouteFilter) ([]*Route, error)
	FindStops(context.Context, *int, *Cursor, []int, *StopFilter) ([]*Stop, error)
	FindTrips(context.Context, *int, *Cursor, []int, *TripFilter) ([]*Trip, error)
	FindFeedVersions(context.Context, *int, *Cursor, []int, *FeedVersionFilter) ([]*FeedVersion, error)
	FindFeeds(context.Context, *int, *Cursor, []int, *FeedFilter) ([]*Feed, error)
	FindOperators(context.Context, *int, *Cursor, []int, *OperatorFilter) ([]*Operator, error)
	FindPlaces(context.Context, *int, *Cursor, []int, *PlaceAggregationLevel, *PlaceFilter) ([]*Place, error)
	FindCensusDatasets(context.Context, *int, *Cursor, []int, *CensusDatasetFilter) ([]*CensusDataset, error)
	RouteStopBuffer(context.Context, *int, *float64, int) ([]*RouteStopBuffer, error)
	FindFeedVersionServiceWindow(context.Context, int) (*ServiceWindow, error)
	DBX() tldb.Ext // escape hatch, for now
}

type EntityLoader interface {
	AgenciesByFeedVersionIDs(ctx context.Context, limit *int, where *AgencyFilter, feedVersionIds []int) ([][]*Agency, error)
	AgenciesByIDs(context.Context, []int) ([]*Agency, []error)
	AgenciesByOnestopIDs(context.Context, *int, *AgencyFilter, []string) ([][]*Agency, error)
	AgencyPlacesByAgencyIDs(context.Context, *int, *AgencyPlaceFilter, []int) ([][]*AgencyPlace, error)
	BookingRulesByFeedVersionIDs(context.Context, *int, *BookingRuleFilter, []int) ([][]*BookingRule, error)
	BookingRulesByIDs(context.Context, []int) ([]*BookingRule, []error)
	CalendarDatesByServiceIDs(context.Context, *int, *CalendarDateFilter, []int) ([][]*CalendarDate, error)
	CalendarsByIDs(context.Context, []int) ([]*Calendar, []error)
	CensusDatasetLayersByDatasetIDs(context.Context, []int) ([][]*CensusLayer, []error)
	CensusFieldsByTableIDs(context.Context, *int, []int) ([][]*CensusField, error)
	CensusGeographiesByDatasetIDs(context.Context, *int, *CensusDatasetGeographyFilter, []int) ([][]*CensusGeography, error)
	CensusGeographiesByEntityIDs(context.Context, *int, *CensusGeographyFilter, string, []int) ([][]*CensusGeography, error)
	CensusGeographiesByLayerIDs(context.Context, *int, *CensusSourceGeographyFilter, []int) ([][]*CensusGeography, error)
	CensusGeographiesBySourceIDs(context.Context, *int, *CensusSourceGeographyFilter, []int) ([][]*CensusGeography, error)
	CensusLayersByIDs(context.Context, []int) ([]*CensusLayer, []error)
	CensusSourcesByIDs(context.Context, []int) ([]*CensusSource, []error)
	CensusSourceLayersBySourceIDs(context.Context, []int) ([][]*CensusLayer, []error)
	CensusSourcesByDatasetIDs(context.Context, *int, *CensusSourceFilter, []int) ([][]*CensusSource, error)
	CensusTableByIDs(context.Context, []int) ([]*CensusTable, []error)
	CensusValuesByGeographyIDs(context.Context, *int, string, []string, []string) ([][]*CensusValue, error)
	FeedFetchesByFeedIDs(context.Context, *int, *FeedFetchFilter, []int) ([][]*FeedFetch, error)
	FeedInfosByFeedVersionIDs(context.Context, *int, []int) ([][]*FeedInfo, error)
	FeedsByIDs(context.Context, []int) ([]*Feed, []error)
	FeedsByOperatorOnestopIDs(context.Context, *int, *FeedFilter, []string) ([][]*Feed, error)
	FeedStatesByFeedIDs(context.Context, []int) ([]*FeedState, []error)
	FeedVersionFileInfosByFeedVersionIDs(context.Context, *int, []int) ([][]*FeedVersionFileInfo, error)
	FeedVersionGeometryByIDs(context.Context, []int) ([]*tt.Polygon, []error)
	FeedVersionGtfsImportByFeedVersionIDs(context.Context, []int) ([]*FeedVersionGtfsImport, []error)
	FeedVersionsByFeedIDs(context.Context, *int, *FeedVersionFilter, []int) ([][]*FeedVersion, error)
	FeedVersionsByIDs(context.Context, []int) ([]*FeedVersion, []error)
	FeedVersionServiceLevelsByFeedVersionIDs(context.Context, *int, *FeedVersionServiceLevelFilter, []int) ([][]*FeedVersionServiceLevel, error)
	FeedVersionServiceWindowByFeedVersionIDs(context.Context, []int) ([]*FeedVersionServiceWindow, []error)
	FlexStopTimesByStopIDs(context.Context, *int, *StopTimeFilter, []FVPair) ([][]*FlexStopTime, error)
	FlexStopTimesByLocationIDs(context.Context, *int, *StopTimeFilter, []FVPair) ([][]*FlexStopTime, error)
	FlexStopTimesByLocationGroupIDs(context.Context, *int, *StopTimeFilter, []FVPair) ([][]*FlexStopTime, error)
	FlexStopTimesByTripIDs(context.Context, *int, *TripStopTimeFilter, []FVPair) ([][]*FlexStopTime, error)
	FrequenciesByTripIDs(context.Context, *int, []int) ([][]*Frequency, error)
	LevelsByIDs(context.Context, []int) ([]*Level, []error)
	LevelsByParentStationIDs(context.Context, *int, []int) ([][]*Level, error)
	LocationGroupsByFeedVersionIDs(context.Context, *int, *LocationGroupFilter, []int) ([][]*LocationGroup, error)
	LocationGroupsByIDs(context.Context, []int) ([]*LocationGroup, []error)
	LocationGroupsByStopIDs(context.Context, *int, []int) ([][]*LocationGroup, error)
	LocationsByFeedVersionIDs(context.Context, *int, *LocationFilter, []int) ([][]*Location, error)
	LocationsByIDs(context.Context, []int) ([]*Location, []error)
	OperatorsByAgencyIDs(context.Context, []int) ([]*Operator, []error)
	OperatorsByCOIFs(context.Context, []int) ([]*Operator, []error)
	OperatorsByFeedIDs(context.Context, *int, *OperatorFilter, []int) ([][]*Operator, error)
	PathwaysByFromStopIDs(context.Context, *int, *PathwayFilter, []int) ([][]*Pathway, error)
	PathwaysByIDs(context.Context, []int) ([]*Pathway, []error)
	PathwaysByToStopIDs(context.Context, *int, *PathwayFilter, []int) ([][]*Pathway, error)
	RouteAttributesByRouteIDs(context.Context, []int) ([]*RouteAttribute, []error)
	RouteGeometriesByRouteIDs(context.Context, *int, []int) ([][]*RouteGeometry, error)
	RouteHeadwaysByRouteIDs(context.Context, *int, []int) ([][]*RouteHeadway, error)
	RoutesByAgencyIDs(context.Context, *int, *RouteFilter, []int) ([][]*Route, error)
	RoutesByFeedVersionIDs(context.Context, *int, *RouteFilter, []int) ([][]*Route, error)
	RoutesByIDs(context.Context, []int) ([]*Route, []error)
	RouteStopPatternsByRouteIDs(context.Context, *int, []int) ([][]*RouteStopPattern, error)
	RouteStopsByRouteIDs(context.Context, *int, []int) ([][]*RouteStop, error)
	RouteStopsByStopIDs(context.Context, *int, []int) ([][]*RouteStop, error)
	SegmentPatternsByRouteIDs(context.Context, *int, *SegmentPatternFilter, []int) ([][]*SegmentPattern, error)
	SegmentPatternsBySegmentIDs(context.Context, *int, *SegmentPatternFilter, []int) ([][]*SegmentPattern, error)
	SegmentsByFeedVersionIDs(context.Context, *int, *SegmentFilter, []int) ([][]*Segment, error)
	SegmentsByIDs(context.Context, []int) ([]*Segment, []error)
	SegmentsByRouteIDs(context.Context, *int, *SegmentFilter, []int) ([][]*Segment, error)
	ShapesByIDs(context.Context, []int) ([]*Shape, []error)
	StopExternalReferencesByStopIDs(context.Context, []int) ([]*StopExternalReference, []error)
	StopObservationsByStopIDs(context.Context, *int, *StopObservationFilter, []int) ([][]*StopObservation, error)
	StopPlacesByStopID(context.Context, []StopPlaceParam) ([]*StopPlace, []error)
	StopsByFeedVersionIDs(context.Context, *int, *StopFilter, []int) ([][]*Stop, error)
	StopsByIDs(context.Context, []int) ([]*Stop, []error)
	StopsByLevelIDs(context.Context, *int, *StopFilter, []int) ([][]*Stop, error)
	StopsByLocationGroupIDs(context.Context, *int, []int) ([][]*Stop, error)
	StopsByParentStopIDs(context.Context, *int, *StopFilter, []int) ([][]*Stop, error)
	StopsByRouteIDs(context.Context, *int, *StopFilter, []int) ([][]*Stop, error)
	StopTimesByStopIDs(context.Context, *int, *StopTimeFilter, []FVPair) ([][]*StopTime, error)
	StopTimesByTripIDs(context.Context, *int, *TripStopTimeFilter, []FVPair) ([][]*StopTime, error)
	TargetStopsByStopIDs(context.Context, []int) ([]*Stop, []error)
	TripsByFeedVersionIDs(context.Context, *int, *TripFilter, []int) ([][]*Trip, error)
	TripsByIDs(context.Context, []int) ([]*Trip, []error)
	TripsByRouteIDs(context.Context, *int, *TripFilter, []FVPair) ([][]*Trip, error)
	ValidationReportErrorExemplarsByValidationReportErrorGroupIDs(context.Context, *int, []int) ([][]*ValidationReportError, error)
	ValidationReportErrorGroupsByValidationReportIDs(context.Context, *int, []int) ([][]*ValidationReportErrorGroup, error)
	ValidationReportsByFeedVersionIDs(context.Context, *int, *ValidationReportFilter, []int) ([][]*ValidationReport, error)
}

type EntityMutator interface {
	StopCreate(ctx context.Context, input StopSetInput) (int, error)
	StopUpdate(ctx context.Context, input StopSetInput) (int, error)
	StopDelete(ctx context.Context, id int) error
	PathwayCreate(ctx context.Context, input PathwaySetInput) (int, error)
	PathwayUpdate(ctx context.Context, input PathwaySetInput) (int, error)
	PathwayDelete(ctx context.Context, id int) error
	LevelCreate(ctx context.Context, input LevelSetInput) (int, error)
	LevelUpdate(ctx context.Context, input LevelSetInput) (int, error)
	LevelDelete(ctx context.Context, id int) error
}

type FVPair struct {
	FeedVersionID int
	EntityID      int
}

type Feature struct {
	ID         *string      `json:"id,omitempty"`
	Geometry   *tt.Geometry `json:"geometry,omitempty"`
	Properties *tt.Map      `json:"properties,omitempty"`
	Type       *string      `json:"type,omitempty"`
}

type Feed struct {
	WithOperatorOnestopID tt.String
	SearchRank            *string
	dmfr.Feed
}

type FeedAuthorization struct {
	dmfr.FeedAuthorization
}

type FeedFetch struct {
	ResponseSha1 tt.String // confusing but easier than alternative fixes
	dmfr.FeedFetch
}

type FeedFetchFilter struct {
	// Search for feed fetches with success (true) or failure (false) or unspecified (null)
	Success *bool `json:"success,omitempty"`
}

type FeedFilter struct {
	// Search for feed with a specific OnestopID
	OnestopID *string `json:"onestop_id,omitempty"`
	// Search for feeds of certain data types
	Spec []FeedSpecTypes `json:"spec,omitempty"`
	// Search for feeds with or without a fetch error
	FetchError *bool `json:"fetch_error,omitempty"`
	// Search for feeds by their import status
	ImportStatus *ImportStatus `json:"import_status,omitempty"`
	// Full text search
	Search *string `json:"search,omitempty"`
	// Search for feeds with a tag
	Tags *tt.Tags `json:"tags,omitempty"`
	// Search for feeds by their source URLs
	SourceURL *FeedSourceURL `json:"source_url,omitempty"`
	// Search for feeds with these license details
	License *LicenseFilter `json:"license,omitempty"`
	// Search for feeds within this bounding box
	Bbox *BoundingBox `json:"bbox,omitempty"`
	// Search for feeds within this geographic polygon
	Within *tt.Polygon `json:"within,omitempty"`
	// Search for feeds within specified radius of a point
	Near *PointRadius `json:"near,omitempty"`
}

type FeedInfo struct {
	gtfs.FeedInfo
}

type FeedLicense struct {
	dmfr.FeedLicense
}

type FeedSourceURL struct {
	// URL
	URL *string `json:"url,omitempty"`
	// URL type
	Type *FeedSourceURLTypes `json:"type,omitempty"`
	// Case sensitive search (true) or case insensitive search (false or null)
	CaseSensitive *bool `json:"case_sensitive,omitempty"`
}

type FeedSourceURLTypes string

type FeedSpecTypes string

type FeedState struct {
	dmfr.FeedState
}

type FeedUrls struct {
	dmfr.FeedUrls
}

type FeedVersion struct {
	SHA1Dir tt.String `json:"sha1_dir"`
	dmfr.FeedVersion
}

type FeedVersionDeleteResult struct {
	// Did the delete succeed
	Success bool `json:"success"`
}

type FeedVersionFetchResult struct {
	// Details of fetched feed version, if successful
	FeedVersion *FeedVersion `json:"feed_version,omitempty"`
	// Exception log if fetch failed
	FetchError *string `json:"fetch_error,omitempty"`
	// Set if the fetched feed version is already present in the database with the same directory contents
	FoundSha1 bool `json:"found_sha1"`
	// Set if the fetched feed version is already present in the database with the same SHA1 hash
	FoundDirSha1 bool `json:"found_dir_sha1"`
}

type FeedVersionFileInfo struct {
	dmfr.FeedVersionFileInfo
}

type FeedVersionFilter struct {
	// Restrict to specific ids
	Ids []int `json:"ids,omitempty"`
	// Search for feed versions with the specified import status
	ImportStatus *ImportStatus `json:"import_status,omitempty"`
	// Search for feed versions with this feed OnestopID
	FeedOnestopID *string `json:"feed_onestop_id,omitempty"`
	// Search for feed versions with this SHA1 hash
	Sha1 *string `json:"sha1,omitempty"`
	// Search for feed versions with this file identifier
	File *string `json:"file,omitempty"`
	// Search for feed versions with the specified feed integer IDs
	FeedIds []int `json:"feed_ids,omitempty"`
	// Search for feed versions that cover the specified date range
	Covers *ServiceCoversFilter `json:"covers,omitempty"`
	// Search for feed versions within this bounding box
	Bbox *BoundingBox `json:"bbox,omitempty"`
	// Search for feed versions within this geographic polygon
	Within *tt.Polygon `json:"within,omitempty"`
	// Search for feed versions within specified radius of a point
	Near *PointRadius `json:"near,omitempty"`
	// Search for stops with these license details
	License *LicenseFilter `json:"license,omitempty"`
}

type FeedVersionGtfsImport struct {
	WarningCount             *json.RawMessage `json:"warning_count"`
	EntityCount              *json.RawMessage `json:"entity_count"`
	SkipEntityErrorCount     *json.RawMessage `json:"skip_entity_error_count"`
	SkipEntityReferenceCount *json.RawMessage `json:"skip_entity_reference_count"`
	SkipEntityFilterCount    *json.RawMessage `json:"skip_entity_filter_count"`
	SkipEntityMarkedCount    *json.RawMessage `json:"skip_entity_marked_count"`
	dmfr.FeedVersionImport
}

type FeedVersionImportResult struct {
	// Did the import succeed
	Success bool `json:"success"`
}

type FeedVersionInput struct {
	// Feed version integer ID
	ID *int `json:"id,omitempty"`
}

type FeedVersionServiceLevel struct {
	dmfr.FeedVersionServiceLevel
}

type FeedVersionServiceLevelFilter struct {
	// Search for service level summaries starting on or after this date
	StartDate *tt.Date `json:"start_date,omitempty"`
	// Search for service level summaries ending on or before this date
	EndDate *tt.Date `json:"end_date,omitempty"`
}

type FeedVersionServiceWindow struct {
	// Internal integer ID
	ID int `json:"id"`
	// Feed start date from feed_info.txt, if available
	FeedStartDate *tt.Date `json:"feed_start_date,omitempty"`
	// Feed end date from feed_info.txt, if available
	FeedEndDate *tt.Date `json:"feed_end_date,omitempty"`
	// Calculated earliest calendar date in service schedule
	EarliestCalendarDate *tt.Date `json:"earliest_calendar_date,omitempty"`
	// Calculated latest calendar date in service schedule
	LatestCalendarDate *tt.Date `json:"latest_calendar_date,omitempty"`
	// Week with most typical service patterns inside the service window
	FallbackWeek *tt.Date `json:"fallback_week,omitempty"`
	// Default timezone for this feed version
	DefaultTimezone *string `json:"default_timezone,omitempty"`
	FeedVersionID   int     `json:"-"`
}

type FeedVersionSetInput struct {
	// Entity ID to update
	ID *int `json:"id,omitempty"`
	// Set entity name to this value
	Name *string `json:"name,omitempty"`
	// Set entity description to this value
	Description *string `json:"description,omitempty"`
}

type FeedVersionUnimportResult struct {
	// Did the unimport succeed
	Success bool `json:"success"`
}

type Finder interface {
	PermFinder
	EntityFinder
	EntityLoader
	EntityMutator
}

type FlexStopTime = StopTime

type FocusPoint struct {
	// Latitude
	Lat float64 `json:"lat"`
	// Longitude
	Lon float64 `json:"lon"`
}

type Frequency struct {
	gtfs.Frequency
}

type GbfsAlertTime struct {
	*gbfs.AlertTime
}

type GbfsBikeRequest struct {
	Near *PointRadius `json:"near,omitempty"`
}

type GbfsBrandAsset struct {
	*gbfs.BrandAsset
}

type GbfsDockRequest struct {
	Near *PointRadius `json:"near,omitempty"`
}

type GbfsFeed struct {
	*gbfs.GbfsFeed
}

type GbfsFinder interface {
	AddData(context.Context, string, gbfs.GbfsFeed) error
	FindBikes(context.Context, *int, *GbfsBikeRequest) ([]*GbfsFreeBikeStatus, error)
	FindDocks(context.Context, *int, *GbfsDockRequest) ([]*GbfsStationInformation, error)
}

type GbfsFreeBikeStatus struct {
	Feed *GbfsFeed
	*gbfs.FreeBikeStatus
}

type GbfsGeofenceFeature struct {
	*gbfs.GeofenceFeature
}

type GbfsGeofenceProperty struct {
	*gbfs.GeofenceProperty
}

type GbfsGeofenceRule struct {
	*gbfs.GeofenceRule
}

type GbfsGeofenceZone struct {
	*gbfs.GeofenceZone
}

type GbfsPlanPrice struct {
	*gbfs.PlanPrice
}

type GbfsRentalApp struct {
	*gbfs.RentalApp
}

type GbfsRentalApps struct {
	*gbfs.RentalApps
}

type GbfsRentalUris struct {
	*gbfs.RentalURIs
}

type GbfsStationInformation struct {
	Feed *GbfsFeed
	*gbfs.StationInformation
}

type GbfsStationStatus struct {
	Feed *GbfsFeed
	*gbfs.StationStatus
}

type GbfsSystemAlert struct {
	*gbfs.SystemAlert
}

type GbfsSystemCalendar struct {
	*gbfs.SystemCalendar
}

type GbfsSystemHour struct {
	*gbfs.SystemHour
}

type GbfsSystemInformation struct {
	Feed *GbfsFeed
	*gbfs.SystemInformation
}

type GbfsSystemPricingPlan struct {
	*gbfs.SystemPricingPlan
}

type GbfsSystemRegion struct {
	*gbfs.SystemRegion
}

type GbfsSystemVersion struct {
	*gbfs.SystemVersion
}

type GbfsVehicleAssets struct {
	*gbfs.VehicleAssets
}

type GbfsVehicleDockAvailable struct {
	Feed *GbfsFeed
	*gbfs.VehicleDockAvailable
}

type GbfsVehicleType struct {
	Feed *GbfsFeed
	*gbfs.VehicleType
}

type GbfsVehicleTypeAvailable struct {
	Feed *GbfsFeed
	*gbfs.VehicleTypeAvailable
}

type ImportStatus string

type Itinerary struct {
	Duration  *Duration `json:"duration"`
	Distance  *Distance `json:"distance"`
	StartTime time.Time `json:"start_time"`
	EndTime   time.Time `json:"end_time"`
	From      *Waypoint `json:"from"`
	To        *Waypoint `json:"to"`
	Legs      []*Leg    `json:"legs,omitempty"`
}

type Leg struct {
	Duration  *Duration            `json:"duration"`
	Distance  *Distance            `json:"distance"`
	StartTime time.Time            `json:"start_time"`
	EndTime   time.Time            `json:"end_time"`
	From      *Waypoint            `json:"from,omitempty"`
	To        *Waypoint            `json:"to,omitempty"`
	Mode      *StepMode            `json:"mode,omitempty"`
	Steps     []*Step              `json:"steps,omitempty"`
	Stops     []*WaypointDeparture `json:"stops,omitempty"`
	Geometry  tt.LineString        `json:"geometry"`
	Trip      *LegTrip             `json:"trip,omitempty"`
}

type LegRoute struct {
	RouteID        string          `json:"route_id"`
	RouteShortName string          `json:"route_short_name"`
	RouteLongName  string          `json:"route_long_name"`
	RouteOnestopID string          `json:"route_onestop_id"`
	RouteType      int             `json:"route_type"`
	RouteColor     *string         `json:"route_color,omitempty"`
	RouteTextColor *string         `json:"route_text_color,omitempty"`
	Agency         *LegRouteAgency `json:"agency"`
}

type LegRouteAgency struct {
	AgencyID        string `json:"agency_id"`
	AgencyName      string `json:"agency_name"`
	AgencyOnestopID string `json:"agency_onestop_id"`
}

type LegTrip struct {
	TripID          string    `json:"trip_id"`
	TripShortName   string    `json:"trip_short_name"`
	Headsign        string    `json:"headsign"`
	FeedID          string    `json:"feed_id"`
	FeedVersionSha1 string    `json:"feed_version_sha1"`
	Route           *LegRoute `json:"route"`
}

type Level struct {
	Geometry      tt.MultiPolygon
	ParentStation tt.Key
	gtfs.Level
}

type LevelSetInput struct {
	// Entity ID to update
	ID *int `json:"id,omitempty"`
	// Feed version of entity to update
	FeedVersion *FeedVersionInput `json:"feed_version,omitempty"`
	// Set GTFS level_id to this value
	LevelID *string `json:"level_id,omitempty"`
	// Set GTFS level_name to this value
	LevelName *string `json:"level_name,omitempty"`
	// Set GTFS level_index to this value
	LevelIndex *float64 `json:"level_index,omitempty"`
	// Set level geometry to this value
	Geometry *tt.MultiPolygon `json:"geometry,omitempty"`
	// Set level parent station to this stop
	Parent *StopSetInput `json:"parent,omitempty"`
}

type LicenseFilter struct {
	// Search for entities with this Share Alike license restriction
	ShareAlikeOptional *LicenseValue `json:"share_alike_optional,omitempty"`
	// Search for entities with this Create Derived Product license restriction
	CreateDerivedProduct *LicenseValue `json:"create_derived_product,omitempty"`
	// Search for entities with this Commercial Use Allowed restriction
	CommercialUseAllowed *LicenseValue `json:"commercial_use_allowed,omitempty"`
	// Search for entities with this Use Without Attribution restriction
	UseWithoutAttribution *LicenseValue `json:"use_without_attribution,omitempty"`
	// Search for entities with this Redistribution Allowed restriction
	RedistributionAllowed *LicenseValue `json:"redistribution_allowed,omitempty"`
}

type LicenseValue string

type Location struct {
	FeedOnestopID   string
	FeedVersionSHA1 string
	gtfs.Location
}

type LocationFilter struct {
	// Restrict to specific ids
	Ids []int `json:"ids,omitempty"`
	// Search for locations with this location_id
	LocationID *string `json:"location_id,omitempty"`
}

type LocationGroup struct {
	FeedOnestopID   string
	FeedVersionSHA1 string
	gtfs.LocationGroup
}

type LocationGroupFilter struct {
	// Restrict to specific ids
	Ids []int `json:"ids,omitempty"`
	// Search for location groups with this location_group_id
	LocationGroupID *string `json:"location_group_id,omitempty"`
}

type LocationGroupStop struct {
	gtfs.LocationGroupStop
}

type Me struct {
	// Internal identifier
	ID string `json:"id"`
	// User name
	Name *string `json:"name,omitempty"`
	// User email
	Email *string `json:"email,omitempty"`
	// User associated roles
	Roles []string `json:"roles,omitempty"`
	// User associated external data, e.g. metering service identifiers
	ExternalData tt.Map `json:"external_data"`
}

type Mutation struct {
}

type Operator struct {
	ID            int
	Generated     bool
	FeedID        int
	FeedOnestopID *string
	SearchRank    *string // internal
	AgencyID      int     // internal
	dmfr.Operator
}

type OperatorFilter struct {
	// Merge multiple agency-operator associations into single operator results
	Merged *bool `json:"merged,omitempty"`
	// Search for operators with this OnestopID
	OnestopID *string `json:"onestop_id,omitempty"`
	// Search for operators with this feed OnestopID
	FeedOnestopID *string `json:"feed_onestop_id,omitempty"`
	// Search for operators with agencies having this GTFS agency_id
	AgencyID *string `json:"agency_id,omitempty"`
	// Full-text search string
	Search *string `json:"search,omitempty"`
	// Search for operators with this set of tag key/values
	Tags *tt.Tags `json:"tags,omitempty"`
	// Search for operators by city name (provided by Natural Earth)
	CityName *string `json:"city_name,omitempty"`
	// Search for operators by country name (provided by Natural Earth)
	Adm0Name *string `json:"adm0_name,omitempty"`
	// Search for operators by state/province/division name (provided by Natural Earth)
	Adm1Name *string `json:"adm1_name,omitempty"`
	// Search for operators by country 2 letter ISO 3166 code (provided by Natural Earth)
	Adm0Iso *string `json:"adm0_iso,omitempty"`
	// Search for operators by state/province/division ISO 3166-2 code (provided by Natural Earth)
	Adm1Iso *string `json:"adm1_iso,omitempty"`
	// Search for operators with these license details
	License *LicenseFilter `json:"license,omitempty"`
	// Search for operators within this bounding box
	Bbox *BoundingBox `json:"bbox,omitempty"`
	// Search for operators within this geographic polygon
	Within *tt.Polygon `json:"within,omitempty"`
	// Search for operators within specified radius of a point
	Near *PointRadius `json:"near,omitempty"`
}

type Pathway struct {
	gtfs.Pathway
}

type PathwayFilter struct {
	// Search for pathways with this GTFS pathway_mode
	PathwayMode *int `json:"pathway_mode,omitempty"`
}

type PathwaySetInput struct {
	// Entity ID to update
	ID *int `json:"id,omitempty"`
	// Feed version of entity to update
	FeedVersion *FeedVersionInput `json:"feed_version,omitempty"`
	// Set GTFS pathway_id to this value
	PathwayID *string `json:"pathway_id,omitempty"`
	// Set GTFS pathway_mode to this value
	PathwayMode *int `json:"pathway_mode,omitempty"`
	// Set GTFS is_bidirectional to this value
	IsBidirectional *int `json:"is_bidirectional,omitempty"`
	// Set GTFS length to this value
	Length *float64 `json:"length,omitempty"`
	// Set GTFS traversal_time to this value
	TraversalTime *int `json:"traversal_time,omitempty"`
	// Set GTFS stair_count to this value
	StairCount *int `json:"stair_count,omitempty"`
	// Set GTFS max_slope to this value
	MaxSlope *float64 `json:"max_slope,omitempty"`
	// Set GTFS min_width to this value
	MinWidth *float64 `json:"min_width,omitempty"`
	// Set GTFS signposted_as to this value
	SignpostedAs *string `json:"signposted_as,omitempty"`
	// Set GTFS reverse_signposted_as to this value
	ReverseSignpostedAs *string `json:"reverse_signposted_as,omitempty"`
	// Set pathway origin to this stop
	FromStop *StopSetInput `json:"from_stop,omitempty"`
	// Set pathway destination to this stop
	ToStop *StopSetInput `json:"to_stop,omitempty"`
}

type PermFilter struct {
	AllowedFeeds        []int
	AllowedFeedVersions []int
}

type PermFinder interface {
	PermFilter(context.Context) *PermFilter
}

type Place struct {
	// Country name
	Adm0Name *string `json:"adm0_name,omitempty"`
	// State or province name
	Adm1Name *string `json:"adm1_name,omitempty"`
	// City name
	CityName *string `json:"city_name,omitempty"`
	// Number of associated operators
	Count int `json:"count"`
	// Operators associated with this place
	Operators []*Operator `json:"operators,omitempty"`
	AgencyIDs tt.Ints     `db:"agency_ids"`
}

type PlaceAggregationLevel string

type PlaceFilter struct {
	// Search for place associations with at least this rank value
	MinRank *float64 `json:"min_rank,omitempty"`
	// Search for place associations by country name (provided by Natural Earth)
	Adm0Name *string `json:"adm0_name,omitempty"`
	// Search for place associations by state/province/division name (provided by Natural Earth)
	Adm1Name *string `json:"adm1_name,omitempty"`
	// Search for place associations by city name (provided by Natural Earth)
	CityName *string `json:"city_name,omitempty"`
}

type PointRadius struct {
	// Latitude
	Lat float64 `json:"lat"`
	// Longitude
	Lon float64 `json:"lon"`
	// Radius around specified point
	Radius float64 `json:"radius"`
}

type Query struct {
}

type RTFinder interface {
	AddData(context.Context, string, []byte) error
	FindTrip(context.Context, *Trip) *pb.TripUpdate
	MakeTrip(context.Context, *Trip) (*Trip, error)
	FindAlertsForTrip(context.Context, *Trip, *int, *bool) []*Alert
	FindAlertsForStop(context.Context, *Stop, *int, *bool) []*Alert
	FindAlertsForRoute(context.Context, *Route, *int, *bool) []*Alert
	FindAlertsForAgency(context.Context, *Agency, *int, *bool) []*Alert
	GetAddedTripsForStop(context.Context, *Stop) []*pb.TripUpdate
	FindStopTimeUpdate(context.Context, *Trip, *StopTime) (*RTStopTimeUpdate, bool)
	// lookup cache methods
	StopTimezone(context.Context, int, string) (*time.Location, bool)
	FeedVersionTimezone(context.Context, int) (*time.Location, bool)
	GetGtfsTripID(context.Context, int) (string, bool)
	GetMessage(context.Context, string, string) (*pb.FeedMessage, bool)
}

type RTStopTimeUpdate struct {
	LastDelay      *int32
	StopTimeUpdate *pb.TripUpdate_StopTimeUpdate
	TripUpdate     *pb.TripUpdate
}

type RTTimeRange struct {
	// GTFS-RT TimeRange start time, in Unix epoch seconds
	Start *int `json:"start,omitempty"`
	// GTFS-RT TimeRange end time, in Unix epoch seconds
	End *int `json:"end,omitempty"`
}

type RTTranslation struct {
	// GTFS-RT TranslatedString translated text
	Text string `json:"text"`
	// GTFS-RT TranslatedString language for this translation
	Language *string `json:"language,omitempty"`
}

type RTTripDescriptor struct {
	// GTFS-RT TripDescriptor trip ID
	TripID *string `json:"trip_id,omitempty"`
	// GTFS-RT TripDescriptor route ID
	RouteID *string `json:"route_id,omitempty"`
	// GTFS-RT TripDescriptor trip direction
	DirectionID *int `json:"direction_id,omitempty"`
	// GTFS-RT TripDescriptor trip start time, in local time HH:MM:SS
	StartTime *tt.Seconds `json:"start_time,omitempty"`
	// GTFS-RT TripDescriptor trip start time, in local date
	StartDate *tt.Date `json:"start_date,omitempty"`
	// GTFS-RT TripDescriptor schedule relationship. See https://gtfs.org/realtime/reference/#enum-schedulerelationship-1
	ScheduleRelationship *string `json:"schedule_relationship,omitempty"`
}

type RTVehicleDescriptor struct {
	// GTFS-RT VehicleDescriptor vehicle ID
	ID *string `json:"id,omitempty"`
	// GTFS-RT VehicleDescriptor vehicle label
	Label *string `json:"label,omitempty"`
	// GTFS-RT VehicleDescriptor vehicle license plate
	LicensePlate *string `json:"license_plate,omitempty"`
}

type RelativeDate string

type Route struct {
	FeedOnestopID                string
	FeedVersionSHA1              string
	OnestopID                    *string
	HeadwaySecondsWeekdayMorning *int
	SearchRank                   *string
	gtfs.Route
}

type RouteAttribute struct {
	// Route category
	Category *int `json:"category,omitempty"`
	// Route subcategory
	Subcategory *int `json:"subcategory,omitempty"`
	// Route running way category
	RunningWay *int `json:"running_way,omitempty"`
	RouteID    int  `json:"-"`
}

type RouteFilter struct {
	// Search for routes with this OnestopID
	OnestopID *string `json:"onestop_id,omitempty"`
	// Search for routes with these OnestopIDs
	OnestopIds []string `json:"onestop_ids,omitempty"`
	// Include previously used OnestopIDs that match the same (feed,route_id)
	AllowPreviousOnestopIds *bool `json:"allow_previous_onestop_ids,omitempty"`
	// Search for routes with this feed version SHA1 hash
	FeedVersionSha1 *string `json:"feed_version_sha1,omitempty"`
	// Search for routes with this feed OnestopID
	FeedOnestopID *string `json:"feed_onestop_id,omitempty"`
	// Search for routes with this GTFS route_id
	RouteID *string `json:"route_id,omitempty"`
	// Search for routes with this GTFS route_type
	RouteType *int `json:"route_type,omitempty"`
	// Search for routes with any of these GTFS route_types
	RouteTypes []int `json:"route_types,omitempty"`
	// Search for routes with 1 or more trips (true) or 0 or more trips (false or null)
	Serviced *bool `json:"serviced,omitempty"`
	// Full text search
	Search *string `json:"search,omitempty"`
	// Search for routes operated by operators with this OnestopID
	OperatorOnestopID *string `json:"operator_onestop_id,omitempty"`
	// Search for routes with these license details
	License *LicenseFilter `json:"license,omitempty"`
	// Search for routes with these agency integer IDs. Deprecated.
	AgencyIds []int `json:"agency_ids,omitempty"`
	// Location
	Location *RouteLocationFilter `json:"location,omitempty"`
	// Backwards compat:Search for routes within this bounding box
	Bbox *BoundingBox `json:"bbox,omitempty"`
	// Backwards compat: Search for routes within this geographic polygon
	Within *tt.Polygon `json:"within,omitempty"`
	// Backwards compat: Search for routes within specified radius of a point
	Near *PointRadius `json:"near,omitempty"`
}

type RouteGeometry struct {
	// If true, the source GTFS feed provides no shapes. This route geometry is based on straight lines between stop points.
	Generated bool `json:"generated"`
	// A single LineString of this most common shape
	Geometry *tt.LineString `json:"geometry,omitempty"`
	// MultiLineString ensemble of the most common shapes for each direction
	CombinedGeometry *tt.Geometry `json:"combined_geometry,omitempty"`
	// Length (in meters) of the simple geometry
	Length *float64 `json:"length,omitempty"`
	// Maximum point-to-point distance in the geometry
	MaxSegmentLength *float64 `json:"max_segment_length,omitempty"`
	// First point max distance
	FirstPointMaxDistance *float64 `json:"first_point_max_distance,omitempty"`
	RouteID               int      `json:"-"`
}

type RouteHeadway struct {
	// Stop used for the headway calculation
	Stop *Stop `json:"stop"`
	// Day of week category; 1=Weekday, 6=Saturday, 7=Sunday
	DowCategory *int `json:"dow_category,omitempty"`
	// Trip direction
	DirectionID *int `json:"direction_id,omitempty"`
	// Typical number of seconds between departing trips at this stop in this direction on this day of the week
	HeadwaySecs *int `json:"headway_secs,omitempty"`
	// Date used for the headway calculation
	ServiceDate *tt.Date `json:"service_date,omitempty"`
	// Number of departures on this stop, day, and direction
	StopTripCount *int `json:"stop_trip_count,omitempty"`
	// Actual departure times on this stop, day, and direction
	DeparturesUnused []*tt.Seconds `json:"departures,omitempty"`
	DepartureInts    tt.Ints       `db:"departures"`
	RouteID          int           `json:"-"`
	SelectedStopID   int           `json:"-"`
}

type RouteLocationFilter struct {
	// Search for routes within this bounding box
	Bbox *BoundingBox `json:"bbox,omitempty"`
	// Search for routes within this geographic polygon
	Polygon *tt.Polygon `json:"polygon,omitempty"`
	// Search for routes within specified radius of a point
	Near *PointRadius `json:"near,omitempty"`
	// Focus search on this point; results will be sorted by distance
	Focus *FocusPoint `json:"focus,omitempty"`
}

type RouteStop struct {
	// Internal integer ID
	ID int `json:"id"`
	// Internal integer ID for this associated stop
	StopID int `json:"stop_id"`
	// Internal integer ID for this associated route
	RouteID int `json:"route_id"`
	// Internal integer ID for this associated agency
	AgencyID int `json:"agency_id"`
	// Associated route
	Route *Route `json:"route"`
	// Associated stop
	Stop *Stop `json:"stop"`
	// Associated agency
	Agency *Agency `json:"agency"`
}

type RouteStopBuffer struct {
	// Geographic buffer around route, based on requested meters
	StopBuffer *tt.Geometry `json:"stop_buffer,omitempty"`
	// Matching set of points (e.g. stops) found inside buffer
	StopPoints *tt.Geometry `json:"stop_points,omitempty"`
	// Convex hull of matching points
	StopConvexhull *tt.Polygon `json:"stop_convexhull,omitempty"`
}

type RouteStopPattern struct {
	// An identifier for this stop pattern; an integer scoped to this particular feed version
	StopPatternID int `json:"stop_pattern_id"`
	// Direction ID of the trip
	DirectionID int `json:"direction_id"`
	// Count of trips for this stop pattern
	Count int `json:"count"`
	// Trips for this stop pattern
	Trips   []*Trip `json:"trips,omitempty"`
	RouteID int     `json:"-"`
}

type ScheduleRelationship string

type Segment struct {
	// Internal integer ID
	ID int `json:"id"`
	// OSM Way ID, if any, associated with this segment
	WayID int `json:"way_id"`
	// Geometry for this segment
	Geometry tt.LineString `json:"geometry"`
	// Routes and stop patterns associated with this segment
	SegmentPatterns []*SegmentPattern `json:"segment_patterns,omitempty"`
	FeedVersionID   int               `json:"-"`
	WithRouteID     int               `json:"-"`
}

type SegmentFilter struct {
	// Search for segments associated with this layer name
	Layer *string `json:"layer,omitempty"`
}

type SegmentPattern struct {
	// Internal integer ID
	ID int `json:"id"`
	// Route for this segment pattern
	Route *Route `json:"route"`
	// Stop pattern for this segment pattern
	StopPatternID int `json:"stop_pattern_id"`
	// Segment geometry for this pattern
	Segment   *Segment `json:"segment"`
	RouteID   int      `json:"-"`
	SegmentID int      `json:"-"`
}

type SegmentPatternFilter struct {
	// Search for segments patterns associated with this layer name
	Layer *string `json:"layer,omitempty"`
}

type ServiceCoversFilter struct {
	// Search for feed versions fetched after this time
	FetchedAfter *time.Time `json:"fetched_after,omitempty"`
	// Search for feed versions fetched before this time
	FetchedBefore *time.Time `json:"fetched_before,omitempty"`
	// Search using only feed_info.txt values
	FeedStartDate *tt.Date `json:"feed_start_date,omitempty"`
	// Search using only feed_info.txt values
	FeedEndDate *tt.Date `json:"feed_end_date,omitempty"`
	// Search using feed_info.txt values or calendar maximum service extent
	StartDate *tt.Date `json:"start_date,omitempty"`
	// Search using feed_info.txt values or calendar maximum service extent
	EndDate *tt.Date `json:"end_date,omitempty"`
	// Search using calendar maximum service extent
	EarliestCalendarDate *tt.Date `json:"earliest_calendar_date,omitempty"`
	// Search using calendar maximum service extent
	LatestCalendarDate *tt.Date `json:"latest_calendar_date,omitempty"`
}

type ServiceWindow struct {
	NowLocal     time.Time
	StartDate    time.Time
	EndDate      time.Time
	FallbackWeek time.Time
}

type Shape struct {
	service.ShapeLine
}

type Step struct {
	Duration       *Duration `json:"duration"`
	Distance       *Distance `json:"distance"`
	StartTime      time.Time `json:"start_time"`
	EndTime        time.Time `json:"end_time"`
	To             *Waypoint `json:"to,omitempty"`
	Mode           StepMode  `json:"mode"`
	Instruction    string    `json:"instruction"`
	GeometryOffset int       `json:"geometry_offset"`
}

type StepMode string

type Stop struct {
	FeedOnestopID   string
	FeedVersionSHA1 string
	OnestopID       *string
	SearchRank      *string
	WithinFeatures  tt.Strings
	WithRouteID     tt.Int
	gtfs.Stop
}

type StopBuffer struct {
	// Search for geographies with these stop IDs
	StopIds []int `json:"stop_ids,omitempty"`
	// Stop ID search radius, in meters
	Radius *float64 `json:"radius,omitempty"`
}

type StopExternalReference struct {
	dmfr.StopExternalReference
}

type StopExternalReferenceSetInput struct {
	TargetFeedOnestopID *string `json:"target_feed_onestop_id,omitempty"`
	TargetStopID        *string `json:"target_stop_id,omitempty"`
}

type StopFilter struct {
	// Search for stops with this OnestopID
	OnestopID *string `json:"onestop_id,omitempty"`
	// Search for stops with these OnestopIDs
	OnestopIds []string `json:"onestop_ids,omitempty"`
	// Include previous used OnestopIDs that match the same (feed,stop_id)
	AllowPreviousOnestopIds *bool `json:"allow_previous_onestop_ids,omitempty"`
	// Search for stops with this feed version SHA1 hash
	FeedVersionSha1 *string `json:"feed_version_sha1,omitempty"`
	// Search for stops with this feed OnestopID
	FeedOnestopID *string `json:"feed_onestop_id,omitempty"`
	// Search for stops with this GTFS stop_id
	StopID *string `json:"stop_id,omitempty"`
	// Search for stops with this GTFS stop_code
	StopCode *string `json:"stop_code,omitempty"`
	// Search for stops with this GTFS location_type
	LocationType *int `json:"location_type,omitempty"`
	// Search for stops with 1 or more trips (true) or 0 or more trips (false or null)
	Serviced *bool `json:"serviced,omitempty"`
	// Full text search
	Search *string `json:"search,omitempty"`
	// Search for stops with these license details
	License *LicenseFilter `json:"license,omitempty"`
	// Search for stops with service by routes or operators with these OnestopIDs
	ServedByOnestopIds []string `json:"served_by_onestop_ids,omitempty"`
	// Search for stopswith service by routes with the specified GTFS route_type
	ServedByRouteType *int `json:"served_by_route_type,omitempty"`
	// Search for stopswith service by routes with any of the specified GTFS route_types
	ServedByRouteTypes []int `json:"served_by_route_types,omitempty"`
	// Search for stops with these agency integer IDs. Deprecated.
	AgencyIds []int `json:"agency_ids,omitempty"`
	// Search geographically
	Location *StopLocationFilter `json:"location,omitempty"`
	// Backwards compat: Search for stops within this bounding box
	Bbox *BoundingBox `json:"bbox,omitempty"`
	// Backwards compat: Search for stops within this geographic polygon
	Within *tt.Polygon `json:"within,omitempty"`
	// Backwards compat: Search for stops within specified radius of a point
	Near *PointRadius `json:"near,omitempty"`
}

type StopLocationFilter struct {
	// Search for stops within this bounding box
	Bbox *BoundingBox `json:"bbox,omitempty"`
	// Search for stops within this geographic polygon
	Polygon *tt.Polygon `json:"polygon,omitempty"`
	// Search within these enclosing features, and return the matching feature ids
	Features []*Feature `json:"features,omitempty"`
	// Search for stops within specified radius of a point
	Near *PointRadius `json:"near,omitempty"`
	// Search within these geography ids
	GeographyIds []*int `json:"geography_ids,omitempty"`
	// Focus search on this point; results will be sorted by distance
	Focus *FocusPoint `json:"focus,omitempty"`
}

type StopObservation struct {
	// GTFS-RT TripUpdate schedule relationship
	ScheduleRelationship *string `json:"schedule_relationship,omitempty"`
	// GTFS-RT TripUpdate trip start date
	TripStartDate *tt.Date `json:"trip_start_date,omitempty"`
	// GTFS-RT TripUpdate trip start time
	TripStartTime *tt.Seconds `json:"trip_start_time,omitempty"`
	// GTFS static origin stop id
	FromStopID *string `json:"from_stop_id,omitempty"`
	// GTFS static destination stop id
	ToStopID *string `json:"to_stop_id,omitempty"`
	// Agency ID for route
	AgencyID *string `json:"agency_id,omitempty"`
	// Route ID for trip
	RouteID *string `json:"route_id,omitempty"`
	// Trip ID
	TripID *string `json:"trip_id,omitempty"`
	// Stop sequence for origin stop
	StopSequence *int `json:"stop_sequence,omitempty"`
	// Source data used to calculate this stop observation. Can be trip update or vehicle positions.
	Source *string `json:"source,omitempty"`
	// GTFS static scheduled arrival time
	ScheduledArrivalTime *tt.Seconds `json:"scheduled_arrival_time,omitempty"`
	// GTFS static scheduled departure time
	ScheduledDepartureTime *tt.Seconds `json:"scheduled_departure_time,omitempty"`
	// GTFS-RT calculated arrival time
	ObservedArrivalTime *tt.Seconds `json:"observed_arrival_time,omitempty"`
	// GTFS-RT calculated departure time
	ObservedDepartureTime *tt.Seconds `json:"observed_departure_time,omitempty"`
	StopID                int         `json:"-"`
}

type StopObservationFilter struct {
	// Search for stop observations derived from the specified source
	Source string `json:"source"`
	// Search for stop observations associated with this feed version integer ID
	FeedVersionID int `json:"feed_version_id"`
	// Search for stop observations made on this trip start date
	TripStartDate tt.Date `json:"trip_start_date"`
}

type StopPlace struct {
	// Best-matched state or province name
	Adm1Name *string `json:"adm1_name,omitempty"`
	// Best-matched state or province ISO code
	Adm1Iso *string `json:"adm1_iso,omitempty"`
	// Best-matched country name
	Adm0Name *string `json:"adm0_name,omitempty"`
	// Best-mached country ISO code
	Adm0Iso *string `json:"adm0_iso,omitempty"`
}

type StopPlaceParam struct {
	ID    int
	Point tlxy.Point
}

type StopSetInput struct {
	// Entity ID to update
	ID *int `json:"id,omitempty"`
	// Feed version of entity to update
	FeedVersion *FeedVersionInput `json:"feed_version,omitempty"`
	// Set GTFS location_type to this value
	LocationType *int `json:"location_type,omitempty"`
	// Set GTFS stop_code to this value
	StopCode *string `json:"stop_code,omitempty"`
	// Set GTFS stop_desc to this value
	StopDesc *string `json:"stop_desc,omitempty"`
	// Set GTFS stop_id to this value
	StopID *string `json:"stop_id,omitempty"`
	// Set GTFS stop_name to this value
	StopName *string `json:"stop_name,omitempty"`
	// Set GTFS stop_timezone to this value
	StopTimezone *string `json:"stop_timezone,omitempty"`
	// Set GTFS stop_url to this value
	StopURL *string `json:"stop_url,omitempty"`
	// Set GTFS wheelchair_boarding to this value
	WheelchairBoarding *int `json:"wheelchair_boarding,omitempty"`
	// Set GTFS zone_id to this value
	ZoneID *string `json:"zone_id,omitempty"`
	// Set GTFS platform_code to this value
	PlatformCode *string `json:"platform_code,omitempty"`
	// Set GTFS tts_stop_name to this value
	TtsStopName *string `json:"tts_stop_name,omitempty"`
	// Set stop geometry to this value
	Geometry *tt.Point `json:"geometry,omitempty"`
	// Set stop parent station to this stop
	Parent *StopSetInput `json:"parent,omitempty"`
	// Set stop level to this level
	Level *LevelSetInput `json:"level,omitempty"`
	// Set or update external reference for this stop
	ExternalReference *StopExternalReferenceSetInput `json:"external_reference,omitempty"`
}

type StopTime struct {
	ServiceDate      tt.Date
	Date             tt.Date
	RTTripID         string            // internal: for ADDED trips
	RTStopTimeUpdate *RTStopTimeUpdate // internal
	gtfs.StopTime
}

type StopTimeEvent struct {
	// Local time for stop
	StopTimezone string `json:"stop_timezone"`
	// Estimated time in UTC
	EstimatedUtc *time.Time `json:"estimated_utc,omitempty"`
	// Estimated time in Unix epoch seconds
	EstimatedUnix *int `json:"estimated_unix,omitempty"`
	// Estimated time in the local time zone
	EstimatedLocal *time.Time `json:"estimated_local,omitempty"`
	// Estimated schedule delay, in seconds, based on either a timestamp or overall trip delay.
	//
	// This value can be set directly from a matching GTFS-RT StopTimeUpdate timestamp or delay value or set via an estimated overall trip delay. The value is capped at +/- 86,400 seconds (24 hours). Values larger than that are are likely erroneous and will be set to null.
	EstimatedDelay *int `json:"estimated_delay,omitempty"`
	// Estimated time in local time HH:MM:SS
	Estimated *tt.Seconds `json:"estimated,omitempty"`
	// Scheduled time in UTC
	ScheduledUtc *time.Time `json:"scheduled_utc,omitempty"`
	// Scheduled time in Unix epoch seconds
	ScheduledUnix *int `json:"scheduled_unix,omitempty"`
	// Sceduled time in the local time zone
	ScheduledLocal *time.Time `json:"scheduled_local,omitempty"`
	// Scheduled time local time HH:MM:SS
	Scheduled *tt.Seconds `json:"scheduled,omitempty"`
	// Estimated time in UTC, source directly from matching GTFS-RT StopTimeUpdate. See https://gtfs.org/realtime/reference/#message-stoptimeevent
	TimeUtc *time.Time `json:"time_utc,omitempty"`
	// Estimated time in Unix epoch seconds, source directly from matching GTFS-RT StopTimeUpdate. See https://gtfs.org/realtime/reference/#message-stoptimeevent
	TimeUnix *int `json:"time_unix,omitempty"`
	// Estimated schedule delay, in seconds. This value is set when there is a directly matching GTFS-RT StopTimeUpdate for this stop and passed through as-is. See GTFS Realtime documentation. See https://gtfs.org/realtime/reference/#message-stoptimeevent
	Delay *int `json:"delay,omitempty"`
	// Estimation uncertainty. This value is set when there is a directly matching GTFS-RT StopTimeUpdate for this stop and passed through as-is. See https://gtfs.org/realtime/reference/#message-stoptimeevent
	Uncertainty *int `json:"uncertainty,omitempty"`
}

type StopTimeFilter struct {
	// Search for trips scheduled on the specified calendar date
	Date *tt.Date `json:"date,omitempty"`
	// Search for trips scheduled on the specified relative date
	RelativeDate *RelativeDate `json:"relative_date,omitempty"`
	// Search for trips scheduled on the specified GTFS calendar service date
	ServiceDate *tt.Date `json:"service_date,omitempty"`
	// Use the feed version fallback week for dates outside the normal service window for that feed version
	UseServiceWindow *bool `json:"use_service_window,omitempty"`
	// Search for stop times with departure times later than the specified time, in seconds since midnight
	StartTime *int `json:"start_time,omitempty"`
	// Search for stop times with arrival times before the specified time, in seconds since midnight
	EndTime *int `json:"end_time,omitempty"`
	// Search for stop times with departure times later than the specified time, in local time HH:MM:SS
	Start *tt.Seconds `json:"start,omitempty"`
	// Search for stop times with arrival times before the specified time, in local time HH:MM:SS
	End *tt.Seconds `json:"end,omitempty"`
	// Search for stop times with departures within the specified number of seconds (in local time)
	Next *int `json:"next,omitempty"`
	// Search for stop times with service by routes with the specified route OnestopIDs
	RouteOnestopIds []string `json:"route_onestop_ids,omitempty"`
	// Include previously used route OnestopIDs that match the same (feed,route_id)
	AllowPreviousRouteOnestopIds *bool `json:"allow_previous_route_onestop_ids,omitempty"`
	// Exclude the first stop_time in a trip
	ExcludeFirst *bool `json:"exclude_first,omitempty"`
	// Exclude the last stop_time in a trip
	ExcludeLast *bool `json:"exclude_last,omitempty"`
}

type Trip struct {
	RTTripID string // internal: for ADDED trips
	gtfs.Trip
}

type TripFilter struct {
	// Search for trips scheduled on the specified GTFS calendar service date
	ServiceDate *tt.Date `json:"service_date,omitempty"`
	// Search for trips scheduled on the specified relative date
	RelativeDate *RelativeDate `json:"relative_date,omitempty"`
	// Use the feed version fallback week for dates outside the normal service window for that feed version
	UseServiceWindow *bool `json:"use_service_window,omitempty"`
	// Search for trips with this GTFS trip_id
	TripID *string `json:"trip_id,omitempty"`
	// Search for trips with this stop pattern ID
	StopPatternID *int `json:"stop_pattern_id,omitempty"`
	// Search for trips with these license details
	License *LicenseFilter `json:"license,omitempty"`
	// Search for trips associated with these route integer IDs. Deprecated.
	RouteIds []int `json:"route_ids,omitempty"`
	// Search for trips associated with these route OnestopIDs
	RouteOnestopIds []string `json:"route_onestop_ids,omitempty"`
	// Search for trips with this feed version SHA1 hash
	FeedVersionSha1 *string `json:"feed_version_sha1,omitempty"`
	// Search for trips with this feed OnestopID
	FeedOnestopID *string `json:"feed_onestop_id,omitempty"`
}

type TripStopTimeFilter struct {
	// Search for stop times with departure times later than the specified time, in local time HH:MM:SS
	Start *tt.Seconds `json:"start,omitempty"`
	// Search for stop times with arrival times before the specified time, in local time HH:MM:SS
	End *tt.Seconds `json:"end,omitempty"`
}

type ValidationRealtimeResult struct {
	// Source URL
	URL string `json:"url"`
	// JSON representation of GTFS-RT data
	JSON tt.Map `json:"json"`
}

type ValidationReport struct {
	// Internal integer ID
	ID int `json:"id"`
	// Time the report was generated, in UTC
	ReportedAt *time.Time `json:"reported_at,omitempty"`
	// Time the reported was generated, in feed local time
	ReportedAtLocal *time.Time `json:"reported_at_local,omitempty"`
	// Time the report was generated, local timezone
	ReportedAtLocalTimezone *string `json:"reported_at_local_timezone,omitempty"`
	// Validation completed successfully
	Success bool `json:"success"`
	// Exception log if feed failed to validate
	FailureReason *string `json:"failure_reason,omitempty"`
	// The report includes GTFS static data
	IncludesStatic *bool `json:"includes_static,omitempty"`
	// The report includes GTFS-RT data
	IncludesRt *bool `json:"includes_rt,omitempty"`
	// Name of validator used
	Validator *string `json:"validator,omitempty"`
	// Version of validator used
	ValidatorVersion *string `json:"validator_version,omitempty"`
	// Validation errors, grouped by filename, if present
	Errors []*ValidationReportErrorGroup `json:"errors"`
	// Validation warnings, grouped by filename, if present
	Warnings []*ValidationReportErrorGroup `json:"warnings"`
	// Details about the validated feed
	Details       *ValidationReportDetails `json:"details,omitempty"`
	FeedVersionID int                      `json:"-"`
}

type ValidationReportDetails struct {
	// SHA1 hash of the validated feed
	Sha1 string `json:"sha1"`
	// Calculated earliest calendar date in service schedule
	EarliestCalendarDate *tt.Date `json:"earliest_calendar_date,omitempty"`
	// Calculated latest calendar date in service schedule
	LatestCalendarDate *tt.Date `json:"latest_calendar_date,omitempty"`
	// Details for each file contained in the feed
	Files []*FeedVersionFileInfo `json:"files"`
	// Calculated service levels for feed
	ServiceLevels []*FeedVersionServiceLevel `json:"service_levels"`
	// Selected agencies contained in feed
	Agencies []*Agency `json:"agencies"`
	// Selected routes contained in feed
	Routes []*Route `json:"routes"`
	// Selected stops contained in feed
	Stops []*Stop `json:"stops"`
	// Feed info data contained in feed
	FeedInfos []*FeedInfo `json:"feed_infos"`
	// Detailed information about GTFS-RT sources used in validation
	Realtime []*ValidationRealtimeResult `json:"realtime,omitempty"`
}

type ValidationReportError struct {
	// Source filename
	Filename string `json:"filename"`
	// Error type
	ErrorType string `json:"error_type"`
	// Error code (for GTFS-RT)
	ErrorCode string `json:"error_code"`
	// Key for this error group
	GroupKey string `json:"group_key"`
	// Affected entity ID
	EntityID string `json:"entity_id"`
	// Affected entity field
	Field string `json:"field"`
	// Affected entity line number (for static)
	Line int `json:"line"`
	// Value of affected field
	Value string `json:"value"`
	// Error message describing problem
	Message string `json:"message"`
	// Entity geometry, if available
	Geometry *tt.Geometry `json:"geometry,omitempty"`
	// JSON representation of entity, if available
	EntityJSON                   tt.Map `json:"entity_json"`
	ID                           int    `json:"-"`
	ValidationReportErrorGroupID int    `json:"-"`
}

type ValidationReportErrorGroup struct {
	// Filename for error group
	Filename string `json:"filename"`
	// Error type
	ErrorType string `json:"error_type"`
	// Error code (for GTFS-RT)
	ErrorCode string `json:"error_code"`
	// Key for this error group
	GroupKey string `json:"group_key"`
	// Affected entity field for this error group
	Field string `json:"field"`
	// Number of affected entities for this error group
	Count int `json:"count"`
	// Examples of this error
	Errors             []*ValidationReportError `json:"errors"`
	ID                 int                      `json:"-"`
	ValidationReportID int                      `json:"-"`
}

type ValidationReportFilter struct {
	// Search for validation reports with the following integer IDs
	ReportIds []int `json:"report_ids,omitempty"`
	// Search for successful validation reports
	Success *bool `json:"success,omitempty"`
	// Search for validation reports generated by the specified validator
	Validator *string `json:"validator,omitempty"`
	// Search for validation reports generated using the specified validator version
	ValidatorVersion *string `json:"validator_version,omitempty"`
	// Search for validation reports that include/exclude GTFS-RT data
	IncludesRt *bool `json:"includes_rt,omitempty"`
	// Search for validation reports that include/exclude GTFS static data
	IncludesStatic *bool `json:"includes_static,omitempty"`
}

type VehiclePosition struct {
	// GTFS-RT VehiclePosition vehicle. See https://gtfs.org/realtime/reference/#message-vehicledescriptor
	Vehicle *RTVehicleDescriptor `json:"vehicle,omitempty"`
	// GTFS-RT VehiclePosition current vehicle position
	Position *tt.Point `json:"position,omitempty"`
	// GTFS-RT VehiclePosition current stop sequence in trip
	CurrentStopSequence *int `json:"current_stop_sequence,omitempty"`
	// GTFS-RT VehiclePosition current stop in trip
	StopID *Stop `json:"stop_id,omitempty"`
	// GTFS-RT VehiclePosition current status string
	CurrentStatus *string `json:"current_status,omitempty"`
	// GTFS-RT VehiclePosition timestamp
	Timestamp *time.Time `json:"timestamp,omitempty"`
	// GTFS-RT VehiclePosition congestion level estimate
	CongestionLevel *string `json:"congestion_level,omitempty"`
}

type Waypoint struct {
	Lon  float64       `json:"lon"`
	Lat  float64       `json:"lat"`
	Name *string       `json:"name,omitempty"`
	Stop *WaypointStop `json:"stop,omitempty"`
}

type WaypointDeparture struct {
	Lon           float64   `json:"lon"`
	Lat           float64   `json:"lat"`
	Departure     time.Time `json:"departure"`
	StopID        string    `json:"stop_id"`
	StopName      string    `json:"stop_name"`
	StopCode      string    `json:"stop_code"`
	StopOnestopID string    `json:"stop_onestop_id"`
	StopIndex     *int      `json:"stop_index,omitempty"`
	StopSequence  *int      `json:"stop_sequence,omitempty"`
}

type WaypointInput struct {
	Lon  float64 `json:"lon"`
	Lat  float64 `json:"lat"`
	Name *string `json:"name,omitempty"`
}

type WaypointStop struct {
	Lon           float64   `json:"lon"`
	Lat           float64   `json:"lat"`
	Departure     time.Time `json:"departure"`
	StopID        string    `json:"stop_id"`
	StopName      string    `json:"stop_name"`
	StopCode      string    `json:"stop_code"`
	StopOnestopID string    `json:"stop_onestop_id"`
}