spatialaddressbook

Your address book on a map! This web app lets a user visualise the locations of their addressbook contacts.

Technologies

• NodeJS
• Express web framework
• Pug templating engine
• MongoDB database (with mongoose object modelling)
• Leaflet mapping library

Installation

Pre-requisites

You need to connect to a database called test that contains a MongoDB collection addresscollection, with some sample data documents. These follow the GeoJSON standard and as a minimum, need to contain the following properties:

• firstname
• lastname
• category
• contact_details

Please refer to the JsonSchema variable in /routes/index.js for more details on the document structure.

How to run

In your terminal, clone the repo and install npm dependencies:

  ... $ git clone git@github.com:globalavocado/spatialaddressbook.git
  ... $ cd spatialaddressbook
  ... $ npm install

open another terminal tab to start MongoDB in any directory:

  ... $ mongod

go back to your spatialaddressbook directory and start the node server in development mode:

  ... $ npm run dev

then open a browser at http://localhost:3000

Project status

done

• retrieve address points from the database and display on map
• layer switcher to filter address points by category (colleague or friend)
• hover over an address point to show first name of the addressbook contact as tooltip
• click anywhere on the map to return map coordinates in the console
• click on an address point for address point properties
• add address points to the database through a web form
• retrieve coordinates for data entry by clicking on the map

to do

• use ES6
• edit address points
• delete address points from the database
• import data from Thunderbird export file