Skip to content

Commit 1dfb030

Browse files
schnuerleschnuerle
authored
Merge pull request #804 from alexdemisch/dev
Reports - Add provider_id. Add adaptive_scooter as a special group type
2 parents 5bd0f3b + fe5f98e commit 1dfb030

1 file changed

Lines changed: 46 additions & 44 deletions

File tree

‎provider/README.md‎

Lines changed: 46 additions & 44 deletions
Original file line numberDiff line numberDiff line change
@@ -365,6 +365,7 @@ The authenticated reports are monthly, historic flat files that may be pre-gener
365365

366366
| Column Name | Type | Comments |
367367
|----------------------| ----------------------------------------- | ------------------------------------------------ |
368+
| `provider_id` | UUID | A UUID for the Provider, unique within MDS. See MDS provider_id in [provider list](/providers.csv). |
368369
| `start_date` | date | Start date of trip the data row, ISO 8601 format, local timezone |
369370
| `duration` | string | Value is always `P1M` for monthly. Based on [ISO 8601 duration](https://en.wikipedia.org/wiki/ISO_8601#Durations) |
370371
| `special_group_type` | [Special Group Type](#special-group-type) | Type that applies to this row |
@@ -385,60 +386,60 @@ All geography IDs included in the city published [Geography](/geography) API end
385386

386387
### Reports - Example
387388

388-
For 3 months of provider operation in a city (September 2019 through November 2019) for 3 geographies, 2 vehicle types, and 1 special group. Timezone is Eastern Time in the US which is _-4_ from UTC before November 3, 2019, and _-5_ after. Values of `-1` represent [redacted data](#data-redaction) counts.
389+
For 3 months of a single provider operation in a city (September 2019 through November 2019) for 3 geographies, 2 vehicle types, and 1 special group. Timezone is Eastern Time in the US which is _-4_ from UTC before November 3, 2019, and _-5_ after. Values of `-1` represent [redacted data](#data-redaction) counts.
389390

390391
**September 2019** `/reports/2019-09.csv`
391392

392393
```csv
393-
start_date,duration,special_group_type,geography_id,vehicle_type,trip_count,rider_count
394-
2019-09-01T00:00-04,P1M,all_riders,44428624-186b-4fc3-a7fb-124f487464a1,scooter,1302,983
395-
2019-09-01T00:00-04,P1M,low_income,44428624-186b-4fc3-a7fb-124f487464a1,scooter,201,104
396-
2019-09-01T00:00-04,P1M,all_riders,44428624-186b-4fc3-a7fb-124f487464a1,bicycle,530,200
397-
2019-09-01T00:00-04,P1M,low_income,44428624-186b-4fc3-a7fb-124f487464a1,bicycle,75,26
398-
2019-09-01T00:00-04,P1M,all_riders,03db06d0-3998-406a-92c7-25a83fc2784a,scooter,687,450
399-
2019-09-01T00:00-04,P1M,low_income,03db06d0-3998-406a-92c7-25a83fc2784a,scooter,98,45
400-
2019-09-01T00:00-04,P1M,all_riders,03db06d0-3998-406a-92c7-25a83fc2784a,bicycle,256,104
401-
2019-09-01T00:00-04,P1M,low_income,03db06d0-3998-406a-92c7-25a83fc2784a,bicycle,41,16
402-
2019-09-01T00:00-04,P1M,all_riders,8ad39dc3-005b-4348-9d61-c830c54c161b,scooter,201,140
403-
2019-09-01T00:00-04,P1M,low_income,8ad39dc3-005b-4348-9d61-c830c54c161b,scooter,35,21
404-
2019-09-01T00:00-04,P1M,all_riders,8ad39dc3-005b-4348-9d61-c830c54c161b,bicycle,103,39
405-
2019-09-01T00:00-04,P1M,low_income,8ad39dc3-005b-4348-9d61-c830c54c161b,bicycle,15,-1
394+
provider_id,start_date,duration,special_group_type,geography_id,vehicle_type,trip_count,rider_count
395+
48415839-3e38-4ba5-a557-e45fb4e6a0a3,2019-09-01T00:00-04,P1M,all_riders,44428624-186b-4fc3-a7fb-124f487464a1,scooter,1302,983
396+
48415839-3e38-4ba5-a557-e45fb4e6a0a3,2019-09-01T00:00-04,P1M,low_income,44428624-186b-4fc3-a7fb-124f487464a1,scooter,201,104
397+
48415839-3e38-4ba5-a557-e45fb4e6a0a3,2019-09-01T00:00-04,P1M,all_riders,44428624-186b-4fc3-a7fb-124f487464a1,bicycle,530,200
398+
48415839-3e38-4ba5-a557-e45fb4e6a0a3,2019-09-01T00:00-04,P1M,low_income,44428624-186b-4fc3-a7fb-124f487464a1,bicycle,75,26
399+
48415839-3e38-4ba5-a557-e45fb4e6a0a3,2019-09-01T00:00-04,P1M,all_riders,03db06d0-3998-406a-92c7-25a83fc2784a,scooter,687,450
400+
48415839-3e38-4ba5-a557-e45fb4e6a0a3,2019-09-01T00:00-04,P1M,low_income,03db06d0-3998-406a-92c7-25a83fc2784a,scooter,98,45
401+
48415839-3e38-4ba5-a557-e45fb4e6a0a3,2019-09-01T00:00-04,P1M,all_riders,03db06d0-3998-406a-92c7-25a83fc2784a,bicycle,256,104
402+
48415839-3e38-4ba5-a557-e45fb4e6a0a3,2019-09-01T00:00-04,P1M,low_income,03db06d0-3998-406a-92c7-25a83fc2784a,bicycle,41,16
403+
48415839-3e38-4ba5-a557-e45fb4e6a0a3,2019-09-01T00:00-04,P1M,all_riders,8ad39dc3-005b-4348-9d61-c830c54c161b,scooter,201,140
404+
48415839-3e38-4ba5-a557-e45fb4e6a0a3,2019-09-01T00:00-04,P1M,low_income,8ad39dc3-005b-4348-9d61-c830c54c161b,scooter,35,21
405+
48415839-3e38-4ba5-a557-e45fb4e6a0a3,2019-09-01T00:00-04,P1M,all_riders,8ad39dc3-005b-4348-9d61-c830c54c161b,bicycle,103,39
406+
48415839-3e38-4ba5-a557-e45fb4e6a0a3,2019-09-01T00:00-04,P1M,low_income,8ad39dc3-005b-4348-9d61-c830c54c161b,bicycle,15,-1
406407
```
407408

408409
**October 2019** `/reports/2019-10.csv`
409410

410411
```csv
411-
start_date,duration,special_group_type,geography_id,vehicle_type,trip_count,rider_count
412-
2019-10-01T00:00-04,P1M,all_riders,44428624-186b-4fc3-a7fb-124f487464a1,scooter,1042,786
413-
2019-10-01T00:00-04,P1M,low_income,44428624-186b-4fc3-a7fb-124f487464a1,scooter,161,83
414-
2019-10-01T00:00-04,P1M,all_riders,44428624-186b-4fc3-a7fb-124f487464a1,bicycle,424,160
415-
2019-10-01T00:00-04,P1M,low_income,44428624-186b-4fc3-a7fb-124f487464a1,bicycle,60,0
416-
2019-10-01T00:00-04,P1M,all_riders,03db06d0-3998-406a-92c7-25a83fc2784a,scooter,550,360
417-
2019-10-01T00:00-04,P1M,low_income,03db06d0-3998-406a-92c7-25a83fc2784a,scooter,78,36
418-
2019-10-01T00:00-04,P1M,all_riders,03db06d0-3998-406a-92c7-25a83fc2784a,bicycle,205,83
419-
2019-10-01T00:00-04,P1M,low_income,03db06d0-3998-406a-92c7-25a83fc2784a,bicycle,33,13
420-
2019-10-01T00:00-04,P1M,all_riders,8ad39dc3-005b-4348-9d61-c830c54c161b,scooter,161,112
421-
2019-10-01T00:00-04,P1M,low_income,8ad39dc3-005b-4348-9d61-c830c54c161b,scooter,28,-1
422-
2019-10-01T00:00-04,P1M,all_riders,8ad39dc3-005b-4348-9d61-c830c54c161b,bicycle,82,31
423-
2019-10-01T00:00-04,P1M,low_income,8ad39dc3-005b-4348-9d61-c830c54c161b,bicycle,-1,0
412+
provider_id,start_date,duration,special_group_type,geography_id,vehicle_type,trip_count,rider_count
413+
48415839-3e38-4ba5-a557-e45fb4e6a0a3,2019-10-01T00:00-04,P1M,all_riders,44428624-186b-4fc3-a7fb-124f487464a1,scooter,1042,786
414+
48415839-3e38-4ba5-a557-e45fb4e6a0a3,2019-10-01T00:00-04,P1M,low_income,44428624-186b-4fc3-a7fb-124f487464a1,scooter,161,83
415+
48415839-3e38-4ba5-a557-e45fb4e6a0a3,2019-10-01T00:00-04,P1M,all_riders,44428624-186b-4fc3-a7fb-124f487464a1,bicycle,424,160
416+
48415839-3e38-4ba5-a557-e45fb4e6a0a3,2019-10-01T00:00-04,P1M,low_income,44428624-186b-4fc3-a7fb-124f487464a1,bicycle,60,0
417+
48415839-3e38-4ba5-a557-e45fb4e6a0a3,2019-10-01T00:00-04,P1M,all_riders,03db06d0-3998-406a-92c7-25a83fc2784a,scooter,550,360
418+
48415839-3e38-4ba5-a557-e45fb4e6a0a3,2019-10-01T00:00-04,P1M,low_income,03db06d0-3998-406a-92c7-25a83fc2784a,scooter,78,36
419+
48415839-3e38-4ba5-a557-e45fb4e6a0a3,2019-10-01T00:00-04,P1M,all_riders,03db06d0-3998-406a-92c7-25a83fc2784a,bicycle,205,83
420+
48415839-3e38-4ba5-a557-e45fb4e6a0a3,2019-10-01T00:00-04,P1M,low_income,03db06d0-3998-406a-92c7-25a83fc2784a,bicycle,33,13
421+
48415839-3e38-4ba5-a557-e45fb4e6a0a3,2019-10-01T00:00-04,P1M,all_riders,8ad39dc3-005b-4348-9d61-c830c54c161b,scooter,161,112
422+
48415839-3e38-4ba5-a557-e45fb4e6a0a3,2019-10-01T00:00-04,P1M,low_income,8ad39dc3-005b-4348-9d61-c830c54c161b,scooter,28,-1
423+
48415839-3e38-4ba5-a557-e45fb4e6a0a3,2019-10-01T00:00-04,P1M,all_riders,8ad39dc3-005b-4348-9d61-c830c54c161b,bicycle,82,31
424+
48415839-3e38-4ba5-a557-e45fb4e6a0a3,2019-10-01T00:00-04,P1M,low_income,8ad39dc3-005b-4348-9d61-c830c54c161b,bicycle,-1,0
424425
```
425426

426427
**November 2019** `/reports/2019-11.csv`
427428

428429
```csv
429-
start_date,duration,special_group_type,geography_id,vehicle_type,trip_count,rider_count
430-
2019-11-01T00:00-05,P1M,all_riders,44428624-186b-4fc3-a7fb-124f487464a1,scooter,834,629
431-
2019-11-01T00:00-05,P1M,low_income,44428624-186b-4fc3-a7fb-124f487464a1,scooter,129,66
432-
2019-11-01T00:00-05,P1M,all_riders,44428624-186b-4fc3-a7fb-124f487464a1,bicycle,339,128
433-
2019-11-01T00:00-05,P1M,low_income,44428624-186b-4fc3-a7fb-124f487464a1,bicycle,48,-1
434-
2019-11-01T00:00-05,P1M,all_riders,03db06d0-3998-406a-92c7-25a83fc2784a,scooter,440,288
435-
2019-11-01T00:00-05,P1M,low_income,03db06d0-3998-406a-92c7-25a83fc2784a,scooter,62,29
436-
2019-11-01T00:00-05,P1M,all_riders,03db06d0-3998-406a-92c7-25a83fc2784a,bicycle,164,66
437-
2019-11-01T00:00-05,P1M,low_income,03db06d0-3998-406a-92c7-25a83fc2784a,bicycle,26,0
438-
2019-11-01T00:00-05,P1M,all_riders,8ad39dc3-005b-4348-9d61-c830c54c161b,scooter,129,90
439-
2019-11-01T00:00-05,P1M,low_income,8ad39dc3-005b-4348-9d61-c830c54c161b,scooter,22,-1
440-
2019-11-01T00:00-05,P1M,all_riders,8ad39dc3-005b-4348-9d61-c830c54c161b,bicycle,-1,25
441-
2019-11-01T00:00-05,P1M,low_income,8ad39dc3-005b-4348-9d61-c830c54c161b,bicycle,0,0
430+
provider_id,start_date,duration,special_group_type,geography_id,vehicle_type,trip_count,rider_count
431+
48415839-3e38-4ba5-a557-e45fb4e6a0a3,2019-11-01T00:00-05,P1M,all_riders,44428624-186b-4fc3-a7fb-124f487464a1,scooter,834,629
432+
48415839-3e38-4ba5-a557-e45fb4e6a0a3,2019-11-01T00:00-05,P1M,low_income,44428624-186b-4fc3-a7fb-124f487464a1,scooter,129,66
433+
48415839-3e38-4ba5-a557-e45fb4e6a0a3,2019-11-01T00:00-05,P1M,all_riders,44428624-186b-4fc3-a7fb-124f487464a1,bicycle,339,128
434+
48415839-3e38-4ba5-a557-e45fb4e6a0a3,2019-11-01T00:00-05,P1M,low_income,44428624-186b-4fc3-a7fb-124f487464a1,bicycle,48,-1
435+
48415839-3e38-4ba5-a557-e45fb4e6a0a3,2019-11-01T00:00-05,P1M,all_riders,03db06d0-3998-406a-92c7-25a83fc2784a,scooter,440,288
436+
48415839-3e38-4ba5-a557-e45fb4e6a0a3,2019-11-01T00:00-05,P1M,low_income,03db06d0-3998-406a-92c7-25a83fc2784a,scooter,62,29
437+
48415839-3e38-4ba5-a557-e45fb4e6a0a3,2019-11-01T00:00-05,P1M,all_riders,03db06d0-3998-406a-92c7-25a83fc2784a,bicycle,164,66
438+
48415839-3e38-4ba5-a557-e45fb4e6a0a3,2019-11-01T00:00-05,P1M,low_income,03db06d0-3998-406a-92c7-25a83fc2784a,bicycle,26,0
439+
48415839-3e38-4ba5-a557-e45fb4e6a0a3,2019-11-01T00:00-05,P1M,all_riders,8ad39dc3-005b-4348-9d61-c830c54c161b,scooter,129,90
440+
48415839-3e38-4ba5-a557-e45fb4e6a0a3,2019-11-01T00:00-05,P1M,low_income,8ad39dc3-005b-4348-9d61-c830c54c161b,scooter,22,-1
441+
48415839-3e38-4ba5-a557-e45fb4e6a0a3,2019-11-01T00:00-05,P1M,all_riders,8ad39dc3-005b-4348-9d61-c830c54c161b,bicycle,-1,25
442+
48415839-3e38-4ba5-a557-e45fb4e6a0a3,2019-11-01T00:00-05,P1M,low_income,8ad39dc3-005b-4348-9d61-c830c54c161b,bicycle,0,0
442443
```
443444

444445
[Top][toc]
@@ -447,10 +448,11 @@ start_date,duration,special_group_type,geography_id,vehicle_type,trip_count,ride
447448

448449
Here are the possible values for the `special_group_type` dimension field:
449450

450-
| Name | Description |
451-
| ---------- | --------------------------------------------------------------------------------------------------------------------- |
452-
| low_income | Trips where a low income discount is applied by the provider, e.g., a discount from a qualified provider equity plan. |
453-
| all_riders | All riders from any group |
451+
| Name | Description |
452+
| ---------------- | --------------------------------------------------------------------------------------------------------------------- |
453+
| low_income | Trips where a low income discount is applied by the provider, e.g., a discount from a qualified provider equity plan. |
454+
| adaptive_scooter | Trips taken on a scooter with features to improve accessibility for people with disabilities, e.g., scooter with a seat or wider base |
455+
| all_riders | All riders from any group |
454456

455457
Other special group types may be added in future MDS releases as relevant agency and provider use cases are identified. When additional special group types or metrics are proposed, a thorough review of utility and relevance in program oversight, evaluation, and policy development should be done by OMF Working Groups, as well as any privacy implications by the OMF Privacy Committee.
456458

0 commit comments

Comments
 (0)