Street View Gallery

Street View Gallery is an enterprise-grade, geospatial visualization platform designed to present custom 360-degree panoramic street view imagery publicly accessible. Built with Next.js and Prisma, it serves as a secure, high-performance, independent alternative to commercial platform ecosystems.

The platform aims organizations and individuals to show their projects which recorded for Google Street View and makes it publicly accessible and explore from single lightweight UI.

Quick Start (Docker run)

For evaluation or localized testing environments, execute the following command:

docker run -d -p 3000:3000 --name gsv_gallery atakanozban/gsv_gallery:latest

Production Deployment (Docker Compose)

For production-grade environments requiring data persistence, network isolation, and high availability, utilize the orchestrated configuration below:

services:
  gsv_gallery:
    image: atakanozban/gsv_gallery:latest
    container_name: gsv_gallery
    ports:
      - "3000:3000"
    environment:
      - PORT=3000
      - DATABASE_URL=file:/app/data/prod.db
      - GOOGLE_MAPS_API_KEY=YOUR_GOOGLE_MAPS_API_KEY_HERE
      - ADMIN_USERNAME=admin
      - ADMIN_PASSWORD=YOUR_SECURE_PASSWORD_HERE
      - GOOGLE_CLIENT_ID=YOUR_GOOGLE_CLIENT_ID_HERE
      - GOOGLE_CLIENT_SECRET=YOUR_GOOGLE_CLIENT_SECRET_HERE
    volumes:
      - ./data:/app/data
    restart: unless-stopped

Configuration & Environment Variables

The platform utilizes environment variables for backend initialization. Ensure these are securely provisioned during container runtime orchestration:

Variable	Description	Requirement
`DATABASE_URL`	The PostgreSQL connection string utilized by the Prisma ORM layer for transaction logs and metadata persistence.	Required

Note on Client-Side Integrations: The platform eliminates compile-time API dependencies. The Google Maps JavaScript API payload is resolved and securely injected via dynamic runtime state mechanics (/api/config) post-initialization.

Core Architecture & Features

Interactive Geospatial Dashboard: A unified, map-centric interface engineered to monitor, display, and review distinct panoramic tracks with optimized multi-layer rendering.
Telemetry & GPX Integration: Automated, server-side parsed polyline extraction from standard GPX track logs, calculating accurate cumulative distances using high-precision spherical geometry algorithms.
Synchronized Dual-View Navigation: Fully synchronized state management linking immersive, full-screen street view iframe panoramas with active tracking mini-maps.
Responsive Enterprise-Ready UI: Highly responsive web design layout optimized for both command-center displays and cross-platform mobile devices out of the box.

Support

If you need more help with Street View Gallery, you can ask for support in Gitea Issues or direct support through mail. This is the best source of answers, as both the n8n support team and community members can help.

3.2 KiB Raw Blame History