Grundlegendes zur API zur Erkennung persönlicher Schutzausrüstung

Die folgenden Informationen beschreiben die DetectProtectiveEquipmentAPI. Beispielcode finden Sie unter Erkennung von persönlicher Schutzausrüstung in einem Bild.

Bereitstellung eines Bilds

Sie können das Eingabebild (JPG- oder PNG-Format) entweder als Bild-Bytes bereitstellen oder auf ein in einem Amazon-S3-Bucket gespeichertes Bild verweisen.

Wir empfehlen, Bilder zu verwenden, bei denen das Gesicht der Person zur Kamera zeigt.

Wenn Ihr Eingabebild nicht auf 0 Grad gedreht ist, empfehlen wir, es vor dem Senden an DetectProtectiveEquipment auf 0 Grad zu drehen. Bilder im JPG-Format können Ausrichtungsinformationen in den Metadaten des Exchangeable Image File Format (Exif) enthalten. Sie können diese Informationen verwenden, um einen Code zu schreiben, der Ihr Bild dreht. Weitere Informationen finden Sie unter Exif Version 2.32. Bilder im PNG-Format enthalten keine Informationen zur Bildausrichtung.

Um ein Bild aus einem Amazon S3 S3-Bucket zu übergeben, verwenden Sie einen Benutzer mit mindestens AmazonS3-RechtenReadOnlyAccess . Verwenden Sie einen Benutzer mit AmazonRekognitionFullAccess-Berechtigungen zum Aufruf von DetectProtectiveEquipment.

Im folgenden Eingabe-JSON-Beispiel wird das Bild in einem Amazon-S3-Bucket übergeben. Weitere Informationen finden Sie unter Arbeiten mit Bildern. Im Beispiel wird eine Zusammenfassung aller PSA-Typen (Kopfbedeckung, Handbedeckung und Gesichtsbedeckung) mit einer Erkennungssicherheit (MinConfidence) von mindestens 80 % angefordert. Sie sollten einen MinConfidence-Wert zwischen 50 und 100 % angeben, da Vorhersagen nur dann von DetectProtectiveEquipment zurückgegeben werden, wenn die Erkennungssicherheit zwischen 50 und 100 % liegt. Wenn Sie einen Wert unter 50 % angeben, sind die Ergebnisse identisch, wenn Sie einen Wert von 50 % angeben. Weitere Informationen finden Sie unter Spezifizierung der Anforderungen für die Zusammenfassung.

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

Wenn Sie eine große Sammlung von Bildern verarbeiten, empfiehlt sich der Einsatz von AWS Batch zum Verarbeiten von Aufrufen an DetectProtectiveEquipment in Stapeln im Hintergrund.

Spezifizierung der Anforderungen für die Zusammenfassung

Sie können optional den Eingabeparameter SummarizationAttributes (ProtectiveEquipmentSummarizationAttributes) verwenden, um zusammenfassende Informationen zu den in einem Bild erkannten PSA-Typen anzufordern.

Verwenden Sie das RequiredEquipmentTypes-Array-Feld, um die PSA-Typen anzugeben, die zusammengefasst werden sollen. Fügen Sie in das Array einen oder mehrere FACE_COVER HAND_COVER oder HEAD_COVER ein.

Verwenden Sie das MinConfidence-Feld, um ein Mindestmaß an Erkennungssicherheit (50–100) anzugeben. Die Zusammenfassung enthält keine Personen, Körperteile, Körperteilabdeckung und PSA-Elemente, die mit einer Wahrscheinlichkeit von weniger als MinConfidence erkennt werden.

Weitere Informationen zur Antwort auf die Zusammenfassung von DetectProtectiveEquipment finden Sie unter Die DetectProtectiveEquipment Antwort verstehen.

Die DetectProtectiveEquipment Antwort verstehen

DetectProtectiveEquipment gibt ein Array von Personen zurück, die im Eingabebild erkannt wurden. Für jede Person werden Informationen über die erkannten Körperteile und die erkannten persönlichen Schutzausrüstungen zurückgegeben. Der JSON-Code für das folgende Bild eines Arbeiters, der eine Kopf-, Hand- und Gesichtsbedeckung trägt, lautet wie folgt.

Beachten Sie in den JSON-Daten Folgendes:

• Erkannte Personen: Persons ist eine Reihe von Personen, die auf dem Bild erkannt wurden (einschließlich Personen, die keine persönliche Schutzausrüstung tragen). DetectProtectiveEquipment kann persönliche Schutzausrüstung bei bis zu 15 Personen erkennen, die auf einem Bild erkannt wurden. Jedes ProtectiveEquipmentPersonObjekt in der Reihe enthält eine Personen-ID, einen Begrenzungsrahmen für die Person, erkannte Körperteile und erkannte persönliche Schutzausrüstung. Der Wert von Confidence in ProtectiveEquipmentPerson gibt die prozentuale Sicherheit von Amazon Rekognition an, dass das Begrenzungsfeld eine Person enthält.

• Körperteile — BodyParts ist eine Reihe von Körperteilen (ProtectiveEquipmentBodyPart), die an einer Person erkannt wurden (einschließlich Körperteile, die nicht durch persönliche Schutzausrüstung abgedeckt sind). Jeder ProtectiveEquipmentBodyPart enthält den Namen (Name) des erkannten Körperteils. DetectProtectEquipment kann Gesicht, Kopf, linke und rechte Körperteile erkennen. Das Confidence-Feld in ProtectiveEquipmentBodyPart gibt das prozentuale Vertrauen an, das Amazon Rekognition in Bezug auf die Erkennungsgenauigkeit des Körperteils hat.

• PSA-Artikel: Das Array EquipmentDetections in einem ProtectiveEquipmentBodyPart-Objekt enthält eine Reihe von erkannten PSA-Artikeln. Jedes EquipmentDetectionObjekt enthält die folgenden Felder.

  • Type – der Typ der gefundenen PSA.

  • BoundingBox – ein Begrenzungsrahmen um die erkannte PSA.

  • Confidence – Das Vertrauen von Amazon Rekognition, dass der Begrenzungsrahmen die erkannte persönliche Schutzausrüstung enthält.

  • CoversBodyPart – Zeigt an, ob sich die erkannte persönliche Schutzausrüstung an der entsprechenden Körperstelle befindet.

  Das CoversBodyPartFeld Value ist ein boolescher Wert, der angibt, ob sich die erkannte persönliche Schutzausrüstung am entsprechenden Körperteil befindet. Das Feld Confidence gibt das Vertrauen in die Vorhersage an. Sie können CoversBodyPart verwenden, um Fälle herauszufiltern, in denen sich die erkannte persönliche Schutzausrüstung zwar auf dem Bild, aber nicht auf der Person befindet.

  Anmerkung

  CoversBodyPart bedeutet bzw. impliziert nicht, dass die Person durch die Schutzausrüstung angemessen geschützt ist oder dass die Schutzausrüstung selbst ordnungsgemäß getragen wurde.

• Übersichtsinformationen: Summary enthält die im SummarizationAttributes-Eingabeparameter angegebenen zusammenfassenden Informationen. Weitere Informationen finden Sie unter Spezifizierung der Anforderungen für die Zusammenfassung.

  Summaryist ein Objekt des Typs ProtectiveEquipmentSummary, das die folgenden Informationen enthält.

  • PersonsWithRequiredEquipment – ein Array von Personen-IDs, wobei jede Person die folgenden Kriterien erfüllt.

    • Die Person trägt die gesamte im SummarizationAttributes-Eingabeparameter angegebene persönliche Schutzausrüstung.

    • Die Confidence für Person (ProtectiveEquipmentPerson), Körperteil (ProtectiveEquipmentBodyPart) und PSA (EquipmentDetection) ist gleich oder größer als die angegebene minimale Vertrauensschwelle (MinConfidence).

    • Der Wert von CoversBodyPart für alle PSA-Artikel ist wahr.

  • PersonsWithoutRequiredEquipment – ein Array mit den IDs von Personen, die eines der folgenden Kriterien erfüllen.

    • Der Confidence-Wert für Person (ProtectiveEquipmentPerson), Körperteil (ProtectiveEquipmentBodyPart) und Körperteilbedeckung (CoversBodyPart) liegt über dem angegebenen Mindestzuverlässigkeitsschwellenwert (MinConfidence), aber der Person fehlt ein oder mehrere angegebene PSA-Artikel (SummarizationAttributes).

    • Der Wert von CoversBodyPart ist falsch für jede angegebene persönliche Schutzausrüstung (SummarizationAttributes), deren Confidence-Wert über dem angegebenen Mindestzuverlässigkeitsschwellenwert (MinConfidence) liegt. Die Person verfügt außerdem über sämtliche angegebene PSA (SummarizationAttributes) und die Confidence-Werte für Person (ProtectiveEquipmentPerson), Körperteil (ProtectiveEquipmentBodyPart) und Schutzausrüstung (EquipmentDetection) sind größer oder gleich der minimalen Vertrauensschwelle (MinConfidence).

  • PersonsIndeterminate – ein Array von IDs von Personen, bei denen der Confidence-Wert für Person (ProtectiveEquipmentPerson), Körperteil (ProtectiveEquipmentBodyPart), Schutzausrüstung (EquipmentDetection) oder den booleschen Wert für CoversBodyPart unter dem angegebenen Mindestzuverlässigkeitsschwellenwert (MinConfidence) liegt.

  Verwenden Sie die Array-Größe, um die Anzahl für eine bestimmte Zusammenfassung zu ermitteln. Die Größe von PersonsWithRequiredEquipment gibt beispielsweise Auskunft über die Anzahl der Personen, bei denen festgestellt wurde, dass sie den angegebenen PSA-Typ tragen.

  Sie können die Personen-ID verwenden, um weitere Informationen über eine Person herauszufinden, z. B. den Standort der Person im Begrenzungsrahmen. Die Personen-ID ist dem ID-Feld eines Objekts (ProtectiveEquipmentPerson) zugeordnet, das in Persons (Array von ProtectiveEquipmentPerson) zurückgegeben wurde. Sie können dann den Begrenzungsrahmen und andere Informationen aus dem entsprechenden ProtectiveEquipmentPerson-Objekt abrufen.

 {
    "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": []
    }
}