Carbon Mapper data contract | PatchOps Knowledge

Provenance

PublisherCarbon Mapper Data Platform

API basehttps://api.carbonmapper.org/api/v1

Docshttps://api.carbonmapper.org/api/v1/docs

Freshness & coverage

FreshnessFreshness not declared

GeographicNot declared

TemporalNot declared

AuthenticationNo credentials required

Caveats

⚠ Catalog coverage is observation-dependent; no detection is not evidence that no emissions occurred.
⚠ Plume and source emission values include upstream uncertainty fields and should not be treated as exact measurements.

Methods (6)

searchPlumes

read

Satellite + airborne CH4/CO2 plume detections. Filter bbox/gas/sector/emission/date.

Entitiesemission_plume

Paginationoffset (offsetField: offset, limitField: limit)

Unitsemission_auto: kg/h · emission_uncertainty_auto: kg/h · plume_latitude: decimal degrees · plume_longitude: decimal degrees

CRSOGC:CRS84

Input schema

{
  "type": "object",
  "properties": {
    "bbox": {
      "type": "array",
      "items": {
        "type": "number"
      },
      "minItems": 4,
      "maxItems": 4,
      "description": "[min longitude, min latitude, max longitude, max latitude] in OGC:CRS84."
    },
    "gas": {
      "type": "string",
      "enum": [
        "CH4",
        "CO2"
      ]
    },
    "sectors": {
      "type": "array",
      "items": {
        "type": "string"
      }
    },
    "emission_min": {
      "type": "number",
      "description": "Minimum emission rate in kg/h."
    },
    "emission_max": {
      "type": "number",
      "description": "Maximum emission rate in kg/h."
    },
    "datetime": {
      "type": "string",
      "description": "ISO 8601 instant or interval."
    },
    "limit": {
      "type": "integer",
      "minimum": 1,
      "maximum": 500
    },
    "offset": {
      "type": "integer",
      "minimum": 0
    }
  },
  "additionalProperties": false
}

Output schema

{
  "type": "array",
  "items": {
    "type": "object",
    "properties": {
      "plume_id": {
        "type": "string"
      },
      "plume_latitude": {
        "type": "string"
      },
      "plume_longitude": {
        "type": "string"
      },
      "datetime": {
        "type": "string"
      },
      "gas": {
        "type": "string"
      },
      "ipcc_sector": {
        "type": "string"
      },
      "emission_auto": {
        "type": "string"
      },
      "emission_uncertainty_auto": {
        "type": "string"
      },
      "published_at": {
        "type": "string"
      }
    },
    "additionalProperties": {
      "type": "string"
    }
  }
}

IPCC sectors: 1B2=Oil&Gas, 6A=Solid Waste, 1A1=Electricity.

getPlume

read

Single plume by plume_id — emission, geometry, instrument, imagery URLs.

Required paramsplume_id

Entitiesemission_plume

Paginationnone

Unitsemission_auto: kg/h · emission_uncertainty_auto: kg/h

CRSOGC:CRS84

Input schema

{
  "type": "object",
  "properties": {
    "plume_id": {
      "type": "string",
      "minLength": 1
    }
  },
  "required": [
    "plume_id"
  ],
  "additionalProperties": false
}

Output schema

{
  "type": "object",
  "properties": {
    "plume_id": {
      "type": "string"
    },
    "geometry": {
      "type": "object"
    },
    "datetime": {
      "type": "string"
    },
    "gas": {
      "type": "string"
    },
    "emission_auto": {
      "type": [
        "number",
        "null"
      ]
    },
    "emission_uncertainty_auto": {
      "type": [
        "number",
        "null"
      ]
    }
  },
  "additionalProperties": true
}

⚠ Imagery links can be pre-signed and expire upstream.

Returns plume PNG, RGB PNG, plume TIF, concentration TIF pre-signed URLs.

searchSources

read

Persistent emission sources (clustered plume detections). Filter bbox/gas/sector.

Entitiesemission_source

Paginationoffset (offsetField: offset, limitField: limit)

Unitssource_emission: kg/h · source_emission_uncertainty: kg/h · source_persistence: fraction · source_latitude: decimal degrees · source_longitude: decimal degrees

CRSOGC:CRS84

Input schema

{
  "type": "object",
  "properties": {
    "bbox": {
      "type": "array",
      "items": {
        "type": "number"
      },
      "minItems": 4,
      "maxItems": 4,
      "description": "[min longitude, min latitude, max longitude, max latitude] in OGC:CRS84."
    },
    "gas": {
      "type": "string",
      "enum": [
        "CH4",
        "CO2"
      ]
    },
    "sectors": {
      "type": "array",
      "items": {
        "type": "string"
      }
    },
    "emission_min": {
      "type": "number",
      "description": "Minimum emission rate in kg/h."
    },
    "limit": {
      "type": "integer",
      "minimum": 1,
      "maximum": 2000
    },
    "offset": {
      "type": "integer",
      "minimum": 0
    }
  },
  "additionalProperties": false
}

Output schema

{
  "type": "array",
  "items": {
    "type": "object",
    "properties": {
      "source_name": {
        "type": "string"
      },
      "source_latitude": {
        "type": "string"
      },
      "source_longitude": {
        "type": "string"
      },
      "gas": {
        "type": "string"
      },
      "ipcc_sector": {
        "type": "string"
      },
      "source_emission": {
        "type": "string"
      },
      "source_emission_uncertainty": {
        "type": "string"
      },
      "source_persistence": {
        "type": "string"
      },
      "observation_date_count": {
        "type": "string"
      },
      "detection_date_count": {
        "type": "string"
      }
    },
    "additionalProperties": {
      "type": "string"
    }
  }
}

source_persistence is 0–1 fraction of overflights with a detection.

downloadPlumesCsv

read

Raw CSV of plume detections matching filters. Full schema with imagery URLs.

Entitiesemission_plume

Paginationoffset (offsetField: offset, limitField: limit)

Unitsemission_auto: kg/h · emission_uncertainty_auto: kg/h · plume_latitude: decimal degrees · plume_longitude: decimal degrees

CRSOGC:CRS84

Input schema

{
  "type": "object",
  "properties": {
    "bbox": {
      "type": "array",
      "items": {
        "type": "number"
      },
      "minItems": 4,
      "maxItems": 4,
      "description": "[min longitude, min latitude, max longitude, max latitude] in OGC:CRS84."
    },
    "gas": {
      "type": "string",
      "enum": [
        "CH4",
        "CO2"
      ]
    },
    "sectors": {
      "type": "array",
      "items": {
        "type": "string"
      }
    },
    "emission_min": {
      "type": "number",
      "description": "Minimum emission rate in kg/h."
    },
    "emission_max": {
      "type": "number",
      "description": "Maximum emission rate in kg/h."
    },
    "datetime": {
      "type": "string",
      "description": "ISO 8601 instant or interval."
    },
    "limit": {
      "type": "integer",
      "minimum": 1,
      "maximum": 500
    },
    "offset": {
      "type": "integer",
      "minimum": 0
    }
  },
  "additionalProperties": false
}

Output schema

{
  "type": "string",
  "contentMediaType": "text/csv"
}

Includes location, datetime, sector, gas, emission, wind, instrument, imagery.

getSourcesGeoJson

read

GeoJSON FeatureCollection of clustered emission sources by bbox/sector/gas.

Entitiesemission_source

Paginationoffset (offsetField: offset, limitField: limit)

Unitsfeatures[].properties.source_emission: kg/h · features[].properties.source_emission_uncertainty: kg/h · features[].properties.source_persistence: fraction

CRSOGC:CRS84

Input schema

{
  "type": "object",
  "properties": {
    "bbox": {
      "type": "array",
      "items": {
        "type": "number"
      },
      "minItems": 4,
      "maxItems": 4,
      "description": "[min longitude, min latitude, max longitude, max latitude] in OGC:CRS84."
    },
    "gas": {
      "type": "string",
      "enum": [
        "CH4",
        "CO2"
      ]
    },
    "sectors": {
      "type": "array",
      "items": {
        "type": "string"
      }
    },
    "emission_min": {
      "type": "number",
      "description": "Minimum emission rate in kg/h."
    },
    "limit": {
      "type": "integer",
      "minimum": 1,
      "maximum": 2000
    },
    "offset": {
      "type": "integer",
      "minimum": 0
    }
  },
  "additionalProperties": false
}

Output schema

{
  "type": "object",
  "properties": {
    "type": {
      "const": "FeatureCollection"
    },
    "features": {
      "type": "array",
      "items": {
        "type": "object",
        "properties": {
          "type": {
            "const": "Feature"
          },
          "geometry": {
            "type": "object"
          },
          "properties": {
            "type": "object"
          }
        },
        "required": [
          "type",
          "geometry",
          "properties"
        ]
      }
    }
  },
  "required": [
    "type",
    "features"
  ]
}

Properties: source_name, gas, sector, emission, persistence, obs counts.

aggregateSourcesBySector

read

Aggregate sources by IPCC sector — count, total/avg emission, persistence.

Entitiesemission_sector_summary

Paginationnone

Unitstotal_emission_kghr: kg/h · avg_emission_kghr: kg/h · avg_persistence: fraction

Input schema

{
  "type": "object",
  "properties": {
    "bbox": {
      "type": "array",
      "items": {
        "type": "number"
      },
      "minItems": 4,
      "maxItems": 4,
      "description": "[min longitude, min latitude, max longitude, max latitude] in OGC:CRS84."
    },
    "gas": {
      "type": "string",
      "enum": [
        "CH4",
        "CO2"
      ]
    }
  },
  "additionalProperties": false
}

Output schema

{
  "type": "array",
  "items": {
    "type": "object",
    "properties": {
      "sector": {
        "type": "string"
      },
      "count": {
        "type": "integer"
      },
      "total_emission_kghr": {
        "type": "number"
      },
      "avg_emission_kghr": {
        "type": [
          "number",
          "null"
        ]
      },
      "avg_persistence": {
        "type": [
          "number",
          "null"
        ]
      }
    },
    "required": [
      "sector",
      "count",
      "total_emission_kghr",
      "avg_emission_kghr",
      "avg_persistence"
    ]
  }
}

Sorted by total emission desc. Useful for super-emitter analysis by play.