90. Fråga: Hämta SatelliteImagery-data efter geometri

Hämta statistik över vegetationsindex för valfri ad-hoc-geometri - ingen registrerad fältgräns krävs. Denna endpoint beräknar sammanfattande statistik för pixlar inom din geometri samtidigt som molniga pixlar ignoreras. För närvarande stöds av Sentinel2 (S2) , Landsat (L4/L5/L7/L8/L9) och Planet (PS) leverantörer.

Denna sida följer GeoPards API-mönster och autentisering som används över GraphQL-endpoints.

Vad du kan göra

• Fråga vegetationsindex för Point, MultiPoint, Polygon och MultiPolygon geometrier.

• Välj bildmaterial leverantörer: S2, L4, L5, L7, L8, L9, PS.

• Få datumstämplade resultat per förvärv med:

  • molnfria - andel av din geometri som är molnfri, intervall från 0 till 1, där 1 betyder helt molnfri.

  • value - statistik för det valda indexet beräknat endast på molnfria pixlar, inkluderar min, max, avg, mdn, var, std.

• Valfritt ange intervall array av indexvärdesintervall för att beräkna täckningsstatistik. När detta anges kommer svaret att innehålla ett intervall fält som visar vilken procent av området som faller inom varje angivet intervall.

  • Area som upptas av varje färg/intervall - baserat på indexvärde (lågt => högt)

  • Täcksprocent - 0..1 värde per intervall som representerar yta i procent

Stödda index

EVI2, NDVI, RVI, LAI, OSAVI, SAVI, GNDVI, IPVI, GCI, WDRVI, RCI, SBI, MCARI1. Indexdefinitioner följer GeoPards vegetationsindexkatalog som används i hela API:et.

Inmatningsparametrar

Fält	Typ	Obligatoriskt	Anteckningar
index	Enum (se ovan)	✅	Vegetationsindex att beräkna.
leverantörer	[Provider!]!	✅	Någon av S2, L4, L5, L7, L8, L9, PS.
startDate	String (ISO8601)	✅	Inkluderande start, t.ex. "2025-05-10T00:00:00.000Z".
endDate	String (ISO8601)	✅	Exklusivt slut eller inkluderande slut beroende på schema; matcha dina andra GeoPard-frågor.
geojson	String	✅	En strängifierad GeoJSON av typen Point / MultiPoint / Polygon / MultiPolygon (WGS84 [lon, lat]). Kom ihåg att escap:a citattecken inuti strängen.
intervall	[[Float!]!]	❌	Array av [min, max] par av indexvärdesintervall för att beräkna täckningsstatistik

Prestandaråd

• För Polygon/MultiPolygon-geometrier, håll datumintervallen snäva (~10–15 dagar) på grund av bearbetningstiden.

• Timeout: 30 s. Använd färre dagar och/eller färre leverantörer om du når gränsen.

• För Point/MultiPoint är större intervall vanligtvis okej (punkter är lätta).

Svarstruktur

graphqlCopyEdit{
  geojson              # eko av din ingående geometri (strängifierad)
  data: [
    {
      uuid             # rasterscen-id
      provider         # S2, L8, L9, ...
      acquisitionDate  # ISO8601
      cloudfree        # 0..1 andel molnfri yta
      value: {
        index          # t.ex. NDVI
        min
        max
        avg
        mdn
        var
        std
      }
      ranges: {
        value
        coverage
      }
    }
  ]
}

Exempel 1: MultiPolygon med MCARI1 på S2/L8/L9 inom ett 5-dagarsfönster

Begär

query GetSatelliteImageryDataByMultiPolygon {
  getSatelliteImageryDataByGeometry(
    input: {
      index: MCARI1                # sätt index här
      providers: [S2, L8, L9]      # satellitleverantörer
      startDate: "2025-05-10T00:00:00.000Z"  # polygoner: föredra 10–15 dagar; 30s timeout
      endDate:   "2025-05-15T00:00:00.000Z"
      geojson: "{\"type\": \"MultiPolygon\", \"coordinates\":[ [ [ [ 8.09058546, 50.21774961 ], [ 8.09291004, 50.21836077 ], [ 8.09328559, 50.21844893 ], [ 8.09341412, 50.21777585 ], [ 8.09342329, 50.21768228 ], [ 8.09342736, 50.21748691 ], [ 8.09342239, 50.21741988 ], [ 8.09331503, 50.2169872 ], [ 8.09327725, 50.21680672 ], [ 8.0932114, 50.21679383 ], [ 8.09307662, 50.216784 ], [ 8.09268795, 50.21672443 ], [ 8.09256905, 50.21670175 ], [ 8.09160986, 50.21647789 ], [ 8.09153097, 50.21647138 ], [ 8.09144745, 50.216479 ], [ 8.09128792, 50.21653615 ], [ 8.09124139, 50.21654808 ], [ 8.09119362, 50.21655407 ], [ 8.09085379, 50.21653536 ], [ 8.09039423, 50.21649463 ], [ 8.09006609, 50.21646137 ], [ 8.08994025, 50.21644261 ], [ 8.08956206, 50.21636986 ], [ 8.08937343, 50.21632184 ], [ 8.08881276, 50.21616093 ], [ 8.08860924, 50.21608589 ], [ 8.08848952, 50.21605007 ], [ 8.08841856, 50.21616403 ], [ 8.08836721, 50.2162167 ], [ 8.08830625, 50.21626762 ], [ 8.08801583, 50.21648103 ], [ 8.08783363, 50.21660479 ], [ 8.08757577, 50.21677569 ], [ 8.08741435, 50.21686857 ], [ 8.08769592, 50.21696741 ], [ 8.08853411, 50.21720846 ], [ 8.08965086, 50.2174967 ], [ 8.09058546, 50.21774961 ] ] ] ]}"
    }
  ) {
    geojson
    data {
      uuid
      provider
      acquisitionDate
      cloudfree     # 0..1
      value {       # statistik beräknad endast på molnfria pixlar
        index
        min
        max
        avg
        mdn
        var
        std
      }
    }
  }
}

Svar

{
  "data": {
    "getSatelliteImageryDataByGeometry": {
      "geojson": "\"{\\\"type\\\": \\\"MultiPolygon\\\", \\\"coordinates\\\": [[[[8.09058546, 50.21774961], [8.09291004, 50.21836077], [8.09328559, 50.21844893], [8.09341412, 50.21777585], [8.09342329, 50.21768228], [8.09342736, 50.21748691], [8.09342239, 50.21741988], [8.09331503, 50.2169872], [8.09327725, 50.21680672], [8.0932114, 50.21679383], [8.09307662, 50.216784], [8.09268795, 50.21672443], [8.09256905, 50.21670175], [8.09160986, 50.21647789], [8.09153097, 50.21647138], [8.09144745, 50.216479], [8.09128792, 50.21653615], [8.09124139, 50.21654808], [8.09119362, 50.21655407], [8.09085379, 50.21653536], [8.09039423, 50.21649463], [8.09006609, 50.21646137], [8.08994025, 50.21644261], [8.08956206, 50.21636986], [8.08937343, 50.21632184], [8.08881276, 50.21616093], [8.08860924, 50.21608589], [8.08848952, 50.21605007], [8.08841856, 50.21616403], [8.08836721, 50.2162167], [8.08830625, 50.21626762], [8.08801583, 50.21648103], [8.08783363, 50.21660479], [8.08757577, 50.21677569], [8.08741435, 50.21686857], [8.08769592, 50.21696741], [8.08853411, 50.21720846], [8.08965086, 50.2174967], [8.09058546, 50.21774961]]]]}\"",
      "data": [
        {
          "uuid": "16c45077-3138-5a9a-9947-d9e54ea77e38",
          "provider": "S2",
          "acquisitionDate": "2025-05-13T10:37:03.661000+00:00",
          "cloudfree": 1,
          "value": {
            "index": "MCARI1",
            "min": 3026.88,
            "max": 6452.881,
            "avg": 5020.917,
            "mdn": 5086.56,
            "var": 437905.281,
            "std": 661.744
          }
        },
        {
          "uuid": "cf5d9e51-c0db-5e02-bf97-35c3e7a0fe07",
          "provider": "S2",
          "acquisitionDate": "2025-05-13T10:47:13.154000+00:00",
          "cloudfree": 1,
          "value": {
            "index": "MCARI1",
            "min": 3441.96,
            "max": 6722.04,
            "avg": 5333.138,
            "mdn": 5403.36,
            "var": 372277.75,
            "std": 610.146
          }
        },
        {
          "uuid": "de9b6b8a-a195-5694-98a0-f17e8122855d",
          "provider": "S2",
          "acquisitionDate": "2025-05-11T10:47:17.500000+00:00",
          "cloudfree": "0.5547445255474452",
          "value": {
            "index": "MCARI1",
            "min": 3438.96,
            "max": 6495.96,
            "avg": 5176.501,
            "mdn": 5181,
            "var": 377633.031,
            "std": 614.519
          }
        },
        {
          "uuid": "917b3657-3ddc-5f43-b39f-5d8493282bde",
          "provider": "S2",
          "acquisitionDate": "2025-05-10T10:37:15.656000+00:00",
          "cloudfree": 1,
          "value": {
            "index": "MCARI1",
            "min": 3395.88,
            "max": 6272.881,
            "avg": 4975.816,
            "mdn": 4999.56,
            "var": 333405.031,
            "std": 577.412
          }
        },
        {
          "uuid": "3fc7ed30-677a-5430-a10b-3490d903616c",
          "provider": "L8",
          "acquisitionDate": "2025-05-12T10:21:17.302000+00:00",
          "cloudfree": 1,
          "value": {
            "index": "MCARI1",
            "min": 3171.24,
            "max": 5361,
            "avg": 4227.754,
            "mdn": 4267.68,
            "var": 261266,
            "std": 511.142
          }
        },
        {
          "uuid": "f3d1bd32-e3c8-5260-ba4c-d84c6a171986",
          "provider": "L9",
          "acquisitionDate": "2025-05-13T10:15:17.115000+00:00",
          "cloudfree": 1,
          "value": {
            "index": "MCARI1",
            "min": 3353.52,
            "max": 5451.72,
            "avg": 4428.534,
            "mdn": 4491.48,
            "var": 306042.719,
            "std": 553.211
          }
        }
      ]
    }
  }
}

Exempel 2: MultiPoint med NDVI på S2/L8/L9 över ett 5-dagarsfönster

Begär

query GetSatelliteImageryDataByMultiPoint {
  getSatelliteImageryDataByGeometry(
    input: {
      providers: [S2, L8, L9]
      index: NDVI
      startDate: "2025-05-10T00:00:00.000Z"   # punkter är lätta; större fönster OK; 30s timeout
      endDate:   "2025-05-15T00:00:00.000Z"
      geojson: "{\"type\": \"MultiPoint\", \"coordinates\": [[8.088754, 50.216859],[8.092651, 50.216905],[ 8.090799, 50.217442]]}"
    }
  ) {
    geojson
    data {
      uuid
      provider
      acquisitionDate
      molnfria
      value {
        index
        min
        max
        avg
        mdn
        var
        std
      }
    }
  }
}

Svar

{
  "data": {
    "getSatelliteImageryDataByGeometry": {
      "geojson": "\"{\\\"type\\\": \\\"MultiPoint\\\", \\\"coordinates\\\": [[8.088754, 50.216859], [8.092651, 50.216905], [8.090799, 50.217442]]}\"",
      "data": [
        {
          "uuid": "cf5d9e51-c0db-5e02-bf97-35c3e7a0fe07",
          "provider": "S2",
          "acquisitionDate": "2025-05-13T10:47:13.154000+00:00",
          "cloudfree": 1,
          "value": {
            "index": "NDVI",
            "min": 0.712,
            "max": 0.873,
            "avg": 0.815,
            "mdn": 0.824,
            "var": 0.002,
            "std": 0.041
          }
        },
        {
          "uuid": "16c45077-3138-5a9a-9947-d9e54ea77e38",
          "provider": "S2",
          "acquisitionDate": "2025-05-13T10:37:03.661000+00:00",
          "cloudfree": 1,
          "value": {
            "index": "NDVI",
            "min": 0.642,
            "max": 0.856,
            "avg": 0.779,
            "mdn": 0.794,
            "var": 0.003,
            "std": 0.055
          }
        },
        {
          "uuid": "de9b6b8a-a195-5694-98a0-f17e8122855d",
          "provider": "S2",
          "acquisitionDate": "2025-05-11T10:47:17.500000+00:00",
          "cloudfree": "0.6363636363636364",
          "value": {
            "index": "NDVI",
            "min": 0.762,
            "max": 0.857,
            "avg": 0.826,
            "mdn": 0.83,
            "var": 0.001,
            "std": 0.029
          }
        },
        {
          "uuid": "917b3657-3ddc-5f43-b39f-5d8493282bde",
          "provider": "S2",
          "acquisitionDate": "2025-05-10T10:37:15.656000+00:00",
          "cloudfree": 1,
          "value": {
            "index": "NDVI",
            "min": 0.667,
            "max": 0.854,
            "avg": 0.79,
            "mdn": 0.802,
            "var": 0.002,
            "std": 0.048
          }
        },
        {
          "uuid": "3fc7ed30-677a-5430-a10b-3490d903616c",
          "provider": "L8",
          "acquisitionDate": "2025-05-12T10:21:17.302000+00:00",
          "cloudfree": 1,
          "value": {
            "index": "NDVI",
            "min": 0.746,
            "max": 0.87,
            "avg": 0.814,
            "mdn": 0.833,
            "var": 0.002,
            "std": 0.039
          }
        },
        {
          "uuid": "f3d1bd32-e3c8-5260-ba4c-d84c6a171986",
          "provider": "L9",
          "acquisitionDate": "2025-05-13T10:15:17.115000+00:00",
          "cloudfree": 1,
          "value": {
            "index": "NDVI",
            "min": 0.707,
            "max": 0.85,
            "avg": 0.795,
            "mdn": 0.813,
            "var": 0.002,
            "std": 0.05
          }
        }
      ]
    }
  }
}

Exempel 3: MultiPolygon med NDVI på S2/L8/L9 med intervall inom ett 5-dagarsfönster

Begär

query GetSatelliteImageryDataByMultiPolygon {
  getSatelliteImageryDataByGeometry(
    input: {
      index: NDVI                # sätt index här
      providers: [S2, L8, L9]      # satellitleverantörer
      startDate: "2025-05-10T00:00:00.000Z"  # polygoner: föredra 10–15 dagar; 30s timeout
      endDate:   "2025-05-15T00:00:00.000Z"
      geojson: "{\"type\": \"MultiPolygon\", \"coordinates\":[ [ [ [ 8.09058546, 50.21774961 ], [ 8.09291004, 50.21836077 ], [ 8.09328559, 50.21844893 ], [ 8.09341412, 50.21777585 ], [ 8.09342329, 50.21768228 ], [ 8.09342736, 50.21748691 ], [ 8.09342239, 50.21741988 ], [ 8.09331503, 50.2169872 ], [ 8.09327725, 50.21680672 ], [ 8.0932114, 50.21679383 ], [ 8.09307662, 50.216784 ], [ 8.09268795, 50.21672443 ], [ 8.09256905, 50.21670175 ], [ 8.09160986, 50.21647789 ], [ 8.09153097, 50.21647138 ], [ 8.09144745, 50.216479 ], [ 8.09128792, 50.21653615 ], [ 8.09124139, 50.21654808 ], [ 8.09119362, 50.21655407 ], [ 8.09085379, 50.21653536 ], [ 8.09039423, 50.21649463 ], [ 8.09006609, 50.21646137 ], [ 8.08994025, 50.21644261 ], [ 8.08956206, 50.21636986 ], [ 8.08937343, 50.21632184 ], [ 8.08881276, 50.21616093 ], [ 8.08860924, 50.21608589 ], [ 8.08848952, 50.21605007 ], [ 8.08841856, 50.21616403 ], [ 8.08836721, 50.2162167 ], [ 8.08830625, 50.21626762 ], [ 8.08801583, 50.21648103 ], [ 8.08783363, 50.21660479 ], [ 8.08757577, 50.21677569 ], [ 8.08741435, 50.21686857 ], [ 8.08769592, 50.21696741 ], [ 8.08853411, 50.21720846 ], [ 8.08965086, 50.2174967 ], [ 8.09058546, 50.21774961 ] ] ] ]}"
      ranges: [
        [0.0, 0.5],
        [0.5, 0.55],
        [0.55, 0.6],
        [0.6, 0.65],
        [0.65, 0.7],
        [0.7, 0.75],
        [0.75, 0.8],
        [0.8, 0.85],
        [0.85, 0.9]
      ]
    }
  ) {
    geojson
    data {
      uuid
      provider
      acquisitionDate
      cloudfree     # 0..1
      value {       # statistik beräknad endast på molnfria pixlar
        index
        min
        max
        avg
        mdn
        var
        std
      }
      ranges {
        value
        coverage   # 0..1
      }
    }
  }
}

Svar

{
  "data": {
    "getSatelliteImageryDataByGeometry": {
      "geojson": "{\"type\":\"MultiPolygon\",\"coordinates\":[[[[8.09058546,50.21774961],[8.09291004,50.21836077],[8.09328559,50.21844893],[8.09341412,50.21777585],[8.09342329,50.21768228],[8.09342736,50.21748691],[8.09342239,50.21741988],[8.09331503,50.2169872],[8.09327725,50.21680672],[8.0932114,50.21679383],[8.09307662,50.216784],[8.09268795,50.21672443],[8.09256905,50.21670175],[8.09160986,50.21647789],[8.09153097,50.21647138],[8.09144745,50.216479],[8.09128792,50.21653615],[8.09124139,50.21654808],[8.09119362,50.21655407],[8.09085379,50.21653536],[8.09039423,50.21649463],[8.09006609,50.21646137],[8.08994025,50.21644261],[8.08956206,50.21636986],[8.08937343,50.21632184],[8.08881276,50.21616093],[8.08860924,50.21608589],[8.08848952,50.21605007],[8.08841856,50.21616403],[8.08836721,50.2162167],[8.08830625,50.21626762],[8.08801583,50.21648103],[8.08783363,50.21660479],[8.08757577,50.21677569],[8.08741435,50.21686857],[8.08769592,50.21696741],[8.08853411,50.21720846],[8.08965086,50.2174967],[8.09058546,50.21774961]]]]}",
      "data": [
        {
          "uuid": "cf5d9e51-c0db-5e02-bf97-35c3e7a0fe07",
          "provider": "S2",
          "acquisitionDate": "2025-05-13T10:47:13.154000+00:00",
          "cloudfree": 1,
          "value": {
            "index": "NDVI",
            "min": 0.625,
            "max": 0.873,
            "avg": 0.795,
            "mdn": 0.808,
            "var": 0.003,
            "std": 0.051
          },
          "ranges": [
            { "value": [0, 0.5], "coverage": 0 },
            { "value": [0.5, 0.55], "coverage": 0 },
            { "value": [0.55, 0.6], "coverage": 0 },
            { "value": [0.6, 0.65], "coverage": 0.0089 },
            { "value": [0.65, 0.7], "coverage": 0.0514 },
            { "value": [0.7, 0.75], "coverage": 0.1288 },
            { "value": [0.75, 0.8], "coverage": 0.2603 },
            { "value": [0.8, 0.85], "coverage": 0.4575 },
            { "value": [0.85, 0.9], "coverage": 0.0932 }
          ]
        },
        {
          "uuid": "917b3657-3ddc-5f43-b39f-5d8493282bde",
          "provider": "S2",
          "acquisitionDate": "2025-05-10T10:37:15.656000+00:00",
          "cloudfree": 1,
          "value": {
            "index": "NDVI",
            "min": 0.585,
            "max": 0.854,
            "avg": 0.768,
            "mdn": 0.78,
            "var": 0.003,
            "std": 0.056
          },
          "ranges": [
            { "value": [0, 0.5], "coverage": 0 },
            { "value": [0.5, 0.55], "coverage": 0 },
            { "value": [0.55, 0.6], "coverage": 0.0014 },
            { "value": [0.6, 0.65], "coverage": 0.0342 },
            { "value": [0.65, 0.7], "coverage": 0.1205 },
            { "value": [0.7, 0.75], "coverage": 0.161 },
            { "value": [0.75, 0.8], "coverage": 0.3233 },
            { "value": [0.8, 0.85], "coverage": 0.3479 },
            { "value": [0.85, 0.9], "coverage": 0.0116 }
          ]
        },
        {
          "uuid": "16c45077-3138-5a9a-9947-d9e54ea77e38",
          "provider": "S2",
          "acquisitionDate": "2025-05-13T10:37:03.661000+00:00",
          "cloudfree": 1,
          "value": {
            "index": "NDVI",
            "min": 0.548,
            "max": 0.856,
            "avg": 0.756,
            "mdn": 0.769,
            "var": 0.004,
            "std": 0.061
          },
          "ranges": [
            { "value": [0, 0.5], "coverage": 0 },
            { "value": [0.5, 0.55], "coverage": 0.0021 },
            { "value": [0.55, 0.6], "coverage": 0.011 },
            { "value": [0.6, 0.65], "coverage": 0.05 },
            { "value": [0.65, 0.7], "coverage": 0.1198 },
            { "value": [0.7, 0.75], "coverage": 0.2231 },
            { "value": [0.75, 0.8], "coverage": 0.295 },
            { "value": [0.8, 0.85], "coverage": 0.295 },
            { "value": [0.85, 0.9], "coverage": 0.0041 }
          ]
        },
        {
          "uuid": "de9b6b8a-a195-5694-98a0-f17e8122855d",
          "provider": "S2",
          "acquisitionDate": "2025-05-11T10:47:17.500000+00:00",
          "cloudfree": 0.6067415730337079,
          "value": {
            "index": "NDVI",
            "min": 0.613,
            "max": 0.865,
            "avg": 0.782,
            "mdn": 0.793,
            "var": 0.003,
            "std": 0.054
          },
          "ranges": [
            { "value": [0, 0.5], "coverage": 0 },
            { "value": [0.5, 0.55], "coverage": 0 },
            { "value": [0.55, 0.6], "coverage": 0 },
            { "value": [0.6, 0.65], "coverage": 0.0311 },
            { "value": [0.65, 0.7], "coverage": 0.0377 },
            { "value": [0.7, 0.75], "coverage": 0.1964 },
            { "value": [0.75, 0.8], "coverage": 0.3097 },
            { "value": [0.8, 0.85], "coverage": 0.3541 },
            { "value": [0.85, 0.9], "coverage": 0.071 }
          ]
        },
        {
          "uuid": "3fc7ed30-677a-5430-a10b-3490d903616c",
          "provider": "L8",
          "acquisitionDate": "2025-05-12T10:21:17.302000+00:00",
          "cloudfree": 1,
          "value": {
            "index": "NDVI",
            "min": 0.619,
            "max": 0.87,
            "avg": 0.781,
            "mdn": 0.793,
            "var": 0.003,
            "std": 0.055
          },
          "ranges": [
            { "value": [0, 0.5], "coverage": 0 },
            { "value": [0.5, 0.55], "coverage": 0 },
            { "value": [0.55, 0.6], "coverage": 0 },
            { "value": [0.6, 0.65], "coverage": 0.0098 },
            { "value": [0.65, 0.7], "coverage": 0.0784 },
            { "value": [0.7, 0.75], "coverage": 0.201 },
            { "value": [0.75, 0.8], "coverage": 0.2451 },
            { "value": [0.8, 0.85], "coverage": 0.3873 },
            { "value": [0.85, 0.9], "coverage": 0.0784 }
          ]
        },
        {
          "uuid": "f3d1bd32-e3c8-5260-ba4c-d84c6a171986",
          "provider": "L9",
          "acquisitionDate": "2025-05-13T10:15:17.115000+00:00",
          "cloudfree": 1,
          "value": {
            "index": "NDVI",
            "min": 0.617,
            "max": 0.85,
            "avg": 0.769,
            "mdn": 0.782,
            "var": 0.003,
            "std": 0.055
          },
          "ranges": [
            { "value": [0, 0.5], "coverage": 0 },
            { "value": [0.5, 0.55], "coverage": 0 },
            { "value": [0.55, 0.6], "coverage": 0 },
            { "value": [0.6, 0.65], "coverage": 0.0495 },
            { "value": [0.65, 0.7], "coverage": 0.0842 },
            { "value": [0.7, 0.75], "coverage": 0.203 },
            { "value": [0.75, 0.8], "coverage": 0.3069 },
            { "value": [0.8, 0.85], "coverage": 0.3465 },
            { "value": [0.85, 0.9], "coverage": 0.0099 }
          ]
        }
      ]
    }
  }
}