apiVersion: capability.naftiko.com/v1
kind: Capability
metadata:
  name: tier-mobility-gbfs
  description: >-
    Read-only access to TIER / Dott public GBFS 2.3 feeds. Discover the
    set of cities operated by Dott, fetch real-time vehicle positions
    and battery levels, look up per-city pricing plans, vehicle types,
    stations, and geofencing rules. Useful for building MaaS apps,
    multimodal trip planners, transport analytics dashboards, and
    research on European shared-mobility supply.
spec:
  provider: tier-mobility
  api: tier-mobility-gbfs
  authentication:
    type: none
  baseUrl: https://gbfs.api.ridedott.com/public/v2
  operations:
    - id: listGbfsVersions
      method: GET
      path: /gbfs_versions.json
      description: List supported GBFS schema versions.
    - id: getGbfsDiscovery
      method: GET
      path: /{system_id}/gbfs.json
      description: Get the GBFS discovery document for a city.
      parameters:
        - name: system_id
          in: path
          required: true
          description: City/system slug, e.g. berlin, paris, london, madrid, dubai.
    - id: getSystemInformation
      method: GET
      path: /{system_id}/system_information.json
      description: System name, language, timezone, and rental app deep links.
    - id: getSystemPricingPlans
      method: GET
      path: /{system_id}/system_pricing_plans.json
      description: Per-vehicle-type unlock and per-minute pricing for the city.
    - id: getVehicleTypes
      method: GET
      path: /{system_id}/vehicle_types.json
      description: Vehicle form factors, propulsion, and max range.
    - id: getFreeBikeStatus
      method: GET
      path: /{system_id}/free_bike_status.json
      description: Real-time position, battery, and rental URIs for every available vehicle.
    - id: getStationInformation
      method: GET
      path: /{system_id}/station_information.json
      description: Static station definitions.
    - id: getStationStatus
      method: GET
      path: /{system_id}/station_status.json
      description: Real-time station availability.
    - id: getGeofencingZones
      method: GET
      path: /{system_id}/geofencing_zones.json
      description: GeoJSON zones with ride/park/speed rules.
  scopes:
    - read:gbfs