@golemio/pid 5.9.2 → 5.9.3-dev.2497470687

package/dist/schema-definitions/jis/models/JISInfotextsPresetsModel.js

@@ -0,0 +1,41 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.JISInfotextsPresetsModel = void 0;
+const sequelize_1 = require("@golemio/core/dist/shared/sequelize");
+class JISInfotextsPresetsModel extends sequelize_1.Model {
+}
+exports.JISInfotextsPresetsModel = JISInfotextsPresetsModel;
+JISInfotextsPresetsModel.tableName = "jis_infotexts_presets";
+JISInfotextsPresetsModel.attributeModel = {
+    infotext_id: {
+        primaryKey: true,
+        type: sequelize_1.DataTypes.UUID,
+        allowNull: false,
+    },
+    route_name: {
+        primaryKey: true,
+        type: sequelize_1.DataTypes.STRING(100),
+        allowNull: false,
+    },
+    created_at: {
+        type: sequelize_1.DataTypes.DATE,
+        allowNull: false,
+    },
+    updated_at: {
+        type: sequelize_1.DataTypes.DATE,
+        allowNull: false,
+    },
+};
+JISInfotextsPresetsModel.jsonSchema = {
+    type: "array",
+    items: {
+        type: "object",
+        properties: {
+            infotext_id: { type: "string" },
+            route_name: { type: "string" },
+        },
+        additionalProperties: false,
+        required: ["infotext_id", "route_name"],
+    },
+};
+//# sourceMappingURL=JISInfotextsPresetsModel.js.map

package/dist/schema-definitions/jis/models/JISInfotextsPresetsModel.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"JISInfotextsPresetsModel.js","sourceRoot":"","sources":["../../../../src/schema-definitions/jis/models/JISInfotextsPresetsModel.ts"],"names":[],"mappings":";;;AACA,mEAO6C;AAG7C,MAAa,wBACT,SAAQ,iBAAmG;;AAD/G,4DA4CC;AAxCiB,kCAAS,GAAG,uBAAuB,CAAC;AAOpC,uCAAc,GAA8C;IACtE,WAAW,EAAE;QACT,UAAU,EAAE,IAAI;QAChB,IAAI,EAAE,qBAAS,CAAC,IAAI;QACpB,SAAS,EAAE,KAAK;KACnB;IACD,UAAU,EAAE;QACR,UAAU,EAAE,IAAI;QAChB,IAAI,EAAE,qBAAS,CAAC,MAAM,CAAC,GAAG,CAAC;QAC3B,SAAS,EAAE,KAAK;KACnB;IACD,UAAU,EAAE;QACR,IAAI,EAAE,qBAAS,CAAC,IAAI;QACpB,SAAS,EAAE,KAAK;KACnB;IACD,UAAU,EAAE;QACR,IAAI,EAAE,qBAAS,CAAC,IAAI;QACpB,SAAS,EAAE,KAAK;KACnB;CACJ,CAAC;AAEY,mCAAU,GAA2C;IAC/D,IAAI,EAAE,OAAO;IACb,KAAK,EAAE;QACH,IAAI,EAAE,QAAQ;QACd,UAAU,EAAE;YACR,WAAW,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE;YAC/B,UAAU,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE;SACjC;QACD,oBAAoB,EAAE,KAAK;QAC3B,QAAQ,EAAE,CAAC,aAAa,EAAE,YAAY,CAAC;KAC1C;CACJ,CAAC"}

package/dist/schema-definitions/jis/models/interfaces/IJISInfotextsPresets.d.ts

@@ -0,0 +1,4 @@
+export interface IJISInfotextsPresets {
+    infotext_id: string;
+    route_name: string;
+}

package/dist/schema-definitions/jis/models/interfaces/IJISInfotextsPresets.js

@@ -0,0 +1,3 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+//# sourceMappingURL=IJISInfotextsPresets.js.map

package/dist/schema-definitions/jis/models/interfaces/IJISInfotextsPresets.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"IJISInfotextsPresets.js","sourceRoot":"","sources":["../../../../../src/schema-definitions/jis/models/interfaces/IJISInfotextsPresets.ts"],"names":[],"mappings":""}

package/dist/schema-definitions/jis/models/interfaces/index.d.ts

@@ -1,5 +1,6 @@
 export * from "./IJISEvent";
 export * from "./IJISEventsRopidGTFSRoutes";
 export * from "./IJISInfotext";
+export * from "./IJISInfotextsPresets";
 export * from "./IJISInfotextsRopidGTFSStops";
 export * from "./IJISTranslationText";

package/dist/schema-definitions/jis/models/interfaces/index.js

@@ -17,6 +17,7 @@ Object.defineProperty(exports, "__esModule", { value: true });
 __exportStar(require("./IJISEvent"), exports);
 __exportStar(require("./IJISEventsRopidGTFSRoutes"), exports);
 __exportStar(require("./IJISInfotext"), exports);
+__exportStar(require("./IJISInfotextsPresets"), exports);
 __exportStar(require("./IJISInfotextsRopidGTFSStops"), exports);
 __exportStar(require("./IJISTranslationText"), exports);
 //# sourceMappingURL=index.js.map

package/dist/schema-definitions/jis/models/interfaces/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../../src/schema-definitions/jis/models/interfaces/index.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;AAAA,8CAA4B;AAC5B,8DAA4C;AAC5C,iDAA+B;AAC/B,gEAA8C;AAC9C,wDAAsC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../../src/schema-definitions/jis/models/interfaces/index.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;AAAA,8CAA4B;AAC5B,8DAA4C;AAC5C,iDAA+B;AAC/B,yDAAuC;AACvC,gEAA8C;AAC9C,wDAAsC"}

package/docs/asyncapi.yaml

@@ -1959,19 +1959,31 @@ components:
                 description: Localized descriptions of the infotext
               informed_entity:
                 type: object
+                nullable: true
                 properties:
                   stops:
                     type: array
+                    nullable: true
                     items:
                       type: object
                       properties:
-                        stop_id:
+                        id:
                           type: string
                           description: Unique identifier for the stop
                       required:
-                        - stop_id
-                required:
-                  - stops
+                        - id
+                  presets:
+                    type: array
+                    nullable: true
+                    description: Departure presets connected to this infotext (optional, migration period)
+                    items:
+                      type: object
+                      properties:
+                        route_name:
+                          type: string
+                          description: Route name of the departure preset (ropid_departures_presets.route_name)
+                      required:
+                        - route_name
               created_timestamp:
                 type: string
                 format: date-time
@@ -1986,6 +1998,5 @@ components:
               - display_type
               - active_period
               - description_text
-              - informed_entity
               - created_timestamp
               - last_modified_timestamp

package/docs/openapi-input.yaml

@@ -786,9 +786,11 @@ components:
                     description: Localized descriptions of the infotext
                   informed_entity:
                     type: object
+                    nullable: true
                     properties:
                       stops:
                         type: array
+                        nullable: true
                         items:
                           type: object
                           properties:
@@ -797,8 +799,18 @@ components:
                               description: Unique identifier for the stop
                           required:
                             - id
-                    required:
-                      - stops
+                      presets:
+                        type: array
+                        nullable: true
+                        description: Departure presets connected to this infotext (optional, migration period)
+                        items:
+                          type: object
+                          properties:
+                            route_name:
+                              type: string
+                              description: Route name of the departure preset (ropid_departures_presets.route_name)
+                          required:
+                            - route_name
                   created_timestamp:
                     type: string
                     format: date-time
@@ -813,7 +825,6 @@ components:
                   - display_type
                   - active_period
                   - description_text
-                  - informed_entity
                   - created_timestamp
                   - last_modified_timestamp
     examples:

package/docs/openapi-output.yaml

@@ -887,77 +887,16 @@ paths:
             tags:
                 - 🚏 PID Departure Boards (v2)
             parameters:
-                - name: ids
-                  in: query
-                  description: Get result by GTFS stop_id. Can be used to retrive individual stops and to separate departures of Prague and intercity routes, even if they depart from the same physical stop. A list of GTFS stops can be found in `stops.txt` file of the [GTFS feed](https://opendata.praha.eu/datasets/https%3A%2F%2Fapi.opendata.praha.eu%2Flod%2Fcatalog%2F9a6a1d8e-45b9-41de-b9ae-0bcec7126876).
-                  required: false
-                  schema:
-                      type: string
-                      example: "U458Z101P"
-                - name: aswIds
-                  in: query
-                  description: "Get result by ASW ID. First part of the number represents the whole node. Usually it groups the stops of the same name or all stops associated with a metro station. Also returns related train stations in the node. The second part of the number is optional and represents individual stops in the node. Use `_` instead of `/` as a separator or encode the slash sign with `%2F`. A list of ASW IDs can be found in [Prague Open data](https://opendata.praha.eu/datasets/https%3A%2F%2Fapi.opendata.praha.eu%2Flod%2Fcatalog%2F6ac8381f-ea19-4ea9-8949-92076809dc5a). ⚠️ Note: combination with `includeMetroTrains` is currently not supported, see [issue pid#222](https://gitlab.com/operator-ict/golemio/code/modules/pid/-/issues/222)."
-                  required: false
-                  schema:
-                      type: string
-                      example: "458_101"
-                - name: cisIds
-                  in: query
-                  description: Get result by CIS ID. A list of CIS IDs can be found in [Prague Open data](https://opendata.praha.eu/datasets/https%3A%2F%2Fapi.opendata.praha.eu%2Flod%2Fcatalog%2F6ac8381f-ea19-4ea9-8949-92076809dc5a).
-                  required: false
-                  schema:
-                      type: number
-                      example: 28004
-                - name: names
-                  in: query
-                  description: Get results by exact name of stop (case and whitespace sensitive). May return stops of the same name from different towns. Using `names` in combination with other identifiers will return an intersection of stops with `names` and stops of ASW, CIS or GTFS identifiers in the same node. Use this feature to filter out a subset of stops of the same name while guaranteeing them to be from the desired node only.
-                  required: false
-                  schema:
-                      type: string
-                      example: "Smíchovské nádraží"
-                - name: minutesBefore
-                  in: query
-                  description: Set the start of interval from which to retrieve departures. Positive numbers are set in past relative to the time of request or `timeFrom` timestamp, negative numbers set the start in the future. Use to compensate for walking distance to a stop. Default is set to 0. Maximum value is 30 because of implemented data retention. Minimum value is -4320 (0 - 3 days GTFS calendar maximum).
-                  required: false
-                  schema:
-                      type: number
-                      example: 10
-                - name: minutesAfter
-                  in: query
-                  description: Set the end of interval from which to retrieve departures. Positive numbers are set in future relative to the time of request or `timeFrom` timestamp, negative are in the past. The sum of minutesBefore and minutesAfter must be larger than zero. Default is set to 180. Maximum value is 4320 (GTFS calendar maximum). Minimum value is -4350 (0 - 3 days GTFS calendar maximum - 30 minutes data retention).
-                  required: false
-                  schema:
-                      type: number
-                      example: 60
-                - name: timeFrom
-                  in: query
-                  description: Set initial timestamp for time interval given by `minutesBefore` and `minutesAfter`. Use to simulate query time different from now. Use ISO 8601 time format and URL encoded symbols - `%3A` for `:`, `%2B` for `.`, `%2F` for `+`. Time zone is set according to the `preferredTimezone` parameter. Applicable range is -6 hours +2 days from now.
-                  required: false
-                  schema:
-                      type: string
-                      example: "2021-01-21T06:00:00"
-                - name: includeMetroTrains
-                  in: query
-                  description: "When selecting a node by `name`, when `true`, will include metro and/or train stops that are a member of the same node. I.e. when querying _Na Knížecí_, setting this to `true` will add the metro station _Anděl_ to results as well because both have the same ASW node number 1040. ⚠️ Note: combination with `aswIds` is currently not supported, see [issue pid#222](https://gitlab.com/operator-ict/golemio/code/modules/pid/-/issues/222)."
-                  required: false
-                  schema:
-                      type: boolean
-                      example: true
-                - name: airCondition
-                  in: query
-                  description: Enrich departures with vehicle air condition information. Setting to `false` will force all items to be `null`. Useful for disabling the indication of air condition during cold season.
-                  required: false
-                  schema:
-                      type: boolean
-                      example: true
-                      default: true
-                - name: preferredTimezone
-                  in: query
-                  description: Preferred timezone offset as defined in the IANA Time zone database in the form of Country/City (use an URL encoded slash sign `%2F` or use an underscore _ symbol), default is Europe/Prague
-                  required: false
-                  schema:
-                      type: string
-                      example: "Europe_Prague"
+                - $ref: "#/components/parameters/DepartureBoardsIds"
+                - $ref: "#/components/parameters/DepartureBoardsAswIds"
+                - $ref: "#/components/parameters/DepartureBoardsCisIds"
+                - $ref: "#/components/parameters/DepartureBoardsNames"
+                - $ref: "#/components/parameters/DepartureBoardsMinutesBefore"
+                - $ref: "#/components/parameters/DepartureBoardsMinutesAfter"
+                - $ref: "#/components/parameters/DepartureBoardsTimeFrom"
+                - $ref: "#/components/parameters/DepartureBoardsIncludeMetroTrains"
+                - $ref: "#/components/parameters/DepartureBoardsAirCondition"
+                - $ref: "#/components/parameters/DepartureBoardsPreferredTimezone"
                 - name: mode
                   in: query
                   description: >-
@@ -966,72 +905,13 @@ paths:
                   schema:
                       type: string
                       example: "departures"
-                - name: order
-                  in: query
-                  description: >-
-                      Valid entries: `real` (default), `timetable`. Order results by predicted time including trip delay or by timetable time.
-                  required: false
-                  schema:
-                      type: string
-                      example: "real"
-                - name: filter
-                  in: query
-                  description: >-
-                      Valid entries: `none` (default), `routeOnce`, `routeOnceFill`, `routeHeadingOnce`, `routeHeadingOnceFill`, `routeHeadingOnceNoGap`, `routeHeadingOnceNoGapFill`. Defines how should be the list of departures returned. `none` returns all departures within the time and item limit. `routeOnce` returns exactly one occurence of departure for each `route_id`. Works best when querying a single stop. `routeHeadingOnce` returns one entry for each pair of `route_id` and `trip_headsign`, i.e. returns departures for routes that have multiple end stops. Works well when quering one or more stops in a node. `...NoGap` will ensure that departures with a distinct trip headsign will not be displayed if they should arrive too far in the future. `...Fill` attributes will behave the same as their namesakes but afterwards will fill the rest of request up to `total/limit` with further departures. Use to have every line/destination represented and have the display filled with departures at the same time.
-                  required: false
-                  schema:
-                      type: string
-                      example: "routeOnce"
-                - name: skip
-                  in: query
-                  description: |
-                      Filters out trips matching the given states.
-                      Multiple filters can be applied using array syntax, e.g., `&skip[]=canceled&skip[]=atStop`.
-                      Using both `untracked` and `missing` will exclude all untracked vehicles, as missing vehicles are a subset of untracked vehicles.
-                      We recommend using `missing` instead of `untracked`, as skipping all untracked vehicles may result in departures not appearing in the API response until the last few minutes before departure, especially for departure boards near the starting station/stop.
-                  required: false
-                  schema:
-                      type: string
-                      example: "canceled"
-                      enum:
-                        - canceled
-                        - atStop
-                        - untracked
-                        - missing
-                - name: limit
-                  in: query
-                  description: Limits the number of items in response. The maximum is 1000 (default value is 20).
-                  required: false
-                  schema:
-                      type: number
-                      format: int64
-                      example: 0
-                - name: total
-                  in: query
-                  description: Sets the number of items that will be queried. Use in conjunction with `offset`. Up to `total - offset`, but not more than `limit` items will be then returned. If unset, is same as `limit`. The maximum is 1000 (default value is 20).
-                  required: false
-                  schema:
-                      type: number
-                      format: int64
-                      example: 0
-                - name: offset
-                  in: query
-                  description: Number of the initial departures that are skipped. Useful for multi-page displays.
-                  required: false
-                  schema:
-                      type: number
-                      format: int64
-                      example: 0
-                - name: appendHeadsignsLimit
-                  in: query
-                  description: >-
-                      Number of stops before route switch at which headsign is enriched with continuation info.
-                      When set and a departure has route-switch data, headsign becomes `<headsign> → <next_route> <next_headsign>`.
-                  required: false
-                  schema:
-                      type: integer
-                      minimum: 0
-                      example: 3
+                - $ref: "#/components/parameters/DepartureBoardsOrder"
+                - $ref: "#/components/parameters/DepartureBoardsFilter"
+                - $ref: "#/components/parameters/DepartureBoardsSkip"
+                - $ref: "#/components/parameters/DepartureBoardsLimit"
+                - $ref: "#/components/parameters/DepartureBoardsTotal"
+                - $ref: "#/components/parameters/DepartureBoardsOffset"
+                - $ref: "#/components/parameters/DepartureBoardsAppendHeadsignsLimit"
 
             responses:
                 "200":
@@ -1056,6 +936,89 @@ paths:
                 "404":
                     description: Not found
 
+    /v2/pid/departureboards/xml:
+        get:
+            summary: "[DEPRECATED] GET Departure Boards (legacy MPVnet XML)"
+            description: |
+                **DEPRECATED.** Legacy MPVnet XML for ROPID information panels that cannot consume JSON.
+                For new integrations use `/v2/pid/departureboards` (JSON).
+
+                UTF-8, no `<?xml ...?>` prologue. Only `mode=departures` is supported (others return 400).
+                Same query parameters and identifier rules as the JSON endpoint
+                (`ids` / `cisIds` / `aswIds` / `names`, at least one required, max 100 stops).
+
+                See the example response below for the exact attribute set.
+            deprecated: true
+            tags:
+                - 🚏 PID Departure Boards (v2)
+            parameters:
+                - $ref: "#/components/parameters/DepartureBoardsIds"
+                - $ref: "#/components/parameters/DepartureBoardsAswIds"
+                - $ref: "#/components/parameters/DepartureBoardsCisIds"
+                - $ref: "#/components/parameters/DepartureBoardsNames"
+                - $ref: "#/components/parameters/DepartureBoardsMinutesBefore"
+                - $ref: "#/components/parameters/DepartureBoardsMinutesAfter"
+                - $ref: "#/components/parameters/DepartureBoardsTimeFrom"
+                - $ref: "#/components/parameters/DepartureBoardsIncludeMetroTrains"
+                - $ref: "#/components/parameters/DepartureBoardsAirCondition"
+                - $ref: "#/components/parameters/DepartureBoardsPreferredTimezone"
+                - name: mode
+                  in: query
+                  description: >-
+                      Only `departures` is supported for this XML endpoint; other values return 400.
+                      Valid entries: `departures` (default), `arrivals`, `mixed`.
+                  required: false
+                  schema:
+                      type: string
+                      example: "departures"
+                - $ref: "#/components/parameters/DepartureBoardsOrder"
+                - $ref: "#/components/parameters/DepartureBoardsFilter"
+                - $ref: "#/components/parameters/DepartureBoardsSkip"
+                - $ref: "#/components/parameters/DepartureBoardsLimit"
+                - $ref: "#/components/parameters/DepartureBoardsTotal"
+                - $ref: "#/components/parameters/DepartureBoardsOffset"
+                - $ref: "#/components/parameters/DepartureBoardsAppendHeadsignsLimit"
+
+            responses:
+                "200":
+                    description: |
+                        Single-line MPVnet XML response. Example body
+
+                        ```xml
+                        <TBL cas="2026-03-20T15:30:00" text="Odjezdy poskytuje Golemio">
+                          <t id="458/1,458/2" zast="Smíchovské nádraží" zobraz_stan="True" stan="A,B">
+                            <o stan="A" lin="129" alias="129" spoj="" smer="Baně"
+                               odj="2026-03-20T15:31:00+01:00" sled="true" zpoz="0" np="true" nad="false" dd="3"/>
+                            <o stan="A" lin="5" alias="5" spoj="" smer="Slivenec"
+                               odj="2026-03-20T15:31:00+01:00" sled="true" zpoz="2" np="false" nad="false"
+                               pz="Plzeňka" dd="2"/>
+                            <o stan="B" lin="B" alias="B" spoj="" smer="Černý Most"
+                               odj="2026-03-20T15:32:00+01:00" sled="true" zpoz="1" np="true" nad="false"
+                               pz="Radlická" dd="1"/>
+                            <o stan="A" lin="X22" alias="X22" spoj="" smer="Nádraží Hostivař"
+                               odj="2026-03-20T15:33:00+01:00" sled="false" zpoz="0" np="false" nad="true"
+                               info="nejede" dd="7"/>
+                            <i stan="A">Výluka tramvají na Smíchově.</i>
+                          </t>
+                        </TBL>
+                        ```
+                    headers:
+                        Cache-Control:
+                            description: Cache control directive for caching proxies
+                            schema:
+                                type: string
+                                example: public, s-maxage=5, stale-while-revalidate=5
+                    content:
+                        text/xml; charset=utf-8:
+                            schema:
+                                type: string
+                "400":
+                    $ref: "#/components/responses/BadRequestError"
+                "401":
+                    $ref: "#/components/responses/UnauthorizedError"
+                "404":
+                    description: Not found
+
     /v3/pid/transferboards:
         get:
             tags:
@@ -2071,6 +2034,162 @@ components:
                             - error_status
 
 
+    parameters:
+        DepartureBoardsIds:
+            name: ids
+            in: query
+            description: Get result by GTFS stop_id. Can be used to retrive individual stops and to separate departures of Prague and intercity routes, even if they depart from the same physical stop. A list of GTFS stops can be found in `stops.txt` file of the [GTFS feed](https://opendata.praha.eu/datasets/https%3A%2F%2Fapi.opendata.praha.eu%2Flod%2Fcatalog%2F9a6a1d8e-45b9-41de-b9ae-0bcec7126876).
+            required: false
+            schema:
+                type: string
+                example: "U458Z101P"
+        DepartureBoardsAswIds:
+            name: aswIds
+            in: query
+            description: "Get result by ASW ID. First part of the number represents the whole node. Usually it groups the stops of the same name or all stops associated with a metro station. Also returns related train stations in the node. The second part of the number is optional and represents individual stops in the node. Use `_` instead of `/` as a separator or encode the slash sign with `%2F`. A list of ASW IDs can be found in [Prague Open data](https://opendata.praha.eu/datasets/https%3A%2F%2Fapi.opendata.praha.eu%2Flod%2Fcatalog%2F6ac8381f-ea19-4ea9-8949-92076809dc5a). ⚠️ Note: combination with `includeMetroTrains` is currently not supported, see [issue pid#222](https://gitlab.com/operator-ict/golemio/code/modules/pid/-/issues/222)."
+            required: false
+            schema:
+                type: string
+                example: "458_101"
+        DepartureBoardsCisIds:
+            name: cisIds
+            in: query
+            description: Get result by CIS ID. A list of CIS IDs can be found in [Prague Open data](https://opendata.praha.eu/datasets/https%3A%2F%2Fapi.opendata.praha.eu%2Flod%2Fcatalog%2F6ac8381f-ea19-4ea9-8949-92076809dc5a).
+            required: false
+            schema:
+                type: number
+                example: 28004
+        DepartureBoardsNames:
+            name: names
+            in: query
+            description: Get results by exact name of stop (case and whitespace sensitive). May return stops of the same name from different towns. Using `names` in combination with other identifiers will return an intersection of stops with `names` and stops of ASW, CIS or GTFS identifiers in the same node. Use this feature to filter out a subset of stops of the same name while guaranteeing them to be from the desired node only.
+            required: false
+            schema:
+                type: string
+                example: "Smíchovské nádraží"
+        DepartureBoardsMinutesBefore:
+            name: minutesBefore
+            in: query
+            description: Set the start of interval from which to retrieve departures. Positive numbers are set in past relative to the time of request or `timeFrom` timestamp, negative numbers set the start in the future. Use to compensate for walking distance to a stop. Default is set to 0. Maximum value is 30 because of implemented data retention. Minimum value is -4320 (0 - 3 days GTFS calendar maximum).
+            required: false
+            schema:
+                type: number
+                example: 10
+        DepartureBoardsMinutesAfter:
+            name: minutesAfter
+            in: query
+            description: Set the end of interval from which to retrieve departures. Positive numbers are set in future relative to the time of request or `timeFrom` timestamp, negative are in the past. The sum of minutesBefore and minutesAfter must be larger than zero. Default is set to 180. Maximum value is 4320 (GTFS calendar maximum). Minimum value is -4350 (0 - 3 days GTFS calendar maximum - 30 minutes data retention).
+            required: false
+            schema:
+                type: number
+                example: 60
+        DepartureBoardsTimeFrom:
+            name: timeFrom
+            in: query
+            description: Set initial timestamp for time interval given by `minutesBefore` and `minutesAfter`. Use to simulate query time different from now. Use ISO 8601 time format and URL encoded symbols - `%3A` for `:`, `%2B` for `.`, `%2F` for `+`. Time zone is set according to the `preferredTimezone` parameter. Applicable range is -6 hours +2 days from now.
+            required: false
+            schema:
+                type: string
+                example: "2021-01-21T06:00:00"
+        DepartureBoardsIncludeMetroTrains:
+            name: includeMetroTrains
+            in: query
+            description: "When selecting a node by `name`, when `true`, will include metro and/or train stops that are a member of the same node. I.e. when querying _Na Knížecí_, setting this to `true` will add the metro station _Anděl_ to results as well because both have the same ASW node number 1040. ⚠️ Note: combination with `aswIds` is currently not supported, see [issue pid#222](https://gitlab.com/operator-ict/golemio/code/modules/pid/-/issues/222)."
+            required: false
+            schema:
+                type: boolean
+                example: true
+        DepartureBoardsAirCondition:
+            name: airCondition
+            in: query
+            description: Enrich departures with vehicle air condition information. Setting to `false` will force all items to be `null`. Useful for disabling the indication of air condition during cold season.
+            required: false
+            schema:
+                type: boolean
+                example: true
+                default: true
+        DepartureBoardsPreferredTimezone:
+            name: preferredTimezone
+            in: query
+            description: Preferred timezone offset as defined in the IANA Time zone database in the form of Country/City (use an URL encoded slash sign `%2F` or use an underscore _ symbol), default is Europe/Prague
+            required: false
+            schema:
+                type: string
+                example: "Europe_Prague"
+        DepartureBoardsOrder:
+            name: order
+            in: query
+            description: >-
+                Valid entries: `real` (default), `timetable`. Order results by predicted time including trip delay or by timetable time.
+            required: false
+            schema:
+                type: string
+                example: "real"
+        DepartureBoardsFilter:
+            name: filter
+            in: query
+            description: >-
+                Valid entries: `none` (default), `routeOnce`, `routeOnceFill`, `routeHeadingOnce`, `routeHeadingOnceFill`, `routeHeadingOnceNoGap`, `routeHeadingOnceNoGapFill`. Defines how should be the list of departures returned. `none` returns all departures within the time and item limit. `routeOnce` returns exactly one occurence of departure for each `route_id`. Works best when querying a single stop. `routeHeadingOnce` returns one entry for each pair of `route_id` and `trip_headsign`, i.e. returns departures for routes that have multiple end stops. Works well when quering one or more stops in a node. `...NoGap` will ensure that departures with a distinct trip headsign will not be displayed if they should arrive too far in the future. `...Fill` attributes will behave the same as their namesakes but afterwards will fill the rest of request up to `total/limit` with further departures. Use to have every line/destination represented and have the display filled with departures at the same time.
+            required: false
+            schema:
+                type: string
+                example: "routeOnce"
+        DepartureBoardsSkip:
+            name: skip
+            in: query
+            description: |
+                Filters out trips matching the given states.
+                Multiple filters can be applied using array syntax, e.g., `&skip[]=canceled&skip[]=atStop`.
+                Using both `untracked` and `missing` will exclude all untracked vehicles, as missing vehicles are a subset of untracked vehicles.
+                We recommend using `missing` instead of `untracked`, as skipping all untracked vehicles may result in departures not appearing in the API response until the last few minutes before departure, especially for departure boards near the starting station/stop.
+            required: false
+            schema:
+                type: string
+                example: "canceled"
+                enum:
+                  - canceled
+                  - atStop
+                  - untracked
+                  - missing
+        DepartureBoardsLimit:
+            name: limit
+            in: query
+            description: Limits the number of items in response. The maximum is 1000 (default value is 20).
+            required: false
+            schema:
+                type: number
+                format: int64
+                example: 0
+        DepartureBoardsTotal:
+            name: total
+            in: query
+            description: Sets the number of items that will be queried. Use in conjunction with `offset`. Up to `total - offset`, but not more than `limit` items will be then returned. If unset, is same as `limit`. The maximum is 1000 (default value is 20).
+            required: false
+            schema:
+                type: number
+                format: int64
+                example: 0
+        DepartureBoardsOffset:
+            name: offset
+            in: query
+            description: Number of the initial departures that are skipped. Useful for multi-page displays.
+            required: false
+            schema:
+                type: number
+                format: int64
+                example: 0
+        DepartureBoardsAppendHeadsignsLimit:
+            name: appendHeadsignsLimit
+            in: query
+            description: >-
+                Number of stops before route switch at which headsign is enriched with continuation info.
+                When set and a departure has route-switch data, headsign becomes `&lt;headsign&gt; → &lt;next_route&gt; &lt;next_headsign&gt;`.
+            required: false
+            schema:
+                type: integer
+                minimum: 0
+                example: 3
+
     schemas:
         RepeatOnlyTimes:
             title: Repeat Only Times