feat(component): GeographyQuizMap — Interactive Map Quiz

[bntvllnt]

Summary

Interactive map quiz where students identify countries, capitals, regions, or historical locations by clicking on the map. Gamified geography learning.

Proposed API

<GeographyQuizMap
  mode="identify" // identify | locate | match
  questions={[
    { id: 1, question: "Click on France", answer: "FRA", type: "country" },
    { id: 2, question: "Where is the Nile River?", answer: nileGeoJSON, type: "feature" },
    { id: 3, question: "Click on Tokyo", answer: [35.68, 139.69], tolerance: 100, type: "point" },
  ]}
  onComplete={handleResults}
  showScore
  timeLimit={60}
>
  <GeographyQuizMapPrompt /> {/* shows current question */}
  <GeographyQuizMapScore />
  <GeographyQuizMapTimer />
  <GeographyQuizMapHint limit={3} /> {/* zoom to region hint */}
  <GeographyQuizMapResults /> {/* end screen with correct answers */}
</GeographyQuizMap>

Quiz Modes

• Identify: "Click on [country/feature]" — click correct region
• Locate: "Where is [city/landmark]?" — click on map point (proximity scoring)
• Match: Match labels to locations (drag name to country)

Requirements

• Country/region click detection via GeoJSON
• Point proximity scoring (close = partial credit)
• Visual feedback: correct (green flash), incorrect (red flash + show correct)
• Score tracking (correct/total, accuracy percentage)
• Timer (optional countdown)
• Hint system (zoom to continent/region)
• Streak tracking
• Results screen with all answers reviewed
• Difficulty levels (continents → countries → cities → features)
• Randomized question order
• Composes: Map2D (feat(component): Map2D — Interactive 2D Map #28), ChoroplethMap (feat(component): ChoroplethMap — Region-Colored Data Map #60)
• Accessible: keyboard alternative for map clicks

Educational Use Cases

• Geography class quizzes
• Country identification games
• Historical geography (identify ancient cities)
• Capital city memorization
• Physical geography (rivers, mountains, deserts)

References

• Seterra Geography Quizzes
• Sporcle Map Quizzes