Query data by station

[goofballLogic]

It should be possible to query the data for a given station. Rather than searching through days of data.

[goofballLogic]

Also allow querying by a "group" of stations - requested by @JoeEarly

[goofballLogic]

@JoeEarly example getStationData API:

await client.getStationData( "waterlevel.ie", "Blackcastle_0000007037" );

{
   "station": {
      "id": "0000007037",
      "name": "Blackcastle"
   },
   "coordinates": [
      -6.680585999999992,
      53.65469699999999
   ],
   "sensors": {
      "0001": {
         "2019-07-03T14:15:00.000Z": {
            "value": 0.381,
            "extractionId": "waterlevel.ie-1562163597213"
         }
      },
      "OD": {
         "2019-07-03T14:15:00.000Z": {
            "value": 31.589,
            "extractionId": "waterlevel.ie-1562163597213"
         }
      },
      "0002": {
         "2019-07-03T14:00:00.000Z": {
            "value": 12.1,
            "extractionId": "waterlevel.ie-1562163597213"
         }
      },
      "0003": {
         "2019-07-03T14:00:00.000Z": {
            "value": 11.96,
            "extractionId": "waterlevel.ie-1562163597213"
         }
      }
   }
}

Note that if there's more than one date's data collected per sensor, you need to find the latest one. Maybe that's something we should add in as an option?

[goofballLogic]

I've also updated the promise-based sample library:

var client = require( "waterlevels.client" ).default( process );

client.listProviders().then( function( providers ) {

    console.log( "Providers:" );
    console.log( providers );

} ).then( function() {

    return client.listDays( "waterlevel.ie" )

} ).then( function( days ) {

    console.log( "Data days for waterlevel.ie" );
    console.log( days );

} ).then( function() {

    return client.getDayData( "waterlevel.ie", "2012-07-31" );

} ).then( function( data ) {

    console.log( "Data for waterlevel.ie on 31st of July 2012" );
    console.log( data );

} ).then( function() {

    return client.listStations( "waterlevel.ie" );

} ).then( function( stations ) {

    console.log( "Stations for waterlevel.ie" );
    console.log( stations.slice( 0, 10 ) );
    console.log( "... first 10 of", stations.length );

} ).then( function() {

    return client.getStationData( "waterlevel.ie", "Dangan_0000030098" );

} ).then( function( data ) {

    console.log( "Data for waterlevel.ie: Dangan station" );
    console.dir( data, { depth: 4 } );

} ).then( function() {

    var stationGroup = [ "Aasleagh_Bridge_0000032060", "Abington_0000025003", "Aghoo_0000036028" ];
    return client.getStationGroupData( "waterlevel.ie", stationGroup );

} ).then( function( data ) {

    console.log( "Data for waterlevel.ie: Aaslegh Bridge, Abington and Aghoo stations" );
    console.dir( data, { depth: 4 } );

} );

[goofballLogic]

Sample output:

Andrews-MacBook-Pro-2:waterlevels.client.samples andrewgibson$ node index
Providers:
[ 'waterlevel.ie' ]
Data days for waterlevel.ie
[
  '2012-07-31', '2013-01-02', '2014-10-11',
  '2015-06-24', '2015-08-21', '2015-09-16',
  '2015-12-07', '2016-01-12', '2016-01-25',
  '2016-02-05', '2016-03-09', '2016-03-15',
  '2016-10-14', '2017-04-20', '2017-05-30',
  '2017-06-27', '2017-10-10', '2017-11-07',
  '2017-11-29', '2018-03-22', '2018-05-03',
  '2018-08-17', '2018-09-04', '2018-10-09',
  '2018-11-06', '2018-12-05', '2019-02-14',
  '2019-02-19', '2019-03-07', '2019-06-19',
  '2019-07-01', '2019-07-02', '2019-07-03'
]
Data for waterlevel.ie on 31st of July 2012
[
  {
    id: '/0000030098/1340/16',
    station: { id: '0000030098', name: 'Dangan' },
    date: '2012-07-31T14:00:00.000Z',
    sensor: '1340',
    coordinates: [ -9.075881576541427, 53.29594626430898 ],
    value: 0,
    extractionId: 'waterlevel.ie-1562163597213'
  },
  {
    id: '/0000030098/1350/17',
    station: { id: '0000030098', name: 'Dangan' },
    date: '2012-07-31T14:00:00.000Z',
    sensor: '1350',
    coordinates: [ -9.075881576541427, 53.29594626430898 ],
    value: 0,
    extractionId: 'waterlevel.ie-1562163597213'
  },
  {
    id: '/0000030098/1380/13',
    station: { id: '0000030098', name: 'Dangan' },
    date: '2012-07-31T14:00:00.000Z',
    sensor: '1380',
    coordinates: [ -9.075881576541427, 53.29594626430898 ],
    value: 0,
    extractionId: 'waterlevel.ie-1562163597213'
  },
  {
    id: '/0000030098/1330/15',
    station: { id: '0000030098', name: 'Dangan' },
    date: '2012-07-31T14:00:00.000Z',
    sensor: '1330',
    coordinates: [ -9.075881576541427, 53.29594626430898 ],
    value: 0,
    extractionId: 'waterlevel.ie-1562163597213'
  },
  {
    id: '/0000030098/1370/18',
    station: { id: '0000030098', name: 'Dangan' },
    date: '2012-07-31T14:00:00.000Z',
    sensor: '1370',
    coordinates: [ -9.075881576541427, 53.29594626430898 ],
    value: 0,
    extractionId: 'waterlevel.ie-1562163597213'
  }
]
Stations for waterlevel.ie
[
  'Aasleagh_Bridge_0000032060',
  'Abington_0000025003',
  'Aclint_0000006026',
  'Adare_Manor_0000024009',
  'Adare_Quay_0000024062',
  'Adelphi_Quay_0000016160',
  'Aggard_Bridge_0000029010',
  'Aghacashlaun_0000036022',
  'Aghawoney_0000039009',
  'Aghoo_0000036028'
]
... first 10 of 408
Data for waterlevel.ie: Dangan station
{
  station: { id: '0000030098', name: 'Dangan' },
  coordinates: [ -9.075881576541427, 53.29594626430898 ],
  sensors: {
    '1300': {
      '2016-03-15T17:15:00.000Z': { value: 8.92, extractionId: 'waterlevel.ie-1562163597213' }
    },
    '1320': {
      '2016-03-15T17:15:00.000Z': { value: 0.323, extractionId: 'waterlevel.ie-1562163597213' }
    },
    '1330': {
      '2012-07-31T14:00:00.000Z': { value: 0, extractionId: 'waterlevel.ie-1562163597213' }
    },
    '1340': {
      '2012-07-31T14:00:00.000Z': { value: 0, extractionId: 'waterlevel.ie-1562163597213' }
    },
    '1350': {
      '2012-07-31T14:00:00.000Z': { value: 0, extractionId: 'waterlevel.ie-1562163597213' }
    },
    '1370': {
      '2012-07-31T14:00:00.000Z': { value: 0, extractionId: 'waterlevel.ie-1562163597213' }
    },
    '1380': {
      '2012-07-31T14:00:00.000Z': { value: 0, extractionId: 'waterlevel.ie-1562163597213' }
    },
    '0002': {
      '2019-07-03T14:00:00.000Z': { value: 17.4, extractionId: 'waterlevel.ie-1562163597213' }
    },
    '0003': {
      '2019-07-03T14:00:00.000Z': { value: 13.54, extractionId: 'waterlevel.ie-1562163597213' }
    },
    '0001': {
      '2019-07-03T14:00:00.000Z': { value: 0.188, extractionId: 'waterlevel.ie-1562163597213' }
    },
    OD: {
      '2019-07-03T14:00:00.000Z': { value: 8.548, extractionId: 'waterlevel.ie-1562163597213' }
    }
  }
}
Data for waterlevel.ie: Aaslegh Bridge, Abington and Aghoo stations
{
  Aasleagh_Bridge_0000032060: {
    station: { id: '0000032060', name: 'Aasleagh Bridge' },
    coordinates: [ -9.671157000000001, 53.617748999999975 ],
    sensors: {
      '0001': {
        '2019-07-03T14:15:00.000Z': { value: 0.616, extractionId: 'waterlevel.ie-1562163597213' }
      },
      OD: {
        '2019-07-03T14:15:00.000Z': { value: 4.116, extractionId: 'waterlevel.ie-1562163597213' }
      },
      '0002': {
        '2019-07-03T14:00:00.000Z': { value: 17, extractionId: 'waterlevel.ie-1562163597213' }
      },
      '0003': {
        '2019-07-03T14:00:00.000Z': { value: 13.95, extractionId: 'waterlevel.ie-1562163597213' }
      }
    }
  },
  Abington_0000025003: {
    station: { id: '0000025003', name: 'Abington' },
    coordinates: [ -8.421221000000003, 52.63186799999999 ],
    sensors: {
      '0001': {
        '2019-07-03T14:00:00.000Z': { value: 0.104, extractionId: 'waterlevel.ie-1562163597213' }
      },
      OD: {
        '2019-07-03T14:00:00.000Z': { value: 37.245, extractionId: 'waterlevel.ie-1562163597213' }
      },
      '0002': {
        '2019-07-03T14:00:00.000Z': { value: 17.7, extractionId: 'waterlevel.ie-1562163597213' }
      },
      '0003': {
        '2019-07-03T14:00:00.000Z': { value: 13.89, extractionId: 'waterlevel.ie-1562163597213' }
      }
    }
  },
  Aghoo_0000036028: {
    station: { id: '0000036028', name: 'Aghoo' },
    coordinates: [ -7.797111856483426, 54.02839547086986 ],
    sensors: {
      '0001': {
        '2019-07-03T14:00:00.000Z': { value: 0.732, extractionId: 'waterlevel.ie-1562163597213' }
      },
      OD: {
        '2019-07-03T14:00:00.000Z': { value: 54.452, extractionId: 'waterlevel.ie-1562163597213' }
      },
      '0002': {
        '2019-07-03T14:00:00.000Z': { value: 11.4, extractionId: 'waterlevel.ie-1562163597213' }
      },
      '0003': {
        '2019-07-03T14:00:00.000Z': { value: 14.02, extractionId: 'waterlevel.ie-1562163597213' }
      }
    }
  }
}