This file presents a series of example Requirements documents for Agencies to use as templates.
- Policy and Geography
- Vehicles Only
- Trips Only
- Trips with No Routes, Vehicles IDs, or Dates
- Provider and Other APIs
- Agency
- Use Cases
- Geography Driven Events
- GBFS Only
Version 1.2.0 of MDS Policy and Geography for agencies to publish rules/fees/incentives and operating/equity/no-ride/slow speed/parking areas to all providers, and require GBFS's geofencing_zones.
{
"metadata": {
"mds_release": "1.2.0",
"file_version": "4",
"last_updated": "1611729218",
"max_update_interval": "P1M",
"agency_id": "737a9c62-c0cb-4c93-be43-271d21b784b5",
"agency_name": "Louisville Metro",
"agency_timezone": "America/New_York",
"agency_language": "en-US",
"agency_currency": "USD",
"agency_website_url": "https://www.cityname.gov/transportation/",
"url": "https://mds.cityname.gov/policy/requirements/1.2.0"
},
"programs": [
{
"description": "City Micromobility Program Policy Rules",
"program_website_url": "https://www.cityname.gov/transportation/shared-devices.html",
"program_document_url": "https://www.cityname.gov/mds_data_policy.pdf",
"provider_ids": [
"70aa475d-1fcd-4504-b69c-2eeb2107f7be",
"2411d395-04f2-47c9-ab66-d09e9e3c3251",
"04ab5c86-ab6f-4abc-b866-e4c92da39a3e",
"bd530feb-936f-40eb-ae04-ce931de216e1",
"a8c54e3e-fe67-4c5a-90a6-4a1d2c2808da"
],
"start_date": 1611958740,
"end_date": null,
"required_data_specs": [
{
"data_spec_name": "MDS",
"version": "1.2.0",
"available_apis": [
{
"api_name": "policy",
"available_endpoints": [
{
"endpoint_name": "policies",
"url": "https://mds.cityname.com/policy/policies/1.2.0"
}
]
},
{
"api_name": "geography",
"available_endpoints": [
{
"endpoint_name": "geographies",
"url": "https://mds.cityname.com/geography/geographies/1.2.0",
"available_fields": [
"geography_type",
"description"
]
}
]
}
]
},
{
"data_spec_name": "GBFS",
"version": "2.2",
"required_apis": [
{
"required_endpoints": [
{
"endpoint_name": "geofencing_zones.json",
"required_fields": [
"features.properties.rules.vehicle_type_id"
]
}
]
}
]
}
]
}
]
}Version 1.1.0 for one provider with scooters, and 1.0.0 for another provider for bicycles, requiring only the Provider /vehicles endpoint and no optional fields, as an authenticated alternative to GBFS for internal use, while still requiring GBFS 2.1 for the public.
{
"metadata": {
"mds_release": "1.2.0",
"file_version": "2",
"last_updated": "1611958740",
"max_update_interval": "P1M",
"agency_id": "737a9c62-c0cb-4c93-be43-271d21b784b5",
"agency_name": "Louisville Metro",
"agency_timezone": "America/New_York",
"agency_language": "en-US",
"agency_currency": "USD",
"agency_website_url": "https://www.cityname.gov/transportation/",
"url": "https://mds.cityname.gov/policy/requirements/1.2.0"
},
"programs": [
{
"description": "City Scooter Monitoring Program 2021",
"program_website_url": "https://www.cityname.gov/transportation/shared-devices.html",
"program_document_url": "https://www.cityname.gov/mds_data_policy.pdf",
"provider_ids": [
"70aa475d-1fcd-4504-b69c-2eeb2107f7be"
],
"vehicle_types": [
"scooter"
],
"start_date": 1611958740,
"end_date": null,
"required_data_specs": [
{
"data_spec_name": "MDS",
"version": "1.2.0",
"mode_id": "micromobility",
"required_apis": [
{
"api_name": "provider",
"required_endpoints": [
{
"endpoint_name": "vehicles"
}
]
}
]
},
{
"data_spec_name": "GBFS",
"version": "2.1"
}
]
},
{
"description": "City Bikeshare Monitoring Program 2021",
"program_website_url": "https://www.cityname.gov/transportation/bikeshare.html",
"program_document_url": "https://www.cityname.gov/mds_data_policy.pdf",
"provider_ids": [
"2411d395-04f2-47c9-ab66-d09e9e3c3251"
],
"vehicle_types": [
"bicycle"
],
"start_date": 1611958740,
"end_date": null,
"required_data_specs": [
{
"data_spec_name": "MDS",
"version": "1.2.0",
"required_apis": [
{
"api_name": "provider",
"required_endpoints": [
{
"endpoint_name": "vehicles"
}
]
}
]
},
{
"data_spec_name": "GBFS",
"version": "2.1"
}
]
}
]
}Version 1.1.0 for 2 providers requiring only historic Provider /trips with the optional parking_verification_url field, linked to a specific MDS Policy.
{
"metadata": {
"mds_release": "1.2.0",
"file_version": "3",
"last_updated": "1611958740",
"max_update_interval": "P1M",
"agency_id": "737a9c62-c0cb-4c93-be43-271d21b784b5",
"agency_name": "Louisville Metro",
"agency_timezone": "America/New_York",
"agency_language": "en-US",
"agency_currency": "USD",
"agency_website_url": "https://www.cityname.gov/transportation/",
"url": "https://mds.cityname.gov/policy/requirements/1.2.0"
},
"programs": [
{
"description": "City Vehicle Program Pilot 2021",
"program_website_url": "https://www.cityname.gov/transportation/shared-devices.html",
"program_document_url": "https://www.cityname.gov/mds_data_policy.pdf",
"provider_ids": [
"70aa475d-1fcd-4504-b69c-2eeb2107f7be",
"2411d395-04f2-47c9-ab66-d09e9e3c3251"
],
"start_date": 1611958740,
"end_date": 1611970539,
"required_data_specs": [
{
"data_spec_name": "MDS",
"version": "1.2.0",
"required_apis": [
{
"api_name": "provider",
"required_endpoints": [
{
"endpoint_name": "trips",
"required_fields": [
"parking_verification_url"
]
}
]
}
]
},
{
"data_spec_name": "GBFS",
"version": "2.2"
}
]
}
]
}Version 1.1.0 for 2 providers asking for only historic Provider /trips with the typically required device_id, vehicle_id, start_time, end_time, and route array data, and the optional parking_verification_url photo URL, not returned in the endpoint.
{
"metadata": {
"mds_release": "1.2.0",
"file_version": "3",
"last_updated": "1611958740",
"max_update_interval": "P1M",
"agency_id": "737a9c62-c0cb-4c93-be43-271d21b784b5",
"agency_name": "Louisville Metro",
"agency_timezone": "America/New_York",
"agency_language": "en-US",
"agency_currency": "USD",
"agency_website_url": "https://www.cityname.gov/transportation/",
"url": "https://mds.cityname.gov/policy/requirements/1.2.0"
},
"programs": [
{
"description": "City Vehicle Program Pilot Research for 2021",
"program_website_url": "https://www.cityname.gov/transportation/shared-devices.html",
"program_document_url": "https://www.cityname.gov/mds_data_policy.pdf",
"provider_ids": [
"70aa475d-1fcd-4504-b69c-2eeb2107f7be",
"2411d395-04f2-47c9-ab66-d09e9e3c3251"
],
"start_date": 1611958740,
"end_date": 1611970539,
"required_data_specs": [
{
"data_spec_name": "MDS",
"version": "1.2.0",
"required_apis": [
{
"api_name": "provider",
"required_endpoints": [
{
"endpoint_name": "trips",
"disallowed_fields": [
"route",
"device_id",
"vehicle_id",
"start_time",
"end_time",
"parking_verification_url"
]
}
]
}
]
},
{
"data_spec_name": "GBFS",
"version": "2.2"
}
]
}
]
}Version 1.1.0 or 0.4.1 for 3 providers with many APIs and endpoints, for two programs: shared dockless and city docked bikes. With use cases added.
Note: by specifying geography, policy, and jurisdiction here with a URL, the agency is in effect saying that they have created and are hosting these, and they are available for use if public.
{
"metadata": {
"mds_release": "1.2.0",
"file_version": "3",
"last_updated": "1611958740",
"max_update_interval": "P1M",
"agency_id": "737a9c62-c0cb-4c93-be43-271d21b784b5",
"agency_name": "Louisville Metro",
"agency_timezone": "America/New_York",
"agency_language": "en-US",
"agency_currency": "USD",
"agency_website_url": "https://www.cityname.gov/transportation/",
"url": "https://mds.cityname.gov/policy/requirements/1.2.0"
},
"programs": [
{
"description": "City Shared Device Program and Policies 2021",
"program_website_url": "https://www.cityname.gov/transportation/shared-devices.html",
"program_document_url": "https://www.cityname.gov/mds_data_policy.pdf",
"provider_ids": [
"70aa475d-1fcd-4504-b69c-2eeb2107f7be",
"2411d395-04f2-47c9-ab66-d09e9e3c3251",
"420e6e94-55a6-4946-b6b3-4398fe22e912"
],
"start_date": 1611958740,
"end_date": 1611970539,
"required_data_specs": [
{
"data_spec_name": "MDS",
"version": "1.2.0",
"required_apis": [
{
"api_name": "provider",
"required_endpoints": [
{
"endpoint_name": "trips",
"required_fields": [
"parking_verification_url",
"standard_cost",
"actual_cost"
]
},
{
"endpoint_name": "status_changes",
"required_fields": [
"event_geographies",
"trip_id"
]
},
{
"endpoint_name": "reports"
},
{
"endpoint_name": "events",
"required_fields": [
"trip_id",
"associated_ticket"
]
},
{
"endpoint_name": "stops",
"required_fields": [
"geography_id",
"address",
"devices",
"image_url"
]
},
{
"endpoint_name": "vehicles",
"required_fields": [
"current_location"
]
}
]
}
],
"available_apis": [
{
"api_name": "policy",
"available_endpoints": [
{
"endpoint_name": "policies",
"url": "https://mds.cityname.gov/policy/policies/1.1.0"
}
]
},
{
"api_name": "geography",
"available_endpoints": [
{
"endpoint_name": "geographies",
"url": "https://mds.cityname.gov/geography/geographies/1.1.0"
}
]
},
{
"api_name": "jurisdiction",
"available_endpoints": [
{
"endpoint_name": "trips",
"url": "https://mds.cityname.gov/jurisdiction/jurisdictions/1.1.0"
}
]
},
{
"api_name": "metrics"
}
],
"use_cases": [
{
"external_url": "https://airtable.com/shrPf4QvORkjZmHIs/tblzFfU6fxQm5Sdhm",
"ids": ["OMF-MDS-2","OMF-MDS-8","OMF-MDS-12","OMF-MDS-13","OMF-MDS-14","OMF-MDS-20","OMF-MDS-29","OMF-MDS-31","OMF-MDS-44"]
},
"external_url": "https://github.com/CDSM-WG/CDS-M/tree/main/use-cases",
"ids": ["open-data","most-used-routes","vehicle-cap","impact-on-transit","origins","vehicle-rotation","distribution-requirements-availability","distribution-requirements-availability","publish-speed-regulations"]
]
},
{
"data_spec_name": "GBFS",
"version": "2.2"
}
]
},
{
"description": "City Docked Device Program 2021",
"program_website_url": "https://www.cityname.gov/transportation/shared-devices.html",
"program_document_url": "https://www.cityname.gov/mds_data_policy.pdf",
"version": "0.4.1",
"provider_ids": [
"70aa475d-1fcd-4504-b69c-2eeb2107f7be",
"2411d395-04f2-47c9-ab66-d09e9e3c3251",
"420e6e94-55a6-4946-b6b3-4398fe22e912"
],
"start_date": 1611958740,
"end_date": 1611970539,
"required_data_specs": [
{
"data_spec_name": "MDS",
"version": "0.4.1",
"required_apis": [
{
"api_name": "provider",
"required_endpoints": [
{
"endpoint_name": "trips",
"required_fields": [
"parking_verification_url",
"standard_cost",
"actual_cost"
]
},
{
"endpoint_name": "status_changes"
},
{
"endpoint_name": "events"
},
{
"endpoint_name": "stops",
"required_fields": [
"geography_id",
"address",
"devices",
"image_url"
]
},
{
"endpoint_name": "vehicles"
}
]
}
]
},
{
"data_spec_name": "GBFS",
"version": "2.1"
}
]
}
]
}Version 1.1.0 for 3 providers and serving Agency only linking to a defined MDS Policy.
{
"metadata": {
"mds_release": "1.2.0",
"file_version": "2",
"last_updated": "1611958740",
"max_update_interval": "P1M",
"agency_id": "737a9c62-c0cb-4c93-be43-271d21b784b5",
"agency_name": "Louisville Metro",
"agency_timezone": "America/New_York",
"agency_language": "en-US",
"agency_currency": "USD",
"agency_website_url": "https://www.cityname.gov/transportation/",
"url": "https://mds.cityname.gov/policy/requirements/1.2.0"
},
"programs": [
{
"description": "City Shared Device Management Program 2021-2022",
"program_website_url": "https://www.cityname.gov/transportation/shared-devices.html",
"program_document_url": "https://www.cityname.gov/mds_data_policy.pdf",
"provider_ids": [
"70aa475d-1fcd-4504-b69c-2eeb2107f7be",
"2411d395-04f2-47c9-ab66-d09e9e3c3251",
"420e6e94-55a6-4946-b6b3-4398fe22e912"
],
"start_date": 1611958740,
"end_date": 1611970539,
"required_data_specs": [
{
"data_spec_name": "MDS",
"version": "1.2.0",
"required_apis": [
{
"api_name": "agency",
"required_endpoints": [
{
"endpoint_name": "vehicles"
},
{
"endpoint_name": "vehicle_register",
"required_fields": [
"year",
"mfg",
"model"
]
},
{
"endpoint_name": "vehicle_update"
},
{
"endpoint_name": "vehicle_event",
"required_fields": [
"event_geographies",
"trip_id"
]
},
{
"endpoint_name": "vehicle_telemetry"
},
{
"endpoint_name": "stops",
"required_fields": [
"status",
"num_spots_disabled"
]
}
]
}
]
},
{
"data_spec_name": "GBFS",
"version": "2.2"
}
]
}
]
}Version 2.0.0 for 2 providers requiring Provider /vehicles with external use cases for the program enumerated.
{
"metadata": {
"mds_release": "2.0.0",
"file_version": "2",
"last_updated": "1611953923",
"max_update_interval": "P1M",
"agency_id": "46c9882d-1297-48fc-83e5-3067d4e9337f",
"agency_name": "Gemeente Amsterdam",
"agency_timezone": "Europe/Amsterdam",
"agency_language": "nl_NL",
"agency_currency": "EUR",
"agency_website_url": "https://www.cityname.gov/transportation/",
"url": "https://mds.cityname.gov/policy/requirements/2.0.0"
},
"programs": [
{
"description": "SMART MOBILITY Actieprogramma",
"program_website_url": "https://www.cityname.gov/transportation/shared-devices.html",
"program_document_url": "https://www.cityname.gov/mds_data_policy.pdf",
"provider_ids": [
"70aa475d-1fcd-4504-b69c-2eeb2107f7be",
"2411d395-04f2-47c9-ab66-d09e9e3c3251"
],
"start_date": 1611958740,
"end_date": 1611970539,
"required_data_specs": [
{
"data_spec_name": "MDS",
"version": "2.0.0",
"required_apis": [
{
"api_name": "provider",
"required_endpoints": [
{
"endpoint_name": "vehicles"
}
]
}
]
},
{
"data_spec_name": "GBFS",
"version": "2.2"
}
],
"use_cases": [
{
"external_url": "https://airtable.com/shr2cnPQvKjzONJpG",
"ids": ["OMF-MDS-4","OMF-MDS-12","OMF-MDS-34"]
},
{
"external_url": "https://github.com/CDSM-WG/CDS-M/tree/main/use-cases",
"ids": ["reduced-speed-area","start-trips","end-trips","realtime-events"]
}
]
}
]
}Version 1.1.0 for 2 providers requiring Provider /status_changes with the minimum required for beta feature Geography Driven Events.
{
"metadata": {
"mds_release": "1.2.0",
"file_version": "1",
"last_updated": "1611958740",
"max_update_interval": "P1M",
"agency_id": "737a9c62-c0cb-4c93-be43-271d21b784b5",
"agency_name": "Portland Metro",
"agency_timezone": "America/Los_Angeles",
"agency_language": "en-US",
"agency_currency": "USD",
"agency_website_url": "https://www.cityname.gov/transportation/",
"url": "https://mds.cityname.gov/policy/requirements/1.2.0"
},
"programs": [
{
"description": "City Shared Vehicle Program",
"program_website_url": "https://www.cityname.gov/transportation/shared-devices.html",
"program_document_url": "https://www.cityname.gov/mds_data_policy.pdf",
"provider_ids": [
"70aa475d-1fcd-4504-b69c-2eeb2107f7be",
"2411d395-04f2-47c9-ab66-d09e9e3c3251"
],
"start_date": 1611958740,
"end_date": 1611970539,
"required_data_specs": [
{
"data_spec_name": "MDS",
"version": "1.2.0",
"required_apis": [
{
"api_name": "provider",
"required_endpoints": [
{
"endpoint_name": "status_changes",
"required_fields": [
"event_geographies"
]
}
]
}
]
},
{
"data_spec_name": "GBFS",
"version": "2.1"
}
]
}
]
}Since Requirements allows the GBFS versions and optional endpoints and fields to be defined, an agency could use it to only require public GBFS feeds, and not require MDS at all.
{
"metadata": {
"mds_release": "1.2.0",
"file_version": "2",
"last_updated": "1611958740",
"max_update_interval": "P1M",
"agency_id": "737a9c62-c0cb-4c93-be43-271d21b784b5",
"agency_name": "Louisville Metro",
"agency_timezone": "America/New_York",
"agency_language": "en-US",
"agency_currency": "USD",
"agency_website_url": "https://www.cityname.gov/transportation/",
"url": "https://mds.cityname.gov/policy/requirements/1.2.0"
},
"programs": [
{
"description": "City Scooter Public Data Feeds 2021",
"program_website_url": "https://www.cityname.gov/transportation/shared-devices.html",
"program_document_url": "https://www.cityname.gov/data_policy.pdf",
"provider_ids": [
"70aa475d-1fcd-4504-b69c-2eeb2107f7be",
"2411d395-04f2-47c9-ab66-d09e9e3c3251"
],
"start_date": 1611958740,
"end_date": null,
"required_data_specs": [
{
"data_spec_name": "GBFS",
"version": "2.2",
"required_apis": [
{
"required_endpoints": [
{
"endpoint_name": "geofencing_zones.json",
"required_fields": [
"features.properties.name",
"features.properties.start",
"features.properties.end",
"features.properties.rules.vehicle_type_id"
]
},
{
"endpoint_name": "system_calendar.json"
},
{
"endpoint_name": "system_pricing_plans.json",
"required_fields": [
"per_km_pricing",
"surge_pricing"
]
}
]
}
]
}
]
}
]
}