90. Запрос: получить данные SatelliteImagery по геометрии

Получите статистику индексa вегетации для любой произвольной геометрии - регистрация границ поля не требуется. Эта конечная точка вычисляет сводную статистику для пикселей внутри вашей геометрии, при этом игнорируя облачные пиксели. В настоящее время поддерживается для Sentinel2 (S2) , Landsat (L4/L5/L7/L8/L9) и Planet (PS) поставщиков.

Эта страница следует шаблонам API GeoPard и аутентификации используемой в GraphQL-конечных точках.

Что вы можете сделать

• Запросить индексы вегетации для геометрии Point, MultiPoint, Polygon и MultiPolygon. геометрии.

• Выберите поставщиков изображений: S2, L4, L5, L7, L8, L9, PS.

• Получите датированные результаты по каждой съёмке с:

  • долей без облаков - доля вашей геометрии, свободная от облаков: значение от 0 до 1, где 1 означает полностью безоблачную площадь.

  • value - статистика для выбранного индекса вычисляется только на безоблачных пикселях, включает min, max, avg, mdn, var, std.

• Опционально укажите диапазоны массив диапазонов значений индекса для расчёта статистики покрытия. При указании в ответе будет поле, показывающее, какой процент площади попадает в каждый заданный диапазон. диапазоны Площадь, занимаемая каждым цветом/диапазоном

  • Площадь, занимаемая каждым цветом/диапазоном - основано на значении индекса (низкое => высокое)

  • Процент покрытия - значение 0..1 для каждого диапазона, представляющее процент поверхности

Поддерживаемые индексы

EVI2, NDVI, RVI, LAI, OSAVI, SAVI, GNDVI, IPVI, GCI, WDRVI, RCI, SBI, MCARI1. Определения индексов соответствуют каталогу индексов вегетации GeoPard, используемому во всём API.

Входные параметры

Поле	Тип	Обязательно	Примечания
индекс	Перечисление (см. выше)	✅	Индекс вегетации для вычисления.
изображений	[Provider!]!	✅	Любой из S2, L4, L5, L7, L8, L9, PS.
startDate	Строка (ISO8601)	✅	Включающее начало, например "2025-05-10T00:00:00.000Z".
endDate	Строка (ISO8601)	✅	Исключающий конец или включающий конец в зависимости от схемы; согласуйте с другими запросами GeoPard.
geojson	Строка	✅	A строковый GeoJSON типа Point / MultiPoint / Polygon / MultiPolygon (WGS84 [донг, широта]). Не забудьте экранировать кавычки внутри строки.
диапазоны	[[Float!]!]	❌	Массив [min, max] пар диапазонов значений индекса для расчёта статистики покрытия

Рекомендации по производительности

• Для геометрий Polygon/MultiPolygon держите диапазоны дат узкими (~10–15 дней) из‑за времени обработки.

• Таймаут: 30 с. Используйте меньшее количество дней и/или меньше поставщиков, если вы достигаете лимита.

• Для Point/MultiPoint большие диапазоны обычно допустимы (точки лёгкие по вычислениям).

Форма ответа

graphqlCopyEdit{
  geojson              # эхокопия вашей входной геометрии (строка)
  data: [
    {
      uuid             # идентификатор растровой сцены
      provider         # S2, L8, L9, ...
      acquisitionDate  # ISO8601
      cloudfree        # доля без облаков 0..1
      value: {
        index          # например, NDVI
        min
        max
        avg
        mdn
        var
        std
      }
      ranges: {
        value
        coverage
      }
    }
  ]
}

Пример 1: MultiPolygon с MCARI1 на S2/L8/L9 в окне 5 дней

Запросить

query GetSatelliteImageryDataByMultiPolygon {
  getSatelliteImageryDataByGeometry(
    input: {
      index: MCARI1                # установите индекс здесь
      providers: [S2, L8, L9]      # поставщики спутниковых данных
      startDate: "2025-05-10T00:00:00.000Z"  # полигоны: предпочитайте 10–15 дней; таймаут 30 с
      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 {       # статистика вычислена только по безоблачным пикселям
        индекс
        min
        max
        avg
        mdn
        var
        std
      }
    }
  }
}

Ответ

{
  "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
          }
        }
      ]
    }
  }
}

Пример 2: MultiPoint с NDVI на S2/L8/L9 за окно в 5 дней

Запросить

query GetSatelliteImageryDataByMultiPoint {
  getSatelliteImageryDataByGeometry(
    input: {
      providers: [S2, L8, L9]
      index: NDVI
      startDate: "2025-05-10T00:00:00.000Z"   # точки лёгкие по вычислениям; большие окна допустимы; таймаут 30 с
      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
      долей без облаков
      value {
        индекс
        min
        max
        avg
        mdn
        var
        std
      }
    }
  }
}

Ответ

{
  "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
          }
        }
      ]
    }
  }
}

Пример 3: MultiPolygon с NDVI на S2/L8/L9 с диапазонами в окне 5 дней

Запросить

query GetSatelliteImageryDataByMultiPolygon {
  getSatelliteImageryDataByGeometry(
    input: {
      index: NDVI                # установите индекс здесь
      providers: [S2, L8, L9]      # поставщики спутниковых данных
      startDate: "2025-05-10T00:00:00.000Z"  # полигоны: предпочитайте 10–15 дней; таймаут 30 с
      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 {       # статистика вычислена только по безоблачным пикселям
        индекс
        min
        max
        avg
        mdn
        var
        std
      }
      ranges {
        value
        coverage   # 0..1
      }
    }
  }
}

Ответ

{
  "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 }
          ]
        }
      ]
    }
  }
}