tagging-system

To normalize photo tagging data for litter observations, you organize tags into a centralized hierarchy linking Photo, PhotoTag, and PhotoTagExtraTags with materials, brands, and custom tags. This structure ensures consistent categorization across all uploaded images.

Migrating litter tags from v4 to v5 data models requires executing built-in conversion workflows that process category-object pivots and handle unresolved tags. The system automatically updates legacy tag structures to match the v5 normalized hierarchy.

You can generate summaries and calculate XP for bulk photo tag uploads using the built-in GeneratePhotoSummaryService and XpCalculator. These services analyze classified tags, process litter categories, and output tagging analytics for user experience points.

Handling unresolved tags and extra-tag-only entries during taxonomy migrations requires using dedicated classification services that validate tag data against the central data model. The system preserves extra-tag-only tags while resolving standard litter objects and materials.

The tagging system fully supports custom tags alongside standardized litter categories, objects, materials, and brands. Custom tags are managed through the PhotoTagExtraTags structure, allowing flexible annotation while maintaining the normalized hierarchical data model.

Classifying tags across photos to maintain a consistent litter taxonomy involves using the ClassifyTagsService to validate and sort tags into categories, materials, and brands. This ensures all photo tags align with the centralized seed data and category-object pivots.