@golemio/parkings 1.6.1 → 1.6.2-dev.1073199149

package/docs/openapi-output.yaml

@@ -20,6 +20,8 @@ tags:
       description: <img src="https://img.shields.io/badge/opendata-available-green" alt="golemioapi-opendata-badge" /> 💡 Parking Lots
     - name: 🅿️ Parking (v2)
       description: <img src="https://img.shields.io/badge/opendata-available-green" alt="golemioapi-opendata-badge" /> 💡 Parking, parking zones, tarifs, measurements.
+    - name: 🅿️ Parking (v3)
+      description: 💡 Parking, tarifs, machines.
 paths:
     /v1/parkings:
         get:
@@ -216,26 +218,18 @@ paths:
                   schema:
                       type: number
                       example: 0
-                - name: timeCondition
+                - name: minutesBefore
                   in: query
-                  required: true
-                  style: form
-                  explode: true
                   schema:
-                      type: object
-                      properties:
-                          minutesBefore:
-                              type: number
-                              example: 10
-                              description: Lists items updated since given number of minutes
-                          updatedSince:
-                              type: string
-                              example: 2022-07-25
-                              description: Lists items updated after given date (ISO format expected)
-                      additionalProperties: false
-                      oneOf:
-                          - required: [ minutesBefore ]
-                          - required: [ updatedSince ]
+                    type: integer                
+                    example: 10                
+                  description: 'Filter by time conditions based on last data update. By maximal minutes before last update.'
+                - name: updatedSince
+                  in: query
+                  schema:
+                    type: string
+                    example: '2022-07-25T00:00:00.000Z'
+                  description: 'Filter by time conditions based on last data update. Date has to be in ISO8601 format. Cannot be used together with minutsBefore.'
             responses:
                 200:
                     description: OK
@@ -333,26 +327,18 @@ paths:
                     schema:
                         type: number
                         example: 0
-                -   name: timeCondition
-                    in: query
-                    required: true
-                    style: form
-                    explode: true
-                    schema:
-                        type: object
-                        properties:
-                            minutesBefore:
-                                type: number
-                                example: 10
-                                description: Lists items updated since given number of minutes
-                            updatedSince:
-                                type: string
-                                example: 2022-07-25
-                                description: Lists items updated after given date (ISO format expected)
-                        additionalProperties: false
-                        oneOf:
-                            - required: [ minutesBefore ]
-                            - required: [ updatedSince ]
+                - name: minutesBefore
+                  in: query
+                  schema:
+                    type: integer                
+                    example: 10                
+                  description: 'Filter by time conditions based on last data update. By maximal minutes before last update.'
+                - name: updatedSince
+                  in: query
+                  schema:
+                    type: string
+                    example: '2022-07-25T00:00:00.000Z'
+                  description: 'Filter by time conditions based on last data update. Date has to be in ISO8601 format. Cannot be used together with minutsBefore.'
                 -   name: zoneType
                     in: query
                     description: Filter by parking zone. Use with square brackets `zoneType[]`,
@@ -468,26 +454,18 @@ paths:
                     schema:
                         type: number
                         example: 0
-                -   name: timeCondition
-                    in: query
-                    required: true
-                    style: form
-                    explode: true
-                    schema:
-                        type: object
-                        properties:
-                            minutesBefore:
-                                type: number
-                                example: 10
-                                description: Lists items updated since given number of minutes
-                            updatedSince:
-                                type: string
-                                example: 2022-07-25
-                                description: Lists items updated after given date (ISO format expected)
-                        additionalProperties: false
-                        oneOf:
-                            - required: [ minutesBefore ]
-                            - required: [ updatedSince ]
+                - name: minutesBefore
+                  in: query
+                  schema:
+                    type: integer                
+                    example: 10                
+                  description: 'Filter by time conditions based on last data update. By maximal minutes before last update.'
+                - name: updatedSince
+                  in: query
+                  schema:
+                    type: string
+                    example: '2022-07-25T00:00:00.000Z'
+                  description: 'Filter by time conditions based on last data update. Date has to be in ISO8601 format. Cannot be used together with minutsBefore.'
             responses:
                 200:
                     description: OK
@@ -573,6 +551,314 @@ paths:
                     $ref: "#/components/responses/UnauthorizedError"
                 404:
                     description: Not found
+    /v3/parking:
+        get:
+          tags:
+            - 🅿️ Parking (v3)
+          summary: 'Get a list of parking locations with filtering options'
+          parameters:
+            - name: primarySource
+              in: query
+              schema:
+                type: array
+                items:
+                  type: string
+                  enum:
+                    - tsk_v2
+              description: 'Filter by primary source. Use with square brackets `primarySource[]`'
+            - name: primarySourceId
+              in: query
+              schema:
+                type: string
+              example: 'c66bb668-eab6-49da-bc84-002263e1dce0'
+              description: 'Filter by primary source ID'
+            - name: boundingBox
+              in: query
+              schema:
+                type: string
+              example: '50.123,14.243,50.017,14.573'
+              description: 'Filter by bounding box in format "topLeft.lat,topLeft.lon,bottomRight.lat,bottomRight.lon", polygons that fit only partialy to selected bounding box are included'
+            - name: validFrom
+              in: query
+              schema:
+                type: string
+                format: date-time
+              example: '2022-08-01T00:00:00Z'
+              description: 'Filter by valid from date'
+            - name: accessDedicatedTo
+              in: query
+              schema:
+                type: array
+                items:
+                  type: string
+                  enum:
+                    - for_all
+                    - disabled
+                    - charging
+                    - parent
+                    - delivery
+                    - customer
+                    - resident
+                    - bus
+                    - designated
+                    - truck
+                    - motorcycle
+                    - RV               
+              description: 'Experimental: Filter by access combinations to specific spaces in parking. Return only strictly matched parking by access to parking spaces'
+            - name: minutesBefore
+              in: query
+              schema:
+                type: integer                
+                example: 10                
+              description: 'Filter by time conditions based on last data update. By maximal minutes before last update.'
+            - name: updatedSince
+              in: query
+              schema:
+                type: string
+                example: '2022-07-25T00:00:00.000Z'
+              description: 'Filter by time conditions based on last data update. Date has to be in ISO8601 format. Cannot be used together with minutsBefore.'
+            - name: limit
+              in: query
+              schema:
+                type: integer
+                default: 1000
+                maximum: 10000
+                minimum: 0
+              description: 'Number of results to return'
+            - name: offset
+              in: query
+              schema:
+                type: integer
+                default: 0
+                minimum: 0
+              description: 'Number of results to skip for pagination'
+          responses:
+            '200':
+              description: 'Successful response'
+              content:
+                application/json; charset=utf-8:
+                    schema:
+                        type: object
+                        properties:
+                            features:
+                                type: array
+                                items:
+                                    $ref: '#/components/schemas/Parking'
+                            type:
+                                type: string
+                                example: FeatureCollection
+    /v3/parking/{id}:
+        get:
+          tags:
+            - 🅿️ Parking (v3)
+          summary: 'Get detailed information about a parking location by ID'
+          parameters:
+            - name: id
+              in: path
+              required: true
+              schema:
+                type: string
+                format: uuid
+              example: 'c66bb668-eab6-49da-bc84-002263e1dce0'
+              description: 'The UUID identifier of the parking location to retrieve'
+          responses:
+            '200':
+              description: 'Successful response'
+              content:
+                application/json:
+                  schema:
+                    $ref: '#/components/schemas/Parking'
+    /v3/parking-tariffs:
+        get:
+          tags:
+            - 🅿️ Parking (v3)
+          summary: 'Get a list of tariffs with filtering options'
+          parameters: 
+            - name: primarySource
+              in: query
+              schema:
+                type: array
+                items:
+                  type: string
+                  enum:
+                    - tsk_v2
+              example: tsk_v2
+              description: 'Filter by primary source. Use with square brackets `primarySource[]`'
+            - name: primarySourceId
+              in: query
+              schema:
+                type: string
+              example: '6c08e2f9-a884-4dce-81e3-00e3391f811a'
+              description: 'Filter by primary source ID of ChargeBand in Tariff (result show all tariffs that contains atleast one ChargeBand with the selected primary sources id and inside only ChargeBand objects that fit into that filter)'
+            - name: validFrom
+              in: query
+              schema:
+                type: string
+                format: date-time
+              example: '2022-08-01T00:00:00.000Z'
+              description: 'Filter by valid from date of ChargeBand in Tariff (result show all tariffs that contains atleast one valid ChargeBand and inside only ChargeBand objects that fit into that filter)'
+            - name: validTo
+              in: query
+              schema:
+                type: string
+                format: date-time
+              example: '2023-12-31T00:00:00.000Z'
+              description: 'Filter by valid to date of ChargeBand in Tariff (result show all tariffs that contains atleast one valid ChargeBand and inside only ChargeBand objects that fit into that filter)'
+            - name: limit
+              in: query
+              schema:
+                type: integer
+                default: 1000
+                maximum: 10000
+                minimum: 0
+              description: 'Number of results to return'
+            - name: offset
+              in: query
+              schema:
+                type: integer
+                default: 0
+                minimum: 0
+              description: 'Number of results to skip for pagination'
+          responses:
+            '200':
+              description: 'Successful response'
+              content:
+                application/json:
+                  schema:
+                    type: array
+                    items:
+                      $ref: '#/components/schemas/ParkingTariff'
+    /v3/parking-tariffs/{id}:
+        get:
+          tags:
+            - 🅿️ Parking (v3)
+          summary: 'Get a tariff by ID'
+          parameters:
+            - name: id
+              in: path
+              required: true
+              schema:
+                type: string
+                format: uuid
+              example: '0639c53f-c555-49ac-b5e0-bb3d50acf588'
+              description: 'UUID of the tariff to retrieve'
+          responses:
+            '200':
+              description: 'Successful response'
+              content:
+                application/json:
+                  schema:
+                    $ref: '#/components/schemas/ParkingTariff'
+    /v3/parking-machines:
+        get:
+          tags:
+            - 🅿️ Parking (v3)
+          summary: 'Get a list of parking machines with filtering options'
+          parameters:
+            - name: primarySource
+              in: query
+              schema:
+                type: array
+                items:
+                  type: string
+                  enum:
+                    - tsk_v2
+              example: tsk_v2
+              description: 'Filter by primary source. Use with square brackets `primarySource[]`'
+            - name: primarySourceId
+              in: query
+              schema:
+                type: string
+              example: '4521afac-66db-4680-abc5-0006837d977a'
+              description: 'Filter by primary source ID'
+            - name: type
+              in: query
+              schema:
+                type: array
+                items:
+                  type: string
+                  enum:
+                    - payment_machine
+                    - info_box
+              example: type[]=payment_machine&type[]=info_box
+              description: 'Filter by type'
+            - name: boundingBox
+              in: query
+              schema:
+                type: string
+              example: '50.123,14.243,50.017,14.573'
+              description: 'Filter by bounding box in format "topLeft.lat,topLeft.lon,bottomRight.lat,bottomRight.lon", polygons that fit only partialy to selected bounding box are included' 
+            - name: codeMask
+              in: query
+              schema:
+                type: string
+              example: '%88'
+              description: |
+                Filter by code mask using substring match and "%" wildcard (partial match). (If used directly in postman or browser, "%" needs to be encoded as "%25".
+                Examples:
+                - `query` matches substring in codes
+                - `start%` matches codes starting with "start"
+                - `%end` matches codes ending with "end"
+                - `%middle%` matches codes containing "middle" anywhere
+            - name: validFrom
+              in: query
+              schema:
+                type: string
+                format: date-time
+              example: '2023-08-01T00:00:00Z'
+              description: 'Filter by valid from date'
+            - name: limit
+              in: query
+              schema:
+                type: integer
+                default: 1000
+                maximum: 10000
+                minimum: 0
+              description: 'Number of results to return'
+            - name: offset
+              in: query
+              schema:
+                type: integer
+                default: 0
+                minimum: 0
+              description: 'Number of results to skip for pagination'
+          responses:
+            '200':
+              description: 'Successful response'
+              content:
+                application/json; charset=utf-8:
+                    schema:
+                        type: object
+                        properties:
+                            features:
+                                type: array
+                                items:
+                                    $ref: '#/components/schemas/ParkingMachine'
+                            type:
+                                type: string
+                                example: FeatureCollection
+    /v3/parking-machines/{id}:
+        get:
+          tags:
+            - 🅿️ Parking (v3)
+          summary: 'Get a parking machine by ID'
+          parameters:
+            - name: id
+              in: path
+              required: true
+              schema:
+                type: string
+                format: uuid
+              example: '4521afac-66db-4680-abc5-0006837d977a'
+              description: 'UUID of the parking machine to retrieve'
+          responses:
+            '200':
+              description: 'Successful response'
+              content:
+                application/json:
+                  schema:
+                    $ref: '#/components/schemas/ParkingMachine'
+
 components:
     responses:
         UnauthorizedError:
@@ -1195,3 +1481,550 @@ components:
                     type: string
                     nullable: true
                     example: Mon-Sun 14:30
+# v3 schemas
+        Parking:
+          type: object
+          title: Parking
+          properties:
+            geometry:
+              type: object
+              properties:
+                type:
+                  type: string
+                  enum:
+                    - Point
+                    - Polygon
+                    - MultiPolygon
+                  description: The type of geometry (GeoJSON Point, Polygon, MultiPolygon).
+                coordinates:
+                  oneOf:
+                    - type: array
+                      items:
+                        type: number
+                      example: [14.441252, 50.109318]
+                      description: Point coordinates
+                    - type: array
+                      items:
+                        type: array
+                        items:
+                          type: array
+                          items:
+                            type: number
+                        example:
+                          [
+                            [14.50823156003554, 50.10498927328214],
+                            [14.505782430390298, 50.1031042405622],
+                            [14.509701037821998, 50.1029471511537],
+                            [14.50823156003554, 50.10498927328214]
+                          ]
+                        description: Polygon coordinates
+                    - type: array
+                      items:
+                        type: array
+                        items:
+                          type: array
+                          items:
+                            type: array
+                            items:
+                              type: number
+                        example:
+                          [
+                            [
+                              [14.50823156003554, 50.10498927328214],
+                              [14.505782430390298, 50.1031042405622],
+                              [14.509701037821998, 50.1029471511537],
+                              [14.50823156003554, 50.10498927328214]
+                            ],
+                            [
+                              [14.50823156003554, 50.10498927328214],
+                              [14.505782430390298, 50.1031042405622],
+                              [14.509701037821998, 50.1029471511537],
+                              [14.50823156003554, 50.10498927328214]
+                            ]
+                          ]
+                        description: MultiPolygon coordinates
+                  description: Coordinates of the geometry.
+              description: GeoJSON geometry of the parking location.
+            properties:
+              type: object
+              properties:
+                id:
+                  type: string                  
+                  description: 'The identifier for the parking location.'
+                primary_source:
+                  type: string
+                  enum:
+                    - tsk_v2
+                  description: 'The primary source of the parking location. Assigned by us.'
+                primary_source_id:
+                  type: string
+                  nullable: true
+                  description: 'The ID defined by the primary source. As in the source data.'
+                name:
+                  type: string
+                  nullable: true
+                  description: 'The name of the parking location.'
+                valid_from:
+                  type: string
+                  format: date-time
+                  description: 'The start date and time when the parking location is opened from. Or date of implementation.'
+                centroid:
+                  type: object
+                  properties:
+                    type:
+                      type: string
+                      enum:
+                        - Point
+                    coordinates:
+                      type: array
+                      items:
+                        type: number
+                  description: 'The GeoJSON centroid of the parking location, centroid is always point in geometry.'
+                last_updated_at:
+                  type: string
+                  format: date-time
+                  description: 'The date and time when info about the parking location was last checked and updated.'
+                last_modified_at_source:
+                  type: string
+                  format: date-time
+                  description: 'The date and time when the parking location was last modified at the source. In case data source provides it.'
+                space:
+                    type: object
+                    properties:
+                        features:
+                            type: array
+                            items:
+                                $ref: '#/components/schemas/ParkingSpace'
+                        type:
+                            type: string
+                            example: FeatureCollection
+                tariff:
+                  type: string
+                  format: uuid
+                  description: 'UUID of related parking tariff.'
+              required:
+                - id
+                - primary_source
+                - valid_from
+                - last_updated_at
+                - centroid
+            type:
+              type: string
+              example: Feature
+        ParkingSpace:
+          type: object
+          title: Parking Space
+          properties:
+            geometry:
+              type: object
+              properties:
+                type:
+                  type: string
+                  enum:
+                    - Point
+                    - Polygon
+                    - MultiPolygon
+                  description: The type of geometry (GeoJSON Point, Polygon, MultiPolygon).
+                coordinates:
+                  oneOf:
+                    - type: array
+                      items:
+                        type: number
+                      example: [14.441252, 50.109318]
+                      description: Point coordinates
+                    - type: array
+                      items:
+                        type: array
+                        items:
+                          type: array
+                          items:
+                            type: number
+                        example:
+                          [
+                            [14.50823156003554, 50.10498927328214],
+                            [14.505782430390298, 50.1031042405622],
+                            [14.509701037821998, 50.1029471511537],
+                            [14.50823156003554, 50.10498927328214]
+                          ]
+                        description: Polygon coordinates
+                    - type: array
+                      items:
+                        type: array
+                        items:
+                          type: array
+                          items:
+                            type: array
+                            items:
+                              type: number
+                        example:
+                          [
+                            [
+                              [14.50823156003554, 50.10498927328214],
+                              [14.505782430390298, 50.1031042405622],
+                              [14.509701037821998, 50.1029471511537],
+                              [14.50823156003554, 50.10498927328214]
+                            ],
+                            [
+                              [14.50823156003554, 50.10498927328214],
+                              [14.505782430390298, 50.1031042405622],
+                              [14.509701037821998, 50.1029471511537],
+                              [14.50823156003554, 50.10498927328214]
+                            ]
+                          ]
+                        description: MultiPolygon coordinates
+                  description: Coordinates of the geometry.
+              description: GeoJSON geometry of the parking space.
+            properties:
+              type: object
+              properties:
+                id:
+                  type: string                  
+                  description: 'The identifier for the parking space.'
+                capacity:
+                  type: integer
+                  minimum: 0
+                  nullable: true
+                  description: 'The capacity of the parking space.'
+                filter:
+                  type: string
+                  description: 'Specific marking of parking space (blue zone, A zone etc.).'
+                access_dedicated_to:
+                  type: array
+                  items:
+                    type: string
+                    enum:
+                    - disabled
+                    - charging
+                    - parent
+                    - delivery
+                    - customer
+                    - resident
+                    - bus
+                    - designated
+                    - truck
+                    - all
+                    - motorcycle
+                    - RV
+                  minItems: 0
+                  description: |
+                    Array of dedicated access types for the parking space:
+                    * `disabled` - reserved for disabled individuals
+                    * `charging` - intended for electric vehicle charging
+                    * `parent` - designated for parents with children
+                    * `delivery` - exclusively for delivery purposes
+                    * `customer` -  exclusive for customers
+                    * `resident` - reserved for residents
+                    * `bus` - reserved for buses
+                    * `designated` - specific purpose (e.g., school, embassy)
+                    * `truck` - reserved for trucks
+                    * `all` - open for all vehicles
+                    * `motorcycle` - for motorcycles only
+                    * `RV` - reserved for recreational vehicles
+                address:
+                  $ref: '#/components/schemas/ParkingAddress'
+                restriction:
+                  type: array
+                  items:
+                    $ref: '#/components/schemas/ParkingRestriction'
+              required:
+                - id
+                - access_dedicated_to
+            type:
+              type: string
+              example: Feature
+        ParkingRestriction:
+          title: Parking Restriction
+          description:
+            Vehicles with a special feature.
+              * `CNG` - Compressed Natural Gas vehicles
+              * `LPG` - Liquefied Petroleum Gas vehicles
+              * `bus` - buses
+              * `truck` - trucks
+              * `motorcycle` - motorcycles
+              * `trailer` - trailers
+              * `RV` - recreational vehicles
+          type: object
+          properties:
+            default:
+              type: string
+              enum:
+                - cng
+                - lpg
+                - bus
+                - truck
+                - motorcycle
+                - trailer
+                - rv
+          additionalProperties:
+            type: boolean
+        ParkingAddress:
+          type: object
+          title: Parking Address
+          properties:
+            address_formated:
+              type: string
+              nullable: true
+              description: 'Formatted address of the parking location.'
+            country:
+              type: string
+              nullable: true
+              description: 'Country of the parking location.'
+            locality:
+              type: string
+              nullable: true
+              description: 'Locality of the parking location.'
+            region:
+              type: string
+              nullable: true
+              description: 'Region of the parking location.'
+            postal_code:
+              type: string
+              nullable: true
+              description: 'Postal code of the parking location.'
+            street_address:
+              type: string
+              nullable: true
+              description: 'Street address of the parking location.'
+        ParkingTariff:
+          type: object
+          title: Parking Tariff
+          properties:
+            id:
+              type: string
+              format: uuid
+              description: 'The UUID identifier for the tariff.'
+            charge_bands:
+              type: array
+              items:
+                $ref: '#/components/schemas/ParkingChargeBand'
+              description: 'Array of Charge Band objects that represent tariff categories for different users.'
+          required:
+            - id
+            - charge_bands
+        ParkingChargeBand:
+          type: object
+          title: Parking Charge Band
+          properties:
+            primary_source:
+              type: string
+              enum: ['tsk_v2']
+              description: 'The primary source of the charge band.'
+            primary_source_id:
+              type: string
+              nullable: true
+              description: 'The ID defines by the primary source.'
+            maximum_duration:
+              type: integer
+              minimum: 0
+              nullable: true
+              description: 'Maximum duration for charging (in seconds).'
+            valid_from:
+              type: string
+              format: date-time
+              description: 'Valid from date.'
+            valid_to:
+              type: string
+              format: date-time
+              nullable: true
+              description: 'Valid to date.'
+            last_updated_at:
+              type: string
+              format: date-time
+              description: 'The date and time when info about the tariff category was last checked and updated.'
+            last_modified_at_source:
+              type: string
+              format: date-time
+              nullable: true
+              description: 'The date and time when the tariff category was last modified at the source.'
+            charges:
+              type: array
+              items:
+                $ref: '#/components/schemas/ParkingCharge'
+              description: 'Array of Charge objects.'
+          required:
+            - primary_source
+            - valid_from
+        ParkingCharge:
+          type: object
+          title: Parking Charge
+          properties:
+            id:
+              type: string
+              format: uuid
+              description: 'The UUID identifier for the charge.'
+            charge:
+              type: string
+              example: '0.6666666666666666'
+              description: 'Charge amount.'
+            charge_type:
+              type: string
+              enum: ['other', 'minimum', 'maximum']
+              description: 'Type of charge.'
+            charge_order_index:
+              type: integer
+              minimum: 0
+              description: 'Order index for charges.'
+            charge_interval:
+              type: integer
+              minimum: 0
+              description: 'Charge interval (in seconds).'
+            max_iterations_of_charge:
+              type: integer
+              minimum: 0
+              description: 'Maximum iterations of charge.'
+            min_iterations_of_charge:
+              type: integer
+              minimum: 0
+              description: 'Minimum iterations of charge.'
+            valid_from:
+              type: string
+              format: date-time
+              description: 'Valid from date.'
+            valid_to:
+              type: string
+              format: date-time
+              nullable: true
+              description: 'Valid to date.'
+            periods_of_time:
+              type: array
+              items:
+                $ref: '#/components/schemas/ParkingPeriodsOfTime'
+              description: 'Array of Periods of Time objects.'
+          required:
+            - id
+            - charge
+            - charge_type
+            - charge_order_index
+            - charge_interval
+            - valid_from
+        ParkingPeriodsOfTime:
+          type: object
+          title: Parking Periods Of Time
+          properties:
+            day_in_week:
+              type: string
+              enum: ['Mo', 'Tu', 'We', 'Th', 'Fr', 'Sa', 'Su']
+              description: 'Day of the week.'
+            start:
+              type: string
+              format: time
+              description: 'Start time of the periods of time.'
+            end:
+              type: string
+              format: time
+              description: 'End time of the periods of time.'
+            ph:
+              type: string
+              enum: ['PH_only', 'PH_off']
+              description: 'Public holiday availability.'
+          required:
+            - day_in_week
+            - start
+            - end
+            - ph
+        ParkingMachine:
+          type: object
+          title: Parking Machine
+          properties:
+            geometry:
+              type: object
+              properties:
+                type:
+                  type: string
+                  enum:
+                    - Point
+                    - Polygon
+                    - MultiPolygon
+                  description: The type of geometry (GeoJSON Point, Polygon, MultiPolygon).
+                coordinates:
+                  oneOf:
+                    - type: array
+                      items:
+                        type: number
+                      example: [14.441252, 50.109318]
+                      description: Point coordinates
+                    - type: array
+                      items:
+                        type: array
+                        items:
+                          type: array
+                          items:
+                            type: number
+                        example:
+                          [
+                            [14.50823156003554, 50.10498927328214],
+                            [14.505782430390298, 50.1031042405622],
+                            [14.509701037821998, 50.1029471511537],
+                            [14.50823156003554, 50.10498927328214]
+                          ]
+                        description: Polygon coordinates
+                    - type: array
+                      items:
+                        type: array
+                        items:
+                          type: array
+                          items:
+                            type: array
+                            items:
+                              type: number
+                        example:
+                          [
+                            [
+                              [14.50823156003554, 50.10498927328214],
+                              [14.505782430390298, 50.1031042405622],
+                              [14.509701037821998, 50.1029471511537],
+                              [14.50823156003554, 50.10498927328214]
+                            ],
+                            [
+                              [14.50823156003554, 50.10498927328214],
+                              [14.505782430390298, 50.1031042405622],
+                              [14.509701037821998, 50.1029471511537],
+                              [14.50823156003554, 50.10498927328214]
+                            ]
+                          ]
+                        description: MultiPolygon coordinates
+                  description: Coordinates of the geometry.
+              description: GeoJSON geometry of the parking machine.
+            properties:
+              type: object
+              properties:
+                id:
+                  type: string
+                  format: uuid
+                  description: The UUID identifier for the parking machine.
+                primary_source:
+                  type: string
+                  enum:
+                    - tsk_v2
+                  description: The primary source of the parking machine.
+                primary_source_id:
+                  type: string
+                  nullable: true
+                  description: The ID defined by the primary source.
+                code:
+                  type: string
+                  description: The code of the parking machine.
+                machine_type:
+                  type: string
+                  enum:
+                    - payment_machine
+                    - info_box
+                  description: |
+                    The type of the parking machine.
+                      * `payment_machine` - a facility where payment can be made for parking; often equipped with payment options
+                      * `info_box` - an installation providing information and possibly a QR code, without payment capabilities.
+                valid_from:
+                  type: string
+                  format: date-time
+                  description: The start date when the parking machine is valid.
+                tariff_id:
+                  type: string
+                  format: uuid
+                  description: The UUID identifier for the tariff connected to the parking machine.
+              required:
+              - id
+              - primary_source
+              - valid_from
+            type:
+              type: string
+              example: Feature