# 17. Satelliittikuva: rajattu pellon rajan mukaan ja mukautettu väriskaala

Satelliittikuva, tarkasti määriteltyjen lohkorajojen mukaan rajattu, on saatavilla erilaisille näkymille, kuten `RGB`, `NIR`, `EVI2`, `LAI`, `NDVI`, `GNDVI`, `IPVI`, `GCI`, `SAVI`, `OSAVI`, `NDWI`, `WDRVI`, `NDMI`, `MCARI`, ym. mukaan lukien siihen liittyvät kontrastiesitykset. Tuotetut satelliittikuvat eivät ole pikselöityneitä ja tarjoavat selkeän visualisoinnin tiedoista.

Tämän tarkan rajauksen lisäksi GeoPard mahdollistaa väriskaalojen mukauttamisen. Tätä ominaisuutta voidaan soveltaa sekä **rajattuihin** ja **kontrastiin** kasvillisuusindeksien esityksiin, tarjoten lisämuokattavuutta datan visualisointiin.

{% hint style="info" %}
Esimerkiksi uusi väriskaala voidaan soveltaa suoraan laajentamalla `env` muuttujaa arvolla `c1:%231b7837%3Bc2:%23ffffbf%3Bc3:%23af8dc3`. Tässä arvossa `%23` edustaa `#` merkkiä, ja `%3b` tarkoittaa `;` merkkiä.
{% endhint %}

Useita esimerkkejä on annettu havainnollistamaan väriskaalojen muokkausta sekä **rajattuihin** ja **kontrastiin** NDVI-näkymille, mikä osoittaa värisäätöominaisuuksiemme joustavuutta.

{% hint style="info" %}
Korjauskerroin `url-osoitteet` alla annettuja on tarkoitettu ainoastaan selittävään käyttöön. \
\
Tarkkaa ja operatiivista käyttöä varten `url-osoitteet` tulisi hakea `geoMaps` objektista. Niitä voidaan muokata käyttämällä tiettyjä attribuutteja, mikä tarjoaa lisää joustavuutta paikkatietojen hallintaan.
{% endhint %}

### NDVI: kontrasti VS kontrasti korjatulla väriskaalalla

![](/files/1967e4a2e63f92f8cbc8f401223a014cd11db002)   **VS**   ![](/files/14d200dd0908ba84eb82c16c2205b79bf3f33a18)

Pyyntömuoto on [https://api.geopard.tech/geo/map/reflect?TRANSPARENT=true\&SRS=EPSG:900913\&HEIGHT=1024\&BBOX=\<minX,minY,maxX,maxY>\&TIME=2022-07-20T10:15:26Z\&CQL\_FILTER=uuid=%27\<planet\_image\_uuid>%27\&VIEWPARAMS=uuid:\<field\_uuid>\&env=v1:0.740%3Bv2:0.835%3Bv3:0.904%3Bc1:%23af8dc3%3Bc2:%23ffffbf%3Bc3:%231b7837\&LAYERS=agri:planetscope\_ndvi\_and\_field\&geopardApiKey=\<geopardApiKey>](https://api.geopard.tech/geo/map/reflect?TRANSPARENT=true\&SRS=EPSG:900913\&HEIGHT=1024\&BBOX=<minX,minY,maxX,maxY>\&TIME=2022-07-20T10:15:26Z\&CQL_FILTER=uuid=%27<planet_image_uuid>%27\&VIEWPARAMS=uuid:<field_uuid>\&env=v1:0.740%3Bv2:0.835%3Bv3:0.904%3Bc1:%23af8dc3%3Bc2:%23ffffbf%3Bc3:%231b7837\&LAYERS=agri:planetscope_ndvi_and_field\&geopardApiKey=<geopardApiKey>).&#x20;

### NDVI: alkuperäinen VS alkuperäinen korjatulla väriskaalalla

![](/files/05bcdeff97cd99f9c6c512b9e1a618baf6f54a13)   **VS**   ![](/files/fbd4bcc18c08db92dbe14449be3331fb763032bb)

Pyyntömuoto on [https://api.geopard.tech/geo/map/reflect?TRANSPARENT=true\&SRS=EPSG:900913\&HEIGHT=1024\&BBOX=\<minX,minY,maxX,maxY>\&TIME=2022-07-20T10:15:26Z\&CQL\_FILTER=uuid=%27\<planet\_image\_uuid>%27\&VIEWPARAMS=uuid:\<field\_uuid>\&LAYERS=agri:planetscope\_ndvi\_and\_field\&env=c1:%23008837%3Bc2:%23a6dba0%3Bc3:%23f7f7f7%3Bc4:%23c2a5cf%3Bc5:%237b3294\&geopardApiKey=\<geopardApiKey>](https://api.geopard.tech/geo/map/reflect?TRANSPARENT=true\&SRS=EPSG:900913\&HEIGHT=1024\&BBOX=<minX,minY,maxX,maxY>\&TIME=2022-07-20T10:15:26Z\&CQL_FILTER=uuid=%27<planet_image_uuid>%27\&VIEWPARAMS=uuid:<field_uuid>\&LAYERS=agri:planetscope_ndvi_and_field\&env=c1:%23008837%3Bc2:%23a6dba0%3Bc3:%23f7f7f7%3Bc4:%23c2a5cf%3Bc5:%237b3294\&geopardApiKey=<geopardApiKey>).

### Selitys URL-parametreista

Missä syöttöattribuutit ovat:

1. `VIEWPARAMS=uuid:<field_uuid>` sisältää "Lohko"-kohteen uuid:n;
2. `CQL_FILTER=uuid=%27<planet_image_uuid>%27` sisältää Planetin toimittaman satelliittikuvan uuid:n, tätä parametria ei tarvita Sentinel2- ja Landsat-toimittajille;
3. `TIME=2022-07-20T10:15:26Z` on satelliittikuvan päivämäärä muodossa `YYYY-MM-DDThh:mm:ssZ` (url-koodattuna) ja sijaitsee "FieldSatelliteImagery"-entiteetissä attribuutilla `acquisitionDate` ;
4. `BBOX=<minX,minY,maxX,maxY>` sisältää lohkon reunarajoitetun laatikon (url-koodattuna) muodossa `EPSG:3857` tai `EPSG:900913` projektio;
5. `WIDTH=1024`  ilmentää tuotetun kuvan kokoa pikseleinä (tarkka luku on tärkeä vain jos sitä käytetään pikkukuvana);
6. `geopardApiKey=<geopard_api_key>` on liitetty valtuutusvaihtoehtoon API-avaimen kautta;
7. `LAYERS=agri:planetscope_ndvi_and_field` ilmentää Planetin toimittaman satelliittikuvan tyyliä; tämä parametri riippuu toimittajasta, kuten Sentinel2 ja Landsat.

<br>


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.geopard.tech/geopard-tutorials/fin/api-dokumentaatio/paikkatietodatan-geo-paatepisteet/wms-hae-paikkatietokerrosten-rasterikuvia/17.-satelliittikuva-rajattu-pellon-rajan-mukaan-ja-mukautettu-variskaala.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.