Carnival Compass

Carnival Compass

Overview

Carnival Compass is a band location service that helps masqueraders find their band on carnival days. Carnival Compass was created by masqueraders, for masqueraders. We understand through experience the frustration of searching for your band while the precious moments of Carnival pass you by. With Carnival Compass you get more wining less finding.

Apps

android
Android
Using your Android device, Bess-fone or Me-too, head to the Google Play Store and grab Carnival Compass and always know where your band is.
iOS
iOS
Using your iOS device, head over to the Apple App Store and install the Carnival Compass app for iOS so you will know the way when it is time to play.
language
Web
Using the nearest web browser, check out the Carnival Compass Web app so you will never lose your band again.
Facebook Messenger
Have a chat with our friendly Carnival Compass bot on Facebook Messenger. Simply ask "Where is <your band name>?" and the bot will reply with its last known location, so you can find your band with FB Messenger in hand.

Social

Carnival Compass

Carnival Compass is a band location service that helps masqueraders find their band on carnival days. Carnival Compass was created by masqueraders, for masqueraders. We understand through experience the frustration of searching for your band while the precious moments of Carnival pass you by. With Carnival Compass you get more wining less finding. For more information contact us at info@carnival-compass.com or 1-868-683-9456.
How it works

Carnival bands provide Carnival Compass with their GPS location at regular intervals during the parade. Carnival Compass then makes the band locations available to masqueraders in various free forms, these forms are:

All bands are welcome

Carnival Compass is free for bands. The more bands we have the more effective the service will be. So all bands, large, medium and small are welcome. To have your band listed in the Carnival Compass service register via this form.

Carnival Compass is open

Third party developers can freely use data acquired by Carnival Compass, via the Carnival Compass API to create their own Carnival band tracking applications. This allows bands to provide their locations once and have many applications and masqueraders benefit. Eg: Carnival bands could use Carnival Compass API to add location features to their individual applications. Developers can request access to the Carnival Compass API via this form.

Carnival Compass Privacy Policy

Last modified: October 16, 2016
Finders
This section refers to privacy of users using Carnival Compass to locate bands.
  • Facebook Messenger App
    The Carnival Compass Facebook Messenger app provides the location of a Carnival band upon request.
    Collected information
    The text of the messages sent to Carnival Compass via Facebook Messenger.
    How messages are used

    Messages are used to identify the band whose location being requested. If the band is identified its location is returned in the response, if the band is not identified a response is returned indicating the type of messages that can be handled.

    The Carnival Compass Facebook Messenger app does not store any of the messages sent to it beyond the time needed to process the request. Once Carnival Compass responds to a request the requesting message is discarded.

  • iOS, Android and Web App
    The Carnival Compass Finder apps on iOS, Android and Web, report on Carnival band's location, no personally identifiable information is requested or required for Carnival Compass to operate.
Trackers

This section refers to privacy of bands that provide location data.

Location data about bands are only collected and made available during the Carnival parade. Before and after the parade no location data is collected. We will remotely disable the tracking ability within the trackers after the parade. Bands should also uninstall trackers after the parade as an extra precaution, trackers can be reinstalled when the next Carnival parade comes around.

All bands are welcome

Carnival Compass is free for bands. The more bands we have the more effective the service will be. So all bands, large, medium and small are welcome. To have your band listed in the Carnival Compass service register via this form.

Bands need to...

Carnival Compass is a service to masqueraders provided in partnershhip with bands. To make this service a reality here are the steps bands need to take:

  • Register via this form.
  • Install tracker app from the Google Play Store on GPS enabled Android device.
  • Use tracker app to customize how band is displayed on the service.
  • Place device with tracker on at least one Band truck during the parade.

That's it! If bands do the above then your masqueraders will have one less thing to be concerned about and will remember more of their great time in your band.

View other bands

As your band makes its way through the city avoid collisions with other bands by having a birds eye view of the location of other bands in the city. Adjust your route as needed to keep moving and keep masqueraders happily chipping.

The more bands that provide their location, the better it is for all, masqueraders, bands and organizers alike.

Developers Developers Developers!

Third party developers can freely use data acquired by Carnival Compass, via the Carnival Compass API to create their own Carnival band tracking applications. This allows bands to provide their locations once and have many applications and masqueraders benefit. Eg: Carnival bands could use Carnival Compass API to add location features to their individual applications. Developers can request access to the Carnival Compass API via this form.

Carnival Compass API

The Carnival Compass API is a simple REST API. It consists of two endpoints:

Endpoint Method Description
/bands GET Request information about all bands
/bands/<band_id> GET Request information about a particular band.

There are two responses the API will provide, a single band JSON object or a JSON array of band objects. Here are the fields to expect from each band object:

Field Description
id The ID of the band, this can be used to retrieve a single band with the /bands/band_id endpoint.
address The address of the band based on the current lat, lng values.
name Name of the band.
tagline The tagline used by the band this year, this is generally the portiral of the band.
lat Latest latitued of the band.
lng Latest longitude of the band.
photo_url The URL that can be used to retrieve the band's image/artwork.
last_updated Milliseconds since the ephoc that the band submitted its location.
website URL to band's website.
cache-control

Each response from the Carnival Compass API includes a cache-control header. cache-control is defined in seconds. This header will define the amount of time that the returned data can be considered fresh. After the cache-control period has passed a new request should be made to retrieve fresh band data.

Developers should avoid making requests before the cache-control period has passed since it will likely return the same data as that of the previous request.

Examples

/bands
HTTP
Request:
GET /bands HTTP/1.1
Host: carnival-compass.appspot.com
Authorization: <YOUR-API-KEY>
Response:
[
  {
    "id": "band1",
    "address": "Queen's Park Savannah Grand Stand",
    "name": "Paparazzi",
    "tagline": "Sky Gazers",
    "lat": 10.665722,
    "lng": -61.512963,
    "photo_url": "https://firebasestorage.googleapis.com/v0/b/carnival-compass.appspot.com/o/band1%2FbandImage.jpg?alt=media&token=dc63ed05-7b97-4c0c-bd75-e098b357907e",
    "last_updated": 1479428614028,
    "website": "http://paparazzicarnival.com"
  },
  {
    "id": "band2",
    "address": "18 Rosalino Street Woodbrook",
    "name": "Bliss",
    "tagline": "al-sahra The Great Desert",
    "lat": 10.6610163,
    "lng": -61.5270716,
    "photo_url": "https://firebasestorage.googleapis.com/v0/b/carnival-compass.appspot.com/o/band2%2FbandImage.jpg?alt=media&token=4c800c6d-465e-4031-931e-85e63b0c4965",
    "last_updated": 1479428614028,
    "website": "http://2017.blisscarnival.com/"
  }
]
              
JavaScript
var data = null;

var xhr = new XMLHttpRequest();
xhr.withCredentials = true;

xhr.addEventListener("readystatechange", function () {
  if (this.readyState === 4) {
    console.log(this.responseText);
  }
});

xhr.open("GET", "https://carnival-compass.appspot.com/bands");
xhr.setRequestHeader("authorization", "YOUR-API-KEY");

xhr.send(data);
              
/bands/<band_id>
HTTP
Request:
GET /bands/band1 HTTP/1.1
Host: carnival-compass.appspot.com
Authorization: <YOUR-API-KEY>
              
Response:
{
  "id": "band1",
  "address": "Queen's Park Savannah Grand Stand",
  "name": "Paparazzi",
  "tagline": "Sky Gazers",
  "lat": 10.665722,
  "lng": -61.512963,
  "photo_url": "https://firebasestorage.googleapis.com/v0/b/carnival-compass.appspot.com/o/band1%2FbandImage.jpg?alt=media&token=dc63ed05-7b97-4c0c-bd75-e098b357907e",
  "last_updated": 1479428614028,
  "website": "http://paparazzicarnival.com"
}
              
JavaScript
var data = null;

var xhr = new XMLHttpRequest();
xhr.withCredentials = true;

xhr.addEventListener("readystatechange", function () {
  if (this.readyState === 4) {
    console.log(this.responseText);
  }
});

xhr.open("GET", "https://carnival-compass.appspot.com/bands/band1");
xhr.setRequestHeader("authorization", "YOUR-API-KEY");

xhr.send(data);
              

Carnival Compass FAQ

  • Why build Carnival Compass?

    Carnival Compass was built because we (masqueraders) were tired of not being able to easily find our band when separated. We hope Carnival Compass can remove this headache from the carnival experience.

  • How does Carnival Compass make money?

    It does not. Carnival Compass is a service that is built by masqueraders for masqueraders. The ability to confidently find a band is huge and that is our initial focus.

  • How much does Carnival Compass cost?

    Carnival Compass is free to all. Free to bands, third party developers and most importantly free to masqueraders.