Get each district's attendance-zone coverage

How completely each standard district's attendance zones were collected, one row per district and zone level: the source tier, the status of each level, the share of the district's land and 2020 population the zones cover, how they were built, and the reason for anything short of complete.

The API returns one row per district with a column per level (level_status_elementary, pct_population_middle, ...); this function pivots those columns long. The district filter runs in R (the route takes no filters; the table has about 180 rows).

Usage

gcd_school_zone_coverage(
  district_code = NULL,
  district = NULL,
  geometry = FALSE
)

Arguments

district_code

A character vector of district codes. Default NULL: every district.

district

District names, matched to codes as in gcd_rows(). Default NULL.

geometry

FALSE (default) returns a tibble; TRUE returns an sf object of the district outlines carrying the same fields (needs the 'sf' package).

Value

A tibble (or sf object), one row per district and zone level, with columns year (integer), district_code, district_name, tier (the source tier, A to E or N), status (the district's overall status), zone_level, level_status ("zoned", "one_school_per_grade", "partial", "not_available", "served_by_other_district"), pct_land_area and pct_population (0-1, the share the level's zones cover), zone_count, methods, accuracy_classes, reason, then levels_covered, currency_statuses, best_lead, extension_note and served_elsewhere (a list-column of tibbles: the other district's school serving that level, with district_code, school_code and reason).

See also

gcd_school_zones() for the zones.

Other geography: gcd_district_boundaries(), gcd_locate(), gcd_school_zone_status(), gcd_school_zones()

Examples

if (FALSE) { # interactive()
gcd_school_zone_coverage(district = "Clay County")
coverage <- gcd_school_zone_coverage()
table(coverage$zone_level, coverage$level_status)
}