Bulk Upload for Observations
The Bulk Upload feature allows you to automatically create multiple observations from a Google Drive folder containing videos and photos. This experimental feature uses AI to process your media files, transcribe video explanations, and automatically generate observations with associated photos.
What is Bulk Upload?
Bulk Upload is an experimental Google Drive integration that enables you to:
- Process Multiple Media Files: Upload videos and photos from a Google Drive folder
- Automatic Transcription: AI extracts and transcribes audio from your videos
- Smart Categorization: AI automatically categorizes observations based on content
- Photo-Video Matching: Associates photos with videos based on timestamps
- Observation Generation: Creates complete observations automatically
How Bulk Upload Works
The Workflow Process
Critical Timing Requirements:
Photos and videos are matched using timestamps, so you must follow this exact workflow:
During Inspection:
- Record a Video: Briefly explain what you're observing while recording the video
- Take Photos: Capture photos of the same observation within a few minutes of the video
- Repeat Process: Continue this video-then-photos sequence for each observation
After Inspection:
- Upload to Google Drive: Place all videos and photos in a single Google Drive folder
- Share the Folder: Give "Viewer" access to the SwiftReporter service account
- Provide Share Link: Paste the folder's share link into the bulk upload interface
AI Processing
What the AI Does:
- Audio Extraction: Extracts audio tracks from your video files
- Speech Transcription: Converts your spoken explanations into text
- Content Analysis: Analyzes transcribed content for categorization
- Photo Association: Matches photos to videos based on capture timestamps
- Observation Creation: Generates complete observations with descriptions and media
Setting Up Bulk Upload
Google Drive Requirements
Folder Preparation:
- Create a dedicated Google Drive folder for your inspection media
- Upload all videos and photos from your inspection to this folder
- Ensure videos and photos are captured with the timing workflow described above
Sharing Requirements:
You must share your Google Drive folder with the SwiftReporter service account:
Service Account Email:
firebase-adminsdk-aqpct@inspection-report-ai.iam.gserviceaccount.com
Sharing Steps:
- Right-click your Google Drive folder
- Select "Share" from the context menu
- Add the service account email with "Viewer" permissions
- Copy the folder's share link for use in SwiftReporter
File Requirements and Limitations
Video File Constraints:
- Maximum Size: Videos must be under 6GB
- Format Support: Standard video formats (MP4, MOV, AVI, etc.)
- Content Requirement: Videos should contain verbal explanations of observations
Photo File Handling:
- All Photos Included: Every photo in the folder will be added to observations
- Quality Standards: Ensure photos meet professional documentation standards
- Relevance: Only include photos you want in your final report
Using the Bulk Upload Feature
Accessing Bulk Upload
From Inspection Screen:
- Open Inspection: Navigate to the inspection where you want to add observations
- Locate Bulk Upload: Find the bulk upload option in the observations section
- Open Modal: Click to open the bulk upload interface
Bulk Upload Process
Step 1: Review Instructions
- Read the experimental feature warning
- Understand the workflow requirements
- Review file size and format limitations
Step 2: Share Folder
- Copy the provided service account email
- Share your Google Drive folder with this email
- Grant "Viewer" access permissions
Step 3: Provide Share Link
- Copy your Google Drive folder's share link
- Paste the link into the provided input field
- Verify the link is a valid Google Drive URL
Step 4: Start Processing
- Click "Start Bulk Upload" to begin processing
- The system validates your share link and folder access
- Processing begins in the background
Processing and Progress
Processing Stages:
- Folder Access: System accesses your shared Google Drive folder
- Media Download: Downloads videos and photos for processing
- Audio Extraction: Extracts audio tracks from video files
- Transcription: Converts speech to text using AI
- Content Analysis: Analyzes content for categorization
- Photo Matching: Associates photos with videos by timestamp
- Observation Creation: Generates complete observations
Progress Monitoring:
- Real-time Updates: Progress bar shows processing completion percentage
- Current Step: Displays which processing stage is currently active
- File Count: Shows progress through total media files
- Completion Time: Processing typically completes within a few minutes
Best Practices for Bulk Upload
Recording Strategy
Video Recording Best Practices:
- Clear Speech: Speak clearly and at normal pace during videos
- Complete Descriptions: Provide comprehensive explanations of observations
- Professional Language: Use appropriate inspection terminology
- Minimal Background Noise: Record in quieter environments when possible
Photo Documentation:
- Immediate Capture: Take photos within minutes of recording related videos
- Multiple Angles: Capture various perspectives of the same issue
- Clear Quality: Ensure photos are well-lit and focused
- Relevant Content: Only photograph items you want documented
Quality Assurance
Pre-Upload Checklist:
- Videos contain clear verbal explanations
- Photos are captured shortly after related videos
- All media files are under size limits
- Folder is properly shared with service account
- Share link is copied correctly
Post-Processing Review:
- All expected observations were created
- Photo-video associations are correct
- Transcriptions accurately reflect spoken content
- Categories and descriptions are appropriate
Bulk Upload is an experimental feature that streamlines the observation creation process by leveraging AI to process your inspection media. While it can significantly speed up documentation, always review and refine the generated content to ensure accuracy and professional quality.