Merge pull request planetlabs#51 from planetlabs/scipy

Add workshop exercise materials & related keys

Author: sarasafavi

jupyter-notebooks/data-api-tutorials/search_and_download_quickstart.ipynb

@@ -152,7 +152,7 @@
    "source": [
     "Planet's products are categorized as **items** and **assets**: an item is a single picture taken by a satellite at a certain time. Items have multiple asset types including the image in different formats, along with supporting metadata files.\n",
     "\n",
-    "For this demonstration, let's get a satellite image that is best suited for visual applications; e.g., basemaps or visual analysis. Since we're not doing any spectral analysis outside of the visual range, we only need a 3-band (RGB) image. To get the image we want, we will specify an item type of `PSScene3Band`, and asset type `visual`.\n",
+    "For this demonstration, let's get a satellite image that is best suited for analytic applications; i.e., a 4-band image with spectral data for Red, Green, Blue and Near-infrared values. To get the image we want, we will specify an item type of `PSScene4Band`, and asset type `analytic`.\n",
     "\n",
     "You can learn more about item & asset types in Planet's Data API [here](https://planet.com/docs/reference/data-api/items-assets/).\n",
     "\n",
@@ -173,7 +173,7 @@
     "# API Key stored as an env variable\n",
     "PLANET_API_KEY = os.getenv('PL_API_KEY')\n",
     "\n",
-    "item_type = \"PSScene3Band\"\n",
+    "item_type = \"PSScene4Band\"\n",
     "\n",
     "# API request object\n",
     "search_request = {\n",
@@ -246,7 +246,7 @@
     " \n",
     "The Data API does not pre-generate assets, so they are not always immediately availiable to download. In order to download an asset, we first have to **activate** it.\n",
     "\n",
-    "Remember, earlier we decided we wanted a color-corrected image best suited for *visual* applications. We can check the status of the visual asset we want to download like so:\n",
+    "Remember, earlier we decided we wanted a color-corrected image best suited for *analytic* applications. We can check the status of the analytic asset we want to download like so:\n",
     " "
    ]
   },
@@ -256,8 +256,8 @@
    "metadata": {},
    "outputs": [],
    "source": [
-    "# This is \"inactive\" if the \"visual\" asset has not yet been activated; otherwise 'active'\n",
-    "print(result.json()['visual']['status'])"
+    "# This is \"inactive\" if the \"analytic\" asset has not yet been activated; otherwise 'active'\n",
+    "print(result.json()['analytic']['status'])"
    ]
   },
   {
@@ -274,11 +274,11 @@
    "outputs": [],
    "source": [
     "# Parse out useful links\n",
-    "links = result.json()[u\"visual\"][\"_links\"]\n",
+    "links = result.json()[u\"analytic\"][\"_links\"]\n",
     "self_link = links[\"_self\"]\n",
     "activation_link = links[\"activate\"]\n",
     "\n",
-    "# Request activation of the 'visual' asset:\n",
+    "# Request activation of the 'analytic' asset:\n",
     "activate_result = \\\n",
     "  requests.get(\n",
     "    activation_link,\n",