update of APIs session

Author: luisesanmartin

1-foundations/4-api-and-dataviz/Introduction to APIs.pdf

@@ -10,15 +10,6 @@
     "<a href=\"https://colab.research.google.com/github/worldbank/dec-python-course/blob/main/1-foundations/4-api-and-dataviz/foundations-s4-api.ipynb\" target=\"_parent\"><img src=\"https://colab.research.google.com/assets/colab-badge.svg\" alt=\"Open In Colab\"/></a>"
    ]
   },
-  {
-   "cell_type": "code",
-   "execution_count": null,
-   "metadata": {},
-   "outputs": [],
-   "source": [
-    "import pandas as pd"
-   ]
-  },
   {
    "cell_type": "markdown",
    "metadata": {},
@@ -74,7 +65,7 @@
     "- Your web browser then renders the HTML information in the response and shows it to you\n",
     "- A familiar example:\n",
     "\n",
-    "`https://www.worldbank.org/en/home`"
+    "`https://www.worldbank.org/ext/en/home`"
    ]
   },
   {
@@ -107,7 +98,7 @@
    "metadata": {},
    "outputs": [],
    "source": [
-    "url = 'https://www.worldbank.org/en/home'"
+    "url = 'https://www.worldbank.org/ext/en/home'"
    ]
   },
   {
@@ -323,6 +314,15 @@
     "Furthermore, we can transform the list inside `data['people']` into a Pandas dataframe for further analysis."
    ]
   },
+  {
+   "cell_type": "code",
+   "execution_count": null,
+   "metadata": {},
+   "outputs": [],
+   "source": [
+    "import pandas as pd"
+   ]
+  },
   {
    "cell_type": "code",
    "execution_count": null,
@@ -417,7 +417,7 @@
    "source": [
     "# Coding a simple API client\n",
     "\n",
-    "- An API \"client\" is a piece of code that facilitates the interaction with an API\n",
+    "- An **API client** is a piece of code that facilitates the interaction with an API\n",
     "- In the example with the astronauts, we had to go through several coding steps to execute the request, obtain the JSON data, and load it into a Pandas data frame\n",
     "- All of those steps could be packed in a Python function that simplified the process of interacting with the API. That function is an API client\n",
     "- In fact, in exercise 1 you were inadvertently creating an API client!\n",
@@ -630,7 +630,7 @@
    "metadata": {},
    "outputs": [],
    "source": [
-    "query = geolocator.geocode('1818 H St NW, Washington DC')"
+    "query = geolocator.geocode('1818 H St NW, Washington DC, USA')"
    ]
   },
   {
@@ -648,7 +648,7 @@
    "cell_type": "markdown",
    "metadata": {},
    "source": [
-    "`query` is an ad-hoc variable type for this library."
+    "`query` has an ad-hoc variable type from this library."
    ]
   },
   {
@@ -781,7 +781,7 @@
    "cell_type": "markdown",
    "metadata": {},
    "source": [
-    "Programming this complicated client is not needded at all to interact with the The World Bank API. It has a dedicated client Python library that greatly facilitates its use.\n",
+    "Programming this complicated client is not needed at all to interact with the The World Bank API. It has a dedicated client Python library that greatly facilitates its use.\n",
     "- Release blog post [here](https://blogs.worldbank.org/opendata/introducing-wbgapi-new-python-package-accessing-world-bank-data)\n",
     "- Documentation [here](https://pypi.org/project/wbgapi/)\n",
     "- Examples [here](https://nbviewer.org/github/tgherzog/wbgapi/blob/master/examples/wbgapi-cookbook.ipynb)"
@@ -883,7 +883,8 @@
     "## Python API client libraries - Main takeaways\n",
     "\n",
     "- API client libraries greatly facilitate the use of APIs. You don't have to code your own client anymore!\n",
-    "- You need to review the library documentation to know how to use them\n",
+    "    - However, not all APIs have a client library.\n",
+    "- You always need to review the library documentation and explore its use to know how to use them\n",
     "- The resulting variables from client libraries might not be in JSON format\n",
     "    + `geopy` returned an ad-hoc variable class\n",
     "    + `wb.data.DataFrame` returned a Pandas dataframe, which is very convenient for further data analysis\n",