# Juried Road historical map website

## Open the website

Double-click `index.html`. The map has no account or internet requirement.

If a browser limits local files, open a terminal in this folder, run `python3 -m http.server 8000`, and visit `http://localhost:8000`.

Once hosted, the site can be installed like an app. On iPhone or iPad, open the site in Safari, tap **Share**, and choose **Add to Home Screen**. On supported desktop and Android browsers, use the **Install** button when it appears. After one complete online visit, the service worker keeps the site’s map data and optimized imagery available offline.

## Using the map

- Move the year control or select a printed year to step through the aerial record.
- Select **Play** to advance automatically through all observation years; select **Pause** or choose a year manually to stop.
- Turn layers on and off in the left panel. On a phone, use **Layers**.
- Select a colored area, line, landmark, or parcel outline for its interpretation, confidence, visibility, parcel, source frame, and date.
- Use **Compare** to place the selected year beside 1968. On 1968, the comparison uses the first available year.
- Drag to pan. Use `+`, `−`, and the home button to zoom or reset.

## Structure

```text
Historical_Map_Website/
├── index.html                 Page structure and explanatory text
├── styles.css                 Responsive archival visual design
├── app.js                     Map, timeline, layers, details, comparison
├── manifest.webmanifest       Installable-app name, colors, and icons
├── sw.js                      Offline cache for the static site
├── data/map-data.js           Generated browser-safe map data
├── assets/aerials/            Optimized co-registered WebP images
├── assets/tiles/              Zoom tiles for high-resolution orthophotos
├── assets/icons/              PWA and iPhone home-screen icons
└── tools/generate_web_assets.py
                               Repeatable data and image generator
```

The site is dependency-free. It does not call external maps, analytics, fonts, or imagery services.

## Publishing package

`deployment/Juried_Road_Website_Cloudflare.zip` is the upload-ready static package. It contains only the public website files—not the GeoPackage, source TIFFs, generator, or private research directories. Because the website includes precise parcel geometry and aerial imagery, publish it only when public access is intended.

The timeline has 22 selectable observation years: 1960, 1968, 1973, 1978, 1981, 1985, 1986, 1987, 1995, 1997, 2001, 2004, 2009, 2010, 2014, 2016, 2017, 2018, 2020, 2022, 2025, and 2026. The source register also preserves 2005 and 2015 Landsat metadata-only records; they are intentionally not selectable because no local farm pixels support landscape observations.

The 2009 selection uses the complete May 21, 2009 USDA NAIP natural-color orthophoto at 1-meter native resolution. It supersedes the earlier incomplete delivery that did not cover the farm.

## Relationship to the GIS sources

The authoritative historical research source remains `../Aerial_Satellite_Acquisitions/Historical_Change_Layer_1960_2026/Juried_Road_Historical_Change_1960_2026.gpkg`. The generator reads that package’s polygon, corridor, and landmark GeoJSON exports and event-register CSV. `data/map-data.js` is a generated browser delivery copy, not a replacement for the GeoPackage.

Historical observation geometry is based on the vetted 1968 units and repeated by date so the same areas can be compared consistently. It is not a set of independently surveyed annual boundaries.

The parcel outlines come from `../Acinapura_Official_Parcels.geojson`. The website copy retains only parcel ID, display label, acreage, property class, geometry, and source note. Owner, mailing, account, deed, and assessment fields are intentionally excluded.

The WebP aerials are browser-sized WGS 84 derivatives made from existing georeferenced TIFFs on a shared crop. Multi-gigabyte source imagery is never embedded.

Each selectable year uses the best suitable locally available georeferenced source recorded for website delivery. Film-era dates use the preferred registered historical frame; modern high-resolution dates use the GeoTIFF rather than a JPEG preview. The 1995 display is a website-only hybrid from the same May 7 flight: the 1-metre USGS Gilboa DOQ supplies detail where it covers the parcels, and the registered NAPP frame supplies the eastern remainder. The source files and authoritative GIS package are unchanged. The 1995 hybrid and the 2001, 2004, 2009, 2010, 2014, 2016, 2018, 2022, and 2025 orthophotos have 2,048-pixel zoom-tile derivatives. The map switches to those tiles when zoomed and loads only tiles near the visible area. The 2017, 2020, and 2026 selections use Sentinel-2 true-color imagery and remain limited to broad land-cover context.

## Refreshing generated assets

Run `tools/generate_web_assets.py` with Python plus rasterio, Pillow, NumPy, and Shapely. The script reads source files without modifying them and writes only within this website folder.

## Evidence limitations

Current parcels are reference boundaries, not historical ownership surveys. `no_conclusion` indicates obscured or inadequate source evidence, not disappearance. Film, season, vegetation, shadows, labels, seams, sensor resolution, and georeferencing uncertainty limit direct comparisons. The 1973 NRCS sheet is especially affected by labels, fiducials, and a mosaic seam. Structure construction or demolition should not be inferred without corroborating photographs or documentary sources.