Skip to content

Data transfer format for weather coverages

Data transfer

  • Data is transferred as geoJSON file
  • We provide an end-point with write access where data can be stored. Preferred transfer technology is azcopy

Data structure

  • Each Feature has a properties object containing the following fields:
  • cell_id - unique identifier of the polygon identified by sequence number of the cell (numbered from top left corner) and coordinates of the centroid of the grid cell (e.g. 1_142.075_-10.025)
  • start_date - coverage inception date
  • end_date - coverage expiration date
  • index_id - unique identifier of the index, e.g. 00000000-0000-0000-0000-000000000085 (for available indices see Weather index definitions)
  • trigger
    • value - defined trigger value for the coverage
    • unit - unit
    • millimeter for precipitation
    • centigrade for temperature
    • day when the trigger is number of days above/below the threshold
  • payout: payout definition - percentage of sum insured paid out when trigger is hit
    • type - one of the following payout types
    • lump_sum - lump sum payout
    • linear - payout with minimum payout and then payout per unit
    • minimum - minimum payout in percent of the sum insured - paid when trigger is hit in case of lump-sum payout
    • maximum - maximum payout in percent of the sum insured (only valid for linear payout type)
    • per_unit - percentage of sum insured paid out per unit (only valid for linear payout type)
  • risk_premium_rate - risk premium rate in percent of the sum insured
  • data_set_id - what data set to use to calculate the trigger value
    • precip_24h_sum - total precipitation
    • temp_24h_max - maximum temperature
    • temp_24h_min - minimum temperature
  • In case you need to provide multiple coverages for the same polygon, you can use the same cell_id and coordinates for multiple Features with different configuration (different index, variable, trigger etc).

Example

{
  "type": "FeatureCollection",
  "name": "pricing_aus",
  "crs": {
    "type": "name",
    "properties": {
      "name": "urn:ogc:def:crs:OGC:1.3:CRS84"
    }
  },
  "features": [
    {
      "type": "Feature",
      "properties": {
        "cell_id": "1_142.075_-10.025",
        "start_date": "2024-01-01",
        "end_date": "2024-12-31",
        "data_provider": "BOM",
        "data_set": "SILO",
        "resolution": "0.5deg",
        "variable": "precip_24h_sum",
        "index_code": "RF007",
        "risk_premium_rate": 0.1,
        "index_id": "00000000-0000-0000-0000-000000000085",
        "trigger": {
          "value": 30,
          "unit": "mm"
        },
        "payout": {
          "type": "linear",
          "minimum": 0.1,
          "maximum": 0.5,
          "per_unit": 0.01
        }
      },
      "geometry": {
        "type": "Polygon",
        "coordinates": [
          [ [142.075, -10.075], [142.075, -10.025], [142.125, -10.025], [142.125, -10.075], [142.075, -10.075] ]
        ]
      }
    },
    {
      "type": "Feature",
      "properties": {
        "cell_id": "1_142.075_-10.025",
        "start_date": "2024-01-01",
        "end_date": "2024-12-31",
        "data_provider": "BOM",
        "data_set": "SILO",
        "resolution": "0.5deg",
        "variable": "temp_24h_max",
        "risk_premium_rate": 0.1,
        "index_id": "00000000-0000-0000-0000-000000000086",
        "trigger": {
          "value": 30,
          "unit": "centigrade"
        },
        "payout": {
          "type": "linear",
          "minimum": 0.1,
          "maximum": 0.5,
          "per_unit": 0.01
        }
      },
      "geometry": {
        "type": "Polygon",
        "coordinates": [
          [ [142.075, -10.075], [142.075, -10.025], [142.125, -10.025], [142.125, -10.075], [142.075, -10.075] ]
        ]
      }
    },
    {
      "type": "Feature",
      "properties": {
        "cell_id": "2_142.125_-10.025",
        "start_date": "2024-01-01",
        "end_date": "2024-12-31",
        "data_provider": "BOM",
        "data_set": "SILO",
        "resolution": "0.05deg",
        "variable": "precip_24h_sum",
        "risk_premium_rate": 0.1,
        "index_id": "00000000-0000-0000-0000-000000000085",
        "trigger": {
          "value": 30,
          "unit": "mm"
        },
        "payout": {
          "type": "linear",
          "minimum": 0.1,
          "maximum": 0.5,
          "per_unit": 0.01
        }
      },
      "geometry": {
        "type": "Polygon",
        "coordinates": [
          [ [142.125, -10.075], [142.125, -10.025], [142.175, -10.025], [142.175, -10.075], [142.125, -10.075] ]
        ]
      }
    },
    {
      "type": "Feature",
      "properties": {
        "cell_id": "2_142.125_-10.025",
        "start_date": "2024-01-01",
        "end_date": "2024-12-31",
        "data_provider": "BOM",
        "data_set": "SILO",
        "resolution": "0.5deg",
        "variable": "temp_24h_max",
        "risk_premium_rate": 0.1,
        "index_id": "00000000-0000-0000-0000-000000000086",
        "trigger": {
          "value": 30,
          "unit": "centigrade"
        },
        "payout": {
          "type": "linear",
          "minimum": 0.1,
          "maximum": 0.5,
          "per_unit": 0.01
        }
      },
      "geometry": {
        "type": "Polygon",
        "coordinates": [
          [ [142.125, -10.075], [142.125, -10.025], [142.175, -10.025], [142.175, -10.075], [142.125, -10.075] ]
        ]
      }
    }
  ]
}