Cette page a été traduite par l'API Cloud Translation.
Switch to English

Conseils généraux

Cette page décrit les étapes de dépannage qui pourraient vous être utiles si vous rencontrez des problèmes avec la fonctionnalité de recherche de produits de l'API Vision.

Résultats de recherche

Quel est le nombre maximal de résultats renvoyés ?

Le nombre maximal de résultats renvoyés varie d'une requête à l'autre en raison des détails de la mise en œuvre. Le nombre maximal de résultats garanti est 500. Si d'autres résultats sont demandés, le numéro demandé risque de ne pas être atteint.

Puis-je définir un seuil pour les résultats ?

Les scores des résultats de recherche ne sont pas calibrés. Cela signifie que les scores des résultats d'une requête donnée seront comparables (c'est ainsi que les résultats sont classés). Toutefois, les résultats des requêtes A et B ne sont pas nécessairement comparables. Cela signifie qu'aucun seuil fixe n'est adapté à un cas d'utilisation donné.

Il est possible de définir un seuil en fonction de vos propres tests. Si vous souhaitez définir un seuil, vous devez le faire pour chaque étiquette d'élément. Cela signifie que vous devez définir un seuil de score pour les résultats de "Chaussures" "indépendamment de "Sacs", etc. pour chaque étiquette.

Existe-t-il un moyen de savoir pourquoi un résultat donné est mieux classé qu'un autre ?

Actuellement, la recherche de produits de l'API Vision n'est pas compatible avec les fonctionnalités qui expliquent pourquoi un résultat particulier a été renvoyé.

Quelle est la différence entre l'utilisation de productGroupedResults et l'utilisation de la fonctionnalité de localisation des objets de l'API Vision ?

La réponse productGroupedResults renvoie une liste d'éléments détectés, leur étiquette et score prédit, leurs cadres de délimitation et un classement des résultats de recherche de produits pour chaque élément. Cette réponse équivaut à envoyer d'abord l'image de la requête à la fonctionnalité de localisation des objets de l'API Vision, puis à l'envoyer avec chaque cadre de délimitation de produit (filtré sur les étiquettes pertinentes) à la recherche de produits de l'API Vision.

L'un des avantages de l'utilisation de productGroupedResults est qu'il est plus rapide et plus direct, car il n'effectue qu'un seul appel d'API. Toutefois, si une logique d'application personnalisée doit être mise en œuvre entre la détection d'objets et la requête de recherche, une méthode en deux étapes est recommandée. Par exemple, vous pouvez ajouter des filtres de recherche de produits de l'API Vision basés sur des thèmes d'objet.

Si je connais l'emplacement d'un produit dans une image, dois-je recadrer l'image avant d'interroger l'API ?

Cette situation peut se produire si, par exemple, un utilisateur est autorisé à dessiner un cadre de délimitation autour de l'élément qu'il souhaite rechercher. En règle générale, vous ne devez pas rogner l'image avant de l'envoyer à l'API. En effet, notre API utilise à la fois le cadre de délimitation de la requête pour renvoyer des résultats ciblés et le contexte global de l'image, ce qui permet souvent d'améliorer les résultats.

Images de référence

Quelles sont les qualités d'une bonne image de référence pour un produit ?

Une bonne image de référence montre clairement le produit et ne comporte aucun autre objet. Les images "packshot" constituent généralement de bonnes images de référence. Ces images servent souvent à présenter un produit à l'utilisateur sur une page produit ou dans une publicité. Elles sont généralement affichées sur un fond blanc. Des images montrant le produit dans d'autres environnements peuvent également constituer de bonnes images de référence, à condition qu'elles ne montrent aucun autre produit. Si vous avez de telles images à votre disposition, n'hésitez pas à toutes les utiliser comme images de référence.

Quel est le nombre optimal d'images de référence pour un produit donné ?

La recherche de produits de l'API Vision peut fonctionner correctement même avec une seule image de référence par produit. En règle générale, trois à huit images, surtout si elles présentent des variations, fournissent les informations nécessaires pour obtenir des résultats corrects lors des recherches de produits avec l'API Cloud Vision. Les variations peuvent porter sur l'orientation du produit, l'éclairage, l'arrière-plan, etc. Des images de référence supplémentaires peuvent être ajoutées à l'index sans que cela ne fasse généralement baisser la précision.

Comment puis-je obtenir davantage d'images de référence pour mes produits ?

Le meilleur moyen d'améliorer la précision de la recherche de produits de l'API Vision consiste à rajouter de bonnes images de référence aux produits. Si vous avez déjà importé un ensemble représentatif d'images de produits et si vous souhaitez améliorer la précision pour certains d'entre eux, vous pouvez soit utiliser d'autres images existantes, soit recueillir des images supplémentaires de ces produits.

Si vous utilisez d'autres images existantes, vérifiez qu'elles montrent clairement le produit et ne contiennent pas d'objet gênant. Par exemple, imaginons que vous ayez une photo d'un mannequin portant une chemise et un pantalon. Cette image en propre ne serait pas une bonne image de référence pour le produit chemise. Toutefois, si vous spécifiez un cadre de délimitation autour de la chemise ou si vous recadrez l'image pour ne garder que la chemise, vous obtenez alors une bonne image de référence. Vous pouvez utiliser la fonctionnalité de localisation des objets de l'API Vision pour proposer des cadres. Cette méthode peut être utilisée parallèlement à une annotation d'annotations de cadre de délimitation fourni par l'utilisateur.

Puis-je améliorer la précision de l'API sur mon ensemble de produits par augmentation des données ?

Ajouter des versions augmentées (par symétrie horizontale, altération du contraste, etc.) des images de référence existantes est une idée judicieuse, mais cela n'augmente généralement presque pas la précision.

Gestion des données

Mettez à jour votre ensemble de produits avec de nouveaux produits lorsque votre inventaire change. Si les modifications sont mineures, vous pouvez ajouter ou supprimer des produits si nécessaire. En cas de modification importante de votre inventaire ou de vos images de référence, vous pouvez également créer un ensemble de produits contenant les modifications et tester la qualité de la recherche avant de basculer complètement sur le nouvel ensemble. Dans les deux cas, vous devez effectuer le suivi des produits et des images figurant dans votre ensemble de produits en enregistrant votre fichier CSV d'importation par lot pour en faciliter la consultation ou le rollback.