Building Scores

​

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

​

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