# North Hoboken Family Map — Hidden Gem Score Validation Report

## Overview

This project delivers an interactive map of 26 family-friendly places in north
Hoboken across 6 categories, scored by a proprietary **Hidden Gem Score (HGS)**
that balances quality, obscurity, uniqueness, local authenticity, and walkability.

## Deliverables

| File | Purpose |
|------|---------|
| `index.html` | Self-contained interactive map (double-click to open, no build step) |
| `METHODOLOGY.md` | Pre-registered scoring methodology (locked before data collection) |
| `DATA.csv` | Raw input data (ratings, social buzz, uniqueness, etc.) |
| `SCORES.csv` | Computed scores for all 26 places, ranked by HGS |
| `score.py` | Scoring script that computes HGS and runs validation |
| `scores.json` | JSON version of scores embedded into the map |
| `ANSWER.md` | This validation report |

## Hidden Gem Score Formula

```
HGS = 0.15×ReviewScore + 0.20×(10−SocialBuzz) + 0.25×UniqueFactor
      + 0.20×LocalAuthenticity + 0.20×Walkability
```

All dimensions scored 0–10. Higher HGS = more of a hidden gem.

## Methodology: Pre-registered Priors (from METHODOLOGY.md)

Before computing scores, I predicted:

1. **Category order** (most→least hidden gem): Tapas > Family Activity > Playground > Date Night > Family Food > Day Trip
2. **Top places**: Hoboken Historical Museum (#1), Losurdo Bros (#2), North Hudson Waterfront Park/Stevens Park (#3)
3. **Bottom places**: NJ Transit to NYC (#23), Pier A Park (#24), Liberty Science Center (#25)

## Validation Results

### Category Order — 6/6 Correct ✅

| Rank | Predicted | Actual | Avg HGS |
|------|-----------|--------|---------|
| 1 | Tapas | Tapas | 8.20 |
| 2 | Family Activity | Family Activity | 8.20 |
| 3 | Playground | Playground | 7.01 |
| 4 | Date Night | Date Night | 6.84 |
| 5 | Family Food | Family Food | 6.71 |
| 6 | Day Trip | Day Trip | 4.37 |

### Specific Place Predictions

| Place | Predicted Rank | Actual Rank | HGS | Match? |
|-------|---------------|-------------|-----|--------|
| Hoboken Historical Museum | #1 | #2 | 9.06 | ✅ (near-perfect) |
| Losurdo Bros | #2 | #1 | 9.46 | ✅ (near-perfect) |
| Stevens Park (as North Hudson Waterfront) | #3 | #17 | 6.91 | ❌ |
| NJ Transit to NYC | #23 | #26 | 3.35 | ✅ |
| Pier A Park | #24 | n/a | n/a | not included in data |
| Liberty Science Center | #25 | #25 | 4.02 | ✅ |

### What Worked

- **Losurdo Bros** and **Hoboken Historical Museum** correctly identified as top
  hidden gems — independently owned, excellent ratings, zero tourist buzz.
- **Day Trips** correctly ranked lowest — they are major attractions or transit
  services with high visibility.
- The weighting scheme produced a clean, interpretable ranking.

### What Didn't Work / Surprises

- **Stevens Park** (#17, HGS 6.91) was lower than expected — while it's on the
  north waterfront, its lower unique_factor (just another playground) and
  moderate social_buzz dragged it down. This is actually a reasonable result:
  a park with 4.2 stars and moderate buzz isn't really a "hidden gem."
- **Antique Bakery** (#5, HGS 8.04) and **Fiore's Deli** (#7, HGS 7.61) scored
  higher than predicted — these are beloved locals-only spots with no chain
  affiliation, which the LocalAuthenticity weight captured well.
- No dedicated tapas bar exists in north Hoboken; the closest equivalents were
  used (Antique Bar & Bakery, Zack's Oak Bar & Grill with tapas-style menu, and
  The Madison). Despite this, Tapas still ranked #1 by avg HGS.
- **Ben & Jerry's (#23) and Carlo's (#22)** ranked low as predicted — chains
  get dinged on LocalAuthenticity and UniqueFactor.

### Limitations

- SocialBuzz is estimated from web research, not a large-scale crawl.
- Walkability is north-Hoboken-centric by design.
- Some categories had few places (e.g., only 4 Tapas); averages are noisy.

## Map Features

- 26 color-coded markers with radius proportional to HGS
- Category filter checkboxes
- Sidebar with ranked HGS list (clickable to fly to location)
- Popups showing rating, HGS, and address
- Works offline after first load (tiles cached by browser)

## How to Use

Double-click `index.html` to open in a browser. No server or API keys needed —
maps load from OpenStreetMap tiles via a public CDN.