Release Candidate
⚠ This repository is a release candidate for CDS 1.0. It has been approved by the Working Group Steering Committee. You may start to use it in your development and production environments for real-world use cases. The release is going through the final OMF approval process, where it may be tweaked or enhanced with more guidance and resources. See the Release Plan page for updates.
Table of Contents
- Overview
- Curb Data Specification APIs
- Structure
- Modularity
- MDS Overlap
- Work in Progress
- Get Involved
- Versions
- Technical Information
- Membership
- Data Privacy
- Use Cases
The Curb Data Specification (CDS), a project of the Open Mobility Foundation (OMF), is a data standard and set of Application Programming Interfaces (APIs) that helps cities manage and companies use dynamic curb zones that optimize loading activities of people and goods, and measure the impact of these programs.
Urban curb is a valuable, limited, and often under-managed part of the public right of way. Curb demand is growing, including from commercial activity like passenger pickup/drop off, traditional and on-demand delivery services, new mobility programs like scooters, bikeshare, and carshare, and goods and freight delivery. While cities have made some progress in digitizing their curb and using curb data, more tools are needed to proactively manage curbs and sidewalks, and to deliver more public value from this scarce resource. CDS can provide a mechanism for expressing static and dynamic regulations, measuring activity at the curb, and developing policies that create more accessible, useful curbs.
CDS is a key piece of digital infrastructure that supports the effective implementation of curb policies in cities and for curb users. For a high level overview and visuals, see the About CDS page on the OMF website.
[Top][toc]
CDS is at its core a set of Application Programming Interfaces (APIs) and endpoints within those APIs, which allow information to flow between organizations managing and using curb places. It includes the following three APIs, with multiple endpoints under each API:
The Curbs API is a standard way for cities to digitally publish curb locations and regulations, which can be shared with the public and with companies using curb space. It defines curb policies, curb zones, spaces in zones, and areas around curbs, and is used by Events and Metrics.
The Events API is a standard way to transmit real-time and historic commercial events happening at the curb to cities. Event data can be derived from company data feeds, on street sensors, session payments, company check-ins, in-person parking personnel, and/or other city data sources. Connected to Curbs and used by Metrics.
The Metrics API is a way to track curb usage session details and define common calculation methodologies to measure historic dwell time, occupancy, usage and other aggregated statistics. It defines sessions and aggregates data derived from raw Events data.
CDS is a data exchange format and a translation layer between internal systems and external entities using data feeds. It is not expected that CDS will be the format used internally to store curb regulations in a city. The internal storage format is something different, and a subset of that data should be able to be converted to CDS for publishing out to the public and curb users.
Many parts of the CDS definitions and APIs align across each other. In these cases, consolidated information can be found on the General Information page.
Structure
CDS contains a series of connected endpoints and fields beneath each interconnected API.
Modularity
CDS is designed to be a modular and flexible specification. Regulatory agencies can use the components of the API that are appropriate for their needs. An agency may choose to use only Curbs, while others may use Curbs, Events, and Metrics. Even within each API many endpoints and fields are optional. This design allows agencies, software and hardware companies, and curb users to use what's appropriate for their use cases, work within their operational capabilities, and text CDS in their pilot projects.
MDS Overlap
Like the Mobility Data Specification (MDS), the CDS will be consumed by both cities and transportation providers operating in the public right of way. In many cases, the same mobility providers using curbs with CDS may also be interacting with other OMF MDS Policy, MDS Provider, and MDS Agency data objects within the same MDS Jurisdiction or MDS Geography, and using similar MDS Metrics. Consistent with the Technology Design Principles codified in the Technology Council's OMF Architectural Landscape Document, the members of this working group are making reasonable best efforts to ensure that work is both modular and inter operable with other technology managed by the OMF as to avoid duplication and downstream implementation complexity. The first version of CDS intentionally has no direct connetions to MDS which allowed it to be created based strictly on real-world curb use cases and needs, but may align directly in future versions.
[Top][toc]
The CDS is a work in progress and is under ongoing development by the community under the guidance of the Working Group Steering Committee on specific discussion topics and bi-weekly public meetings around a specific Scope of Work. The Steering Committee has created supplementary resources like Architectural Decisions, Use Cases, Privacy Guidance, Policy Language Guidance, and a Pilot Project Guide. After the CDS 1.0 launch, the public working group will incorporate feedback from on-the-ground pilot programs into future versions.
[Top][toc]
How cities use CDS depends on a variety of factors: their transportation goals, existing services and infrastructure, and the unique needs of their communities. Cities are using CDS to create policy, manage curbs, and ensure the safe operation of vehicles in the public right of way.
A list of use cases is useful to show what's possible with CDS, to see many use cases up front for privacy considerations, and to use for policy discussions and policy language. More details and examples can be seen on the CDS Use Cases.
[Top][toc]
CDS has a current release (version 1.0.0), and an upcoming releases in development. For a full list of releases, their status, recommended versions, and timelines, see the Official CDS Releases page.
The OMF provides guidance on upgrading for cities, providers, and software companies, and sample permit language for cities. See our CDS Version Guidance for best practices on how and when to upgrade CDS as new versions become available. Our complimentary CDS Policy Language Guidance document is for cities writing CDS into their operating policy and includes sample policy language.[toc]: #table-of-contents
