1. Google map API is not for free now. -> Will be updated to mapbox API soon.
2. Plotly function in this function doesn't work now. -> Will be updated soon.

Final project for SI 507 (School of Information master course at University of Michigan-Ann Arbor)

program diagram:

#[Data resources]#############################

1. The Economic data in this project is from API of THE WORLD BANK. This API required no authorizaion. The link of the API is: https://datahelpdesk.worldbank.org/knowledgebase/articles/898581-api-basic-call-structure

2. Use the Flicker API to get photos. This API required API key. The example of the secrets.py that contains the API key for the program is provided. The link of the API is: https://www.flickr.com/services/api/

3. Web scraping of Financial Times news. The link of the Webpage is: https://www.ft.com/search

#[How to run the function]#############################

First, when you run the program, you can choose whether to build the new database or not. If it is your first time to run the program, please enter "Yes".

Then, you will enter the home layer of the program, you will be required to type in some commands to run the program. At the home layer, you can choose three types of functions to run. ("a", "b" or "c") You also can use some command to get extra supports.(such as "help" or "exit")

The explanation of the commands are following:

Commands available for specific layers:

[Home] --------------------

[a] --> [Economic charts]

Description: Search for Economic Data of countries from the World Bank database.

Options:

[a] *** Line chart
<Description>: Get a line chart of a country's GDP/GNI/GDP_growth from 1995 to 2015.
<User Input>: a 2-letter country code, data type (GDP/GNI/GDP_growth)


[b] *** World map
<Description>: Get the world map of GDP/GNI of all countries at a specific year.
<User Input>: data type (GDP/GNI/GDP_growth), a 4 digit year (between 1995 to 2015)

[b] --> [Financial times news search]

<Description>: You can search for latest ten news in FTimes website regarding to 
the country you want to look for.

<User Input>: a 2-letter country code

[c] --> [Flicker Photo search]

Description: You can search for ten photos of a country that have a tag 
you want.

<User Input>: a 2-letter country code, a tag for the photo

Command available for all layers:

[code]

Description: Open a website that listing all countries names and their 2-letter 
Alpha2 code. This allows user to find the 2-letter country code of a specific 
country.
https://www.worldatlas.com/aatlas/ctycodes.htm

[Help]

Description: Open the help.txt to see the description of the program

[back]

Description: Go back to home layer.

[exit]

Description: Leave the program.

#[How the function is constructed]#############################

[Part 1]

I built four functions to get data according to the Alpha2 of country. These functions will be used to build the database. The functions are:

get_GPS_of_country(Alpha2)
get_GDP_of_country(Alpha2)
get_GDP_growth_of_country(Alpha2)
get_GNI_of_country(Alpha2)

[Part 2]

Define functions to build the SQL database that read data from CSV and JSON into a new database called world_bank.db The functions are:

create_db()
populate_db()

[Part 3]

Define functions that can create different charts by using Plotly.

get_data_for_one(alpha2, title)
plot_for_one(result_dic)
get_data_for_all(title, year)
plot_for_all(result_dic)

[Part 4]

Define a function perform web scraping from the Financial Times website.

get_FTimes_page(Alpha2)

[Part 5]

Define a function for make requests from flicker API.

get_flickr_data(Alpha2, tag_for_search = 'National flag')
get_flickr_photo_info(id_num, tag)

[Part 6]

Implement logic to process user commands and define the function for running the main commands.

command_econ()
command_ft()
command_flicker()

[Part 7]

Implement interactive prompt. The function for user to decide which command runs according to the user input.

interactive_prompt()