Tiler Previews - Get Format

Riferimento

Servizio:: Planetary Computer

Versione API:: 2025-04-30-preview

Creare un'anteprima di un set di dati.

GET https://contoso-catalog.gwhqfdeddydpareu.uksouth.geocatalog.spatio.azure.com/data/collections/{collectionId}/items/{itemId}/preview.{format}?api-version=2025-04-30-preview

Con parametri facoltativi:

GET https://contoso-catalog.gwhqfdeddydpareu.uksouth.geocatalog.spatio.azure.com/data/collections/{collectionId}/items/{itemId}/preview.{format}?api-version=2025-04-30-preview&assets={assets}&expression={expression}&assetBidx={assetBidx}&asset_as_band={asset_as_band}&nodata={nodata}&unscale={unscale}&algorithm={algorithm}&algorithm_params={algorithm_params}&color_formula={color_formula}&dst-crs={dst-crs}&resampling={resampling}&max_size={max_size}&height={height}&width={width}&rescale={rescale}&colormap_name={colormap_name}&colormap={colormap}&return_mask={return_mask}

Parametri dell'URI

Nome	In	Necessario	Tipo	Descrizione
collectionId	path	True	string maxLength: 500 pattern: .*	Identificatore della collezione STAC
format	path	True	string maxLength: 500 pattern: .*	Formato di output per il riquadro o l'immagine (ad esempio, png, jpeg, webp).
itemId	path	True	string maxLength: 500 pattern: .*	Identificatore dell'elemento STAC
api-version	query	True	string minLength: 1	Versione dell'API da usare per questa operazione.
algorithm	query		Algorithm	Nome algoritmo
algorithm_params	query		string	Parametro dell'algoritmo
asset_as_band	query		boolean	Asset come banda
assetBidx	query		string[]	Indici per fascia di attività (indici separati dal coma)
assets	query		string[]	Nomi dei beni.
color_formula	query		string	formula rio-color (info: https://github.com/mapbox/rio-color)
colormap	query		string	Mappa dei colori personalizzata con codifica JSON
colormap_name	query		ColorMapNames	Nome della mappa dei colori
dst-crs	query		string	Sistema di riferimento delle coordinate di output.
expression	query		string	Espressione matematica a bande tra asset
height	query		integer (int32)	Altezza in pixel per l'immagine di output
max_size	query		integer (int32)	Limite delle dimensioni di output dell'immagine se i limiti di larghezza e altezza non sono impostati.
nodata	query		number (float)	Sovrascrivi il valore Nodata interno
resampling	query		Resampling	Metodo di ricampionamento.
rescale	query		string[]	virgola (',') delimitata dall'intervallo Min,Max. Può impostare più volte per più bande.
return_mask	query		boolean	Aggiungere una maschera ai dati di output.
unscale	query		boolean	Applica scala interna o offset
width	query		integer (int32)	Larghezza in pixel per l'immagine di output

Risposte

Nome	Tipo	Descrizione
200 OK	file	Restituisci un'immagine. Media Types: "image/png", "image/jpeg", "image/jpg", "image/webp", "image/jp2", "image/tiff; application=geotiff", "application/x-binary", "application/json"
Other Status Codes	Azure.Core.Foundations.ErrorResponse	Risposta di errore imprevista. Media Types: "image/png", "image/jpeg", "image/jpg", "image/webp", "image/jp2", "image/tiff; application=geotiff", "application/x-binary", "application/json" Intestazioni x-ms-error-code: string

Nome

Tipo

Descrizione

200 OK

file

Restituisci un'immagine.

Media Types: "image/png", "image/jpeg", "image/jpg", "image/webp", "image/jp2", "image/tiff; application=geotiff", "application/x-binary", "application/json"

Other Status Codes

Azure.Core.Foundations.ErrorResponse

Risposta di errore imprevista.

Media Types: "image/png", "image/jpeg", "image/jpg", "image/webp", "image/jp2", "image/tiff; application=geotiff", "application/x-binary", "application/json"

Intestazioni

x-ms-error-code: string

Sicurezza

OAuth2Auth

Tipo: oauth2
Flow: implicit
URL di autorizzazione: https://login.microsoftonline.com/common/oauth2/authorize

Ambiti

Nome	Descrizione
https://geocatalog.spatio.azure.com/.default

Esempio