Skip to content

Commit 8d4cc7e

Browse files
wellorderwellorder
committed
Changes from discusssion.
1 parent 128163f commit 8d4cc7e

1 file changed

Lines changed: 48 additions & 46 deletions

File tree

‎provider/README.md‎

Lines changed: 48 additions & 46 deletions
Original file line numberDiff line numberDiff line change
@@ -363,13 +363,15 @@ The authenticated reports are monthly, historic flat files that may be pre-gener
363363
**`data` Filename:** monthly file named by year and month, e.g. `/reports/YYYY-MM.csv`
364364
**`data` Payload:** monthly CSV files with the following structure:
365365

366-
| Column Name | Type | Comments |
367-
|----------------------|--------------------------------------------|----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|
368-
| `special_group_type` | [Special Group Type](#special-group-type) | Type that applies to this row |
369-
| `geography_id` | [Geography](/geography) | ID that applies to this row. Includes all IDs in /geography. When there is no /geography then return `null` for this value and return counts based on the entire operating area. |
370-
| `vehicle_type` | [Vehicle Type](/agency#vehicle-type) | Type that applies to this row |
371-
| `trip_count` | integer | Count of trips taken for this row |
372-
| `rider_count` | integer | Count of unique riders for this row |
366+
| Column Name | Type | Comments |
367+
|----------------|--------------------------------------|----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|
368+
| `provider_id` | UUID | A UUID for the Provider, unique within MDS. See MDS provider_id in [provider list](/providers.csv). |
369+
| `start_date` | date | Start date of trip the data row, ISO 8601 date format, i.e. YYYY-MM-DD || `special_group_type` | [Special Group Type](#special-group-type) | Type that applies to this row |
370+
| `duration` | string | Value is always `P1M` for monthly. Based on [ISO 8601 duration](https://en.wikipedia.org/wiki/ISO_8601#Durations) |
371+
| `geography_id` | [Geography](/geography) | ID that applies to this row. Includes all IDs in /geography. When there is no /geography then return `null` for this value and return counts based on the entire operating area. |
372+
| `vehicle_type` | [Vehicle Type](/agency#vehicle-type) | Type that applies to this row |
373+
| `trip_count` | integer | Count of trips taken for this row |
374+
| `rider_count` | integer | Count of unique riders for this row |
373375

374376
#### Data Notes
375377

@@ -388,55 +390,55 @@ For 3 months of provider operation in a city (September 2019 through November 20
388390
**September 2019** `/reports/2019-09.csv`
389391

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

406408
**October 2019** `/reports/2019-10.csv`
407409

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

424426
**November 2019** `/reports/2019-11.csv`
425427

426428
```csv
427-
special_group_type,geography_id,vehicle_type,trip_count,rider_count
428-
all_riders,44428624-186b-4fc3-a7fb-124f487464a1,scooter,834,629
429-
low_income,44428624-186b-4fc3-a7fb-124f487464a1,scooter,129,66
430-
all_riders,44428624-186b-4fc3-a7fb-124f487464a1,bicycle,339,128
431-
low_income,44428624-186b-4fc3-a7fb-124f487464a1,bicycle,48,-1
432-
all_riders,03db06d0-3998-406a-92c7-25a83fc2784a,scooter,440,288
433-
low_income,03db06d0-3998-406a-92c7-25a83fc2784a,scooter,62,29
434-
all_riders,03db06d0-3998-406a-92c7-25a83fc2784a,bicycle,164,66
435-
low_income,03db06d0-3998-406a-92c7-25a83fc2784a,bicycle,26,0
436-
all_riders,8ad39dc3-005b-4348-9d61-c830c54c161b,scooter,129,90
437-
low_income,8ad39dc3-005b-4348-9d61-c830c54c161b,scooter,22,-1
438-
all_riders,8ad39dc3-005b-4348-9d61-c830c54c161b,bicycle,-1,25
439-
low_income,8ad39dc3-005b-4348-9d61-c830c54c161b,bicycle,0,0
429+
start_date,duration,special_group_type,geography_id,vehicle_type,trip_count,rider_count
430+
2019-11-01,P1M,all_riders,44428624-186b-4fc3-a7fb-124f487464a1,scooter,834,629
431+
2019-11-01,P1M,low_income,44428624-186b-4fc3-a7fb-124f487464a1,scooter,129,66
432+
2019-11-01,P1M,all_riders,44428624-186b-4fc3-a7fb-124f487464a1,bicycle,339,128
433+
2019-11-01,P1M,low_income,44428624-186b-4fc3-a7fb-124f487464a1,bicycle,48,-1
434+
2019-11-01,P1M,all_riders,03db06d0-3998-406a-92c7-25a83fc2784a,scooter,440,288
435+
2019-11-01,P1M,low_income,03db06d0-3998-406a-92c7-25a83fc2784a,scooter,62,29
436+
2019-11-01,P1M,all_riders,03db06d0-3998-406a-92c7-25a83fc2784a,bicycle,164,66
437+
2019-11-01,P1M,low_income,03db06d0-3998-406a-92c7-25a83fc2784a,bicycle,26,0
438+
2019-11-01,P1M,all_riders,8ad39dc3-005b-4348-9d61-c830c54c161b,scooter,129,90
439+
2019-11-01,P1M,low_income,8ad39dc3-005b-4348-9d61-c830c54c161b,scooter,22,-1
440+
2019-11-01,P1M,all_riders,8ad39dc3-005b-4348-9d61-c830c54c161b,bicycle,-1,25
441+
2019-11-01,P1M,low_income,8ad39dc3-005b-4348-9d61-c830c54c161b,bicycle,0,0
440442
```
441443

442444
[Top][toc]

0 commit comments

Comments
 (0)