{
"cells": [
{
"cell_type": "markdown",
"metadata": {},
"source": [
"# Restaurant Quest using TomTom API \n",
"\n",
"#### About this document\n",
"* **Scope**: This is the full story that includes both the demographic data analysis and using TomTom API to examine the surroundings of a neighborhood.⬇ [Click here to get the **Patial story that focus on maps**](https://nbviewer.jupyter.org/github/xding78/Sharing/blob/master/RestaurantQuest/RestaurantQuest_TomTomAPI.ipynb).\n",
"* **Version**: 1.0 | Updated on: 14 Jan 2020\n",
"* **Author**: [Xinrong Ding](https://www.linkedin.com/in/xding/)\n",
"\n",
"### Table of contents\n",
"\n",
"[1. Introduction: The Challenge](#1) \n",
"[2. Data Requirements](#2) \n",
"[3. Analyze Demographic Data](#3) \n",
"[4. View Candidate Neighborhoods on a Map](#4) \n",
"[5. Explore the surrondings](#5) \n",
"[6. In-depth analysis of one neighborhood](#6) \n",
"[7. Conclusion and future work](#7)\n",
"\n",
" \n",
"
"
]
},
{
"cell_type": "markdown",
"metadata": {},
"source": [
" \n",
"# 1. Introduction: The Challenge\n",
"[Back to top](#top)\n",
"\n",
"A good friend of mine, Linda, whose dream is to open a Chinese restaurant one day to share the joy of traditional Chinese food with others. Now, everything is ready, she can finally realize her dream. She has chosen Amsterdam to be the place where her dream starts. Not only because Amsterdam is one of the most populous and visited cities in Europe but also because the diverse culture the city embraces.\n",
"\n",
"My challenge as a data scientist is to help her to find the ideal location in Amsterdam using whatever data I can access.\n",
"\n",
"## 1.1. A Cooperative Iterative Approach \n",
"\n",
"It's important to emphasize that even though I might know how to deal with data better, Linda knows food business a lot more. Throughout this project, we will collaborate closely to take the full advantage of our expertise.\n",
"\n",
"The process is also iterative. Decisions that we made at the beginning may not be the best ones. We both fully understand that when we learn more about Amsterdam and its residences, we need to re-examine and fine-tune our decisions continuously.\n",
"\n",
"\n",
"## 1.2. About Amsterdam \n",
"\n",
"[Amsterdam](https://en.wikipedia.org/wiki/Amsterdam) is the capital city and the most populous municipality of [the Netherlands](https://en.wikipedia.org/wiki/Netherlands). \n",
"Here are some facts about it:\n",
"\n",
"* Amsterdam has a population of **854,047** within the city proper\n",
"* Amsterdam city proper has **4,457** inhabitants per square kilometer and **2,275** households per square kilometer.\n",
"* Amsterdam has more than **100 kilometers (60 miles)** of canals, most of which are navigable by boat.\n",
"\n",
"As to tourism, Amsterdam is one of the most popular tourist destinations in Europe\n",
"* The number of international tourists per year is: **20.63 million**.\n",
"* Out of which, the number of day-trippers is: **16 million**.\n",
"\n",
"_Reference: https://en.wikipedia.org/wiki/Amsterdam_\n",
"\n",
"\n",
"## 1.3. Business Questions \n",
"\n",
"To find the ideal location for the restaurant, we must first seek answers to a few questions.\n",
"\n",
"### Question 1: How many restaurants already exist?\n",
"\n",
"The fewer similar restaurants are in the neighborhood, the better chance for Linda's new restaurant to kickstart and make a profit. Therefore, the number of existing restaurants in the neighborhood must be taken into consideration.\n",
"I will use TomTom API to find answers to this question.\n",
"\n",
"### Question 2: How popular will Chinese food be in the neighborhood?\n",
"\n",
"For Linda, it's important to serve traditional Chinese food the way she knows. Even though Chinese food is widely loved, it makes sense to get an impression of how existing Chinese restaurants (or Asian restaurants) are perceived.\n",
"I will use TomTom API to find answers to this question.\n",
"\n",
"### Question 3: Who are the target customers and where do they live?\n",
"\n",
"It is going to be a small restaurant (5 to 7 tables) due to the limited budget. The estimated primary income would be takeout and orders made online.\n",
"From experience, Linda knows that people who live alone are more likely to buy takeout or use online food ordering apps such as Uber Eats. They are the ideal target customers for her new restaurant. So, we will look for an area with a relatively high density of one-person household.\n",
"We need demographic information to answer this question.\n",
"\n",
"\n",
" \n",
"\n",
" \n",
"\n",
"\n",
"# 2. Data Requirements\n",
"[Back to top](#top)\n",
"\n",
"We have the big questions, where to \n",
"open a Chinese restaurant in Amsterdam. Now, we need to collect data that can help us answer these questions. I will collect data from these two sources:\n",
"\n",
"* Data of the surroundings (density of similar restaurants nearby)\n",
"* Demographic data (per area in Amsterdam)\n",
"\n",
"\n",
"## 2.1. Data of Surroundings \n",
"[Back to top](#top)\n",
"\n",
"* [**TomTom Maps API**](https://developer.tomtom.com/products/maps-api).\n",
"* [**TomTom Search API**](https://developer.tomtom.com/products/search-api).\n",
"\n",
"\n",
"\n",
"## 2.2 Demographic Data \n",
"[Back to top](#top)\n",
"\n",
"To know which neighborhoods are more interesting to investigate further, we need to look into demographic data. We will choose neighborhoods that have more target customers in terms of quantity and density.\n",
"\n",
"The Central Bureau of Statistics of the Netherlands, **CBS** in short, provides a large number of demographic data regarding who live and work in the Netherlands. \n",
"In [this page](https://opendata.cbs.nl/statline/#/CBS/nl/dataset/84286NED/table?ts=1558337871247), you can choose whatever feature you need to solve the problem. The list of features is quite comprehensive. It is important, therefore, to define exactly what the data can be used.\n",
"\n",
"\n",
"#### Features that can be used to answer the question\n",
"\n",
"* **Regional specifics** _(Regioaanduiding)_: This information can help me to link relative details to a specific area.\n",
"* **Total Households** _(Particulier huishouden)_: Number of households in a neighborhood.\n",
"* **One-person Households** _(Eenpersoonshuishoudens)_: Number of households with only one person.\n",
"* **Population density** _(Bevolkingsdichtheid)_: A more densely populated area means more customers for a restaurant. The unit of population density is **number of people per square kilometer**.\n",
"\n",
"#### Information that isn't available\n",
"\n",
"* **Origin of birth** _(Personen met een migratieachtergrond)_: This information can help us to determine the types of food the restaurant should offer.\n",
" * Unfortunately, the categorization is not detailed enough. I am not able to single out people come from China in the data.\n",
"* **Income per household** _(Inkomen van huishoudens)_: Since restaurants are usually quite expensive comparing to home-cooking. Only people who have sufficient income can afford to go to restaurants often. \n",
"_Unfortunately, this information is missing consistently from the database._\n",
"\n",
"#### Features deliberately excluded\n",
"\n",
"* **Civil status**: Since we can distinguish one-person households, it's not necessary to understand why people live alone (single or divorced does not seem to link to food strategy directly).\n",
"* **Gender**: In the Netherlands, there isn't a big difference between men and women in terms of the likeliness of cooking at home.\n",
"* **Type of house**: This has no direct correlation to people's choice of food.\n",
"\n",
"\n",
" \n",
"\n",
" \n",
"\n",
"\n",
"# 3. Analyze Demographic Data\n",
"[Back to top](#top)\n",
"\n",
"I selected necessary data from [CBS](https://opendata.cbs.nl/statline/#/CBS/nl/dataset/84286NED/table?ts=1558337871247), as mentioned in [chapter 2.2](#22). \n",
"The data is in CSV format.\n",
"\n",
"## 3.1 Load Data to a Dataframe\n",
"\n",
"#### Load necessary libraries"
]
},
{
"cell_type": "code",
"execution_count": 1,
"metadata": {},
"outputs": [],
"source": [
"# library to handle data in a vectorized manner\n",
"import numpy as np \n",
"# library to load dataframe\n",
"import pandas as pd\n",
"\n",
"# Matplotlib and associated plotting mhttps://leafletjs.com/odules\n",
"import matplotlib.colors as colors\n",
"import matplotlib.pyplot as plt"
]
},
{
"cell_type": "markdown",
"metadata": {},
"source": [
"#### Load the CSV file"
]
},
{
"cell_type": "code",
"execution_count": 2,
"metadata": {},
"outputs": [
{
"data": {
"text/html": [
"\n",
"\n",
"
\n",
" \n",
" \n",
" \n",
" Neighborhood \n",
" ID \n",
" Total Residences \n",
" Total Households \n",
" One-person Households \n",
" Population Density \n",
" Lat \n",
" Lon \n",
" \n",
" \n",
" \n",
" \n",
" 0 \n",
" Burgwallen-Oude Zijde \n",
" WK036300 \n",
" 4305 \n",
" 3090 \n",
" 2180 \n",
" 12323 \n",
" 52.371946 \n",
" 4.896103 \n",
" \n",
" \n",
" 1 \n",
" Burgwallen-Nieuwe Zijde \n",
" WK036301 \n",
" 3930 \n",
" 2835 \n",
" 2000 \n",
" 6881 \n",
" 52.373706 \n",
" 4.889922 \n",
" \n",
" \n",
" 2 \n",
" Grachtengordel-West \n",
" WK036302 \n",
" 6385 \n",
" 4110 \n",
" 2570 \n",
" 14261 \n",
" 52.370837 \n",
" 4.885478 \n",
" \n",
" \n",
" 3 \n",
" Grachtengordel-Zuid \n",
" WK036303 \n",
" 5350 \n",
" 3410 \n",
" 2140 \n",
" 10303 \n",
" 52.364422 \n",
" 4.894243 \n",
" \n",
" \n",
" 4 \n",
" Nieuwmarkt \n",
" WK036304 \n",
" 9765 \n",
" 6485 \n",
" 4285 \n",
" 13741 \n",
" 52.372160 \n",
" 4.900096 \n",
" \n",
" \n",
"
\n",
"
"
],
"text/plain": [
" Neighborhood ID Total Residences Total Households \\\n",
"0 Burgwallen-Oude Zijde WK036300 4305 3090 \n",
"1 Burgwallen-Nieuwe Zijde WK036301 3930 2835 \n",
"2 Grachtengordel-West WK036302 6385 4110 \n",
"3 Grachtengordel-Zuid WK036303 5350 3410 \n",
"4 Nieuwmarkt WK036304 9765 6485 \n",
"\n",
" One-person Households Population Density Lat Lon \n",
"0 2180 12323 52.371946 4.896103 \n",
"1 2000 6881 52.373706 4.889922 \n",
"2 2570 14261 52.370837 4.885478 \n",
"3 2140 10303 52.364422 4.894243 \n",
"4 4285 13741 52.372160 4.900096 "
]
},
"execution_count": 2,
"metadata": {},
"output_type": "execute_result"
}
],
"source": [
"df = pd.read_csv('https://github.com/xding78/Sharing/raw/master/RestaurantQuest/Amsterdam.csv')\n",
"df.head()"
]
},
{
"cell_type": "code",
"execution_count": 3,
"metadata": {},
"outputs": [
{
"data": {
"text/plain": [
"(65, 8)"
]
},
"execution_count": 3,
"metadata": {},
"output_type": "execute_result"
}
],
"source": [
"df.shape"
]
},
{
"cell_type": "markdown",
"metadata": {},
"source": [
"#### In total 65 neighborhoods\n",
"\n",
"_There are definitely more neighborhoods in Amsterdam municipality. However, for the sake of this challenge, we decided to focus on the neighborhoods that within or connected to Amsterdam city proper._ \n",
"\n",
"#### Sort the neighborhoods by the population density"
]
},
{
"cell_type": "code",
"execution_count": 4,
"metadata": {
"scrolled": true
},
"outputs": [
{
"data": {
"text/html": [
"\n",
"\n",
"
\n",
" \n",
" \n",
" \n",
" Neighborhood \n",
" ID \n",
" Total Residences \n",
" Total Households \n",
" One-person Households \n",
" Population Density \n",
" Lat \n",
" Lon \n",
" \n",
" \n",
" \n",
" \n",
" 14 \n",
" Staatsliedenbuurt \n",
" WK036314 \n",
" 13315 \n",
" 8105 \n",
" 4860 \n",
" 28139 \n",
" 52.380287 \n",
" 4.870951 \n",
" \n",
" \n",
" 19 \n",
" Van Lennepbuurt \n",
" WK036319 \n",
" 6990 \n",
" 4535 \n",
" 3005 \n",
" 28005 \n",
" 52.365144 \n",
" 4.867845 \n",
" \n",
" \n",
" 31 \n",
" Indische Buurt West \n",
" WK036331 \n",
" 12640 \n",
" 7060 \n",
" 3930 \n",
" 26985 \n",
" 52.361625 \n",
" 4.938813 \n",
" \n",
" \n",
" 21 \n",
" Overtoomse Sluis \n",
" WK036321 \n",
" 7890 \n",
" 4840 \n",
" 2910 \n",
" 26482 \n",
" 52.359468 \n",
" 4.860689 \n",
" \n",
" \n",
" 18 \n",
" Kinkerbuurt \n",
" WK036318 \n",
" 6590 \n",
" 3950 \n",
" 2460 \n",
" 26135 \n",
" 52.369167 \n",
" 4.866649 \n",
" \n",
" \n",
"
\n",
"
"
],
"text/plain": [
" Neighborhood ID Total Residences Total Households \\\n",
"14 Staatsliedenbuurt WK036314 13315 8105 \n",
"19 Van Lennepbuurt WK036319 6990 4535 \n",
"31 Indische Buurt West WK036331 12640 7060 \n",
"21 Overtoomse Sluis WK036321 7890 4840 \n",
"18 Kinkerbuurt WK036318 6590 3950 \n",
"\n",
" One-person Households Population Density Lat Lon \n",
"14 4860 28139 52.380287 4.870951 \n",
"19 3005 28005 52.365144 4.867845 \n",
"31 3930 26985 52.361625 4.938813 \n",
"21 2910 26482 52.359468 4.860689 \n",
"18 2460 26135 52.369167 4.866649 "
]
},
"execution_count": 4,
"metadata": {},
"output_type": "execute_result"
}
],
"source": [
"df.sort_values([\"Population Density\"], axis=0, ascending=False, inplace=True)\n",
"df.head()"
]
},
{
"cell_type": "markdown",
"metadata": {},
"source": [
"## 3.2 Drop Unnecessary Data\n",
"[Back to top](#top)"
]
},
{
"cell_type": "markdown",
"metadata": {},
"source": [
"As we mentioned earlier, we want to learn the population density together with how many households are with only one person. It seems that the total number of residences is not necessary to answer any of the questions. Therefore, we decide to remove it from the data from now on."
]
},
{
"cell_type": "code",
"execution_count": 5,
"metadata": {},
"outputs": [
{
"data": {
"text/html": [
"\n",
"\n",
"
\n",
" \n",
" \n",
" \n",
" Neighborhood \n",
" ID \n",
" Total Households \n",
" One-person Households \n",
" Population Density \n",
" Lat \n",
" Lon \n",
" \n",
" \n",
" \n",
" \n",
" 14 \n",
" Staatsliedenbuurt \n",
" WK036314 \n",
" 8105 \n",
" 4860 \n",
" 28139 \n",
" 52.380287 \n",
" 4.870951 \n",
" \n",
" \n",
" 19 \n",
" Van Lennepbuurt \n",
" WK036319 \n",
" 4535 \n",
" 3005 \n",
" 28005 \n",
" 52.365144 \n",
" 4.867845 \n",
" \n",
" \n",
" 31 \n",
" Indische Buurt West \n",
" WK036331 \n",
" 7060 \n",
" 3930 \n",
" 26985 \n",
" 52.361625 \n",
" 4.938813 \n",
" \n",
" \n",
" 21 \n",
" Overtoomse Sluis \n",
" WK036321 \n",
" 4840 \n",
" 2910 \n",
" 26482 \n",
" 52.359468 \n",
" 4.860689 \n",
" \n",
" \n",
" 18 \n",
" Kinkerbuurt \n",
" WK036318 \n",
" 3950 \n",
" 2460 \n",
" 26135 \n",
" 52.369167 \n",
" 4.866649 \n",
" \n",
" \n",
"
\n",
"
"
],
"text/plain": [
" Neighborhood ID Total Households One-person Households \\\n",
"14 Staatsliedenbuurt WK036314 8105 4860 \n",
"19 Van Lennepbuurt WK036319 4535 3005 \n",
"31 Indische Buurt West WK036331 7060 3930 \n",
"21 Overtoomse Sluis WK036321 4840 2910 \n",
"18 Kinkerbuurt WK036318 3950 2460 \n",
"\n",
" Population Density Lat Lon \n",
"14 28139 52.380287 4.870951 \n",
"19 28005 52.365144 4.867845 \n",
"31 26985 52.361625 4.938813 \n",
"21 26482 52.359468 4.860689 \n",
"18 26135 52.369167 4.866649 "
]
},
"execution_count": 5,
"metadata": {},
"output_type": "execute_result"
}
],
"source": [
"df.drop(\"Total Residences\", axis=1, inplace=True)\n",
"df.head()"
]
},
{
"cell_type": "markdown",
"metadata": {},
"source": [
"## 3.3. Observe Data using a Bar Chart \n",
"[Back to top](#top)\n",
"\n",
"In order to better decide what to do with the data, I want to take a good look at the data. Visualizing the data will help a lot. I choose to use a horizontal bar chart, because I want the neighborhood names to be very easy to read. Due to the number of neighborhoods (65), the vertical bar might not offer enough room to show all the bars."
]
},
{
"cell_type": "code",
"execution_count": 6,
"metadata": {},
"outputs": [
{
"data": {
"text/html": [
"\n",
"\n",
"
\n",
" \n",
" \n",
" \n",
" Neighborhood \n",
" Total Households \n",
" One-person Households \n",
" Population Density \n",
" \n",
" \n",
" \n",
" \n",
" 14 \n",
" Staatsliedenbuurt \n",
" 8105 \n",
" 4860 \n",
" 28139 \n",
" \n",
" \n",
" 19 \n",
" Van Lennepbuurt \n",
" 4535 \n",
" 3005 \n",
" 28005 \n",
" \n",
" \n",
" 31 \n",
" Indische Buurt West \n",
" 7060 \n",
" 3930 \n",
" 26985 \n",
" \n",
" \n",
" 21 \n",
" Overtoomse Sluis \n",
" 4840 \n",
" 2910 \n",
" 26482 \n",
" \n",
" \n",
" 18 \n",
" Kinkerbuurt \n",
" 3950 \n",
" 2460 \n",
" 26135 \n",
" \n",
" \n",
"
\n",
"
"
],
"text/plain": [
" Neighborhood Total Households One-person Households \\\n",
"14 Staatsliedenbuurt 8105 4860 \n",
"19 Van Lennepbuurt 4535 3005 \n",
"31 Indische Buurt West 7060 3930 \n",
"21 Overtoomse Sluis 4840 2910 \n",
"18 Kinkerbuurt 3950 2460 \n",
"\n",
" Population Density \n",
"14 28139 \n",
"19 28005 \n",
"31 26985 \n",
"21 26482 \n",
"18 26135 "
]
},
"execution_count": 6,
"metadata": {},
"output_type": "execute_result"
}
],
"source": [
"# step 1: Extract only necessary data\n",
"df_visualize = df[[\"Neighborhood\", \"Total Households\", \"One-person Households\", \"Population Density\"]]\n",
"df_visualize.head()"
]
},
{
"cell_type": "code",
"execution_count": 7,
"metadata": {},
"outputs": [
{
"data": {
"text/plain": [
""
]
},
"execution_count": 7,
"metadata": {},
"output_type": "execute_result"
},
{
"data": {
"image/png": "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6NCBk08+mREjRhT5mORX9kMPPZSdLzExkYyMDLZs2UKXLl049dRTSUxMZNy46IFO8+fP57TTTqNJkyaceeaZfPfdd9nbjh8/nubNm1OnTh1mzpwJwLZt2+jfvz9JSUk0atSIadOm5Ypt3bp1dO7cmUaNGjFw4EDcoycy5xVDcVIPuoiIiIiIyD60dOlSmjRpsltatWrVOOGEE/jiiy8ASE9PZ+HChZQvX566desyePBgKlasyF133cXUqVOpXLky999/P8OGDePWW2/NtY+5c+eybNkyTjzxRM466yxeffVVOnTokO/2FSpUYNasWQDUrFmTr776ivLly7NhwwYAbrvtNho1asRrr73Gf//7Xy699FLS09MBWL58OdOmTWPTpk3UrVuXK6+8knLlyuWKq2PHjtm985s3b6ZevXoFlh3P22+/Tc2aNXnjjTcA2LhxIzt27GDw4MFMnDiRo48+mnHjxnHzzTfz9NNPA7Bz507mzp3Lm2++ye23387UqVN57LHHAFi8eDHLly+nc+fOrFixYrd93X777bRt25Zbb72VN954g1GjRuUZQ3FTA11ERERERGQfcnfMLN/0008/nSOOiIbeN2jQgK+//poNGzawbNky2rRpA8D27dtp1apV3H00b96ck08+GYDevXsza9YsKlSokO/2vXr1yl5OTk6mT58+dO/ene7duwMwa9YsXnnlFQA6derEunXrshulXbp0oXz58pQvX55jjjmG77//nlq1auWKa9q0adSoUQOIevqzesfzKzuepKQkhg4dyo033kjXrl1p164dS5YsYcmSJZxxxhlANFT/uOOOy96mZ8+eADRp0oSMjIzs/Q4ePBiAevXqceKJJ+ZqoM+YMYNXX301u57Vq1fPM4bipgZ6PswsE1gMGJAJ/MXdPyzC9mnAZnd/KM66QcBWdx9rZncAM9x9avFEDmbWAdhelHj3YB8funvrIuRvCTwClA+vce6eZmapQFN3/0s+23YHVrj7sr2MOSPsa21W/GZWExjh7ucXJpZYi9dsJOGmN4oUQ8Z9XYoatoiIiIgcwBo2bJjdGM3y888/s2rVKk455RTmz59P+fLls9eVKVOGnTt34u6cccYZvPjii7ttO2fOHAYOHAjAHXfcQbVq1XJdADCzPLfPUrly5ezlN954gxkzZjBp0iTuvPNOli5dmj20O2e5QNx4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\n",
"text/plain": [
""
]
},
"metadata": {
"needs_background": "light"
},
"output_type": "display_data"
}
],
"source": [
"ax = df_visualize.plot(kind='barh', figsize=(14,20))\n",
"#ax.set_title('Population and Households in Amsterdam')\n",
"ax.set_xlabel('Population and Households in Amsterdam')\n",
"ax.set_ylabel('Neighborhood')\n",
"ax.invert_yaxis()\n",
"ax.set_yticklabels(df['Neighborhood'].values)\n",
"\n",
"rects = ax.patches\n",
"\n",
"# use axvline to mark the average population density\n",
"mean = df[\"Population Density\"].mean()\n",
"ax.axvline(mean, color='#2B9B2A') #Green\n",
"\n",
"# use axvline to mark the average total households\n",
"mean2 = df[\"Total Households\"].mean()\n",
"ax.axvline(mean2, color='#1E77B4') #Blue\n",
"\n",
"# use axvline to mark the average one-person households\n",
"mean3 = df[\"One-person Households\"].mean()\n",
"ax.axvline(mean3, color='#FF7F0F') #Orange"
]
},
{
"cell_type": "markdown",
"metadata": {},
"source": [
"### 3.3.1. Learnings from the Above Bar Chart \n",
"[Back to top](#top)\n",
"\n",
"1. One thing becomes evident is that many neighborhoods in Amsterdam has much lower population density than the average value. These neighborhoods are very unlikely to be ideal location to open the restaurant. Therefore, we should remove them to focus on the neighborhoods that are more densely populated. We will do that in the [next chapter](#34).\n",
"2. The second learning is that amongst the more densely populated neighborhoods, not all of them have above average total number of households and one-person households.We will do further analysis in [chapter 3.5](#35) to filter out the neighborhoods that do not have enough one-person households.\n",
"\n",
"\n",
"## 3.4. Remove Neighborhoods that have below average population density \n",
"[Back to top](#top)"
]
},
{
"cell_type": "code",
"execution_count": 8,
"metadata": {},
"outputs": [
{
"name": "stdout",
"output_type": "stream",
"text": [
"Average population density of Amsterdam city proper is: 13233\n"
]
}
],
"source": [
"#First calculate the average residences of each neighborhood\n",
"average_density = int(df[\"Population Density\"].mean())\n",
"print(\"Average population density of Amsterdam city proper is: \", average_density)"
]
},
{
"cell_type": "code",
"execution_count": 9,
"metadata": {
"scrolled": true
},
"outputs": [
{
"data": {
"text/html": [
"\n",
"\n",
"
\n",
" \n",
" \n",
" \n",
" Neighborhood \n",
" ID \n",
" Total Households \n",
" One-person Households \n",
" Population Density \n",
" Lat \n",
" Lon \n",
" \n",
" \n",
" \n",
" \n",
" 14 \n",
" Staatsliedenbuurt \n",
" WK036314 \n",
" 8105 \n",
" 4860 \n",
" 28139 \n",
" 52.380287 \n",
" 4.870951 \n",
" \n",
" \n",
" 19 \n",
" Van Lennepbuurt \n",
" WK036319 \n",
" 4535 \n",
" 3005 \n",
" 28005 \n",
" 52.365144 \n",
" 4.867845 \n",
" \n",
" \n",
" 31 \n",
" Indische Buurt West \n",
" WK036331 \n",
" 7060 \n",
" 3930 \n",
" 26985 \n",
" 52.361625 \n",
" 4.938813 \n",
" \n",
" \n",
" 21 \n",
" Overtoomse Sluis \n",
" WK036321 \n",
" 4840 \n",
" 2910 \n",
" 26482 \n",
" 52.359468 \n",
" 4.860689 \n",
" \n",
" \n",
" 18 \n",
" Kinkerbuurt \n",
" WK036318 \n",
" 3950 \n",
" 2460 \n",
" 26135 \n",
" 52.369167 \n",
" 4.866649 \n",
" \n",
" \n",
"
\n",
"
"
],
"text/plain": [
" Neighborhood ID Total Households One-person Households \\\n",
"14 Staatsliedenbuurt WK036314 8105 4860 \n",
"19 Van Lennepbuurt WK036319 4535 3005 \n",
"31 Indische Buurt West WK036331 7060 3930 \n",
"21 Overtoomse Sluis WK036321 4840 2910 \n",
"18 Kinkerbuurt WK036318 3950 2460 \n",
"\n",
" Population Density Lat Lon \n",
"14 28139 52.380287 4.870951 \n",
"19 28005 52.365144 4.867845 \n",
"31 26985 52.361625 4.938813 \n",
"21 26482 52.359468 4.860689 \n",
"18 26135 52.369167 4.866649 "
]
},
"execution_count": 9,
"metadata": {},
"output_type": "execute_result"
}
],
"source": [
"#Drop all neighborhoods that has a Total Households number below average\n",
"#result[result['Value'] ! <= 10] \n",
"df = df[df[\"Population Density\"] > average_density]\n",
"df.head()"
]
},
{
"cell_type": "code",
"execution_count": 10,
"metadata": {},
"outputs": [
{
"name": "stdout",
"output_type": "stream",
"text": [
"Number of neighborhoods that has higher than average population density: 29\n"
]
}
],
"source": [
"print(\"Number of neighborhoods that has higher than average population density: \", df.shape[0])"
]
},
{
"cell_type": "markdown",
"metadata": {},
"source": [
"## 3.5. Neighborhoods that Have More One-person Households \n",
"[Back to top](#top)"
]
},
{
"cell_type": "code",
"execution_count": 11,
"metadata": {},
"outputs": [
{
"data": {
"text/html": [
"\n",
"\n",
"
\n",
" \n",
" \n",
" \n",
" Neighborhood \n",
" ID \n",
" Total Households \n",
" One-person Households \n",
" Population Density \n",
" Lat \n",
" Lon \n",
" Percentage of One-person Households \n",
" \n",
" \n",
" \n",
" \n",
" 14 \n",
" Staatsliedenbuurt \n",
" WK036314 \n",
" 8105 \n",
" 4860 \n",
" 28139 \n",
" 52.380287 \n",
" 4.870951 \n",
" 59.96 \n",
" \n",
" \n",
" 19 \n",
" Van Lennepbuurt \n",
" WK036319 \n",
" 4535 \n",
" 3005 \n",
" 28005 \n",
" 52.365144 \n",
" 4.867845 \n",
" 66.26 \n",
" \n",
" \n",
" 31 \n",
" Indische Buurt West \n",
" WK036331 \n",
" 7060 \n",
" 3930 \n",
" 26985 \n",
" 52.361625 \n",
" 4.938813 \n",
" 55.67 \n",
" \n",
" \n",
" 21 \n",
" Overtoomse Sluis \n",
" WK036321 \n",
" 4840 \n",
" 2910 \n",
" 26482 \n",
" 52.359468 \n",
" 4.860689 \n",
" 60.12 \n",
" \n",
" \n",
" 18 \n",
" Kinkerbuurt \n",
" WK036318 \n",
" 3950 \n",
" 2460 \n",
" 26135 \n",
" 52.369167 \n",
" 4.866649 \n",
" 62.28 \n",
" \n",
" \n",
"
\n",
"
"
],
"text/plain": [
" Neighborhood ID Total Households One-person Households \\\n",
"14 Staatsliedenbuurt WK036314 8105 4860 \n",
"19 Van Lennepbuurt WK036319 4535 3005 \n",
"31 Indische Buurt West WK036331 7060 3930 \n",
"21 Overtoomse Sluis WK036321 4840 2910 \n",
"18 Kinkerbuurt WK036318 3950 2460 \n",
"\n",
" Population Density Lat Lon \\\n",
"14 28139 52.380287 4.870951 \n",
"19 28005 52.365144 4.867845 \n",
"31 26985 52.361625 4.938813 \n",
"21 26482 52.359468 4.860689 \n",
"18 26135 52.369167 4.866649 \n",
"\n",
" Percentage of One-person Households \n",
"14 59.96 \n",
"19 66.26 \n",
"31 55.67 \n",
"21 60.12 \n",
"18 62.28 "
]
},
"execution_count": 11,
"metadata": {},
"output_type": "execute_result"
}
],
"source": [
"#calculate the percentage of one-person households of every neighborhood\n",
"df[\"Percentage of One-person Households\"] = round(df[\"One-person Households\"] / df[\"Total Households\"]*10000)/100\n",
"df.head()"
]
},
{
"cell_type": "code",
"execution_count": 12,
"metadata": {},
"outputs": [
{
"data": {
"text/html": [
"\n",
"\n",
"
\n",
" \n",
" \n",
" \n",
" Neighborhood \n",
" ID \n",
" Total Households \n",
" One-person Households \n",
" Population Density \n",
" Lat \n",
" Lon \n",
" Percentage of One-person Households \n",
" \n",
" \n",
" \n",
" \n",
" 6 \n",
" Jordaan \n",
" WK036306 \n",
" 12985 \n",
" 8625 \n",
" 23289 \n",
" 52.374500 \n",
" 4.879491 \n",
" 66.42 \n",
" \n",
" \n",
" 19 \n",
" Van Lennepbuurt \n",
" WK036319 \n",
" 4535 \n",
" 3005 \n",
" 28005 \n",
" 52.365144 \n",
" 4.867845 \n",
" 66.26 \n",
" \n",
" \n",
" 4 \n",
" Nieuwmarkt \n",
" WK036304 \n",
" 6485 \n",
" 4285 \n",
" 13741 \n",
" 52.372160 \n",
" 4.900096 \n",
" 66.08 \n",
" \n",
" \n",
" 24 \n",
" Oude Pijp \n",
" WK036324 \n",
" 9875 \n",
" 6510 \n",
" 23353 \n",
" 52.355216 \n",
" 4.894574 \n",
" 65.92 \n",
" \n",
" \n",
" 25 \n",
" Nieuwe Pijp \n",
" WK036325 \n",
" 7905 \n",
" 5015 \n",
" 23998 \n",
" 52.351856 \n",
" 4.897728 \n",
" 63.44 \n",
" \n",
" \n",
"
\n",
"
"
],
"text/plain": [
" Neighborhood ID Total Households One-person Households \\\n",
"6 Jordaan WK036306 12985 8625 \n",
"19 Van Lennepbuurt WK036319 4535 3005 \n",
"4 Nieuwmarkt WK036304 6485 4285 \n",
"24 Oude Pijp WK036324 9875 6510 \n",
"25 Nieuwe Pijp WK036325 7905 5015 \n",
"\n",
" Population Density Lat Lon \\\n",
"6 23289 52.374500 4.879491 \n",
"19 28005 52.365144 4.867845 \n",
"4 13741 52.372160 4.900096 \n",
"24 23353 52.355216 4.894574 \n",
"25 23998 52.351856 4.897728 \n",
"\n",
" Percentage of One-person Households \n",
"6 66.42 \n",
"19 66.26 \n",
"4 66.08 \n",
"24 65.92 \n",
"25 63.44 "
]
},
"execution_count": 12,
"metadata": {},
"output_type": "execute_result"
}
],
"source": [
"#sorting data frame by Percentage of One-person Households\n",
"df.sort_values([\"Percentage of One-person Households\"], axis=0, ascending=False, inplace=True) \n",
"df.head()"
]
},
{
"cell_type": "code",
"execution_count": 13,
"metadata": {},
"outputs": [
{
"data": {
"text/html": [
"\n",
"\n",
"
\n",
" \n",
" \n",
" \n",
" Neighborhood \n",
" Percentage of One-person Households \n",
" \n",
" \n",
" \n",
" \n",
" 6 \n",
" Jordaan \n",
" 66.42 \n",
" \n",
" \n",
" 19 \n",
" Van Lennepbuurt \n",
" 66.26 \n",
" \n",
" \n",
" 4 \n",
" Nieuwmarkt \n",
" 66.08 \n",
" \n",
" \n",
" 24 \n",
" Oude Pijp \n",
" 65.92 \n",
" \n",
" \n",
" 25 \n",
" Nieuwe Pijp \n",
" 63.44 \n",
" \n",
" \n",
"
\n",
"
"
],
"text/plain": [
" Neighborhood Percentage of One-person Households\n",
"6 Jordaan 66.42\n",
"19 Van Lennepbuurt 66.26\n",
"4 Nieuwmarkt 66.08\n",
"24 Oude Pijp 65.92\n",
"25 Nieuwe Pijp 63.44"
]
},
"execution_count": 13,
"metadata": {},
"output_type": "execute_result"
}
],
"source": [
"# step 1: Extract only necessary data\n",
"# oph stands for One-person Households\n",
"df_oph = df[[\"Neighborhood\", \"Percentage of One-person Households\"]]\n",
"df_oph.head()"
]
},
{
"cell_type": "code",
"execution_count": 14,
"metadata": {},
"outputs": [
{
"data": {
"text/plain": [
""
]
},
"execution_count": 14,
"metadata": {},
"output_type": "execute_result"
},
{
"data": {
"image/png": "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\n",
"text/plain": [
""
]
},
"metadata": {
"needs_background": "light"
},
"output_type": "display_data"
}
],
"source": [
"# step 2: plot data\n",
"ax = df_oph.plot(kind='barh', figsize=(14,10))\n",
"ax.set_title('Population density per neighborhood in Amsterdam')\n",
"ax.set_xlabel('Population Density')\n",
"ax.set_ylabel('Neighborhood')\n",
"ax.invert_yaxis()\n",
"ax.set_yticklabels(df_oph['Neighborhood'].values)\n",
"\n",
"rects = ax.patches\n",
"\n",
"ax.axvline(61, color='r')"
]
},
{
"cell_type": "markdown",
"metadata": {},
"source": [
"### 3.5.1. Learnings from the Above Bar Chart \n",
"[Back to top](#top)\n",
"\n",
"As mentioned after we examine the data in a bar chart ([chapter 3.3.1](#331)). It seems that the percentage of one-person households (in comparison to the total number of households) seems to be rather consistent for the neighborhoods that have above average population density.\n",
"\n",
"Now, in the above bar chart, the consistency becomes quite clear.\n",
"\n",
"However, we observe there are roughly 3 ranges of the percentage:\n",
"\n",
"1. High: 66% ~ 67%. The first four neighborhood\n",
"2. Medium: 59% ~ 63.5%. \n",
"3. Low: 53% ~ 59%. The last 10 neighborhood\n",
"\n",
"We decided to focus on the **top 10**, the neighborhoods that have **over 61 percent of one-person households** (Marked by the red line in the above bar chart)."
]
},
{
"cell_type": "code",
"execution_count": 15,
"metadata": {},
"outputs": [
{
"data": {
"text/plain": [
"(10, 8)"
]
},
"execution_count": 15,
"metadata": {},
"output_type": "execute_result"
}
],
"source": [
"df = df[df[\"Percentage of One-person Households\"] > 61.0]\n",
"df.shape"
]
},
{
"cell_type": "markdown",
"metadata": {},
"source": [
" \n",
"\n",
" \n",
"\n",
"\n",
"# 4. View candidate neighborhoods on a map\n",
"**↑** [Back to top](#top)\n",
"\n",
"I use these tools to visualize the information I gathered above:\n",
"* [TomTom Maps API](https://developer.tomtom.com/products/maps-api?gclid=Cj0KCQiA2ITuBRDkARIsAMK9Q7Mra8DrrcLAR20WH9DDHfOud1XSVeaJzWeyLEG7ebjjaL2LUGoGHhkaAn2rEALw_wcB): map data\n",
"* [folium](https://python-visualization.github.io/folium/): map rendering library\n",
"\n",
"### Recap the 10 remaining neighborhoods"
]
},
{
"cell_type": "code",
"execution_count": 16,
"metadata": {},
"outputs": [
{
"data": {
"text/html": [
"\n",
"\n",
"
\n",
" \n",
" \n",
" \n",
" Neighborhood \n",
" ID \n",
" Total Households \n",
" One-person Households \n",
" Population Density \n",
" Lat \n",
" Lon \n",
" Percentage of One-person Households \n",
" \n",
" \n",
" \n",
" \n",
" 6 \n",
" Jordaan \n",
" WK036306 \n",
" 12985 \n",
" 8625 \n",
" 23289 \n",
" 52.374500 \n",
" 4.879491 \n",
" 66.42 \n",
" \n",
" \n",
" 19 \n",
" Van Lennepbuurt \n",
" WK036319 \n",
" 4535 \n",
" 3005 \n",
" 28005 \n",
" 52.365144 \n",
" 4.867845 \n",
" 66.26 \n",
" \n",
" \n",
" 4 \n",
" Nieuwmarkt \n",
" WK036304 \n",
" 6485 \n",
" 4285 \n",
" 13741 \n",
" 52.372160 \n",
" 4.900096 \n",
" 66.08 \n",
" \n",
" \n",
" 24 \n",
" Oude Pijp \n",
" WK036324 \n",
" 9875 \n",
" 6510 \n",
" 23353 \n",
" 52.355216 \n",
" 4.894574 \n",
" 65.92 \n",
" \n",
" \n",
" 25 \n",
" Nieuwe Pijp \n",
" WK036325 \n",
" 7905 \n",
" 5015 \n",
" 23998 \n",
" 52.351856 \n",
" 4.897728 \n",
" 63.44 \n",
" \n",
" \n",
" 27 \n",
" Weesperzijde \n",
" WK036327 \n",
" 3470 \n",
" 2180 \n",
" 14984 \n",
" 52.357900 \n",
" 4.906300 \n",
" 62.82 \n",
" \n",
" \n",
" 2 \n",
" Grachtengordel-West \n",
" WK036302 \n",
" 4110 \n",
" 2570 \n",
" 14261 \n",
" 52.370837 \n",
" 4.885478 \n",
" 62.53 \n",
" \n",
" \n",
" 18 \n",
" Kinkerbuurt \n",
" WK036318 \n",
" 3950 \n",
" 2460 \n",
" 26135 \n",
" 52.369167 \n",
" 4.866649 \n",
" 62.28 \n",
" \n",
" \n",
" 20 \n",
" Helmersbuurt \n",
" WK036320 \n",
" 4580 \n",
" 2835 \n",
" 22124 \n",
" 52.363360 \n",
" 4.871285 \n",
" 61.90 \n",
" \n",
" \n",
" 16 \n",
" Frederik Hendrikbuurt \n",
" WK036316 \n",
" 5160 \n",
" 3165 \n",
" 23520 \n",
" 52.376956 \n",
" 4.874085 \n",
" 61.34 \n",
" \n",
" \n",
"
\n",
"
"
],
"text/plain": [
" Neighborhood ID Total Households One-person Households \\\n",
"6 Jordaan WK036306 12985 8625 \n",
"19 Van Lennepbuurt WK036319 4535 3005 \n",
"4 Nieuwmarkt WK036304 6485 4285 \n",
"24 Oude Pijp WK036324 9875 6510 \n",
"25 Nieuwe Pijp WK036325 7905 5015 \n",
"27 Weesperzijde WK036327 3470 2180 \n",
"2 Grachtengordel-West WK036302 4110 2570 \n",
"18 Kinkerbuurt WK036318 3950 2460 \n",
"20 Helmersbuurt WK036320 4580 2835 \n",
"16 Frederik Hendrikbuurt WK036316 5160 3165 \n",
"\n",
" Population Density Lat Lon \\\n",
"6 23289 52.374500 4.879491 \n",
"19 28005 52.365144 4.867845 \n",
"4 13741 52.372160 4.900096 \n",
"24 23353 52.355216 4.894574 \n",
"25 23998 52.351856 4.897728 \n",
"27 14984 52.357900 4.906300 \n",
"2 14261 52.370837 4.885478 \n",
"18 26135 52.369167 4.866649 \n",
"20 22124 52.363360 4.871285 \n",
"16 23520 52.376956 4.874085 \n",
"\n",
" Percentage of One-person Households \n",
"6 66.42 \n",
"19 66.26 \n",
"4 66.08 \n",
"24 65.92 \n",
"25 63.44 \n",
"27 62.82 \n",
"2 62.53 \n",
"18 62.28 \n",
"20 61.90 \n",
"16 61.34 "
]
},
"execution_count": 16,
"metadata": {},
"output_type": "execute_result"
}
],
"source": [
"df"
]
},
{
"cell_type": "markdown",
"metadata": {},
"source": [
"### Install and import folium"
]
},
{
"cell_type": "code",
"execution_count": 17,
"metadata": {},
"outputs": [],
"source": [
"#!conda install -c conda-forge folium=0.5.0 --yes #install folium\n",
"import folium # map rendering library"
]
},
{
"cell_type": "markdown",
"metadata": {},
"source": [
"## 4.1 Use TomTom Search API \n",
"**↑** [Back to top](#top)\n",
"\n",
"### Get an API key\n",
"\n",
"Click the \"Get Your Key\" button in [this page](https://developer.tomtom.com/content/search-api-explorer) to get an API key.\n",
"\n",
"### Load the TomTom API\n",
"\n",
"TomTom API offers multiple APIs, including the Search API. There is no need to load each API separately."
]
},
{
"cell_type": "code",
"execution_count": 18,
"metadata": {},
"outputs": [],
"source": [
"import requests\n",
"tomtom_api_keys = [\"qTI9oA80m7X6TeWf4qKDjA2UvCy6p5mA\"] # max 2500 calls/day\n",
"api_key = tomtom_api_keys[0]"
]
},
{
"cell_type": "markdown",
"metadata": {},
"source": [
"### Establishing the map\n",
"\n",
"First, I want to define a function using [Geocoding feature in Search API](https://developer.tomtom.com/content/search-api-explorer#/Geocoding/get_search__versionNumber__geocode__query___ext_) to get lat/lon of the center of a city. In this case, I retrieve the center of Amsterdam so that the map is properly aligned in the view."
]
},
{
"cell_type": "code",
"execution_count": 19,
"metadata": {},
"outputs": [],
"source": [
"# Search for city: \n",
"def SearchCity(api_key,City,Country):\n",
" \n",
" url = 'https://api.tomtom.com/search/2/search/'\n",
" url += City + ', ' + Country\n",
" url += '.json?limit=1&idxSet=Geo&key=' + api_key\n",
" \n",
" result = requests.get(url).json()\n",
" \n",
" GeoID = result['results'][0]['dataSources']['geometry']['id']\n",
" position = result['results'][0]['position']\n",
" \n",
" return GeoID,position"
]
},
{
"cell_type": "markdown",
"metadata": {},
"source": [
"### Get the center location of Amsterdam"
]
},
{
"cell_type": "code",
"execution_count": 20,
"metadata": {},
"outputs": [],
"source": [
"Amsterdam_position = SearchCity(api_key, \"Amsterdam\", \"Netherlands\")"
]
},
{
"cell_type": "code",
"execution_count": 21,
"metadata": {},
"outputs": [
{
"name": "stdout",
"output_type": "stream",
"text": [
"52.37317 4.89066\n"
]
}
],
"source": [
"lat_amsterdam = Amsterdam_position[1]['lat']\n",
"lon_amsterdam = Amsterdam_position[1]['lon']\n",
"print(lat_amsterdam, lon_amsterdam)"
]
},
{
"cell_type": "code",
"execution_count": 22,
"metadata": {},
"outputs": [],
"source": [
"#!conda install -c conda-forge geopy --yes # uncomment this line if you haven't completed the TomTom API lab\n",
"from geopy.geocoders import Nominatim # convert an address into latitude and longitude values"
]
},
{
"cell_type": "code",
"execution_count": 23,
"metadata": {},
"outputs": [
{
"name": "stdout",
"output_type": "stream",
"text": [
"The geograpical coordinate of Amsterdam are 52.3727598, 4.8936041.\n"
]
}
],
"source": [
"address = 'Amsterdam, The Netherlands'\n",
"\n",
"geolocator = Nominatim(user_agent=\"amsterdam\")\n",
"location = geolocator.geocode(address)\n",
"latitude = location.latitude\n",
"longitude = location.longitude\n",
"print('The geograpical coordinate of Amsterdam are {}, {}.'.format(latitude, longitude))"
]
},
{
"cell_type": "markdown",
"metadata": {},
"source": [
"### First Impression of the Candidate Neighborhoods\n",
"\n",
"Now, let’s instantiate the visual component, the TomTom map itself, so I can begin displaying neighborhoods."
]
},
{
"cell_type": "code",
"execution_count": 24,
"metadata": {},
"outputs": [],
"source": [
"#Define a function to initialize any map using TomTom map.\n",
"def init_map(api_key=api_key, latitude=0, longitude=0, zoom=14, layer = \"basic\", style = \"main\"):\n",
" \"\"\"\n",
" The initialise_map function initializes a clean TomTom map\n",
" \"\"\"\n",
" \n",
" maps_url = \"http://{s}.api.tomtom.com/map/1/tile/\"+layer+\"/\"+style+\"/{z}/{x}/{y}.png?tileSize=512&key=\"\n",
" TomTom_map = folium.Map(\n",
" location = [latitude, longitude], # on what coordinates [lat, lon] to initialise our map\n",
" zoom_start = zoom, # with what zoom level to initialize the map, from 0 to 22\n",
" tiles = str(maps_url + api_key),\n",
" attr = 'TomTom')\n",
" \n",
" return TomTom_map"
]
},
{
"cell_type": "markdown",
"metadata": {},
"source": [
"## 4.2. Visualize one feature on the map \n",
"**↑** [Back to top](#top)\n",
"\n",
"Let's start from visualizing the number of one-person households on the map to get an impression of the 10 candidate neighborhoods."
]
},
{
"cell_type": "code",
"execution_count": 25,
"metadata": {},
"outputs": [
{
"data": {
"text/html": [
""
],
"text/plain": [
""
]
},
"execution_count": 25,
"metadata": {},
"output_type": "execute_result"
}
],
"source": [
"#Visualize one feature (number of one-person households) to get an impression of the 10 candidate neighborhoods.\n",
"TomTom_map = init_map(latitude=lat_amsterdam, longitude=lon_amsterdam, zoom=13, layer = \"basic\")\n",
"\n",
"# add markers to map\n",
"for lat, lon, neighborhood, oph in zip(df['Lat'], df['Lon'], df['Neighborhood'], df['One-person Households']):\n",
" label = '{}'.format(neighborhood)\n",
" label = folium.Popup(label, parse_html=True)\n",
" folium.Circle(\n",
" [lat, lon],\n",
" radius=oph/25,\n",
" popup=label, \n",
" color='#FF7F0F', # Orange\n",
" fill=True,\n",
" fill_color='#FF7F0F',\n",
" fill_opacity=0.3).add_to(TomTom_map)\n",
"TomTom_map.save('01_demographic.html')\n",
"TomTom_map"
]
},
{
"cell_type": "markdown",
"metadata": {},
"source": [
"## 4.3. Visualize more features on the map \n",
"**↑** [Back to top](#top)\n",
"\n",
"The above map gives us an impression of how many one-person households actually exist in each neighborhood.\n",
"\n",
"Now, let's add two more features to the map, so there are three features in total:\n",
"\n",
"1. **Orange circles** represent the number of one-person households.\n",
"2. **Blue circles** represent the number of households in total.\n",
"3. **Green circles** represent the population density.\n",
"\n",
"Important notes about these circles:\n",
"\n",
"* The center of the orange, green, and blue circles is the center of the neighborhood. Click the center of the circles to see the name of the neighborhood.\n",
"* The radius of each circle represents the number of each feature.\n",
"\n",
"In order to show a more zoomed in map view, I re-adjust the center of the map.\n",
"\n",
"### Re-adjust the center of the map using an address\n",
"\n",
"Based on the previous map visualization, I can see a better center for further analysis is the address: Prinsengracht 745A Amsterdam."
]
},
{
"cell_type": "code",
"execution_count": 26,
"metadata": {},
"outputs": [],
"source": [
"url = \"https://api.tomtom.com/search/2/geocode/Prinsengracht 745A Amsterdam.json?countrySet=NL&key=\" + api_key\n",
"result = requests.get(url).json()"
]
},
{
"cell_type": "code",
"execution_count": 27,
"metadata": {},
"outputs": [
{
"name": "stdout",
"output_type": "stream",
"text": [
"52.36425 4.88628\n"
]
}
],
"source": [
"lat_center = result['results'][0]['position']['lat']\n",
"lon_center = result['results'][0]['position']['lon']\n",
"print(lat_center, lon_center)"
]
},
{
"cell_type": "markdown",
"metadata": {},
"source": [
"### Draw the Map with One-person Households, Total Households, and Population Density."
]
},
{
"cell_type": "code",
"execution_count": 28,
"metadata": {
"scrolled": false
},
"outputs": [
{
"data": {
"text/html": [
""
],
"text/plain": [
""
]
},
"execution_count": 28,
"metadata": {},
"output_type": "execute_result"
}
],
"source": [
"TomTom_map = init_map(latitude=lat_center, longitude=lon_center, zoom=14, layer = \"basic\")\n",
"\n",
"# add markers that represent one-person households to the map\n",
"for lat, lon, neighborhood, oph in zip(df['Lat'], df['Lon'], df['Neighborhood'], df['One-person Households']):\n",
" label = '{}'.format(neighborhood)\n",
" label = folium.Popup(label, parse_html=True)\n",
" folium.Circle(\n",
" [lat, lon],\n",
" radius=oph/25,\n",
" popup=label,\n",
" color='#FF7F0F', # Orange\n",
" fill=True,\n",
" fill_color='#FF7F0F', \n",
" fill_opacity=0.3\n",
" ).add_to(TomTom_map)\n",
"\n",
"# add markers that represent total households to the map\n",
"for lat, lon, neighborhood, households in zip(df['Lat'], df['Lon'], df['Neighborhood'], df['Total Households']):\n",
" label = '{}'.format(neighborhood)\n",
" label = folium.Popup(label, parse_html=True)\n",
" folium.Circle(\n",
" [lat, lon],\n",
" radius=households/25,\n",
" popup=label,\n",
" color='#1E77B4', # Blue\n",
" fill=False\n",
" ).add_to(TomTom_map)\n",
" \n",
"# add markers that represent population density to the map\n",
"for lat, lon, neighborhood, density in zip(df['Lat'], df['Lon'], df['Neighborhood'], df['Population Density']):\n",
" label = '{}'.format(neighborhood)\n",
" label = folium.Popup(label, parse_html=True)\n",
" folium.Circle(\n",
" [lat, lon],\n",
" radius=density/100,\n",
" popup=label,\n",
" color='#2A9E2A', # Green\n",
" fill=False\n",
" ).add_to(TomTom_map)\n",
"TomTom_map.save('02_demographic.html')\n",
"TomTom_map"
]
},
{
"cell_type": "markdown",
"metadata": {},
"source": [
"### Learnings from the above data visualization\n",
"\n",
"As you can see, when choosing an ideal location to open the Chinese restaurant:\n",
"\n",
"* **The bigger the green circles the better.**\n",
"* **The less difference between the size of the blue circles and the orange circles the better.**"
]
},
{
"cell_type": "markdown",
"metadata": {},
"source": [
"## 4.4. Conclusion and Next Step \n",
"**↑** [Back to top](#top)\n",
"\n",
"Based the above analysis, I have chosen **10** out of **65** neighborhoods in Amsterdam city proper as the candidate neighborhoods for us to investigate further.\n",
"\n",
"**The next step**, covered in the next chapter, will be to further analyze the **10** neighborhoods by looking into **the density of Chinese restaurants** in each. This will help me narrow down Linda’s choices for the best exact location for her new restaurant.\n",
"\n",
"\n",
" \n",
"\n",
" \n",
"\n",
"\n",
"# 5. Explore the surroundings\n",
"**↑** [Back to top](#top)\n",
"\n",
"(Add description of TomTom Search API)\n",
"\n",
"Now, I know where the remaining 10 neighborhoods locate and their geo-relationship. It's time to explore the surroundings. In the scope of the project, I will focus on only question to demonstrate the methodology:\n",
"\n",
" * How many Chinese restaurants are already available in each neighborhood?\n",
"\n",
"## 5.1. How many Chinese restaurants are already available in each neighborhood? \n",
"\n",
"Use the [Search API explorer](https://developer.tomtom.com/content/search-api-explorer#/Search/get_search__versionNumber__categorySearch__query___ext_) to get the url. I choose to store all search results in a JSON file.\n",
"\n",
"Some key variables:\n",
"\n",
"* Search radius: **radius**\n",
"* Maximum number of search results: **limit**"
]
},
{
"cell_type": "code",
"execution_count": 29,
"metadata": {},
"outputs": [],
"source": [
"search_radius = 3000\n",
"search_limit = 2000"
]
},
{
"cell_type": "code",
"execution_count": 30,
"metadata": {},
"outputs": [],
"source": [
"url = ('https://api.tomtom.com/search/2/categorySearch/Chinese restaurant.json?countrySet=NL'\n",
" +'&lat=52.364250&lon=4.886280&limit=2000&radius=3000&key=' + api_key)\n",
"result = requests.get(url).json()\n",
"#result"
]
},
{
"cell_type": "markdown",
"metadata": {},
"source": [
"### Examine one of the search results in the JSON file"
]
},
{
"cell_type": "code",
"execution_count": 31,
"metadata": {},
"outputs": [
{
"data": {
"text/plain": [
"({'type': 'POI',\n",
" 'id': 'NL/POI/p0/109857',\n",
" 'score': 5.14904,\n",
" 'dist': 150.32529954911772,\n",
" 'info': 'search:ta:528009005857203-NL',\n",
" 'poi': {'name': 'Taste Of Culture',\n",
" 'phone': '+(31)-(20)-4271136',\n",
" 'categorySet': [{'id': 7315012}],\n",
" 'url': 'www.tasteofculture.net',\n",
" 'categories': ['chinese', 'restaurant'],\n",
" 'classifications': [{'code': 'RESTAURANT',\n",
" 'names': [{'nameLocale': 'en-US', 'name': 'chinese'},\n",
" {'nameLocale': 'en-US', 'name': 'restaurant'}]}]},\n",
" 'address': {'streetNumber': '139HS',\n",
" 'streetName': 'Korte Leidsedwarsstraat',\n",
" 'municipalitySubdivision': 'Amsterdam',\n",
" 'municipality': 'Amsterdam',\n",
" 'countrySubdivision': 'North Holland',\n",
" 'postalCode': '1017',\n",
" 'extendedPostalCode': '1017PZ',\n",
" 'countryCode': 'NL',\n",
" 'country': 'Netherlands',\n",
" 'countryCodeISO3': 'NLD',\n",
" 'freeformAddress': 'Korte Leidsedwarsstraat 139HS, 1017PZ, Amsterdam',\n",
" 'localName': 'Amsterdam'},\n",
" 'position': {'lat': 52.36311, 'lon': 4.88509},\n",
" 'viewport': {'topLeftPoint': {'lat': 52.36401, 'lon': 4.88362},\n",
" 'btmRightPoint': {'lat': 52.36221, 'lon': 4.88656}},\n",
" 'entryPoints': [{'type': 'main',\n",
" 'position': {'lat': 52.36305, 'lon': 4.885}}]},)"
]
},
"execution_count": 31,
"metadata": {},
"output_type": "execute_result"
}
],
"source": [
"{'type': 'POI',\n",
" 'id': 'NL/POI/p0/109857',\n",
" 'score': 5.14904,\n",
" 'dist': 150.32529954911772,\n",
" 'info': 'search:ta:528009005857203-NL',\n",
" 'poi': {'name': 'Taste Of Culture',\n",
" 'phone': '+(31)-(20)-4271136',\n",
" 'categorySet': [{'id': 7315012}],\n",
" 'url': 'www.tasteofculture.net',\n",
" 'categories': ['chinese', 'restaurant'],\n",
" 'classifications': [{'code': 'RESTAURANT',\n",
" 'names': [{'nameLocale': 'en-US', 'name': 'chinese'},\n",
" {'nameLocale': 'en-US', 'name': 'restaurant'}]}]},\n",
" 'address': {'streetNumber': '139HS',\n",
" 'streetName': 'Korte Leidsedwarsstraat',\n",
" 'municipalitySubdivision': 'Amsterdam',\n",
" 'municipality': 'Amsterdam',\n",
" 'countrySubdivision': 'North Holland',\n",
" 'postalCode': '1017',\n",
" 'extendedPostalCode': '1017PZ',\n",
" 'countryCode': 'NL',\n",
" 'country': 'Netherlands',\n",
" 'countryCodeISO3': 'NLD',\n",
" 'freeformAddress': 'Korte Leidsedwarsstraat 139HS, 1017PZ, Amsterdam',\n",
" 'localName': 'Amsterdam'},\n",
" 'position': {'lat': 52.36311, 'lon': 4.88509},\n",
" 'viewport': {'topLeftPoint': {'lat': 52.36401, 'lon': 4.88362},\n",
" 'btmRightPoint': {'lat': 52.36221, 'lon': 4.88656}},\n",
" 'entryPoints': [{'type': 'main',\n",
" 'position': {'lat': 52.36305, 'lon': 4.885}}]},"
]
},
{
"cell_type": "markdown",
"metadata": {},
"source": [
"I can learn from the above JSON file that the following information is essential to show Chinese Restaurants on the map:\n",
"\n",
"* Get lat lon from:**'position': {'lat': 52.36311, 'lon': 4.88509},**\n",
"* Get name from: **'poi': {'name': 'Taste Of Culture',**\n",
"\n",
"### Now, let's plot these restaurants on the map.\n",
"\n",
"\n",
"## 5.2. Show Chinese restaurants on the map \n",
"**↑** [Back to top](#top)\n",
"\n",
"Use the position and name information extracted from the JSON file to show POIs on the map."
]
},
{
"cell_type": "code",
"execution_count": 32,
"metadata": {
"scrolled": false
},
"outputs": [
{
"data": {
"text/html": [
""
],
"text/plain": [
""
]
},
"execution_count": 32,
"metadata": {},
"output_type": "execute_result"
}
],
"source": [
"# add a grey circle to represent the search radius\n",
"folium.Circle(\n",
" [lat_center, lon_center],\n",
" radius=search_radius,\n",
" color='#004B7F', # Navy\n",
" opacity=0.3,\n",
" fill = False\n",
").add_to(TomTom_map)\n",
"\n",
"# Add POIs one by one to the map\n",
"for poi in result['results']:\n",
" folium.Marker(location=tuple(poi['position'].values()),\n",
" popup=str(poi['poi']['name']), \n",
" icon=folium.Icon(color='blue', icon='glyphicon-star')\n",
" #icon=icon\n",
" ).add_to(TomTom_map)\n",
"TomTom_map.save('03_ChineseRestaurants.html')\n",
"TomTom_map"
]
},
{
"cell_type": "markdown",
"metadata": {},
"source": [
"#### Legends of the above map\n",
"\n",
"1. **Blue markers**: Chinese restaurants.\n",
"2. **Orange circles**: the number of one-person households.\n",
"3. **Blue circles**: the number of households in total.\n",
"4. **Green circles**: the population density.\n",
"5. **Grey circle**: the search radius.\n",
"\n",
"## 5.3. Cluster the POIs \n",
"**↑** [Back to top](#top)\n",
"\n",
"What I would really like to do is have a more obvious visual as to the number of Chinese restaurants in the area. Clustering the POIs (Point of Interests) might help this.\n",
"\n",
"#### First, let's import the necessary plugins: folium.plugins.MarkerCluster"
]
},
{
"cell_type": "code",
"execution_count": 33,
"metadata": {},
"outputs": [],
"source": [
"from folium.plugins import MarkerCluster"
]
},
{
"cell_type": "markdown",
"metadata": {},
"source": [
"### Show POIs as clusters on the map"
]
},
{
"cell_type": "code",
"execution_count": 34,
"metadata": {},
"outputs": [
{
"data": {
"text/html": [
""
],
"text/plain": [
""
]
},
"execution_count": 34,
"metadata": {},
"output_type": "execute_result"
}
],
"source": [
"#------IMPORTANT: Reinitiate the TomTom_map, so that the POI pins won't remain in the map--------\n",
"TomTom_map = init_map(latitude=lat_center, longitude=lon_center, zoom=14, layer = \"basic\")\n",
"\n",
"# add markers that represent one-person households to the map\n",
"for lat, lon, neighborhood, oph in zip(df['Lat'], df['Lon'], df['Neighborhood'], df['One-person Households']):\n",
" label = '{}'.format(neighborhood)\n",
" label = folium.Popup(label, parse_html=True)\n",
" folium.Circle(\n",
" [lat, lon],\n",
" radius=oph/25,\n",
" popup=label,\n",
" color='#FF7F0F', # Orange\n",
" fill=True,\n",
" fill_color='#FF7F0F', \n",
" fill_opacity=0.3\n",
" ).add_to(TomTom_map)\n",
"\n",
"# add markers that represent total households to the map\n",
"for lat, lon, neighborhood, households in zip(df['Lat'], df['Lon'], df['Neighborhood'], df['Total Households']):\n",
" label = '{}'.format(neighborhood)\n",
" label = folium.Popup(label, parse_html=True)\n",
" folium.Circle(\n",
" [lat, lon],\n",
" radius=households/25,\n",
" popup=label,\n",
" color='#1E77B4', # Blue\n",
" fill=False\n",
" ).add_to(TomTom_map)\n",
" \n",
"# add markers that represent population density to the map\n",
"for lat, lon, neighborhood, density in zip(df['Lat'], df['Lon'], df['Neighborhood'], df['Population Density']):\n",
" label = '{}'.format(neighborhood)\n",
" label = folium.Popup(label, parse_html=True)\n",
" folium.Circle(\n",
" [lat, lon],\n",
" radius=density/100,\n",
" popup=label,\n",
" color='#2A9E2A', # Green\n",
" fill=False\n",
" ).add_to(TomTom_map)\n",
" \n",
"#----------------END of the reinitiation of TomTom_map------------\n",
"\n",
"\n",
"\n",
"#--------------Show POIs in Clusters rather than POI pins on the map------------\n",
"\n",
"# Define the marker cluster\n",
"mc = MarkerCluster()\n",
"\n",
"# add a grey circle to represent the search radius\n",
"folium.Circle(\n",
" [lat_center, lon_center],\n",
" radius=search_radius,\n",
" color='#004B7F', # Navy\n",
" opacity=0.3,\n",
" fill = False\n",
").add_to(TomTom_map)\n",
"\n",
"# Add POIs one by one to the map\n",
"for poi in result['results']:\n",
" mc.add_child(\n",
" folium.Marker(\n",
" location=tuple(poi['position'].values()),\n",
" popup=str(poi['poi']['name'])\n",
" ))\n",
"\n",
"TomTom_map.add_child(mc)\n",
"TomTom_map.save('04_POI_Clustered.html')\n",
"TomTom_map"
]
},
{
"cell_type": "markdown",
"metadata": {},
"source": [
"Zoom in and out the map above to observe how the clusters react.\n",
"\n",
"### Key Takeaways\n",
"\n",
"Now that I have investigated options for Linda through multiple filters and criteria, **I can conclude**:\n",
"\n",
"* There must be at least one existing Chinese restaurant in or near the neighborhood. \n",
"If there isn’t at least one Chinese restaurant, it might mean that **there is not enough demand**. \n",
"Opening a Chinese restaurant without understanding why there are no any could be a risk for Linda.\n",
"* There cannot be more than 10 existing Chinese restaurants in the neighborhood, in order to mitigate competition for her. \n",
"**Linda wants to stand out!!**\n",
"\n",
"If I apply the criteria, from the above map, I can exclude these neighborhoods:\n",
"\n",
"* Too many existing Chinese restaurants\n",
" * Nieuwmarkt\n",
"* No existing Chinese restaurant in or near the neighborhood\n",
" * Weesperzijde\n",
" * Frederik Hendrikbuurt\n",
" * Grachtengordel-West\n",
" * Nieuwe Pijp\n",
" \n",
"### The remaining neighborhoods left for Linda to choose from:\n",
"* Jordaan\n",
"* Van Lennepbuurt\n",
"* Oude Pijp\n",
"* Kinkerbuurt\n",
"* Helmersbuurt\n",
"\n",
" \n",
"\n",
" \n",
"\n",
"\n",
"# 6. In-depth analysis of one neighborhood\n",
"**↑** [Back to top](#top)\n",
"\n",
"Let's use **_Jordaan_** as an example to show how I look into one particular candidate neighborhood.\n",
"\n",
"## 6.1. Draw the area of the neighborhood on the map "
]
},
{
"cell_type": "code",
"execution_count": 35,
"metadata": {},
"outputs": [],
"source": [
"area_name = 'Jordaan'"
]
},
{
"cell_type": "markdown",
"metadata": {},
"source": [
"Define a function to get polygon of a given GeoID."
]
},
{
"cell_type": "code",
"execution_count": 36,
"metadata": {},
"outputs": [],
"source": [
"# get polygon of GeoID: \n",
"def getPolygon(api_key,GeoID,zoomLevel):\n",
" \n",
" url = 'https://api.tomtom.com/search/2/additionalData.json?geometries=' + GeoID\n",
" url += '&geometriesZoom=' + str(zoomLevel)\n",
" url += '&key=' + api_key\n",
" \n",
" result = requests.get(url).json() \n",
" GeoJson = result['additionalData'][0]['geometryData']\n",
" \n",
" return GeoJson"
]
},
{
"cell_type": "markdown",
"metadata": {},
"source": [
"Search the city"
]
},
{
"cell_type": "code",
"execution_count": 37,
"metadata": {},
"outputs": [],
"source": [
"# Search City:\n",
"GeoID, position = SearchCity(api_key, area_name ,'Amsterdam')"
]
},
{
"cell_type": "markdown",
"metadata": {},
"source": [
"Find out the center location of the neighborhood"
]
},
{
"cell_type": "code",
"execution_count": 38,
"metadata": {},
"outputs": [
{
"name": "stdout",
"output_type": "stream",
"text": [
"The center of the neighborhood is: ( 52.37329 , 4.87992 )\n"
]
}
],
"source": [
"lat_area = position['lat']\n",
"lon_area = position['lon']\n",
"print(\"The center of the neighborhood is: (\", lat_area, \", \", lon_area, \")\")"
]
},
{
"cell_type": "markdown",
"metadata": {},
"source": [
"### Create a polygon and add it to the map"
]
},
{
"cell_type": "code",
"execution_count": 39,
"metadata": {},
"outputs": [
{
"data": {
"text/html": [
""
],
"text/plain": [
""
]
},
"execution_count": 39,
"metadata": {},
"output_type": "execute_result"
}
],
"source": [
"# Get Polygon of city:\n",
"Polygon = getPolygon(api_key,GeoID,22)\n",
"\n",
"map_url = 'http://{s}.api.tomtom.com/map/1/tile/basic/main/{z}/{x}/{y}.png?view=Unified&key=' + api_key\n",
"\n",
"TomTom_map = folium.Map(\n",
" location=[lat_area, lon_area],\n",
" zoom_start=14,\n",
" tiles= map_url,\n",
" attr='TomTom')\n",
"\n",
"# add polygons to a map\n",
"folium.GeoJson(\n",
" Polygon).add_to(TomTom_map)\n",
"\n",
"TomTom_map.save('05_Area.html')\n",
"TomTom_map"
]
},
{
"cell_type": "markdown",
"metadata": {},
"source": [
"## 6.2. Show Chinese restaurants in the neighborhood \n",
"**↑** [Back to top](#top)\n",
"\n",
"### Search for the Chinese restaurant using the search API\n",
"\n",
"Set the search radius to 1.2 km to cover the entire neighborhood."
]
},
{
"cell_type": "code",
"execution_count": 40,
"metadata": {},
"outputs": [],
"source": [
"url = ('https://api.tomtom.com/search/2/categorySearch/Chinese restaurant.json?countrySet=NL'\n",
" +'&lat=52.37329&lon=4.87992&limit=2000&radius=1200&key=' + api_key)\n",
"result = requests.get(url).json()\n",
"#result"
]
},
{
"cell_type": "code",
"execution_count": 41,
"metadata": {},
"outputs": [
{
"data": {
"text/html": [
""
],
"text/plain": [
""
]
},
"execution_count": 41,
"metadata": {},
"output_type": "execute_result"
}
],
"source": [
"# add a grey circle to represent the search radius\n",
"folium.Circle(\n",
" [lat_area, lon_area],\n",
" radius=1200,\n",
" color='#004B7F', # Navy\n",
" opacity=0.3,\n",
" fill = False\n",
").add_to(TomTom_map)\n",
"\n",
"# Add POIs one by one to the map\n",
"for poi in result['results']:\n",
" folium.Marker(location=tuple(poi['position'].values()),\n",
" popup=str(poi['poi']['name']), \n",
" icon=folium.Icon(color='blue', icon='glyphicon-star')\n",
" #icon=icon\n",
" ).add_to(TomTom_map)\n",
"TomTom_map.save('06_Area_POI.html')\n",
"TomTom_map"
]
},
{
"cell_type": "markdown",
"metadata": {},
"source": [
"#### Legends of the above map\n",
"\n",
"1. **Blue markers**: Chinese restaurants.\n",
"2. **Blue area**: The shape of the neighborhood\n",
"3. **Grey circle**: the search radius.\n",
"\n",
"### Takeaways from this map\n",
"\n",
"1.\tAccording to **[TomTom Maps API](https://developer.tomtom.com/products/maps-api?gclid=Cj0KCQiA2ITuBRDkARIsAMK9Q7PaNwgDOLImQcoaRN8mHEJ9bcBuNg_UEH3S5Ybk2tlVj-kQNJILIWAaAkYIEALw_wcB)**, there are more than 20 Chinese Restaurants within the range of 500 meters of the neighborhood Jordaan.\n",
"2.\tFrom the map I learn that the west of Jordaan seems to be void of Chinese restaurants. If Linda opens a Chinese restaurant there, she will likely have enough customers.\n",
"\n",
"\n",
"## 6.3. Repeat! \n",
"**↑** [Back to top](#top)\n",
"\n",
"At this point, I would advise Linda to repeat this in-depth examination for each neighborhood she is considering. I could also adjust the details. I consider to include other venues, for example – looking at the number of cafes, snack bars, etc present in an area in addition to regular restaurants.\n",
"\n",
"\n",
" \n",
"\n",
" \n",
"\n",
"# 7. Conclusion and future work\n",
"**↑** [Back to top](#top)\n",
"\n",
"## The limitation of this project\n",
"\n",
"### Only focus on residential information\n",
"\n",
"This project is limited by the lack of crucial information. So far I have been focused quite a lot on residence information and one-person households. However, customers can also come from nearby business venues. I am unable to validate any assumption or answer any questions, because the information of business venues in Amsterdam is not as available as demographic information.\n",
"\n",
"### Rent of a venue is not taken into consideration\n",
"\n",
"Due to lack of information, I am unable to include rental price as part of the analysis. Cost could be a big factor for Linda. In order to be able to predict the potential profit, however, it is crucial to include potential rental price.\n",
"\n",
"### Explore more POI categories\n",
"\n",
"There are other facilities in the neighborhood which may influence the income of the restaurant. For instance:\n",
"\n",
"* **How easy is it to reach the place via public transportation?** \n",
"Search for nearby bus stops, tram stations, train stations, etc.\n",
"* **How easy is it to park your car in the neighborhood?** \n",
"Search for nearby parking garages or open parking places.\n",
"\n",
"\n",
"## Next steps for Linda\n",
"\n",
"* Continue to perform the same in-depth analysis to all neighborhoods as I did in [In-depth analysis of one neighborhood](#5).\n",
"* Include rental price of each neighborhood in future analysis to be informed about her costs to profit ratio.\n",
"\n",
"\n",
"
"
]
}
],
"metadata": {
"kernelspec": {
"display_name": "Python 3",
"language": "python",
"name": "python3"
},
"language_info": {
"codemirror_mode": {
"name": "ipython",
"version": 3
},
"file_extension": ".py",
"mimetype": "text/x-python",
"name": "python",
"nbconvert_exporter": "python",
"pygments_lexer": "ipython3",
"version": "3.7.3"
}
},
"nbformat": 4,
"nbformat_minor": 2
}