Skip to content

Add geographies to be returned in Reports in Requirements #873

@alexdemisch

Description

@alexdemisch

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.

Metadata

Metadata

Assignees

No one assigned

    Labels

    ProviderSpecific to the Provider APIReportsReports endpoint and related ideasRequirementsDirectly related to features in the Policy Requirements endpointminor updateA change that is minor and should require little discussion, or is a maintenance/readme/typo update.

    Type

    No type

    Projects

    No projects

    Milestone

    Relationships

    None yet

    Development

    No branches or pull requests

    Issue actions