# 1. Background¶

This is the virtual challenge I choose to complete an online Data Science course. And I have so much fun tackling the challenge using TomTom Maps API, I would like to share the project with others.

## 1.1 The challenge¶

Linda has a dream to open a Chinese restaurant to share the joy of great food with others. Now, everything is ready, she chooses Amsterdam to be the place where her dream takes off. Not only because Amsterdam is one of the most populous and visited cities in Europe but also because the diverse culture the city embraces.

## 1.2. The approach¶

The big question is, where to open a Chinese restaurant in Amsterdam. I need to collect data from at least two sources to narrow down the selection:

1. Demographic data (for instance: population density per area in Amsterdam)
2. Data of the surroundings (for instance: density of similar restaurants nearby)

Since you are here to read about fantastic things you can do with TomTom Maps API, I will be much more focused on the second part: Data of the surroundings. If you are interested in the complete story, please read: the full Story

To find the ideal location for the restaurant, I must first seek answers to a few questions.

### Question 1: How many restaurants already exist?¶

If this new restaurant would be the only one in a neighborhood, there will be more profit for Linda. So, the number of existing restaurants in the neighborhood must be taken into consideration. Again, this question can be answered, hopefully, by using TomTom API.

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 double check how existing Chinese restaurants (or Asian restaurants) are perceived. This question can be answered, hopefully, by using TomTom API.

### Question 3: Who are the target customers and where do they live?¶

It is going to be a small restaurant (5 to 7 tables) due to the limited investment. The primary income would be takeout and orders made online. From past 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. We need demographic information to answer this question.

# 2. Data requirements¶

We have the big question, where to open a Chinese restaurant in Amsterdam. Now, we need to collect data that can help us answer the questions. We need to collect data from at least two sources:

1. Data of the surroundings (density of similar restaurants nearby)
2. Demographic data (per area in Amsterdam)

## 2.1. Data of surroundings¶

### TomTom Search API:¶

To find all points of interest (POI) per category around a certain location, I will utilize TomTom Search:

## 2.2 Demographic data¶

### Demographic features that are crucial to learn for this project:¶

• Total Households: Number of households in a neighborhood.
• High number of total households guarantees a solid base of potential customers.
• Population density: A more densely populated area means more customers for a restaurant. The unit of population density is number of people per square kilometer.
• On top of total households, this feature tells us how many households there are within a given area. Since people living nearby are more likely target customers, the more densely populated neighborhood is a more ideal choice.
• One-person Households: Number of the households that with only one person.
• One-person households are perfect target customers, as these individuals are more likely to order takeout and avoid cooking alone.

Demographic analysis is definitely essential to start narrowing down neighborhoods in Amsterdam. However, it is not the focus of this article. If you are interested in the full story (including demographic data analysis), please read the full story.

### Conclude demographic analysis¶

From studying and analyzing demographic data, I chose 10 out of 65 neighborhoods in Amsterdam. Now, I want to display all of these neighborhoods on a map, to give Linda some visuals so she can make her decision more easily!

# 3. View candidate neighborhoods on a map¶

I will use these tools to visualize information on a map:

## 3.1 Load the information of the 10 remaining neighborhoods into a dataframe¶

The CSV file that is loaded below is cleaned up based on analyzing demographic data. In the full story, I explained how to process the data from a larger dataset.

In [1]:
# library to handle data in a vectorized manner
import numpy as np
import pandas as pd

# Matplotlib and associated plotting modules
import matplotlib.colors as colors
import matplotlib.pyplot as plt


In [2]:
df = pd.read_csv('https://github.com/xding78/Sharing/raw/master/RestaurantQuest/Amsterdam_top10.csv')
df

Out[2]:
Neighborhood Total Residences Total Households One-person Households Population Density Percentage of One-person Households Lat Lon
0 Jordaan 19435 12985 8625 23289 66.42 52.374500 4.879491
1 Van Lennepbuurt 6990 4535 3005 28005 66.26 52.365144 4.867845
2 Nieuwmarkt 9765 6485 4285 13741 66.08 52.372160 4.900096
3 Oude Pijp 14820 9875 6510 23353 65.92 52.355216 4.894574
4 Nieuwe Pijp 12325 7905 5015 23998 63.44 52.351856 4.897728
5 Weesperzijde 5535 3470 2180 14984 62.82 52.357900 4.906300
6 Grachtengordel-West 6385 4110 2570 14261 62.53 52.370837 4.885478
7 Kinkerbuurt 6590 3950 2460 26135 62.28 52.369167 4.866649
8 Helmersbuurt 7410 4580 2835 22124 61.90 52.363360 4.871285
9 Frederik Hendrikbuurt 8435 5160 3165 23520 61.34 52.376956 4.874085

### Install folium¶

In [3]:
#-----install folium map----
#pip install folium==0.9.1 #comment it out if folium is already installed

#----Alterantively, install folium with the following code-------
#!conda install -c conda-forge folium=0.5.0 --yes #install folium


### Import folium¶

In [4]:
import folium # map rendering library


## 3.2 Use TomTom Search API¶

### Get an API key¶

TomTom API offers multiple APIs, including the Search API. There is no need to load each API separately.

In [5]:
import requests
tomtom_api_keys = ["qTI9oA80m7X6TeWf4qKDjA2UvCy6p5mA"] # max 2500 calls/day
api_key = tomtom_api_keys[0]


### Establishing the map¶

First, I want to define a function using Geocoding feature in Search API 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.

In [6]:
# Search for city:
def SearchCity(api_key,City,Country):

url = 'https://api.tomtom.com/search/2/search/'
url += City + ', ' + Country
url += '.json?limit=1&idxSet=Geo&key=' + api_key

result = requests.get(url).json()

GeoID = result['results'][0]['dataSources']['geometry']['id']
position = result['results'][0]['position']

return GeoID,position

In [7]:
Amsterdam_position = SearchCity(api_key, "Amsterdam", "Netherlands")

In [8]:
lat_amsterdam = Amsterdam_position[1]['lat']
lon_amsterdam = Amsterdam_position[1]['lon']
print(lat_amsterdam, lon_amsterdam)

52.37317 4.89066


### First Impression of the Candidate Neighborhoods¶

Now, let’s instantiate the visual component, the TomTom map itself, so I can begin displaying neighborhoods.

In [9]:
#Define a function to initialize any map using TomTom map.
def init_map(api_key=api_key, latitude=0, longitude=0, zoom=14, layer = "basic", style = "main"):
"""
The initialise_map function initializes a clean TomTom map
"""

maps_url = "http://{s}.api.tomtom.com/map/1/tile/"+layer+"/"+style+"/{z}/{x}/{y}.png?tileSize=512&key="
TomTom_map = folium.Map(
location = [latitude, longitude],  # on what coordinates [lat, lon] to initialise our map
zoom_start = zoom,  # with what zoom level to initialize the map, from 0 to 22
tiles = str(maps_url + api_key),
attr = 'TomTom')



## 3.3 Visualize one feature on the map¶

Let's start from visualizing the number of one-person households on the map to get an impression of the 10 candidate neighborhoods.

In [10]:
#Visualize one feature (number of one-person households) to get an impression of the 10 candidate neighborhoods.
TomTom_map = init_map(latitude=lat_amsterdam, longitude=lon_amsterdam, zoom=13, layer = "basic")

for lat, lon, neighborhood, oph in zip(df['Lat'], df['Lon'], df['Neighborhood'], df['One-person Households']):
label = '{}'.format(neighborhood)
label = folium.Popup(label, parse_html=True)
folium.Circle(
[lat, lon],
popup=label,
color='#FF7F0F', # Orange
fill=True,
fill_color='#FF7F0F',
TomTom_map.save('01_demographic.html')
TomTom_map

Out[10]:

## 3.4 Visualize more features on the map¶

The above map gives us an impression of how many one-person households actually exist in each neighborhood.

Now, let's add two more features to the map, so there are three features in total:

1. Orange circles represent the number of one-person households.
2. Blue circles represent the number of households in total.
3. Green circles represent the population density.

• 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.
• The radius of each circle represents the number of each feature.

In order to show a more zoomed in map view, I re-adjust the center of the map.

Based on the previous map visualization, I can see a better center for further analysis is the address: Prinsengracht 745A Amsterdam.

In [11]:
url = "https://api.tomtom.com/search/2/geocode/Prinsengracht 745A Amsterdam.json?countrySet=NL&key=" + api_key
result = requests.get(url).json()

In [12]:
lat_center = result['results'][0]['position']['lat']
lon_center = result['results'][0]['position']['lon']
print(lat_center, lon_center)

52.36425 4.88628


### Draw the Map with One-person Households, Total Households, and Population Density.¶

In [27]:
TomTom_map = init_map(latitude=lat_center, longitude=lon_center, zoom=14, layer = "basic")

# add markers that represent one-person households to the map
for lat, lon, neighborhood, oph in zip(df['Lat'], df['Lon'], df['Neighborhood'], df['One-person Households']):
label = '{}'.format(neighborhood)
label = folium.Popup(label, parse_html=True)
folium.Circle(
[lat, lon],
popup=label,
color='#FF7F0F', # Orange
fill=True,
fill_color='#FF7F0F',
fill_opacity=0.3

# add markers that represent total households to the map
for lat, lon, neighborhood, households in zip(df['Lat'], df['Lon'], df['Neighborhood'], df['Total Households']):
label = '{}'.format(neighborhood)
label = folium.Popup(label, parse_html=True)
folium.Circle(
[lat, lon],
popup=label,
color='#1E77B4', # Blue
fill=False

# add markers that represent population density to the map
for lat, lon, neighborhood, density in zip(df['Lat'], df['Lon'], df['Neighborhood'], df['Population Density']):
label = '{}'.format(neighborhood)
label = folium.Popup(label, parse_html=True)
folium.Circle(
[lat, lon],
popup=label,
color='#2A9E2A', # Green
fill=False
TomTom_map.save('02_demographic.html')
TomTom_map

Out[27]:

### Learnings from the above data visualization¶

As you can see, when choosing an ideal location to open the Chinese restaurant:

• The bigger the green circles the better.
• The less difference between the size of the blue circles and the orange circles the better.

## 3.5 Conclusion and Next Step¶

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.

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.

# 4. Explore the surroundings¶

(Add description of TomTom Search API)

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:

• How many Chinese restaurants are already available in each neighborhood?

## 4.1. How many Chinese restaurants are already available in each neighborhood?¶

Use the Search API explorer to get the url. I choose to store all search results in a JSON file.

Some key variables:

• Maximum number of search results: limit
In [14]:
search_radius = 3000
search_limit = 2000

In [15]:
url = ('https://api.tomtom.com/search/2/categorySearch/Chinese restaurant.json?countrySet=NL'
result = requests.get(url).json()
#result


### One of the search results in the JSON file.¶

In [16]:
{'type': 'POI',
'id': 'NL/POI/p0/109857',
'score': 5.14904,
'dist': 150.32529954911772,
'info': 'search:ta:528009005857203-NL',
'poi': {'name': 'Taste Of Culture',
'phone': '+(31)-(20)-4271136',
'categorySet': [{'id': 7315012}],
'url': 'www.tasteofculture.net',
'categories': ['chinese', 'restaurant'],
'classifications': [{'code': 'RESTAURANT',
'names': [{'nameLocale': 'en-US', 'name': 'chinese'},
{'nameLocale': 'en-US', 'name': 'restaurant'}]}]},
'municipalitySubdivision': 'Amsterdam',
'municipality': 'Amsterdam',
'countrySubdivision': 'North Holland',
'postalCode': '1017',
'extendedPostalCode': '1017PZ',
'countryCode': 'NL',
'country': 'Netherlands',
'countryCodeISO3': 'NLD',
'localName': 'Amsterdam'},
'position': {'lat': 52.36311, 'lon': 4.88509},
'viewport': {'topLeftPoint': {'lat': 52.36401, 'lon': 4.88362},
'btmRightPoint': {'lat': 52.36221, 'lon': 4.88656}},
'entryPoints': [{'type': 'main',
'position': {'lat': 52.36305, 'lon': 4.885}}]},

Out[16]:
({'type': 'POI',
'id': 'NL/POI/p0/109857',
'score': 5.14904,
'dist': 150.32529954911772,
'info': 'search:ta:528009005857203-NL',
'poi': {'name': 'Taste Of Culture',
'phone': '+(31)-(20)-4271136',
'categorySet': [{'id': 7315012}],
'url': 'www.tasteofculture.net',
'categories': ['chinese', 'restaurant'],
'classifications': [{'code': 'RESTAURANT',
'names': [{'nameLocale': 'en-US', 'name': 'chinese'},
{'nameLocale': 'en-US', 'name': 'restaurant'}]}]},
'municipalitySubdivision': 'Amsterdam',
'municipality': 'Amsterdam',
'countrySubdivision': 'North Holland',
'postalCode': '1017',
'extendedPostalCode': '1017PZ',
'countryCode': 'NL',
'country': 'Netherlands',
'countryCodeISO3': 'NLD',
'localName': 'Amsterdam'},
'position': {'lat': 52.36311, 'lon': 4.88509},
'viewport': {'topLeftPoint': {'lat': 52.36401, 'lon': 4.88362},
'btmRightPoint': {'lat': 52.36221, 'lon': 4.88656}},
'entryPoints': [{'type': 'main',
'position': {'lat': 52.36305, 'lon': 4.885}}]},)

I can learn from the above JSON file that the following information is essential to show Chinese Restaurants on the map:

• Get lat lon from:'position': {'lat': 52.36311, 'lon': 4.88509},
• Get name from: 'poi': {'name': 'Taste Of Culture',

## 4.2. Show Chinese restaurants on the map¶

Use the position and name information extracted from the JSON file to show POIs on the map.

In [17]:
# add a grey circle to represent the search radius
folium.Circle(
[lat_center, lon_center],
color='#004B7F', # Navy
opacity=0.3,
fill = False

# Add POIs one by one to the map
for poi in result['results']:
folium.Marker(location=tuple(poi['position'].values()),
popup=str(poi['poi']['name']),
icon=folium.Icon(color='blue', icon='glyphicon-star')
#icon=icon
TomTom_map.save('03_ChineseRestaurants.html')
TomTom_map

Out[17]:

#### Legends of the above map¶

1. Blue markers: Chinese restaurants.
2. Orange circles: the number of one-person households.
3. Blue circles: the number of households in total.
4. Green circles: the population density.
5. Grey circle: the search radius.

## 4.3. Cluster the POIs¶

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.

In [18]:
from folium.plugins import MarkerCluster

In [19]:
#------IMPORTANT: Reinitiate the TomTom_map, so that the POI pins won't remain in the map--------
TomTom_map = init_map(latitude=lat_center, longitude=lon_center, zoom=14, layer = "basic")

# add markers that represent one-person households to the map
for lat, lon, neighborhood, oph in zip(df['Lat'], df['Lon'], df['Neighborhood'], df['One-person Households']):
label = '{}'.format(neighborhood)
label = folium.Popup(label, parse_html=True)
folium.Circle(
[lat, lon],
popup=label,
color='#FF7F0F', # Orange
fill=True,
fill_color='#FF7F0F',
fill_opacity=0.3

# add markers that represent total households to the map
for lat, lon, neighborhood, households in zip(df['Lat'], df['Lon'], df['Neighborhood'], df['Total Households']):
label = '{}'.format(neighborhood)
label = folium.Popup(label, parse_html=True)
folium.Circle(
[lat, lon],
popup=label,
color='#1E77B4', # Blue
fill=False

# add markers that represent population density to the map
for lat, lon, neighborhood, density in zip(df['Lat'], df['Lon'], df['Neighborhood'], df['Population Density']):
label = '{}'.format(neighborhood)
label = folium.Popup(label, parse_html=True)
folium.Circle(
[lat, lon],
popup=label,
color='#2A9E2A', # Green
fill=False

#----------------END of the reinitiation of TomTom_map------------

#--------------Show POIs in Clusters rather than POI pins on the map------------

# Define the marker cluster
mc = MarkerCluster()

folium.Circle(
[lat_center, lon_center],
color='#004B7F', # Navy
opacity=0.3,
fill = False

# Add POIs one by one to the map
for poi in result['results']:
folium.Marker(
location=tuple(poi['position'].values()),
popup=str(poi['poi']['name'])
))

TomTom_map.save('04_POI_Clustered.html')
TomTom_map

Out[19]:

Zoom in and out the map to observe how the clusters react.

### Key Takeaways¶

Now that I have investigated options for Linda through multiple filters and criteria, I can conclude:

• There must be at least one existing Chinese restaurant in or near the neighborhood.
If there isn’t at least one Chinese restaurant, it might mean that there is not enough demand.
Opening a Chinese restaurant without understanding why there are no any could be a risk for Linda.
• There cannot be more than 10 existing Chinese restaurants in the neighborhood, in order to mitigate competition for her.
Linda wants to stand out!!

If I apply the criteria, from the above map, I can exclude these neighborhoods:

• Too many existing Chinese restaurants
• Nieuwmarkt
• No existing Chinese restaurant in or near the neighborhood
• Weesperzijde
• Frederik Hendrikbuurt
• Grachtengordel-West
• Nieuwe Pijp

### The remaining neighborhoods left for Linda to choose from:¶

• Jordaan
• Van Lennepbuurt
• Oude Pijp
• Kinkerbuurt
• Helmersbuurt

# 5. In-depth analysis of one neighborhood¶

Let's use Jordaan as an example to show how I look into one particular candidate neighborhood.

## 5.1. Draw the area of the neighborhood on the map¶

In [20]:
area_name = 'Jordaan'


Define a function to get polygon of a given GeoID.

In [21]:
# get polygon of GeoID:
def getPolygon(api_key,GeoID,zoomLevel):

url += '&geometriesZoom=' + str(zoomLevel)
url += '&key=' + api_key

result = requests.get(url).json()

return GeoJson

In [22]:
# Search City:
GeoID, position = SearchCity(api_key, area_name ,'Amsterdam')

In [23]:
lat_area = position['lat']
lon_area = position['lon']
print("The center of the neighborhood is: (", lat_area, ", ", lon_area, ")")

The center of the neighborhood is: ( 52.37329 ,  4.87992 )


### Create a polygon and add it to the map¶

In [24]:
# Get Polygon of city:
Polygon = getPolygon(api_key,GeoID,22)

map_url = 'http://{s}.api.tomtom.com/map/1/tile/basic/main/{z}/{x}/{y}.png?view=Unified&key=' + api_key

TomTom_map = folium.Map(
location=[lat_area, lon_area],
zoom_start=14,
tiles= map_url,
attr='TomTom')

# add polygons to a map
folium.GeoJson(

TomTom_map.save('05_Area.html')
TomTom_map

Out[24]:

## 5.2. Show Chinese restaurants in the neighborhood¶

### Search for the Chinese restaurant using the search API¶

Set the search radius to 1.2 km to cover the entire neighborhood.

In [25]:
url = ('https://api.tomtom.com/search/2/categorySearch/Chinese restaurant.json?countrySet=NL'
result = requests.get(url).json()
#result

In [26]:
# add a grey circle to represent the search radius
folium.Circle(
[lat_area, lon_area],
color='#004B7F', # Navy
opacity=0.3,
fill = False

# Add POIs one by one to the map
for poi in result['results']:
folium.Marker(location=tuple(poi['position'].values()),
popup=str(poi['poi']['name']),
icon=folium.Icon(color='blue', icon='glyphicon-star')
#icon=icon
TomTom_map.save('06_Area_POI.html')
TomTom_map

Out[26]:

#### Legends of the above map¶

1. Blue markers: Chinese restaurants.
2. Blue area: The shape of the neighborhood
3. Grey circle: the search radius.

### Takeaways from this map¶

1. According to TomTom Maps API, there are more than 20 Chinese Restaurants within the range of 500 meters of the neighborhood Jordaan.
2. From 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.

## 5.3. Repeat!¶

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.

# 6. Conclusion and future work¶

## The limitation of this project¶

### Only focus on residential information¶

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.

### Rent of a venue is not taken into consideration¶

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.

### Explore more POI categories¶

There are other facilities in the neighborhood which may influence the income of the restaurant. For instance:

• How easy is it to reach the place via public transportation?
Search for nearby bus stops, tram stations, train stations, etc.
• How easy is it to park your car in the neighborhood?
Search for nearby parking garages or open parking places.

## Next steps for Linda¶

• Continue to perform the same in-depth analysis to all neighborhoods as I did in In-depth analysis of one neighborhood.
• Include rental price of each neighborhood in future analysis to be informed about her costs to profit ratio.