Cropwise
powered by syngenta

REMOTE SENSING

Image Preview

Requirements:

Download processed vegetation indices and satellite data for your agricultural fields. This service provides access to pre-calculated indices like NDVI, SAVI, and custom color palettes optimized for agricultural analysis.

You can use the Image Preview endpoint to download processed index files in various formats.

How it works

The Image Preview service processes raw satellite imagery to calculate vegetation indices and applies agricultural-specific color palettes. The service uses a structured URL format: /{sub_product}/{raster_type}/{format} where you specify the vegetation index, palette type, and file format.

Available formats include PNG, JPEG, and TIFF. The service supports dynamic band expressions for custom index calculations and various raster types like falsecolor, truecolor, and other palettes.

Quick start

  1. Prerequisites: Valid authentication token and Remote Sensing contract
  2. Find your images: Use the listing endpoint to find available processed images
  3. Select index type: Choose from available vegetation indices (NDVI, SAVI, etc.)
  4. Choose raster type: Select palette type (falsecolor, truecolor)
  5. Choose format: Select download format (PNG, JPEG, TIFF)
  6. Preview data: Use the image preview endpoint to download processed files

Practical Example

First you need to list the images available for a given AOI and date range. You can do this using the Listing Images endpoint.

Then, choose the image you want to preview. For example, let's say you want to preview the NDVI subproduct of an image with ID CWOVF_s2a_20250507_36075901_6e636a68-a20f-4074-9fe2-6bb10d3b894b_4e09853a-d956-4af0-b2bc-43e6403f4b75_cff00d12-0b7c-11ee-ba77-fdbc6a6803c2__cwp_gqxfcz9tyqbr-32-367.

If you want to simply preview the image as a PNG, you can call the endpoint like this:

curl --request GET \
  --url https://api.remote-sensing.cropwise.com/images/CWOVF_s2a_20250507_36075901_6e636a68-a20f-4074-9fe2-6bb10d3b894b_4e09853a-d956-4af0-b2bc-43e6403f4b75_cff00d12-0b7c-11ee-ba77-fdbc6a6803c2__cwp_gqxfcz9tyqbr-32-367/ndvi/falsecolor/png \
  --header 'Authorization: Bearer {your_cropwise_token}'

Available vegetation indices

  • NDVI (Normalized Difference Vegetation Index): Most commonly used vegetation index for crop health monitoring
  • SAVI (Soil-Adjusted Vegetation Index): Optimal for areas with significant soil background
  • Dynamic band expressions: Create custom indices using band expressions

Common use cases

  • Precision agriculture mapping: Download NDVI data for variable rate applications
  • Visualization and reporting: Download color-coded images for presentations
  • Custom index calculations: Use dynamic band expressions for specialized analysis
  • Time series analysis: Download multiple dates for temporal analysis

Download formats

TIFF (.tiff)

  • Use case: GIS analysis, precision agriculture
  • Features: Georeferenced, preserves data values
  • Size: Larger files, best data quality

PNG (.png)

  • Use case: Visualization, reporting, web display
  • Features: Color-coded, compressed
  • Size: Smaller files, visual representation

JPEG (.jpeg)

  • Use case: Quick preview, compressed visualization
  • Features: Highly compressed, good for web display
  • Size: Smallest files, lossy compression

Quality considerations

  • Cloud coverage: Check cloud masks before downloading
  • Format selection: Choose TIFF for analysis, PNG/JPEG for visualization
  • Raster type: Select appropriate visualization for your use case
  • Data validation: Verify data quality metrics in image metadata
  • Band expressions: Test custom expressions with sample data first

Next steps

Next
Using the field classification API