Wander Wisely app was created to help with the organization of a journey. Fields of currency, geography and weather are three sectors on which I focused the most. This is simple, modern desktop app.
- Python (mainly: tkinter, sqlite3, matplotlib, requests, datetime, pillow)
- SQL, API, CSV
To use certain features of this application, an API keys are required.
Go to the Fixer API and Geoapify - log in to your existing account or register a new account if you don't have one (there are free plans available).
Below are the modules where you should provide the API keys:
- frame1 Module:
- frame2 Module:
- funcPlots Module:
- geoFunc Module:
The main frame of the Wander Wisely application serves as the central hub for users to plan their travel adventures. It provides essential features for inputting travel destination information, selecting the primary currency, and accessing various travel-related analyses.
- Destination and Primary Currency Input
Upon launching the Wander Wisely app, users are greeted with a section to input their desired travel destination (country) and their everyday primary currency. The application is protected against case errors.
- Travel Analysis Options
After entering the destination and primary currency, users are presented with a range of options to analyze and plan their trip effectively. These options include:
- Currency Analysis: Users can select this option to get insights into the currency exchange rates and conversion tools for their primary currency in the chosen destination. It provides real-time currency exchange rate information based on user input (displayed on the of the section).
-
Geographical Information: This option allows users to explore the geographical location of their chosen destination. Users can access information about popular landmarks and attractions in their selected destination.
-
Weather Forecast: This feature provides users with up-to-date weather information for their chosen travel destination, helping them prepare for varying weather conditions during their trip. Also it provides a weather from year before departure date.
- Navigation Buttons
To access each of the travel analysis options mentioned above, users can simply click on the corresponding button. These buttons provide an intuitive and user-friendly way to explore different aspects of their trip.
The application uses a mechanism to determine whether to display fake buttons or real buttons. Fake buttons are initially shown and are replaced with real buttons after valid user input is received. State of buttons couldn't been used because customtkinker buttons don't handle this function (usage of state causes bugs).
- Exit Button
Located at the bottom of the main frame, there is an exit button that allows users to gracefully exit the Wander Wisely app when they have finished planning or using its features.
The application includes error handling to notify users of incorrect inputs or data retrieval issues. Error messages are displayed as labels and automatically disappear after a set time.
This section of the travel assistant application allows users to analyze changes in a selected currency. Users can choose a date range for currency analysis. After confirming the dates, users can select which type of chart they want to display.
Usage Instructions:
-
Enter Date Range: Start by entering the desired start and end dates for the currency analysis in the "Enter the start date" and "Enter the end date" fields. Dates should be entered in the "YYYY-MM-DD" format.
-
Confirm Time Span: Click the "CONFIRM TIME SPAN" button to confirm the selected date range.
-
Choose Chart: After confirming the date range, you can choose from the following charts to display: - Comparison to the Current Rate: Shows a comparison of the selected currency's rate to the current rate. - Rate Compared to EUR, USD, PLN, CNY: Displays the selected currency's rate compared to EUR, USD, PLN, and CNY. - Currency Rate for the Last 30 Days: Shows the currency rate for the last 30 days.
If the user enters a date in the wrong format, a message will prompt them to correct it.
In the geographical part of the Wander Wisely, users can explore geographical facts related to their destination country. Users will have the opportunity to discover information about their departure country, calculate the distance between their departure and destination countries, and explore nearby attractions.
Upon opening the Geographic Exploration section, in the bottom left corner of the application window, you will find the following information:
- Capital of the Destination Country: The capital city of the selected destination country.
- Five Largest Cities: The names of the five largest cities in the destination country, along with their respective populations.
This geographic information provides users with a quick overview of key details about their destination country, including its capital and major cities.
Usage Instructions:
-
Enter Departure Country: Start by entering your departure country in the "What is your departure country?" field. Ensure that you enter the full name of the country.
-
Select Distance Unit: Choose the unit in which the distance between your departure and destination countries will be displayed. You can choose between kilometers and miles.
-
Confirm Choices: Click the "CONFIRM COUNTRY" button to confirm your departure country and distance unit selection.
-
Explore Geographic Facts: Once confirmed, the application will display information about the distance between your departure country and the selected destination country. You'll also get a list of nearby attractions in the destination country's capital, with the option to open them in a web browser and save choices in the database.
If you enter an invalid country name when specifying your departure country, the application will display an error message.
In this section of the travel assistant application, users can check the weather forecast for their destination country. The Weather Forecast section provides users with the capability to view both historical weather data from a year ago and a weather forecast for the upcoming week.
Usage Instructions:
-
Select Date of Departure: Use the calendar widget to select the date of your departure. Click on the date you want to choose, and it will be displayed as the selected departure date.
-
Submit Date: After selecting the date of departure, click the "SUBMIT DATE" button to proceed.
-
View Weather Data: Once the date of departure is confirmed, the application will display options to view weather-related information. Users can choose between two options:
- Year Ago: This option allows you to view historical weather data from exactly one year ago on the selected date. It provides insights into what the weather was like on the same day in the past.
- Next Week: This option provides a weather forecast for the upcoming week in your destination country.
