openmobilityfoundation / mobility-data-specification

A data standard to enable right-of-way regulation and two-way communication between mobility companies and local governments.
https://www.openmobilityfoundation.org/about-mds/
Other
676 stars 232 forks source link

Add geographies to be returned in Reports in Requirements #873

Open alexdemisch opened 11 months ago

alexdemisch commented 11 months ago

The Reports endpoint provides a useful way to aggregate information that otherwise shouldn’t be provided in a raw form. This has been a helpful way for SFMTA to gather information about scooter trips taken by users on a low-income plan and trips on adaptive devices.

To make the Reports endpoint data more useful, we added a set of neighborhoods to our Geographies endpoint that are helpful analytical zones for which we want to see aggregated data. However, our Geographies endpoint also contains equity neighborhoods used for distribution requirements and a no parking zone. We really don’t need aggregated data for these “operational” geographies, but the spec requires operators to aggregate data for all geographies anyway (even geographies that may no longer have any use because all data is immutable).

This can be overly burdensome for operators, and will only get more complex as more geographies are added, especially because the geographies are immutable. Having a method to flag which geographies should be returned in a reports endpoint would be helpful. I could see this going into Policy Requirements, Geographies, or Reports. But Policy Requirements might make the most sense.

schnuerle commented 10 months ago

Agree and this was a known complexity/limitation going into the launch of the Reports beta feature (we made changes and took it out of beta for 2.0). It's time we addressed this in the next release, and I also think Policy Requirements in the best place to enumerate the relevant geographies. For now you could publish a list of geography IDs to the operators that are relevant to Reports.

schnuerle commented 2 months ago

Everyone note how @alexdemisch is implementing geographies in the wild in this Requirements file.