Giter VIP home page Giter VIP logo

neighborhood-map-app's Introduction

My Neighborhood React App

Project Description

This app is a project made with React for the completion of the Udacity's Front-End Web Developer Nanodegree.

Instructions

Build a single page map application using React and the Google Maps API. Integrate a third-party data API and make the app accessible, responsive and usable.

How to start

  1. Clone or download the repository;

  2. Inside of the root folder, create a .env file where to store the API keys for Google Maps and Foursquare. The file has the following structure (notations between quotes must be replaced with the actual API keys):

         REACT_APP_GM_API_KEY="Google Maps API key"
         REACT_APP_FSQ_CLIENTID="Foursquare Client ID"
         REACT_APP_FSQ_CLIENTSECRET="Foursquare Client Secret"
    
  3. In the terminal, cd into the root folder, and input the command $ npm install to install the dependencies.

  4. Type $ npm start. The app will open in the browser automatically.

Project overview

This app consists in a neighborhood map that uses the Google Maps API. The map displays 10 venues listed inside of a side menu in alphabetical order. The corresponding markers are placed in the map upon loading the app.

The venues can be selected from the map, by clicking on the markers, or from the listbox. It is possible to search for venues by typing a query on the searchbar in the side menu. This will filter the places by their name, and the filtering will be reflected in both the list and the map, with both showing only the places that match the query. The "x" button on the search bar clears the input, deselects any active place/marker, and makes all the places/markers visible again.

Once a venue is selected by either clicking on a list item in the listbox, or on a marker in the map, the selection is displayed in the list, the marker animates, and an infowindow opens above it displaying some information about the venue fetched with the Foursquare API (name, address, category, icon, and total of likes), and the streetview of it.

The app is fully responsive and accessible. All the features can be used with either the mouse or the keyboard.

Desktop version

Desktop

Mobile version

Mobile Map Mobile Sidemenu

Dependencies:

neighborhood-map-app's People

Contributors

sonjya00 avatar

Watchers

 avatar

Forkers

carolunasilver

Recommend Projects

  • React photo React

    A declarative, efficient, and flexible JavaScript library for building user interfaces.

  • Vue.js photo Vue.js

    ๐Ÿ–– Vue.js is a progressive, incrementally-adoptable JavaScript framework for building UI on the web.

  • Typescript photo Typescript

    TypeScript is a superset of JavaScript that compiles to clean JavaScript output.

  • TensorFlow photo TensorFlow

    An Open Source Machine Learning Framework for Everyone

  • Django photo Django

    The Web framework for perfectionists with deadlines.

  • D3 photo D3

    Bring data to life with SVG, Canvas and HTML. ๐Ÿ“Š๐Ÿ“ˆ๐ŸŽ‰

Recommend Topics

  • javascript

    JavaScript (JS) is a lightweight interpreted programming language with first-class functions.

  • web

    Some thing interesting about web. New door for the world.

  • server

    A server is a program made to process requests and deliver data to clients.

  • Machine learning

    Machine learning is a way of modeling and interpreting data that allows a piece of software to respond intelligently.

  • Game

    Some thing interesting about game, make everyone happy.

Recommend Org

  • Facebook photo Facebook

    We are working to build community through open source technology. NB: members must have two-factor auth.

  • Microsoft photo Microsoft

    Open source projects and samples from Microsoft.

  • Google photo Google

    Google โค๏ธ Open Source for everyone.

  • D3 photo D3

    Data-Driven Documents codes.