One Hat Cyber Team

Edit File: search-faces-by-image.rst

**To search for faces in a collection that match the largest face in an image.**

The following ``search-faces-by-image`` command searches for faces in a collection that match the largest face in the specified image.::

aws rekognition search-faces-by-image \
        --image '{"S3Object":{"Bucket":"MyImageS3Bucket","Name":"ExamplePerson.jpg"}}' \
        --collection-id MyFaceImageCollection

{
        "SearchedFaceBoundingBox": {
            "Width": 0.18562500178813934, 
            "Top": 0.1618015021085739, 
            "Left": 0.5575000047683716, 
            "Height": 0.24770642817020416
        }, 
        "SearchedFaceConfidence": 99.993408203125, 
        "FaceMatches": [
            {
                "Face": {
                    "BoundingBox": {
                        "Width": 0.18562500178813934, 
                        "Top": 0.1618019938468933, 
                        "Left": 0.5575000047683716, 
                        "Height": 0.24770599603652954
                    }, 
                    "FaceId": "ce7ed422-2132-4a11-ab14-06c5c410f29f", 
                    "ExternalImageId": "example-image.jpg", 
                    "Confidence": 99.99340057373047, 
                    "ImageId": "8d67061e-90d2-598f-9fbd-29c8497039c0"
                }, 
                "Similarity": 99.97913360595703
            }, 
            {
                "Face": {
                    "BoundingBox": {
                        "Width": 0.18562500178813934, 
                        "Top": 0.1618019938468933, 
                        "Left": 0.5575000047683716, 
                        "Height": 0.24770599603652954
                    }, 
                    "FaceId": "13692fe4-990a-4679-b14a-5ac23d135eab", 
                    "ExternalImageId": "image3.jpg", 
                    "Confidence": 99.99340057373047, 
                    "ImageId": "8df18239-9ad1-5acd-a46a-6581ff98f51b"
                }, 
                "Similarity": 99.97913360595703
            }, 
            {
                "Face": {
                    "BoundingBox": {
                        "Width": 0.41499999165534973, 
                        "Top": 0.09187500178813934, 
                        "Left": 0.28083300590515137, 
                        "Height": 0.3112500011920929
                    }, 
                    "FaceId": "8d3cfc70-4ba8-4b36-9644-90fba29c2dac", 
                    "ExternalImageId": "image2.jpg", 
                    "Confidence": 99.99769592285156, 
                    "ImageId": "a294da46-2cb1-5cc4-9045-61d7ca567662"
                }, 
                "Similarity": 99.18069458007812
            }, 
            {
                "Face": {
                    "BoundingBox": {
                        "Width": 0.48166701197624207, 
                        "Top": 0.20999999344348907, 
                        "Left": 0.21250000596046448, 
                        "Height": 0.36125001311302185
                    }, 
                    "FaceId": "bd4ceb4d-9acc-4ab7-8ef8-1c2d2ba0a66a", 
                    "ExternalImageId": "image1.jpg", 
                    "Confidence": 99.99949645996094, 
                    "ImageId": "5e1a7588-e5a0-5ee3-bd00-c642518dfe3a"
                }, 
                "Similarity": 98.66607666015625
            }, 
            {
                "Face": {
                    "BoundingBox": {
                        "Width": 0.5349419713020325, 
                        "Top": 0.29124999046325684, 
                        "Left": 0.16389399766921997, 
                        "Height": 0.40187498927116394
                    }, 
                    "FaceId": "745f7509-b1fa-44e0-8b95-367b1359638a", 
                    "ExternalImageId": "image9.jpg", 
                    "Confidence": 99.99979400634766, 
                    "ImageId": "67a34327-48d1-5179-b042-01e52ccfeada"
                }, 
                "Similarity": 98.24278259277344
            }, 
            {
                "Face": {
                    "BoundingBox": {
                        "Width": 0.5307819843292236, 
                        "Top": 0.2862499952316284, 
                        "Left": 0.1564060002565384, 
                        "Height": 0.3987500071525574
                    }, 
                    "FaceId": "2eb5f3fd-e2a9-4b1c-a89f-afa0a518fe06", 
                    "ExternalImageId": "image10.jpg", 
                    "Confidence": 99.99970245361328, 
                    "ImageId": "3c314792-197d-528d-bbb6-798ed012c150"
                }, 
                "Similarity": 98.10665893554688
            }, 
            {
                "Face": {
                    "BoundingBox": {
                        "Width": 0.5074880123138428, 
                        "Top": 0.3774999976158142, 
                        "Left": 0.18302799761295319, 
                        "Height": 0.3812499940395355
                    }, 
                    "FaceId": "086261e8-6deb-4bc0-ac73-ab22323cc38d", 
                    "ExternalImageId": "image6.jpg", 
                    "Confidence": 99.99930572509766, 
                    "ImageId": "ae1593b0-a8f6-5e24-a306-abf529e276fa"
                }, 
                "Similarity": 98.10526275634766
            }, 
            {
                "Face": {
                    "BoundingBox": {
                        "Width": 0.5574039816856384, 
                        "Top": 0.37187498807907104, 
                        "Left": 0.14559100568294525, 
                        "Height": 0.4181250035762787
                    }, 
                    "FaceId": "11c4bd3c-19c5-4eb8-aecc-24feb93a26e1", 
                    "ExternalImageId": "image5.jpg", 
                    "Confidence": 99.99960327148438, 
                    "ImageId": "80739b4d-883f-5b78-97cf-5124038e26b9"
                }, 
                "Similarity": 97.94659423828125
            }, 
            {
                "Face": {
                    "BoundingBox": {
                        "Width": 0.5773710012435913, 
                        "Top": 0.34437501430511475, 
                        "Left": 0.12396000325679779, 
                        "Height": 0.4337500035762787
                    }, 
                    "FaceId": "57189455-42b0-4839-a86c-abda48b13174", 
                    "ExternalImageId": "image8.jpg", 
                    "Confidence": 100.0, 
                    "ImageId": "0aff2f37-e7a2-5dbc-a3a3-4ef6ec18eaa0"
                }, 
                "Similarity": 97.93476867675781
            }
        ], 
        "FaceModelVersion": "3.0"
    }

For more information, see `Searching for a Face Using an Image <https://docs.aws.amazon.com/rekognition/latest/dg/search-face-with-image-procedure.html>`__ in the *Amazon Rekognition Developer Guide*.