World-Map-Explorer

World-Map-Explorer is an intuitive, accessible, and user-friendly tool designed to explore and learn about the map inclusively. This project is developed by Zendalona. The goal of the project is to ensure that everyone can access the world map in a playful and educational manner.

Table of Contents

• Introduction
• Features
• Installation
• Usage

Introduction

World-Map-Explorer is an inclusive and educational mapping tool designed for individuals with visual impairments as well as sighted users. The purpose is to detail the requirements for creating an accessible, user-friendly application that serves educational purposes and enhances the mapping experience for all users.

Features

• Capturing User Location: Automatically center the map on your location using your IP address for a personalized experience.

• Keyboard-Assisted Navigation: Navigate the map effortlessly using arrow keys to move the cursor in any direction.

• Navigation Using Search: Discover any location with ease using the search feature to explore countries, states, rivers, and historical monuments.

• Boundary Setting for Search and navigation: Select a place to learn more about it, enhancing your exploration experience.

• Adjustable Pointer: Customize the distance and angle of a pointer to explore nearby locations with precision.

• Real-Time Voice Over: Receive real-time coordinates of your current location for an interactive experience.

• Reset to User Location: Quickly reset the cursor position to your starting location with a single click..

• Distance to Borders: Instantly know the distance to borders in the north, south, east, and west at district, state, or country levels.

• Real-Time Voice Over: Receive real-time coordinates of your current location for an interactive experience.

• Zoom Capabilities with Voice: Zoom in and out with voice assist, making navigation more accessible..

• Border Crossing Alert: Get real-time alerts when crossing borders, adding an interactive element to your journey..

• Distance Finder: Find the shortest distance between any two places with ease.

• Map Layout Options: Switch between political and geographical views to please your viewing experience.

---

Installation

Follow these steps to install and set up the project on your local machine.

Prerequisites

Ensure you have the following installed:

• Git: For cloning the repository.
• Node.js: For running the server.
• Web Browser: To view the application.

Clone the Repository

1. Open your terminal or command prompt.

2. Run the following command to clone the repository:

   git clone https://github.com/zendalona/WorldMapExplorer.git

3. Navigate into the project directory:

   cd WorldMapExplorer

---

Usage

After that, follow these steps to run the application.

Start the Server

1. Start the server with the following command:

   node server.js

2. Once the server is running, the application will be accessible at:

   http://localhost:3000
   

3. Open this URL in your web browser to view and interact with the application.

You’re done! You can see the detailed user manual for more information.