Bulk Upload for Observations

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:

  1. Record a Video: Briefly explain what you're observing while recording the video
  2. Take Photos: Capture photos of the same observation within a few minutes of the video
  3. Repeat Process: Continue this video-then-photos sequence for each observation

After Inspection:

  1. Upload to Google Drive: Place all videos and photos in a single Google Drive folder
  2. Share the Folder: Give "Viewer" access to the SwiftReporter service account
  3. 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:

  1. Right-click your Google Drive folder
  2. Select "Share" from the context menu
  3. Add the service account email with "Viewer" permissions
  4. 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:

  1. Open Inspection: Navigate to the inspection where you want to add observations
  2. Locate Bulk Upload: Find the bulk upload option in the observations section
  3. 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:

  1. Folder Access: System accesses your shared Google Drive folder
  2. Media Download: Downloads videos and photos for processing
  3. Audio Extraction: Extracts audio tracks from video files
  4. Transcription: Converts speech to text using AI
  5. Content Analysis: Analyzes content for categorization
  6. Photo Matching: Associates photos with videos by timestamp
  7. 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.

Continue Reading...
Observations System Overview