Skip to content

About

A browser-based GeoGuessr clone for Belarus built with vanilla JavaScript, Yandex Maps API, and Leaflet.

Topics

Resources

Stars

2 stars

Watchers

0 watching

Forks

Latest commit

 

History

5 Commits

Folders and files

Repository files navigation

BeloGuessr

BeloGuessr is a browser-based game inspired by GeoGuessr mechanics. The player navigates through random street panoramas and marks their current location on an interactive map as accurately as possible.

Screenshots

image_2026-06-08_18-21-10 image_2026-06-08_18-22-37 image_2026-06-08_18-42-44 image_2026-06-08_18-20-53

Key Features

  • Panoramas: Utilizing the Yandex Maps API to display random panoramas at specific coordinates.
  • Interactive Map: Built with Leaflet, supporting various layers (OSM, Satellite, Hybrid) and automatic regional boundary masking using the Nominatim API.
  • Scoring System: Calculates the distance between the actual coordinates and the player's guess using the Haversine formula, converting it into points (maximum 5000 per round).
  • Statistics and Customization: Local storage of the username, games played, wins, and round settings via localStorage.
  • Adaptive Interface: Supports light and dark themes.

Tech Stack

  • HTML5 / CSS3
  • Vanilla JavaScript
  • Yandex Maps API
  • Leaflet.js
  • OpenStreetMap / ArcGIS

Running the Project

The project consists of static files and requires no complex build process. To ensure proper network request handling (CORS) and map API functionality, it should be run through a local web server.

git clone git@github.com:NotiLo-A/BeloGuesser.git
cd BeloGuesser
python -m http.server 8000

Open your browser and navigate to http://localhost:8000.

Future Plans

  • Multiplayer implementation (creating custom rooms and joining via unique codes).
  • Backend integration for managing game sessions and a global leaderboard.

About

A browser-based GeoGuessr clone for Belarus built with vanilla JavaScript, Yandex Maps API, and Leaflet.

Topics

Resources

Stars

2 stars

Watchers

0 watching

Forks

Releases

Used by

Contributors

Languages