meta data for this page
  •  

Differences

This shows you the differences between two versions of the page.

Link to this comparison view

Both sides previous revision Previous revision
Next revision 		Previous revision
opendata2015:group3:start [2015/03/05 19:37]
niklas [Features (with screen captures!)] 		opendata2015:group3:start [2015/03/17 11:08] (current)
dimitar [Project Source Code Presentation and Report]
Line 4: Line 4:
  
 ===== Group members ===== ===== Group members =====
-  * Ashraf Abdo (Abdomen) +  * Ashraf Abdo 
-  * Dimitar "Polarbear" Minovski +  * Dimitar Minovski 
-  * Niklas Kolbe, the wise man+  * Niklas Kolbe
  
 ===== Idea and Motivation ===== ===== Idea and Motivation =====
Line 13: Line 13:
 With the help of this data, the city, municipality or region could maintain and provide biking routes that correspond to the demand and enhance services on busy routes. Also analysis in terms of traffic (e.g. traffic lights) could consider the cycling data. With the help of this data, the city, municipality or region could maintain and provide biking routes that correspond to the demand and enhance services on busy routes. Also analysis in terms of traffic (e.g. traffic lights) could consider the cycling data.
  
-The user just needs to run a mobile application while he is biking to track the route. The routes will then be sent to the server. The anonymously gathered data will be accessible via an open REST API.+The user just needs to run a mobile application while he is biking to track the route. The tracked routes will then be sent to the server. The anonymously gathered data will be accessible via an open REST API.
  
 ===== Concept ===== ===== Concept =====
Line 44: Line 44:
  
  
-{{ :opendata2015:group3:webservice.png?300|}} +=== External Webservice ===
-=== "External" Webservice ===+
 To demonstrate what could be done with the data we implemented an example service which accesses the Open Bicycling Data: To demonstrate what could be done with the data we implemented an example service which accesses the Open Bicycling Data:
  
Line 74: Line 73:
   * Google Maps API   * Google Maps API
  
-===== RESTful Open Cycling Data API Documentation =====+===== RESTful Open Cycling Data API ===== 
 +=== Documentation ===
  
 The complete Open Cycling Data API Documentation is available in .json and .yaml format: The complete Open Cycling Data API Documentation is available in .json and .yaml format:
Line 80: Line 80:
  
 A short summary:  A short summary: 
-The API is available at https://lutcodecamp-niklaskolbe.c9.io/biketracks/{datarequest}/{country}/{region}?{parameters}+The API can be accessed via https://lutcodecamp-niklaskolbe.c9.io/biketracks/{datarequest}/{country}/{region}?{parameters}
   * datarequest = all|geojson|coordinates. Defines the respond format. Available: all the date, GEOJSON format or just coordinates.    * datarequest = all|geojson|coordinates. Defines the respond format. Available: all the date, GEOJSON format or just coordinates. 
   * country = the country name or country code (e.g. finland or fi)   * country = the country name or country code (e.g. finland or fi)
Line 89: Line 89:
   * day   * day
   * limit (to limit respond to x datasets)   * limit (to limit respond to x datasets)
-===== Your project folder compressed and uploaded to the wiki OR a public link to your Git or Mercurial repository ===== 
  
 +=== Example Requests ===
 +Request: https://lutcodecamp-niklaskolbe.c9.io/biketracks/all/finland/lappeenranta?year=2015&month=3&day=5&limit=100
 +
 +Example response: 
 +  [
 +    {
 +      "_id":"54f873dd8a87341d583aa4d2",
 +      "country":"finland",
 +      "country_code":"fi",
 +      "administrative_area_level_1":"",
 +      "administrative_area_level_2":"lappeenranta",
 +      "locality":"",
 +      "postal_code":"53850",
 +      "__v":0,
 +      "timestamps":[
 +         "2015-03-05T15:17:10.487Z",
 +         "2015-03-05T15:17:18.831Z",
 +         "2015-03-05T15:17:30.220Z"
 +      ],
 +      "coordinates":[
 +         {
 +            "latitude":61.04799,
 +            "longitude":28.08706,
 +            "_id":"54f873dd8a87341d583aa4d5"
 +         },
 +         {
 +            "latitude":61.04657,
 +            "longitude":28.09506,
 +            "_id":"54f873dd8a87341d583aa4d4"
 +         },
 +         {
 +            "latitude":61.04767,
 +            "longitude":28.09706,
 +            "_id":"54f873dd8a87341d583aa4d3"
 +         }
 +      ]
 +    }
 +  ]
 +
 +Request: https://lutcodecamp-niklaskolbe.c9.io/biketracks/geojson/finland?year=2015&month=3
 +
 +Example response:
 +  {
 +   "type":"FeatureCollection",
 +   "features":[
 +      {
 +         "type":"Feature",
 +         "geometry":{
 +            "type":"LineString",
 +            "coordinates":[
 +               [
 +                  61.04767,
 +                  28.09706
 +               ],
 +               [
 +                  61.04767,
 +                  28.09706
 +               ],
 +               [
 +                  61.04767,
 +                  28.09706
 +               ]
 +            ]
 +         }
 +      }
 +    ]
 +  }
 +
 +Request: https://lutcodecamp-niklaskolbe.c9.io/biketracks/coordinates/finland/lappeenranta?year=2015
 +
 +Example respond:
 +  [
 +   [
 +      61.06173,
 +      28.10345
 +   ],
 +   [
 +      61.05953,
 +      28.10354
 +   ],
 +   [
 +      61.05568,
 +      28.10794
 +   ]
 +  ]
 +
 +===== "External" Webservice =====
 +
 +The "external" webservice is accessible via http://lutcodecamp-niklaskolbe.c9.io/{country}/{region}
 +
 +The web service accesses the Open Cycling Data API and creates a google heat map.
 +
 +By specifying a country and/or a region the map will be centered and the data filtered accordingly. As for the API, the website accepts the optional parameters year, month and day and also filters the data accordingly.
 +
 +{{ :opendata2015:group3:webservice2.png?600 |}}
 +
 +===== Project Source Code Presentation and Report =====
 +
 +Presentation: http://bit.ly/OpenCyclingData
 +
 +Report: {{:opendata2015:group3:codecampreport.pdf|}}
 +
 +Poster: {{:opendata2015:group3:raritan_poster.pdf|}}
 +
 +Source code API + webservice: {{:opendata2015:group3:opencyclingdata_heatmap.zip|}}
  
 +Source code mobile application: {{:opendata2015:group3:gpstracker-master.7z|}}