Ottieni i metadati dell'immagine in n8n

Cosa fa questo nodo

PDF4me - Ottieni i metadati dell'immagine legge le proprietà tecniche di qualsiasi immagine nel tuo n8n flusso di lavoro e li restituisce come dati strutturati: formato, larghezza, altezza, DPI, bit per pixel, orientamento e EXIF dati della fotocamera quando presenti. Utilizzare l'output per controllare la qualità dell'immagine, registrare le proprietà delle risorse in un database, instradare le immagini di grandi dimensioni a una fase di ridimensionamento o convalidare che le foto caricate soddisfino le specifiche di pubblicazione prima di memorizzarle. Accetta dati binari, Base64 corde o pubblico URLS.

Articoli correlati del blog

Non ci sono ancora post sul blog dedicati a questa funzionalità — in arrivo a breve.

Nel frattempo, dai un'occhiata al blog di PDF4me per trovare tutorial e procedure operative su tutte le piattaforme.

Visita il blog →

Autenticazione del tuo API Richiesta

Ogni PDF4me nodo in n8n richiede valido Credenziali. Crea o seleziona le credenziali che contengono il tuo PDF4me API chiave affinché il nodo possa autenticare in modo sicuro le richieste di analisi delle immagini.

Get your API Key

Informazioni importanti da non perdere

Il tipo di immagine deve corrispondere al formato effettivo

Imposta il tipo di immagine su JPEG, PNG, GIF o BMP per corrispondere al formato effettivo dell'immagine fornita. Una mancata corrispondenza tra il valore del tipo di immagine e il formato reale può causare la restituzione di un errore o di metadati errati da parte del nodo. Se non si è sicuri del formato, controllare l'estensione del file o MIME tipo dal nodo precedente prima di impostare questo parametro.

hasExifData ti dice se exifData è sicuro da usare

Il campo exifData è nullo quando l'immagine non ha dati incorporati EXIF metadati - comuni per immagini generate programmaticamente, screenshot e grafica esportata. Controlla sempre prima il booleano hasExifData prima di mappare i campi exifData nei nodi a valle. Il tentativo di accedere ai sottocampi di un oggetto nullo causerà l'errore. n8n esecuzione fallita.

La risoluzione è espressa in DPI, non in pixel.

I valori di horizontalResolution e verticalResolution vengono espressi in punti per pollice (DPI), non in pixel. Un'immagine web tipica ha una risoluzione di 72 o 96 DPI. Un'immagine di qualità per la stampa dovrebbe avere una risoluzione di almeno 300 DPI. Utilizza questi campi per filtrare le immagini nei flussi di lavoro di controllo qualità, ad esempio per rifiutare le immagini con una risoluzione inferiore a 200 DPI destinate alla pubblicazione su carta e indirizzarle a una richiesta di ricaricamento.

Imposta il tipo di dati di input e il tipo di immagine in modo che corrispondano alla sorgente dell'immagine, inserisci il nome del file di output con estensione .json ed esegui. Tutti i campi dei metadati saranno disponibili nell'output del nodo.

Parametri

Necessario: Tipo di dati di input, il campo sorgente dell'immagine corrispondente a quel tipo (Campo binario di input, Base64 Contenuto dell'immagine o Immagine URL), Nome del file di output e Tipo di immagine. Async è facoltativo.

Parametro	Necessario	Cosa fa	Esempio
Input Data Type	Yes	Format of the source image. Choose Binary Data to map from a prior node, Base64 String for encoded image data, or URL for a publicly accessible image file.	Binary Data
Input Binary Field	Yes (Binary Data)	The binary property name from the prior node holding the image. Must match the binary output key of the upstream node.	data
Base64 Image Content	Yes (Base64)	Base64-encoded image string. JPEG, PNG, GIF, and BMP all accepted.	/9j/4AAQS...
Image URL	Yes (URL)	Publicly accessible HTTPS URL to the image. PDF4me fetches it and returns the metadata.	https://example.com/photo.png
Output File Name	Yes	Filename for the metadata output. Use .json extension. This names the binary output item in n8n.	image_metadata.json
Image Type	Yes	Actual format of the source image. Must match the real format - JPEG, PNG, GIF, or BMP.	PNG
Async	No	When true, runs asynchronously and returns immediately for large image files. Results must be handled via polling or callback.	false

Campi di output

Campo	Tipo	Cosa contiene
imageFormat	String	Detected format of the image - Jpeg, Png, Gif, or Bmp.
fileSize	Number	Size of the original image in bytes.
width	Number	Image width in pixels.
height	Number	Image height in pixels.
orientation	String | null	Portrait, Landscape, Square, or null if not encoded in the image.
bitsperPixel	Number	Color depth. 32 is typical for PNG with alpha; 24 for standard JPEG.
horizontalResolution	Number	Horizontal resolution in DPI. 96 = web, 300 = print quality.
verticalResolution	Number	Vertical resolution in DPI.
hasExifData	Boolean	True if the image contains embedded EXIF metadata. Always check this before using exifData.
exifData	Object | null	Camera settings, GPS coordinates, timestamps, and other EXIF fields. Null when hasExifData is false.
hasXmpData	Boolean	True if the image contains Adobe XMP metadata.
_metadata	Object	Processing summary - success status, message, timestamp, and operation name.

Configurazione rapida

1. Aggiungi un PDF4me nodo e seleziona Ottieni i metadati dell'immagine.
2. Scegli o crea Credenziali con il tuo PDF4me API chiave.
3. Impostato Tipo di dati di input e mappare la sorgente dell'immagine (binaria, Base64, O URL).
4. Impostato Tipo di immagine per corrispondere al formato effettivo della tua immagine.
5. Inserisci Nome del file di output con .json estensione e clic Esegui nodoMappa width, height, horizontalResolution, E hasExifData nei nodi a valle.

Esempi di flusso di lavoro

Esempi di flusso di lavoroCommon n8n workflow patterns using Get Image Metadata.

Lavori di stampa Gate in base alla risoluzione dell'immagine

1. L'invio di un modulo si attiva quando un designer carica un'immagine per la produzione di stampa.
2. La funzione Get Image Metadata legge i valori di horizontalResolution e verticalResolution dal file caricato.
3. Un nodo IF verifica se entrambi i valori sono pari o superiori a 300 DPI.
4. Le immagini che superano il controllo qualità vengono aggiunte alla coda di stampa in Airtable. Le immagini che non superano il controllo qualità generano un messaggio su Slack che chiede al grafico di ricaricarle a una risoluzione più elevata.

Catalogare le risorse digitali con metadati completi in un database

1. La funzione "Cartella di monitoraggio" di Dropbox si attiva quando una nuova immagine viene aggiunta alla cartella "Acquisizione risorse".
2. Get Image Metadata estrae tutte le proprietà, tra cui EXIF dati della telecamera, se presenti.
3. Un nodo Postgres o Airtable scrive una nuova riga con il nome del file, le dimensioni, il formato, i DPI e EXIF data di acquisizione nel catalogo delle risorse.
4. La risorsa viene spostata nella cartella "Catalogata" e un messaggio Slack conferma la nuova voce.

Indirizzare le immagini di grandi dimensioni a una fase di ridimensionamento prima della pubblicazione.

1. UN HTTP Il webhook riceve le immagini dei prodotti da un modulo di caricamento di un sito di e-commerce.
2. La funzione Get Image Metadata restituisce la larghezza e l'altezza di ciascuna immagine.
3. Un nodo IF instrada le immagini con larghezza superiore a 4000 pixel a una fase di compressione o ridimensionamento dell'immagine prima dell'archiviazione.
4. Le immagini con le dimensioni corrette saltano la fase di ridimensionamento e vengono caricate direttamente sulla CDN del prodotto.

Domande frequenti

What metadata does this node return exactly?+

The node returns imageFormat (Jpeg/Png/Gif/Bmp), fileSize in bytes, width and height in pixels, orientation (Portrait/Landscape/Square/null), bitsperPixel (color depth), horizontalResolution and verticalResolution in DPI, hasExifData boolean, exifData object (camera make/model, GPS, timestamps - or null if absent), hasXmpData boolean, and a _metadata processing summary. All fields are available as individual mapped outputs in downstream n8n nodes.

Why do I need to set Image Type separately if PDF4me can detect the format?+

Image Type tells the PDF4me API which decoder to use for the initial parse, which improves accuracy and speed - especially for edge cases where file headers are incomplete or the binary is embedded in a Base64 string with no MIME type context. The imageFormat output field then confirms the actual detected format after processing.

How do I check if EXIF data is present before using it?+

Map the hasExifData output into an IF node condition. When hasExifData is true, route to a branch that maps exifData sub-fields (such as exifData.DateTimeOriginal or exifData.GPSLatitude). When false, skip that branch or substitute a default value. Attempting to access a property on a null exifData object will fail the n8n execution.

Can I use a public image URL instead of uploading the binary?+

Yes. Set Input Data Type to URL and enter the full HTTPS address of the image in the Image URL field. PDF4me fetches the image directly from that URL and returns the metadata. The URL must be publicly accessible - authenticated or private storage URLs will not work unless you generate a signed/pre-signed URL first.

How do I use this node to validate images before storing them?+

Add Get Image Metadata immediately after the upload trigger. Map width, height, horizontalResolution, and fileSize into IF node conditions that check your publishing requirements - for example width >= 800 AND horizontalResolution >= 72 AND fileSize <= 5000000. Images that pass all conditions proceed to storage; those that fail are rejected with a notification to the uploader. This creates a fully automated image quality gate with zero manual review.

Nodi correlati

Capovolgi l'immagine

Rifletti un'immagine orizzontalmente, verticalmente o in entrambe le direzioni: utilizza questa funzione dopo aver letto i metadati per correggere i problemi di orientamento rilevati nell'analisi.

Comprimi l'immagine

Riduci le dimensioni del file immagine se i metadati indicano che l'immagine supera i limiti di spazio di archiviazione o di larghezza di banda disponibili, prima di caricarla sul cloud.

Converti formato immagine

Converti l'immagine in un formato diverso quando il formato immagine rilevato non corrisponde al formato richiesto da un flusso successivo API o sistema di pubblicazione.

Richiedi assistenza

n8n IntegrationGet your API Keyn8n Documentation