Collection
A collection is a group of items to be recognized.
Image Recognition is always performed within a specific collection. You can select one of your collections using its token. Check our Image Recognition API to learn how.
Token
A token uniquely identifies one collection of items that you want to recognize.
Tokens are used in the Image Recognition API, in the CraftAR Mobile App, and in the CraftAR mobile SDKs to specify which collection of images should be searched through.
Each collection has one token assigned automatically upon creation. For each collection you can add as many tokens as you wish. You can also delete all of them and eliminate all possible outside accesses to your collection.
Visit the Support Center If you’re trying to find the token for your collection
Tips: Taking advantage of tokens in your app
#1 Imagine you have an app for two different applications, a web service and a mobile app. You may want to distinguish them with different tokens. Now let’s imagine that at some point, you may want to revoke the access from the mobile app. Simply delete the corresponding token and that app will no longer be able to search through that collection.
#2 Imagine you want to grant temporary access to one of your collections. Simply generate and share a new token for that collection. This access can be easily revoked by deleting the corresponding token.
Item
An item represents an entity that you want to recognize. Examples of items are logos, physical objects, or drawings, among others. Inside CraftAR there are two types of items: Augmented Reality (AR) and Image Recognition (IR) items.
Check the Image Recognition API to learn how this information is received upon recognition.
An Image Recognition item contains:
- One or more images representing its appearance (i.e. reference image).
- URL returned upon its recognition (optional). Typical uses of the URL include a website with information or a video related to the item.
- Custom data returned upon its recognition (optional). Typical uses of this field include text that describes the item, for instance, product information.
An Augmented Reality item contains:
- A single image representing its appearance.
- An Augmented Reality scene. This scene is rendered automatically once the item is recognized, when the app is running the CraftAR Augmented Reality SDK.
Reference and Query image
The following picture shows an example of object representation, i.e. reference image in your collection, and a query image sent by an end-user for instance from your mobile app.
Improving the recognition performance depends on many factors. We take care of illumination conditions and viewing angle to cover most of the cases, but there are certain best practices that you can follow.
The following list of articles from our Support Center can help you identify what options you have to improve the overall experience of your users:
- Preparing the collection of reference images
- Reference Image: quality, dimensions, and formats
- Query Image: quality, dimensions and formats
We suggest to search inside the Support Center for object-specific best practices (small objects, bottles, etc.).