Download Cog
Download the Cloud-Optimized GeoTIFF for a raster dataset.
On S3 storage with presigned downloads enabled, answers 302 to a short-lived presigned URL (at most 5 minutes, and never past the expiry of a ?token= download token); otherwise streams the object with Content-Type image/tiff. Even then, a GET carrying If-Match, or a resume whose If-Range no longer matches, is streamed. A COG imported by reference redirects to its origin. Accepts standard auth or ?token= JWT query parameter for browser downloads.
user may be None when a no-sub anonymous download token (issued by POST /auth/download-token/{id} for a public dataset) is presented on ?token=. The function branches on user-None to enforce public visibility and emit the audit row with user_id=NULL.
Request
- The document declares no server URL.
- Auth: one of:
- none
- OAuth 2 (password, token URL /api/auth/login)
- API key in header X-Api-Key
- API key in query parameter api_key
Path parameters
Response
The whole COG file
Changes
No recorded changes to this operation across all 50 revisions of this API.