Skip to content

Commit 9bfddfe

Browse files
committed
Removes columns entirely.
1 parent dc4746f commit 9bfddfe

1 file changed

Lines changed: 41 additions & 43 deletions

File tree

provider/README.md

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

366366
| Column Name | Type | Comments |
367367
|----------------------|--------------------------------------------|----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|
368-
| `start_date` | date | Start date of trip the data row, ISO 8601 format |
369-
| `time_zone` | string | Time zone of market, from the [tzdata database](https://www.iana.org/time-zones) |
370368
| `special_group_type` | [Special Group Type](#special-group-type) | Type that applies to this row |
371369
| `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. |
372370
| `vehicle_type` | [Vehicle Type](/agency#vehicle-type) | Type that applies to this row |
@@ -377,68 +375,68 @@ The authenticated reports are monthly, historic flat files that may be pre-gener
377375

378376
Report contents include every combination of special group types, geography IDs, and vehicle types in operation for each month since the provider began operations in the jurisdiction. New files are added monthly in addition to the previous monthly historic files.
379377

380-
Counts are calculated based the agency's local time zone, and this time zone is returned in the `time_zone` column. Trips are counted based on their start time, i.e. if a trip starts in month A but ends in month B, it will be counted only as part of the report for month A.
378+
Counts are calculated based the agency's local time zone. Trips are counted based on their start time, i.e. if a trip starts in month A but ends in month B, it will be counted only as part of the report for month A.
381379

382380
All geography IDs included in the city published [Geography](/geography) API endpoint are included in the report results. In lieu of serving an API, this can alternately be a [flat file](/geography#file-format) created by the city and sent to the provider via link. If there is no `/geography` available, then counts are for the entire agency operating area, and `null` is returned for each Geography ID.
383381

384382
[Top][toc]
385383

386384
### Reports - Example
387385

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. The time zone is `America/New_York`. Values of `-1` represent [redacted data](#data-redaction) counts.
386+
For 3 months of provider operation in a city (September 2019 through November 2019) for 3 geographies, 2 vehicle types, and 1 special group. Values of `-1` represent [redacted data](#data-redaction) counts.
389387

390388
**September 2019** `/reports/2019-09.csv`
391389

392390
```csv
393-
start_date,time_zone,special_group_type,geography_id,vehicle_type,trip_count,rider_count
394-
2019-09-01,America/New_York,all_riders,44428624-186b-4fc3-a7fb-124f487464a1,scooter,1302,983
395-
2019-09-01,America/New_York,low_income,44428624-186b-4fc3-a7fb-124f487464a1,scooter,201,104
396-
2019-09-01,America/New_York,all_riders,44428624-186b-4fc3-a7fb-124f487464a1,bicycle,530,200
397-
2019-09-01,America/New_York,low_income,44428624-186b-4fc3-a7fb-124f487464a1,bicycle,75,26
398-
2019-09-01,America/New_York,all_riders,03db06d0-3998-406a-92c7-25a83fc2784a,scooter,687,450
399-
2019-09-01,America/New_York,low_income,03db06d0-3998-406a-92c7-25a83fc2784a,scooter,98,45
400-
2019-09-01,America/New_York,all_riders,03db06d0-3998-406a-92c7-25a83fc2784a,bicycle,256,104
401-
2019-09-01,America/New_York,low_income,03db06d0-3998-406a-92c7-25a83fc2784a,bicycle,41,16
402-
2019-09-01,America/New_York,all_riders,8ad39dc3-005b-4348-9d61-c830c54c161b,scooter,201,140
403-
2019-09-01,America/New_York,low_income,8ad39dc3-005b-4348-9d61-c830c54c161b,scooter,35,21
404-
2019-09-01,America/New_York,all_riders,8ad39dc3-005b-4348-9d61-c830c54c161b,bicycle,103,39
405-
2019-09-01,America/New_York,low_income,8ad39dc3-005b-4348-9d61-c830c54c161b,bicycle,15,-1
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
406404
```
407405

408406
**October 2019** `/reports/2019-10.csv`
409407

410408
```csv
411-
start_date,time_zone,special_group_type,geography_id,vehicle_type,trip_count,rider_count
412-
2019-10-01,America/New_York,all_riders,44428624-186b-4fc3-a7fb-124f487464a1,scooter,1042,786
413-
2019-10-01,America/New_York,low_income,44428624-186b-4fc3-a7fb-124f487464a1,scooter,161,83
414-
2019-10-01,America/New_York,all_riders,44428624-186b-4fc3-a7fb-124f487464a1,bicycle,424,160
415-
2019-10-01,America/New_York,low_income,44428624-186b-4fc3-a7fb-124f487464a1,bicycle,60,0
416-
2019-10-01,America/New_York,all_riders,03db06d0-3998-406a-92c7-25a83fc2784a,scooter,550,360
417-
2019-10-01,America/New_York,low_income,03db06d0-3998-406a-92c7-25a83fc2784a,scooter,78,36
418-
2019-10-01,America/New_York,all_riders,03db06d0-3998-406a-92c7-25a83fc2784a,bicycle,205,83
419-
2019-10-01,America/New_York,low_income,03db06d0-3998-406a-92c7-25a83fc2784a,bicycle,33,13
420-
2019-10-01,America/New_York,all_riders,8ad39dc3-005b-4348-9d61-c830c54c161b,scooter,161,112
421-
2019-10-01,America/New_York,low_income,8ad39dc3-005b-4348-9d61-c830c54c161b,scooter,28,-1
422-
2019-10-01,America/New_York,all_riders,8ad39dc3-005b-4348-9d61-c830c54c161b,bicycle,82,31
423-
2019-10-01,America/New_York,low_income,8ad39dc3-005b-4348-9d61-c830c54c161b,bicycle,-1,0
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
424422
```
425423

426424
**November 2019** `/reports/2019-11.csv`
427425

428426
```csv
429-
start_date,time_zone,special_group_type,geography_id,vehicle_type,trip_count,rider_count
430-
2019-11-01,America/New_York,all_riders,44428624-186b-4fc3-a7fb-124f487464a1,scooter,834,629
431-
2019-11-01,America/New_York,low_income,44428624-186b-4fc3-a7fb-124f487464a1,scooter,129,66
432-
2019-11-01,America/New_York,all_riders,44428624-186b-4fc3-a7fb-124f487464a1,bicycle,339,128
433-
2019-11-01,America/New_York,low_income,44428624-186b-4fc3-a7fb-124f487464a1,bicycle,48,-1
434-
2019-11-01,America/New_York,all_riders,03db06d0-3998-406a-92c7-25a83fc2784a,scooter,440,288
435-
2019-11-01,America/New_York,low_income,03db06d0-3998-406a-92c7-25a83fc2784a,scooter,62,29
436-
2019-11-01,America/New_York,all_riders,03db06d0-3998-406a-92c7-25a83fc2784a,bicycle,164,66
437-
2019-11-01,America/New_York,low_income,03db06d0-3998-406a-92c7-25a83fc2784a,bicycle,26,0
438-
2019-11-01,America/New_York,all_riders,8ad39dc3-005b-4348-9d61-c830c54c161b,scooter,129,90
439-
2019-11-01,America/New_York,low_income,8ad39dc3-005b-4348-9d61-c830c54c161b,scooter,22,-1
440-
2019-11-01,America/New_York,all_riders,8ad39dc3-005b-4348-9d61-c830c54c161b,bicycle,-1,25
441-
2019-11-01,America/New_York,low_income,8ad39dc3-005b-4348-9d61-c830c54c161b,bicycle,0,0
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
442440
```
443441

444442
[Top][toc]

0 commit comments

Comments
 (0)