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.