Tiers
Tiers are returned by both Identification and Verification callouts. While confidence scores tell you the confidence at which Simprints rates the likelihood of a match, tiers are a great way to set the UI for the user. Confidence scores adapt over time to make the returns more accurate, however tiers make displaying the results to the user constant and significantly easier to understand.
Tier Class
Our matching algorithm generates a confidence score which you can use to tell how closely fingerprints match. To help you interpret this number, we provide a Tier class which aims to illustrate the degree with which the prints match:
public enum Tier {
TIER_1, // Almost certain match (fingerprints are very similar)
TIER_2, // Very good match
TIER_3, // Good match
TIER_4, // Okay match
TIER_5, // No match (fingerprints are very different)
}
Getting and Using the Returned Tier
Use the getTier() method to get the tier from a returned Identification or Verification object.
An example, using a verification:
// After onActivityResult, where Simprints ID has returned a Verification object
switch (verification.getTier()) {
case TIER_1:
case TIER_2:
case TIER_3:
case TIER_4:
// It's a match!
break;
case TIER_5:
// It's not a match!
break;
}