Comprendere il rilevamento dei dispositivi di protezione individuale API - Amazon Rekognition
Fornire un'immagineComprendere la DetectProtectiveEquipment risposta

Le traduzioni sono generate tramite traduzione automatica. In caso di conflitto tra il contenuto di una traduzione e la versione originale in Inglese, quest'ultima prevarrà.

Comprendere il rilevamento dei dispositivi di protezione individuale API

Le seguenti informazioni descrivono il DetectProtectiveEquipmentAPI. Per il codice di esempio, consulta Rilevamento dei dispositivi di protezione individuale in un immagine.

Fornire un'immagine

Puoi fornire l'immagine (JPGo il PNG formato) di input come byte di immagine o fare riferimento a un'immagine archiviata in un bucket Amazon S3.

Si consiglia di utilizzare immagini in cui il viso della persona è rivolto verso la fotocamera.

Se l'immagine in ingresso non è ruotata di 0 gradi, consigliamo di ruotarla di 0 gradi prima di inviarla a DetectProtectiveEquipment. Le immagini in JPG formato potrebbero contenere informazioni di orientamento nei metadati Exif (Exchangeable Image File Format). È possibile utilizzare queste informazioni per scrivere un codice che ruoti l'immagine. Per ulteriori informazioni, consulta Exif versione 2.32. PNGle immagini in formato non contengono informazioni sull'orientamento dell'immagine.

Per trasferire un'immagine da un bucket Amazon S3, usa un utente con almeno i privilegi AmazonS3. ReadOnlyAccess Usa un utente con privilegi AmazonRekognitionFullAccess per chiamare DetectProtectiveEquipment.

Nell'input di esempio seguenteJSON, l'immagine viene passata in un bucket Amazon S3. Per ulteriori informazioni, consulta Lavorare con le immagini. L'esempio richiede un riepilogo di tutti i PPE tipi (copricapo, copricapo e mascherina) con una confidenza di rilevamento minima (MinConfidence) dell'80%. È necessario specificare un valore MinConfidence compreso tra il 50 e il 100%, in quanto DetectProtectiveEquipment restituisce previsioni solo quando la confidenza del rilevamento è compresa tra il 50% e il 100%. Se si specifica un valore inferiore al 50%, i risultati sono gli stessi specificando un valore del 50%. Per ulteriori informazioni, consulta Specificazione dei requisiti di riepilogo. 

{
    "Image": {
        "S3Object": {
            "Bucket": "bucket",
            "Name": "worker.jpg"
        }
    },
    "SummarizationAttributes": {
        "MinConfidence": 80,
        "RequiredEquipmentTypes": [
            "FACE_COVER",
            "HAND_COVER",
            "HEAD_COVER"
        ]
    }
}

Se hai un'ampia raccolta di immagini da elaborare, valuta la possibilità di utilizzare AWSBatch per elaborare le chiamate DetectProtectiveEquipment in batch in background.

Specificazione dei requisiti di riepilogo

Facoltativamente, puoi utilizzare il parametro di input SummarizationAttributes (ProtectiveEquipmentSummarizationAttributes) per richiedere informazioni di riepilogo sui tipi di dati PPE rilevati in un'immagine.

Per specificare i tipi di elementi PPE da riepilogare, utilizzate il campo RequiredEquipmentTypes array. Nell'array, includete uno o più di FACE_COVER, HAND_COVER o HEAD_COVER.

Utilizzate il campo MinConfidence per specificare una confidenza minima di rilevamento (50-100). Il riepilogo non include le persone, le parti del corpo, le parti del corpo coperte e gli elementi rilevati con un grado di PPE confidenza inferiore aMinConfidence.

Per informazioni sulla risposta di riepilogo da DetectProtectiveEquipment, consulta Comprendere la DetectProtectiveEquipment risposta.

Comprendere la DetectProtectiveEquipment risposta

DetectProtectiveEquipment restituisce un array di persone rilevate nell'immagine di input. Per ogni persona, vengono restituite informazioni sulle parti del corpo rilevate e sugli oggetti rilevati. PPE L'JSONimmagine seguente di un lavoratore che indossa un copricapo, un copricapo e un copricapo è la seguente.

Operaio edile che indossa camicia a quadretti, elmetto e mascherina facciale con in mano un utensile elettrico. Le caselle verdi evidenziano viso, elmetto, mano guantata e strumento.

NelJSON, nota quanto segue.

  • Persone rilevate: Persons è una serie di persone rilevate nell'immagine (incluse le persone che non indossanoPPE). DetectProtectiveEquipmentè PPE in grado di rilevare fino a 15 persone rilevate in un'immagine. Ogni ProtectiveEquipmentPersonoggetto dell'array contiene un ID personale, un riquadro di delimitazione per la persona, le parti del corpo rilevate e gli elementi rilevati diPPE. Il valore di Confidence in ProtectiveEquipmentPerson indica la percentuale di fiducia di Amazon Rekognition che il riquadro di delimitazione contenga una persona.

  • Parti del corpo: BodyParts è una serie di parti del corpo (ProtectiveEquipmentBodyPart) rilevate su una persona (comprese le parti del corpo non coperte daPPE). Ciascuna ProtectiveEquipmentBodyPart include il nome (Name) della parte del corpo rilevata. DetectProtectEquipment è in grado di rilevare parti del corpo del volto, della testa, della mano sinistra e della mano destra. Il campo Confidence in ProtectiveEquipmentBodyPart indica la percentuale di confidenza di Amazon Rekognition nella precisione di rilevamento della parte del corpo.

  • PPEElementi: la matrice EquipmentDetections di un ProtectiveEquipmentBodyPart oggetto contiene una serie di PPE elementi rilevati. Ogni EquipmentDetectionoggetto contiene i seguenti campi.

    • Type— Il tipo di oggetto rilevatoPPE.

    • BoundingBox— un riquadro di delimitazione attorno a quello rilevatoPPE.

    • Confidence— La fiducia di Amazon Rekognition che il bounding box contenga quanto rilevato. PPE

    • CoversBodyPart— Indica se la sostanza rilevata PPE si trova sulla parte del corpo corrispondente.

    Il CoversBodyPartcampo Value è un valore booleano che indica se la parte del corpo rilevata PPE si trova sulla parte del corpo corrispondente. Il campo Confidence indica la fiducia nella previsione. È possibile CoversBodyPart utilizzarlo per filtrare i casi in cui il rilevato PPE si trova nell'immagine, ma non effettivamente sulla persona.

    Nota

    CoversBodyPart non indica o implica che la persona sia adeguatamente protetta dall'equipaggiamento protettivo o che l'equipaggiamento protettivo stesso sia indossato correttamente.

  • Informazioni di riepilogo – Summary contiene le informazioni di riepilogo specificate nel parametro SummarizationAttributes di input. Per ulteriori informazioni, consulta Specificazione dei requisiti di riepilogo.

    Summaryè un oggetto di tipo ProtectiveEquipmentSummaryche contiene le seguenti informazioni.

    • PersonsWithRequiredEquipment— Una serie IDs di persone in cui ogni persona soddisfa i seguenti criteri.

      • La persona indossa tutto ciò che è PPE specificato nel parametro SummarizationAttributes di input.

      • La Confidence per la persona (ProtectiveEquipmentPerson), parte del corpo (ProtectiveEquipmentBodyPart), equipaggiamento protettivo (EquipmentDetection) è uguale o superiore alla soglia minima di confidenza specificata (MinConfidence).

      • Il valore di CoversBodyPart for all items of PPE è true.

    • PersonsWithoutRequiredEquipment— Una serie IDs di persone che soddisfano uno dei seguenti criteri.

      • I Confidence valori relativi alla copertura della persona (ProtectiveEquipmentPerson), della parte del corpo (ProtectiveEquipmentBodyPart) e della parte del corpo (CoversBodyPart) sono superiori alla soglia di confidenza minima specificata (MinConfidence), ma alla persona mancano uno o più dati specificati PPE (SummarizationAttributes).

      • Il valore di CoversBodyPart è false per qualsiasi valore specificato PPE (SummarizationAttributes) che ha un Confidence valore maggiore della soglia di confidenza minima specificata (MinConfidence). La persona possiede anche tutti i valori specificati PPE (SummarizationAttributes) e i Confidence valori per persona (ProtectiveEquipmentPerson), parte del corpo (ProtectiveEquipmentBodyPart) e equipaggiamento protettivo (EquipmentDetection) sono maggiori o uguali alla soglia minima di confidenza (MinConfidence.

    • PersonsIndeterminate— Una serie IDs di persone rilevate in cui il Confidence valore della persona (ProtectiveEquipmentPerson), della parte del corpo (), dell'equipaggiamento protettivo (EquipmentDetection) o del valore CoversBodyPart booleano è inferiore alla soglia di confidenza minima specificata (MinConfidence). ProtectiveEquipmentBodyPart

    Utilizzate la dimensione dell'array per ottenere un conteggio per un particolare riepilogo. Ad esempio, la taglia di PersonsWithRequiredEquipment indica il numero di persone rilevate che indossano il tipo specificato di. PPE

    Puoi utilizzare l'ID della persona per scoprire ulteriori informazioni su una persona, come la posizione del riquadro di delimitazione della persona. L'ID della persona viene mappato al campo ID di un oggetto restituito (ProtectiveEquipmentPerson) in Persons (array diProtectiveEquipmentPerson). È quindi possibile ottenere il riquadro di delimitazione e altre informazioni dall'oggetto ProtectiveEquipmentPerson corrispondente. 


 {
    "ProtectiveEquipmentModelVersion": "1.0",
    "Persons": [
        {
            "BodyParts": [
                {
                    "Name": "FACE",
                    "Confidence": 99.99861145019531,
                    "EquipmentDetections": [
                        {
                            "BoundingBox": {
                                "Width": 0.14528800547122955,
                                "Height": 0.14956723153591156,
                                "Left": 0.4363413453102112,
                                "Top": 0.34203192591667175
                            },
                            "Confidence": 99.90001678466797,
                            "Type": "FACE_COVER",
                            "CoversBodyPart": {
                                "Confidence": 98.0676498413086,
                                "Value": true
                            }
                        }
                    ]
                },
                {
                    "Name": "LEFT_HAND",
                    "Confidence": 96.9786376953125,
                    "EquipmentDetections": [
                        {
                            "BoundingBox": {
                                "Width": 0.14495663344860077,
                                "Height": 0.12936046719551086,
                                "Left": 0.5114737153053284,
                                "Top": 0.5744519829750061
                            },
                            "Confidence": 83.72270965576172,
                            "Type": "HAND_COVER",
                            "CoversBodyPart": {
                                "Confidence": 96.9288558959961,
                                "Value": true
                            }
                        }
                    ]
                },
                {
                    "Name": "RIGHT_HAND",
                    "Confidence": 99.82939147949219,
                    "EquipmentDetections": [
                        {
                            "BoundingBox": {
                                "Width": 0.20971858501434326,
                                "Height": 0.20528452098369598,
                                "Left": 0.2711356580257416,
                                "Top": 0.6750612258911133
                            },
                            "Confidence": 95.70789337158203,
                            "Type": "HAND_COVER",
                            "CoversBodyPart": {
                                "Confidence": 99.85433197021484,
                                "Value": true
                            }
                        }
                    ]
                },
                {
                    "Name": "HEAD",
                    "Confidence": 99.9999008178711,
                    "EquipmentDetections": [
                        {
                            "BoundingBox": {
                                "Width": 0.24350935220718384,
                                "Height": 0.34623199701309204,
                                "Left": 0.43011072278022766,
                                "Top": 0.01103297434747219
                            },
                            "Confidence": 83.88762664794922,
                            "Type": "HEAD_COVER",
                            "CoversBodyPart": {
                                "Confidence": 99.96485900878906,
                                "Value": true
                            }
                        }
                    ]
                }
            ],
            "BoundingBox": {
                "Width": 0.7403100728988647,
                "Height": 0.9412225484848022,
                "Left": 0.02214839495718479,
                "Top": 0.03134796395897865
            },
            "Confidence": 99.98855590820312,
            "Id": 0
        }
    ],
    "Summary": {
        "PersonsWithRequiredEquipment": [
            0
        ],
        "PersonsWithoutRequiredEquipment": [],
        "PersonsIndeterminate": []
    }
}