Geo Client

The Geo Client application is a sample GUI application developed for educational purposes to demonstrate how to retrieve and visualize data from Geo Service via gRPC.

Features

• Search cities by name or coordinates
• Find regions within a specified area
• Filter regions by geographical features
• Get the weather forecast
• Interactive map visualization

Prerequisites

• Geo server running on localhost:50051

Prepare WSL (You should have already done this for GeoService)

1. Enable WSL on your system.
2. Create a WSL VM with Ubuntu. On the host, run these commands:

> wsl --install -d Ubuntu-22.04
> wsl --update
> wsl --shutdown

3. Install Docker Desktop (if Docker Desktop is unavailable, use Rancher Desktop).
4. Enable Ubuntu WSL integration in Docker/Rancher Desktop settings.
5. Start WSL. On the host, run:

> wsl -d Ubuntu-22.04

6. Run these commands inside WSL:

$ cd ~
$ git clone https://github.com/cqginternship/geo-client.git GeoClient
$ cd GeoClient

For detailed setup instructions, refer to the WSL Containers Tutorial.

---

Work with code from WSL

1. Install VSCode with WSL and Dev Containers extensions on the host.
2. Start WSL and run these commands:

$ cd ~/GeoClient
$ code .

In VSCode:

1. VSCode will start in WSL mode. To develop, switch to "Dev Container" mode. Press Ctrl+Shift+P and select "Dev Containers: Reopen in Container". Note that the first time this may take a few minutes.
2. Use F5 - for debuging or ctrl + F5 - for runing

---