# 90. Užklausa: gauti palydovinių vaizdų duomenis pagal geometriją Gaukite vegetacijos indekso statistikas bet kuriai ad hoc geometrijai - **nereikia registruotos lauko ribos**. Šis galinis taškas apskaičiuoja santraukines statistikas pikseliams jūsų geometrijoje, tuo tarpu **ignoruodamas debesuotus pikselius**. Šiuo metu palaikoma: **Sentinel2 (S2)** , **Landsat (L4/L5/L7/L8/L9)** ir **Planet (PS)** tiekėjai. {% hint style="danger" %} Šis puslapis atitinka GeoPard API šablonus ir [autentifikavimą](https://docs.geopard.tech/geopard-tutorials/api-docs/authorization-apikey-credentials-or-oauth-2.0) naudojamą GraphQL galiniuose taškuose. {% endhint %} ## Ką galite daryti * Užklausa **vegetacijos indeksai** skirti **Point, MultiPoint, Polygon ir MultiPolygon** geometrijos. * Pasirinkite vaizdus **tiekėjus**: `S2`, `L4`, `L5`, `L7`, `L8`, `L9`, `PS`. * Gauti **su datos žyma** rezultatus už kiekvieną įsigijimą su: * `be debesų` - frakcija jūsų geometrijos, kuri yra be debesų, reikšmė nuo 0 iki 1, kur 1 reiškia visiškai be debesų. * `reikšmė` - statistika pasirinktam indeksui apskaičiuota **tik** ant be debesų pikselių, įskaitant `min`, `max`, `avg`, `mdn`, `var`, `std`. * Papildomai pateikite **intervalus** indeksų verčių intervalų masyvas, skirtas apskaičiuoti užimtumo statistikas. Kai pateikta, atsakyme bus įtraukta `intervalus` laukas, rodantis, kokia procentinė dalis ploto patenka į kiekvieną nurodytą intervalą. * **Plotas, užimtas kiekvienos spalvos/intervulo** - pagal indekso reikšmę (nuo mažos iki didelės) * **Užimtumo procentas** - 0..1 reikšmė už intervalą, atspindinti paviršiaus procentą ## Palaikomi indeksai `EVI2`, `NDVI`, `RVI`, `LAI`, `OSAVI`, `SAVI`, `GNDVI`, `IPVI`, `GCI`, `WDRVI`, `RCI`, `SBI`, `MCARI1`. Indeksų apibrėžtys atitinka GeoPard [vegetacijos indeksų katalogą](https://docs.geopard.tech/geopard-tutorials/product-tour-web-app/satellite-monitoring/indices-for-crops-and-soils#vegetation-indices) naudojamą visame API. ### Įvesties parametrai
LaukasTipasReikalingaPastabos
indeksasEnum (žiūrėti aukščiau)✅Vegetacijos indeksas, kurį reikia apskaičiuoti.
tiekėjus[Provider!]!✅Bet kuris iš S2, L4, L5, L7, L8, L9, PS.
startDateString (ISO8601)✅Įtraukianti pradžia, pvz. "2025-05-10T00:00:00.000Z".
endDateString (ISO8601)✅Išskirtinė pabaiga arba įtraukta pabaiga priklausomai nuo schemos; suderinkite su kitomis GeoPard užklausomis.
geojsonString✅A išverstas į eilutę GeoJSON tipo Point / MultiPoint / Polygon / MultiPolygon (WGS84 [lon, lat]). Atminkite, kad reikia pabėgti kabutes viduje eilutės.
intervalus[[Float!]!]❌Masyvas iš [min, max] porų indekso verčių intervalų, skirtų apskaičiuoti užimtumo statistikas
## **Našumo rekomendacijos** * Poligonų/MultiPolygon geometrijoms palaikykite datos intervalus siaurus (**\~10–15 dienų**) dėl apdorojimo laiko. * **Timeoutas:** 30 s. Naudokite mažiau dienų ir (arba) mažiau tiekėjų, jei pasiekiate ribą. * Taškams/MultiPoint paprastai didesni intervalai yra tinkami (taškai yra lengvi). ## Atsakymo forma ```graphql graphqlKopijuotiRedaguoti{ geojson # atspindys jūsų įvestos geometrijos (išverstas į eilutę) data: [ { uuid # rastrinės scenos id provider # S2, L8, L9, ... acquisitionDate # ISO8601 cloudfree # 0..1 be debesų ploto frakcija value: { index # pvz., NDVI min max avg mdn var std } ranges: { reikšmė coverage } } ] } ``` ## Pavyzdys 1: MultiPolygon su MCARI1 S2/L8/L9 per 5 dienų langą ### Užklausti ```graphql užklausa GetSatelliteImageryDataByMultiPolygon { getSatelliteImageryDataByGeometry( input: { index: MCARI1 # čia nustatykite indeksą providers: [S2, L8, L9] # palydovų tiekėjai startDate: "2025-05-10T00:00:00.000Z" # poligonams: pageidautina 10–15 dienų; 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 { # statistika apskaičiuota tik ant be debesų pikselių indeksas min max avg mdn var std } } } } ``` ### Atsakymas ```json { "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 } } ] } } } ``` ## Pavyzdys 2: MultiPoint su NDVI S2/L8/L9 per 5 dienų langą ### Užklausti ```graphql užklausa GetSatelliteImageryDataByMultiPoint { getSatelliteImageryDataByGeometry( input: { providers: [S2, L8, L9] index: NDVI startDate: "2025-05-10T00:00:00.000Z" # taškai yra lengvi; didesni intervalai galimi; 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 be debesų value { indeksas min max avg mdn var std } } } } ``` ### Atsakymas ```json { "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 } } ] } } } ``` ## Pavyzdys 3: MultiPolygon su NDVI S2/L8/L9 su intervalais per 5 dienų langą ### Užklausti ```graphql užklausa GetSatelliteImageryDataByMultiPolygon { getSatelliteImageryDataByGeometry( input: { index: NDVI # čia nustatykite indeksą providers: [S2, L8, L9] # palydovų tiekėjai startDate: "2025-05-10T00:00:00.000Z" # poligonams: pageidautina 10–15 dienų; 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 { # statistika apskaičiuota tik ant be debesų pikselių indeksas min max avg mdn var std } ranges { reikšmė coverage # 0..1 } } } } ``` ### Atsakymas ```json { "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 } ] } ] } } } ```