Preview data

View low-resolution previews before placing an order.


Overview

Some data hosts provide free, low-resolution images of data that you can view before placing an order:

  • Quicklooks are previews of full scenes on a basemap.
  • Thumbnails are small, light-weighted previews of full scenes. For some data hosts, thumbnails can be cropped and rotated compared to quicklooks.

Not all data hosts provide thumbnails or quicklooks.

See a quicklook

To see a quicklook of a full scene from the catalog, call the /catalog/{host_name}/image/{image_id}/quicklook endpoint with the host name and image ID as path parameters.

Request

GET /catalog/{host_name}/image/{image_id}/quicklook HTTP/1.1
Host: api.up42.com
Authorization: Bearer {token}

Response

If a quicklook is available, the response is an image file. Otherwise, the response is null.

See a thumbnail

To see a thumbnail of a full scene from the catalog, call the /catalog/{host_name}/image/{image_id}/thumbnail endpoint with the host name and image ID as path parameters.

Request

GET /catalog/{host_name}/image/{image_id}/thumbnail HTTP/1.1
Host: api.up42.com
Authorization: Bearer {token}

Response

If a quicklook is available, the response is an image file. Otherwise, the response is null.