Dine the Distance

About Me

Hi! My name is Anita, and I'm currently a junior studying Computer Science at the University of Illinois at Chicago. When I'm not doing school work, my favorite hobbies include biking, cooking, and painting (I've been doing a lot of online paint alongs during lockdown).

​ I'm a HUGE foodie. One of my favorite social activities has always been going out to eat with friends. I thoroughly miss in-person classes in Chicago because it gave me an excuse to try out new places for takeout nearly every week. If you're ever in the city, I 10/10 recommend heading to Brightwok Kitchen!

Choosing a place to eat has always been a struggle of mine, and there are a couple factors I always take into account:

1. Convenience – I have never been one to take a road trip just for the sake of getting some food.
2. Cuisine – I crave Sushi way more often than I would like to admit.

That's pretty much it. I'm generally not that picky 😊

What's Dine the Distance? 🚗

​ Dine the Distance is a web application that takes the zip location locations between two points (you and a friend), a restaurant cuisine, and delivers restaurant recommendations at a neutral midpoint location. Each restaurant recommendation is requested from the Azure Maps API and includes a link to the location’s website, menu, phone number, and address. Dine the Distance provides food locations that are convenient whilst filtering results by cuisine preferences. It was created to help avoid situations where you and your friends cannot decide on a place to meet up and grab some food.

Now we'll go into the steps I took to build this project the necessary details to replicate it in the future:

Creating the Azure Function App 💻

1. Navigate to the Azure Portal and create a Function App Resource that uses a Node.js runtime stack.
2. After it has deployed, add an HTTP trigger to your resource. This is where we will be providing the backend code for our application!
3. Before the function can be used, you will want to install the necessary package dependencies. Run “npm init -y” in your terminal to create a package.json file to store your dependencies. Next, install the following dependencies (npm install):
   • node-fetch
     • To make our HTTP requests
     • https://www.npmjs.com/package/node-fetch#api
   • us-zips
     • To convert user zip code input into latitude and longitude coordinates
     • https://www.npmjs.com/package/us-zips
   • geolib
     • To find the midpoint between two coordinate locations
     • https://www.npmjs.com/package/geolib

Frontend ✨

1. Create a form for user input

<form onsubmit="handle(event)" enctype="multipart/form-data">
    <div class="row">
        <div class="form-group col-md-6">
            <input type="text" name="zip1" placeholder="Zip Code 1" required>
            <input type="text" name="phone1" placeholder="Phone Number 1" required>
        </div>

        <div class="form-group col-md-6 mt-3 mt-md-0">
            <input type="text" name="zip2" placeholder="Zip Code 2" required>
            <input type="text" name="phone2" placeholder="Phone Number 2" required>
        </div>
    </div>

    <div class="text-center" style="padding-top: 30px;">
        <input type="text" name="cuisine" placeholder="Food Cuisine" required>
    </div>
    <div class="text-center"><button type="submit">Find Food!</button></div>
</form>

​ To capture the user’s location, contact information, and preferred cuisine information, you will need to create a form in an index.html file. The main elements you will definitely need in this form include:

• Two inputs for two user zip code locations
• Two inputs for two user phone numbers
• A submit button to send the form data to our HTTP trigger (called dineTrigger)

1. Send user's form data to our HTTP trigger (dineTrigger)

  var functionUrl = "/api/dineTrigger"
  const resp = await fetch (functionUrl, {
      method: 'POST',
      body:JSON.stringify({zip1, zip2, cuisine}),
      headers: {
        'Content-Type': 'application/json'
      },
  });

  var data = await resp.json();
  var newData = JSON.stringify(data.results);
  var obj = JSON.parse(newData);

​ Send an object containing the user zip code and cuisine information and await a JSON response body that can be parsed to populate the frontend with relevant restaurant information.

Backend ⚙️

HTTP Trigger 1 (dineTrigger)

Our first HTTP trigger will send our user zip code and cuisine information to Azure Maps to retrieve restaurant information.

1. Convert zip codes into coordinates and find the midpoint

   module.exports = async function (context, req) {

       var body = req.body;

       //zip code 1 -> latitude and longitude (us-zips) -> zip1Response
       //zip code 2 -> latitude and longitude (us-zips) -> zip2Response
       // midpoint lat lon (geolib) -> centerCoords 

       var zip1 = body.zip1;
       var zip2 = body.zip2;

       var zip1Response = usZips[zip1];
       var zip2Response = usZips[zip2];

       var centerCoords = geolib.getCenterOfBounds([
           { latitude: zip1Response["latitude"], longitude: zip1Response["longitude"] },
           { latitude: zip2Response["latitude"], longitude: zip2Response["longitude"] },
       ]);

       var cuisine = body.cuisine;

       var testResult = await analyzeCoords(centerCoords["latitude"], centerCoords["longitude"], cuisine);

       context.res = {
           // status: 200, /* Defaults to 200 */
           body: testResult
       };
   }

​ Before we can request restaurant data, we will need to find the midpoint between the two zip code locations entered by the user. This is where the us-zips and geolib node packages come in handy! First, convert the user zip code locations into JSON objects with their respective latitude/longitude coordinates using the usZips function. Next, we will use these coordinates to find the midpoint via geolib.getCenterOfBounds. Lastly, pass in the center latitude, center longitude, and preferred user cuisine into another function (analyzeCoords) to send this data to the Azure Maps API.

1. Request Restaurant Data

   async function analyzeCoords(latitude, longitude, cuisine){ 

       const subscriptionKey = process.env['map-key']; 
       const uriBase = 'https://atlas.microsoft.com' + '/search/fuzzy/json';

       let params = new URLSearchParams({
           'api-version': '1.0',
           'query': cuisine + ' ' + 'restaurant',
           'subscription-key': subscriptionKey,
           'lat': latitude,
           'lon': longitude,
           'limit': 10
       })


       let resp = await fetch(uriBase + '?' + params.toString(), {
           method: 'GET'
       })

       let data = await resp.json();

       return data; 
   }

​ Let us take a closer look at the analyzeCoords (latitude, longitude, cuisine) function. In this function, you will want to populate your URL search parameters and perform a GET request for your response data that we will parse through for the user to see on the frontend.

Refer to the Free Form Search API documentation to add or modify URL parameters:

https://docs.microsoft.com/en-us/rest/api/maps/search/getsearchfuzzy

HTTP Trigger 2 (msgTrigger)

Our second HTTP trigger will send users text message directions to the restaurant they select.

1. Add Twilio Bindings to your HTTP Trigger's function.json file

   {
     "type": "twilioSms",
     "name": "message",
     "accountSidSetting": "TwilioAccountSid",
     "authTokenSetting": "TwilioAuthToken",
     "from": "+1425XXXXXXX",
     "direction": "out",
     "body": "Azure Functions Testing"
   }

​ You'll need to create a Twilio Account in order to populate your Twilio resource binding with the proper accountSID, authToken, and Twilio phone number. In this project, I created two bindings in order to send a separate text to each of the two user's who will need the restaurant address.

1. Send user's restaurant choice to the HTTP trigger (msgTrigger)

   async function sendAddress(phone1, phone2, address, name){
     var functionUrl = "/api/msgTrigger";
     const resp = await fetch (functionUrl, {
       method: 'POST',
       body:JSON.stringify({phone1, phone2, address, name}),
       headers: {
         'Content-Type': 'application/json'
       },
     });
   }

​ Similar to how we sent an object containing form information to dineTrigger, we'll need to make another POST request to send an object containing the user's phone numbers and restaurant location to our new HTTP trigger.

1. Text both users the address of the restaurant they select

   module.exports = async function (context, req) {

       var body = req.body;
       var phone1 = body.phone1;
       var phone2 = body.phone2;
       var address = body.address;
       var restaurantName = body.name;

       var txtMessage = "Thanks for using Dine the Distance! Here's the address to go to " + restaurantName + ": " + address;

       //send directions

       context.bindings.message = {
           body : txtMessage,
           to: phone1 
       };
       context.bindings.message2 = {
           body : txtMessage,
           to: phone2 
       };
   }

​ Finally! It's time to send the users the address of the restaurant they plan to go to. After defining the body of the received POST request, we can formulate our message into a variable (txtMessage) and specify the body and phone numbers we want to contact in context.bindings.message.

Deploying the Static Web App 🚀

1. Create a static web app in Azure in the Azure Portal and add the workflow to the master branch of the GitHub repo you are currently working in
2. Grab a friend and try a new restaurant with Dine the Distance!

Here's a link to try out my version: https://calm-moss-0d1a6c110.azurestaticapps.net/

Additionally here's my Github repo if you want to check out my code: https://github.com/a-padman/Dine2

So what's next? 🔮

​ Dine the Distance has some room for additional features. The next course of action involves presenting each user with a distance tracker to help them visualize how far they will need to drive to each recommended restaurant.

​ Until then....with Dine the Distance, you and your friends can stop aimlessly scrolling on online for restaurants nearby and instead utilize this all-in-one functional web app next time you want to grab a bite!

Special Mentions 🤗

​ This project was created as part of the Bit Project Serverless BitCamp cohosted by Microsoft. I'd like to thank my mentor Marie Hoeger for answering all my questions and making this project a great learning experience! Additionally, thanks to Emily, Evelyn, and Julia for coordinating our cohort activities and laying out clear expectations throughout the Bit Camp.

Lastly, the name credit for this app goes out to my dear friend Divya Francis 💖