This is a very reduced set of MAP API calls specific to MAP Hyperlocal Rainfall

They allow you to return predicted rainfall along a planned Journey or for a specific point.

MAP Hyperlocal Rainfall predictions are available for any point at 5 minute increments for the next hour from NOW. These predictions are updated every 5 minutes. In the near future we will be extending these calls to include rainfall forecast data out to 36 hours at 1 hour increments

A more detailed set of MAP API calls for use with MAP IOT, MAP Rain and MAP Sewer will be available soon.

1 Access Login details

The calls below will work from a demonstration area around Huntingdon. To apply for an account to test out the calls in your own application then please send a request from our Contact Page

2 Hyperlocal Rainfall Intensity predictions for a Point

This method returns the rainfall intensity predictions for any point defined by a latitude and longitude.

This call returns the predicted rainfall intensity (mm/hr) for the next hour from NOW for any point using WGS84 latitude/longitude

The NOW time is snapped to the nearest 5 minutes. The rainfall intensity returned is timed from this snapped now time

The data returns; time, offset from NOW, location, rainfall intensity (mm/hr), units and the range used for displaying icons where the values are:

  • Rainfall Intensity mm/hr from 0 to < 0.25 mm/hr - returns a value of 0
  • Rainfall Intensity mm/hr from 0.25 to < 1 mm/hr - returns a value of 1
  • Rainfall Intensity mm/hr from 1 to < 4 mm/hr - returns a value of 2
  • Rainfall Intensity mm/hr from 4 to < 16 mm/hr - returns a value of 3
  • Rainfall Intensity mm/hr > 16 mm/hr – returns a value of 4
  • JSON
    https://innovate2.meniscus.co.uk/Map/ReadData/CalcJSON?calc=8016A408-7332-4B79-8B41-7C737E12CCB0&apiKey=adem982fGlq5&exp=ToJson(GetLocationRainfallIntensity(“Hyperlocal”,LocationWGS84(52.345793,-0.190548)))

    [{ "time" : "2018-01-03T13:00:00.0000000", "offset" : "00:00:00", "lat" : "52.34579°N", "lon" : "00.19055°W", "rainfall" : "0.00", "units" : "mm/hour", "range" : 0 }, { "time" : "2018-01-03T13:05:00.0000000", "offset" : "00:05:00", "lat" : "52.34579°N", "lon" : "00.19055°W", "rainfall" : "0.00", "units" : "mm/hour", "range" : 0 }, { "time" : "2018-01-03T13:10:00.0000000", "offset" : "00:10:00", "lat" : "52.34579°N", "lon" : "00.19055°W", "rainfall" : "0.00", "units" : "mm/hour", "range" : 0 }, { "time" : "2018-01-03T13:15:00.0000000", "offset" : "00:15:00", "lat" : "52.34579°N", "lon" : "00.19055°W", "rainfall" : "0.00", "units" : "mm/hour", "range" : 0 }, { "time" : "2018-01-03T13:20:00.0000000", "offset" : "00:20:00", "lat" : "52.34579°N", "lon" : "00.19055°W", "rainfall" : "0.00", "units" : "mm/hour", "range" : 0 }, { "time" : "2018-01-03T13:25:00.0000000", "offset" : "00:25:00", "lat" : "52.34579°N", "lon" : "00.19055°W", "rainfall" : "0.00", "units" : "mm/hour", "range" : 0 }, { "time" : "2018-01-03T13:30:00.0000000", "offset" : "00:30:00", "lat" : "52.34579°N", "lon" : "00.19055°W", "rainfall" : "0.00", "units" : "mm/hour", "range" : 0 }, { "time" : "2018-01-03T13:35:00.0000000", "offset" : "00:35:00", "lat" : "52.34579°N", "lon" : "00.19055°W", "rainfall" : "0.00", "units" : "mm/hour", "range" : 0 }, { "time" : "2018-01-03T13:40:00.0000000", "offset" : "00:40:00", "lat" : "52.34579°N", "lon" : "00.19055°W", "rainfall" : "0.00", "units" : "mm/hour", "range" : 0 }, { "time" : "2018-01-03T13:45:00.0000000", "offset" : "00:45:00", "lat" : "52.34579°N", "lon" : "00.19055°W", "rainfall" : "0.00", "units" : "mm/hour", "range" : 0 }, { "time" : "2018-01-03T13:50:00.0000000", "offset" : "00:50:00", "lat" : "52.34579°N", "lon" : "00.19055°W", "rainfall" : "0.00", "units" : "mm/hour", "range" : 0 }, { "time" : "2018-01-03T13:55:00.0000000", "offset" : "00:55:00", "lat" : "52.34579°N", "lon" : "00.19055°W", "rainfall" : "0.00", "units" : "mm/hour", "range" : 0 }, { "time" : "2018-01-03T14:00:00.0000000", "offset" : "01:00:00", "lat" : "52.34579°N", "lon" : "00.19055°W", "rainfall" : "0.00", "units" : "mm/hour", "range" : 0 }]
    

    CSV
    https://innovate2.meniscus.co.uk/Map/ReadData/CalcJSON?calc=8016A408-7332-4B79-8B41-7C737E12CCB0&apiKey=adem982fGlq5&exp=ToCSV(GetLocationRainfallIntensity(“Hyperlocal”,LocationWGS84(52.345793,-0.190548)))

    2018-01-03 13:00:00.000,00:00:00,52.34579°N,00.19055°W,0.00,mm/hour,0
    2018-01-03 13:05:00.000,00:05:00,52.34579°N,00.19055°W,0.00,mm/hour,0
    2018-01-03 13:10:00.000,00:10:00,52.34579°N,00.19055°W,0.00,mm/hour,0
    2018-01-03 13:15:00.000,00:15:00,52.34579°N,00.19055°W,0.00,mm/hour,0
    2018-01-03 13:20:00.000,00:20:00,52.34579°N,00.19055°W,0.00,mm/hour,0
    2018-01-03 13:25:00.000,00:25:00,52.34579°N,00.19055°W,0.00,mm/hour,0
    2018-01-03 13:30:00.000,00:30:00,52.34579°N,00.19055°W,0.00,mm/hour,0
    2018-01-03 13:35:00.000,00:35:00,52.34579°N,00.19055°W,0.00,mm/hour,0
    2018-01-03 13:40:00.000,00:40:00,52.34579°N,00.19055°W,0.00,mm/hour,0
    2018-01-03 13:45:00.000,00:45:00,52.34579°N,00.19055°W,0.00,mm/hour,0
    2018-01-03 13:50:00.000,00:50:00,52.34579°N,00.19055°W,0.00,mm/hour,0
    2018-01-03 13:55:00.000,00:55:00,52.34579°N,00.19055°W,0.00,mm/hour,0
    2018-01-03 14:00:00.000,01:00:00,52.34579°N,00.19055°W,0.00,mm/hour,0
    

    This call returns the predicted rainfall intensity (mm/hr) for the next hour from NOW for any point using longitude/latitude

    The NOW time is snapped to the nearest 5 minutes. The rainfall intensity returned is times from this snapped now time

    The data returns; time, offset from NOW, location, rainfall intensity (mm/hr), units and the range used for displaying icons where the values are:

  • Rainfall Intensity mm/hr from 0 to < 0.25 mm/hr - returns a value of 0
  • Rainfall Intensity mm/hr from 0.25 to < 1 mm/hr - returns a value of 1
  • Rainfall Intensity mm/hr from 1 to < 4 mm/hr - returns a value of 2
  • Rainfall Intensity mm/hr from 4 to < 16 mm/hr - returns a value of 3
  • Rainfall Intensity mm/hr > 16 mm/hr – returns a value of 4
  • JSON
    https://innovate2.meniscus.co.uk/Map/ReadData/CalcJSON?calc=8016A408-7332-4B79-8B41-7C737E12CCB0&apiKey=adem982fGlq5&exp=ToJson(GetLocationRainfallIntensity(“Hyperlocal”,Location(-0.190548,52.345793)))

    [{ "time" : "2018-01-03T13:00:00.0000000", "offset" : "00:00:00", "lat" : "52.34579°N", "lon" : "00.19055°W", "rainfall" : "0.00", "units" : "mm/hour", "range" : 0 }, { "time" : "2018-01-03T13:05:00.0000000", "offset" : "00:05:00", "lat" : "52.34579°N", "lon" : "00.19055°W", "rainfall" : "0.00", "units" : "mm/hour", "range" : 0 }, { "time" : "2018-01-03T13:10:00.0000000", "offset" : "00:10:00", "lat" : "52.34579°N", "lon" : "00.19055°W", "rainfall" : "0.00", "units" : "mm/hour", "range" : 0 }, { "time" : "2018-01-03T13:15:00.0000000", "offset" : "00:15:00", "lat" : "52.34579°N", "lon" : "00.19055°W", "rainfall" : "0.00", "units" : "mm/hour", "range" : 0 }, { "time" : "2018-01-03T13:20:00.0000000", "offset" : "00:20:00", "lat" : "52.34579°N", "lon" : "00.19055°W", "rainfall" : "0.00", "units" : "mm/hour", "range" : 0 }, { "time" : "2018-01-03T13:25:00.0000000", "offset" : "00:25:00", "lat" : "52.34579°N", "lon" : "00.19055°W", "rainfall" : "0.00", "units" : "mm/hour", "range" : 0 }, { "time" : "2018-01-03T13:30:00.0000000", "offset" : "00:30:00", "lat" : "52.34579°N", "lon" : "00.19055°W", "rainfall" : "0.00", "units" : "mm/hour", "range" : 0 }, { "time" : "2018-01-03T13:35:00.0000000", "offset" : "00:35:00", "lat" : "52.34579°N", "lon" : "00.19055°W", "rainfall" : "0.00", "units" : "mm/hour", "range" : 0 }, { "time" : "2018-01-03T13:40:00.0000000", "offset" : "00:40:00", "lat" : "52.34579°N", "lon" : "00.19055°W", "rainfall" : "0.00", "units" : "mm/hour", "range" : 0 }, { "time" : "2018-01-03T13:45:00.0000000", "offset" : "00:45:00", "lat" : "52.34579°N", "lon" : "00.19055°W", "rainfall" : "0.00", "units" : "mm/hour", "range" : 0 }, { "time" : "2018-01-03T13:50:00.0000000", "offset" : "00:50:00", "lat" : "52.34579°N", "lon" : "00.19055°W", "rainfall" : "0.00", "units" : "mm/hour", "range" : 0 }, { "time" : "2018-01-03T13:55:00.0000000", "offset" : "00:55:00", "lat" : "52.34579°N", "lon" : "00.19055°W", "rainfall" : "0.00", "units" : "mm/hour", "range" : 0 }, { "time" : "2018-01-03T14:00:00.0000000", "offset" : "01:00:00", "lat" : "52.34579°N", "lon" : "00.19055°W", "rainfall" : "0.00", "units" : "mm/hour", "range" : 0 }]
    

    CSV
    https://innovate2.meniscus.co.uk/Map/ReadData/CalcJSON?calc=8016A408-7332-4B79-8B41-7C737E12CCB0&apiKey=adem982fGlq5&exp=ToCSV(GetLocationRainfallIntensity(“Hyperlocal”,Location(-0.190548,52.345793)))

    2018-01-03 13:00:00.000,00:00:00,52.34579°N,00.19055°W,0.00,mm/hour,0
    2018-01-03 13:05:00.000,00:05:00,52.34579°N,00.19055°W,0.00,mm/hour,0
    2018-01-03 13:10:00.000,00:10:00,52.34579°N,00.19055°W,0.00,mm/hour,0
    2018-01-03 13:15:00.000,00:15:00,52.34579°N,00.19055°W,0.00,mm/hour,0
    2018-01-03 13:20:00.000,00:20:00,52.34579°N,00.19055°W,0.00,mm/hour,0
    2018-01-03 13:25:00.000,00:25:00,52.34579°N,00.19055°W,0.00,mm/hour,0
    2018-01-03 13:30:00.000,00:30:00,52.34579°N,00.19055°W,0.00,mm/hour,0
    2018-01-03 13:35:00.000,00:35:00,52.34579°N,00.19055°W,0.00,mm/hour,0
    2018-01-03 13:40:00.000,00:40:00,52.34579°N,00.19055°W,0.00,mm/hour,0
    2018-01-03 13:45:00.000,00:45:00,52.34579°N,00.19055°W,0.00,mm/hour,0
    2018-01-03 13:50:00.000,00:50:00,52.34579°N,00.19055°W,0.00,mm/hour,0
    2018-01-03 13:55:00.000,00:55:00,52.34579°N,00.19055°W,0.00,mm/hour,0
    2018-01-03 14:00:00.000,01:00:00,52.34579°N,00.19055°W,0.00,mm/hour,0
    

    3 Hyperlocal Rainfall Intensity predictions for a Journey

    These methods return rainfall intensity predictions for a Journey defined by a series of points (latitude and longitude). They also include an aggregated intensity that can be used to define a rainfall icon

    This returns the predicted rainfall along a Journey comprising 6 points (in this case). In practice the number of points on a Journey is limited only by the size of the URL you send us

    This method uses the WGS84 coordinate system and the locations are in the format latitude/longitude

    ToCSV or ToJSON method can be used to return the formatted data.

    The data returns; time, offset from NOW, location, rainfall intensity (mm/hr), units and the range used for displaying icons where the values are:

  • Rainfall Intensity mm/hr from 0 to < 0.25 mm/hr - returns a value of 0
  • Rainfall Intensity mm/hr from 0.25 to < 1 mm/hr - returns a value of 1
  • Rainfall Intensity mm/hr from 1 to < 4 mm/hr - returns a value of 2
  • Rainfall Intensity mm/hr from 4 to < 16 mm/hr - returns a value of 3
  • Rainfall Intensity mm/hr > 16 mm/hr – returns a value of 4
  • JSON
    https://innovate2.meniscus.co.uk/Map/ReadData/CalcJSON?calc=8016A408-7332-4B79-8B41-7C737E12CCB0&apiKey=adem982fGlq5&exp=ToJSON(GetJourneyRainfallIntensityFromNowWGS84(“Hyperlocal”,”Minutes(5),52.345793,-0.190548;Minutes(10),52.342879,-0.192903;Minutes(15),52.347541,-0.190995;Minutes(20),52.352803,-0.175076;Minutes(25),52.341746,-0.152109;Minutes(30),52.330943,-0.175167″))

    Returns

    [{ "time" : "2018-01-03T13:05:00.0000000", "offset" : "00:05:00", "lat" : "52.34579°N", "lon" : "00.19055°W", "rainfall" : "0.00", "units" : "mm/hour", "range" : 0 }, { "time" : "2018-01-03T13:10:00.0000000", "offset" : "00:10:00", "lat" : "52.34288°N", "lon" : "00.19290°W", "rainfall" : "0.00", "units" : "mm/hour", "range" : 0 }, { "time" : "2018-01-03T13:15:00.0000000", "offset" : "00:15:00", "lat" : "52.34754°N", "lon" : "00.19100°W", "rainfall" : "0.00", "units" : "mm/hour", "range" : 0 }, { "time" : "2018-01-03T13:20:00.0000000", "offset" : "00:20:00", "lat" : "52.35280°N", "lon" : "00.17508°W", "rainfall" : "0.00", "units" : "mm/hour", "range" : 0 }, { "time" : "2018-01-03T13:25:00.0000000", "offset" : "00:25:00", "lat" : "52.34175°N", "lon" : "00.15211°W", "rainfall" : "0.00", "units" : "mm/hour", "range" : 0 }, { "time" : "2018-01-03T13:30:00.0000000", "offset" : "00:30:00", "lat" : "52.33094°N", "lon" : "00.17517°W", "rainfall" : "0.00", "units" : "mm/hour", "range" : 0 }]
    

    CSV
    https://innovate2.meniscus.co.uk/Map/ReadData/CalcJSON?calc=8016A408-7332-4B79-8B41-7C737E12CCB0&apiKey=adem982fGlq5&exp=ToCSV(GetJourneyRainfallIntensityFromNowWGS84(“Hyperlocal”,”Minutes(5),52.345793,-0.190548;Minutes(10),52.342879,-0.192903;Minutes(15),52.347541,-0.190995;Minutes(20),52.352803,-0.175076;Minutes(25),52.341746,-0.152109;Minutes(30),52.330943,-0.175167″))

    Returns

    2018-01-03 13:05:00.000,00:05:00,52.34579°N,00.19055°W,0.00,mm/hour,0
    2018-01-03 13:10:00.000,00:10:00,52.34288°N,00.19290°W,0.00,mm/hour,0
    2018-01-03 13:15:00.000,00:15:00,52.34754°N,00.19100°W,0.00,mm/hour,0
    2018-01-03 13:20:00.000,00:20:00,52.35280°N,00.17508°W,0.00,mm/hour,0
    2018-01-03 13:25:00.000,00:25:00,52.34175°N,00.15211°W,0.00,mm/hour,0
    2018-01-03 13:30:00.000,00:30:00,52.33094°N,00.17517°W,0.00,mm/hour,0
    

    This returns the predicted rainfall along a Journey comprising 6 points (in this case). In practice the number of points on a Journey is limited only by the size of the URL you send us

    This method uses locations in the format longitude/latitude

    ToCSV or ToJSON method can be used to return the formatted data.

    The data returns; time, offset from NOW, location, rainfall intensity (mm/hr), units and the range used for displaying icons where the values are:

  • Rainfall Intensity mm/hr from 0 to < 0.25 mm/hr - returns a value of 0
  • Rainfall Intensity mm/hr from 0.25 to < 1 mm/hr - returns a value of 1
  • Rainfall Intensity mm/hr from 1 to < 4 mm/hr - returns a value of 2
  • Rainfall Intensity mm/hr from 4 to < 16 mm/hr - returns a value of 3
  • Rainfall Intensity mm/hr > 16 mm/hr – returns a value of 4
  • JSON
    https://innovate2.meniscus.co.uk/Map/ReadData/CalcJSON?calc=8016A408-7332-4B79-8B41-7C737E12CCB0&apiKey=adem982fGlq5&exp=ToJSON(GetJourneyRainfallIntensityFromNow(“Hyperlocal”,”Minutes(5),-0.190548,52.345793;Minutes(10),-0.192903,52.342879;Minutes(15),-0.190995,52.347541;Minutes(20),-0.175076,52.352803;Minutes(25),-0.152109,52.341746;Minutes(30),-0.175167,52.330943″))

    Returns

    [{ "time" : "2018-01-03T13:05:00.0000000", "offset" : "00:05:00", "lat" : "52.34579°N", "lon" : "00.19055°W", "rainfall" : "0.00", "units" : "mm/hour", "range" : 0 }, { "time" : "2018-01-03T13:10:00.0000000", "offset" : "00:10:00", "lat" : "52.34288°N", "lon" : "00.19290°W", "rainfall" : "0.00", "units" : "mm/hour", "range" : 0 }, { "time" : "2018-01-03T13:15:00.0000000", "offset" : "00:15:00", "lat" : "52.34754°N", "lon" : "00.19100°W", "rainfall" : "0.00", "units" : "mm/hour", "range" : 0 }, { "time" : "2018-01-03T13:20:00.0000000", "offset" : "00:20:00", "lat" : "52.35280°N", "lon" : "00.17508°W", "rainfall" : "0.00", "units" : "mm/hour", "range" : 0 }, { "time" : "2018-01-03T13:25:00.0000000", "offset" : "00:25:00", "lat" : "52.34175°N", "lon" : "00.15211°W", "rainfall" : "0.00", "units" : "mm/hour", "range" : 0 }, { "time" : "2018-01-03T13:30:00.0000000", "offset" : "00:30:00", "lat" : "52.33094°N", "lon" : "00.17517°W", "rainfall" : "0.00", "units" : "mm/hour", "range" : 0 }]
    

    CSV
    https://innovate2.meniscus.co.uk/Map/ReadData/CalcJSON?calc=8016A408-7332-4B79-8B41-7C737E12CCB0&apiKey=adem982fGlq5&exp=ToCSV(GetJourneyRainfallIntensityFromNow(“Hyperlocal”,”Minutes(5),-0.190548,52.345793;Minutes(10),-0.192903,52.342879;Minutes(15),-0.190995,52.347541;Minutes(20),-0.175076,52.352803;Minutes(25),-0.152109,52.341746;Minutes(30),-0.175167,52.330943″))

    Returns

    2018-01-03 13:05:00.000,00:05:00,52.34579°N,00.19055°W,0.00,mm/hour,0
    2018-01-03 13:10:00.000,00:10:00,52.34288°N,00.19290°W,0.00,mm/hour,0
    2018-01-03 13:15:00.000,00:15:00,52.34754°N,00.19100°W,0.00,mm/hour,0
    2018-01-03 13:20:00.000,00:20:00,52.35280°N,00.17508°W,0.00,mm/hour,0
    2018-01-03 13:25:00.000,00:25:00,52.34175°N,00.15211°W,0.00,mm/hour,0
    2018-01-03 13:30:00.000,00:30:00,52.33094°N,00.17517°W,0.00,mm/hour,0