🌍 GeoGuesser

Can you guess where in the world you are?

A quick geography quiz: five rounds, each showing a real street-view or satellite image of a city somewhere in the world. Pick the right city from four choices before time runs out on your streak.

How to play

1. Follow the setup step below to add your Google Maps API key.
2. Open index.html in a browser — no build step, no server required.
3. Hit Let's Play!
4. Five questions, four choices each. Click an answer, or use the keyboard.

Keyboard shortcuts

Key	Action
1–4	Pick an answer
Tab	Cycle through options
→ / Enter	Advance to the next question
Esc	Clear focus

Setup

This game pulls real street-view and satellite imagery from the Google Maps Platform, so it needs an API key.

1. In Google Cloud Console, enable the Street View Static API and Maps Static API for a project, and create an API key.
2. Restrict the key (HTTP referrers) to the domain(s) you'll host this on, and set a quota/budget alert — the key is used client-side, so restricting it is what keeps it safe to use in a page anyone can view.
3. Copy config.example.js to config.js and paste your key in:

   cp config.example.js config.js

4. Open index.html.

config.js is gitignored — your key never gets committed.

Tech

Plain HTML, CSS, and JavaScript — no frameworks, no dependencies, no build tools. Sound effects are synthesized live with the Web Audio API.

Running it

git clone git@github.com:jeperry/GeoGuesser.git
cd GeoGuesser
cp config.example.js config.js   # add your API key
open index.html