ImageData

The ImageData message is used to send captured live images or loaded photo images to the BioID Web Service. They are sent in their binary representation. Optionally some tags can be associated with each uploaded image.

Message definition

message ImageData {
    bytes image = 1;
    repeated string tags = 2;
}

Message fields

image

The binary image data.

tags

Depending on the API, an image can be tagged to allow different usage scenarios.

Supported image formats

The image types currently supported by BWS are:

• Portable Network Graphics (PNG)
• Windows Bitmap (BMP)
• Graphics Interchange Format (GIF)
• Joint Photographic Experts Group (JPEG)
• Tagged Image File Format (TIFF)
• Targa Image File (TGA)
• Portable Bitmap (PBM)
• Webp
• OpenExr HDR multi-channel images (EXR)
• Quite OK Image Format (QOI)

Recommendations

• Use color images.
• Use an image resolution of at least 480 x 640 pixels (but less than 1200 x 1600).
• An optimal image contains a single fully visible face with a face size of about 300 x 300 pixels.
• A lossless compression is highly recommended.
• Do not use lossy compression (at least not with high compression rates).
• ...