Replace the static housing map with Google Maps #99

Closed
opened 2026-09-18 21:00:26 +00:00 by emmawong · 3 comments
Member

Overall Objective

Replace the static image on /map with an interactive Google Map showing our dorms. Users should be able to pan, zoom, and select a dorm marker to open its existing building-details page.

No new Figma design is required!

Suggested Approach

Use Google's React Maps tutorial as guidance. Follow sections 3–6 for the map and markers, then 8 for clicks. The setup has already been taken care of.

  1. Open apps/frontend/src/app/map-page.tsx. Follow the tutorial's APIProvider and Map examples to replace the static image.

  2. Use the settings from issue #94 instead of pasting the tutorial's key. Request /api/config/maps through apps/frontend/src/api/client.ts, then pass its apiKey to APIProvider and mapId to Map when enabled is true.

  3. Replace the tutorial's Sydney locations with CMU dorms. Use the coordinates added in Issue #97 : location.latitude becomes lat, and location.longitude becomes lng. Give each marker the dorm's name and skip any record without valid coordinates.

  4. Follow the tutorial's marker-click example, but open the dorm's existing page instead of moving the map. Use React Router's useNavigate() to go to /building/${building.id}. No popup or new details page is needed.

  5. Choose an initial view that shows the dorms around CMU. Give the map a visible height, keep the current page heading, and change the instructions to “Select a dorm marker to view building details.” Make sure it fits on both phones and desktops.

  6. Show a loading message while the map starts, and an unavailable message with building links if settings are missing or loading fails.

Help & Resources

### Overall Objective Replace the static image on `/map` with an interactive Google Map showing our dorms. Users should be able to pan, zoom, and select a dorm marker to open its existing building-details page. No new Figma design is required! ### Suggested Approach Use [Google's React Maps tutorial](https://developers.google.com/codelabs/maps-platform/maps-platform-101-react-js#5) as guidance. Follow sections **3–6** for the map and markers, then **8** for clicks. The setup has already been taken care of. 1. Open [`apps/frontend/src/app/map-page.tsx`](https://git.cmu.dev/ScottyLabs/housing/src/branch/main/apps/frontend/src/app/map-page.tsx). Follow the tutorial's `APIProvider` and `Map` examples to replace the static image. 2. Use the settings from issue #94 instead of pasting the tutorial's key. Request `/api/config/maps` through `apps/frontend/src/api/client.ts`, then pass its `apiKey` to `APIProvider` and `mapId` to `Map` when `enabled` is true. 3. Replace the tutorial's Sydney locations with CMU dorms. Use the coordinates added in Issue #97 : `location.latitude` becomes `lat`, and `location.longitude` becomes `lng`. Give each marker the dorm's name and skip any record without valid coordinates. 4. Follow the tutorial's marker-click example, but open the dorm's existing page instead of moving the map. Use React Router's `useNavigate()` to go to `/building/${building.id}`. No popup or new details page is needed. 5. Choose an initial view that shows the dorms around CMU. Give the map a visible height, keep the current page heading, and change the instructions to “Select a dorm marker to view building details.” Make sure it fits on both phones and desktops. 6. Show a loading message while the map starts, and an unavailable message with building links if settings are missing or loading fails. ### Help & Resources - Issue #94 - Issue #97 - [README](../../ScottyLabs/housing/src/branch/main/README.md) - [Contributing Guidelines](../../ScottyLabs/housing/src/branch/main/docs/CONTRIBUTING.md)
rhsen self-assigned this 2026-09-19 20:25:40 +00:00
Member

No activity here for 21 days. If this is still live, drop a comment or push something and I'll clear the label. Otherwise it'll be unassigned on the next sweep.

No activity here for 21 days. If this is still live, drop a comment or push something and I'll clear the label. Otherwise it'll be unassigned on the next sweep.
Member

work in progress

work in progress
Member

No activity here for 21 days. If this is still live, drop a comment or push something and I'll clear the label. Otherwise it'll be unassigned on the next sweep.

No activity here for 21 days. If this is still live, drop a comment or push something and I'll clear the label. Otherwise it'll be unassigned on the next sweep.
Sign in to join this conversation.
No milestone
No assignees
3 participants
Notifications
Due date
The due date is invalid or out of range. Please use the format "yyyy-mm-dd".

No due date set.

Dependencies

No dependencies set

Reference
ScottyLabs/housing#99
No description provided.