API setup
This page is ready to work with two APIs: NYC Open Data (Socrata) for live NYC datasets and Google Maps Embed API for an interactive map. You can launch without any API keys by keeping the curated resources below, then add the keys later.
1) NYC Open Data
Paste your Socrata app token into the JavaScript config. The page can still work without a token for light traffic, but a token is better for reliability.
const CONFIG = {
socrataAppToken: "PASTE_YOUR_SOCRATA_APP_TOKEN",
googleMapsApiKey: "PASTE_YOUR_GOOGLE_MAPS_API_KEY"
};
2) Google Maps Embed API
Enable the Maps Embed API in Google Cloud, create a browser-restricted API key, then paste it into the same config object. The map updates when people select a resource card.
https://www.google.com/maps/embed/v1/place?key=YOUR_KEY&q=400-430+East+30th+Street+New+York+NY
Good launch strategy: keep the curated links live from day one, then use the APIs to add smarter search, more locations, and live maps.
Map is using a simple public Google embed right now. Add your Google Maps Embed API key to unlock smarter place embeds and better map control.
Tap a card to update the map. Cards marked Live API are pulled from NYC Open Data when your Socrata settings are added.
NYC resource directory
Start with the official city help points, then use the nonprofits and churches for meals, clothing, support, and advocacy. Live API cards can be loaded underneath the curated list.
Design upgrades for your HUGS version
Design Idea
Use a crisis-first sticky bar
Keep 311, 911, Food Help NYC, and “Get Directions” visible on mobile at all times.
Design Idea
Add a HUGS request intake form
Let users choose food, shelter, clothing, transportation, caregiver help, or case support.
Design Idea
Show trust labels
Mark each card as Official NYC, Nonprofit, Church/Faith, or HUGS Community Partner.
Design Idea
Add borough quick tabs
A Bronx, Brooklyn, Manhattan, Queens, and Staten Island toggle makes the page much faster to use under stress.