Skip to main content

​
Overview

Borough enriches building data with quality scores computed from NYC Open Data sources. Each score ranges from 0 to 100, where higher is better. Scores are available via GET /v1/building/{id}/scores.

​
Score types

​
Health Score

Source: HPD Violations (NYC Department of Housing Preservation & Development) Measures building maintenance quality based on open HPD violations.
  • Class C (immediately hazardous): -3 points each
  • Class B (hazardous): -2 points each
  • Class A (non-hazardous): -1 point each
  • Formula: max(0, 100 - weighted_sum)
Individual violations are available via GET /v1/building/{id}/violations.

​
Noise Score

Source: 311 Service Requests (noise complaints) Measures ambient noise levels based on 311 noise complaints within 200 meters of the building over the trailing 6 months. Uses logarithmic inverse normalization against a max of 50 complaints.

​
Safety Score

Source: NYPD Complaint Data Measures neighborhood safety based on NYPD complaint data within 400 meters over the trailing 12 months. Weighted by severity:
  • Felony: 5 points
  • Misdemeanor: 2 points
  • Violation: 1 point
Uses logarithmic decay against a max of 200 weighted points.

​
Transit Score

Source: MTA GTFS Stops Measures public transit accessibility based on proximity and density of subway/bus stops within 400 meters. Two components (50 points each):
  • Proximity: Linear decay based on distance to nearest stop (0-400m)
  • Density: Logarithmic scale of stops within 400m

​
Update frequency

ScoreScheduleData Source
HealthWeeklyHPD violations
NoiseWeekly311 complaints
SafetyWeeklyNYPD data
TransitMonthlyGTFS stops
Internet providersMonthlyFCC Broadband Map
Enrichment jobs run on a periodic schedule. Scores reflect the most recent computation cycle.

​
Internet provider availability

Borough also enriches buildings with likely internet provider availability from official FCC Broadband Data Collection public data.
  • Coverage level: exact-building when matched, or Census-block level from FCC public bulk imports
  • Source: FCC Broadband Map public availability data
  • Cadence: monthly scheduled refresh plus manual backfills when needed
  • Disclaimer: provider availability may vary by apartment or unit
This product uses FCC APIs and/or Data but is not endorsed or certified by the FCC.

​
Internal ops

The FCC API integration requires FCC Broadband Data Collection credentials for authenticated jobs; public bulk imports can also be loaded from FCC BDC published files.
  1. Create an FCC Broadband Map account.
  2. Generate an API key from the FCC Broadband Map account tools.
  3. Set worker secrets for FCC_BDC_USERNAME, FCC_BDC_HASH_VALUE, and FCC_BDC_API_KEY when using authenticated FCC API jobs.
  4. Trigger the broadband enrichment job manually for the initial backfill, then let the monthly cron maintain it.

​
Availability

  • Scores require building geo-coordinates (latitude/longitude)
  • Health score additionally requires a BBL (Borough-Block-Lot) identifier
  • Not all buildings have all scores; missing scores return null