Skip to content

Caerii/LifeInBetweenXR

Repository files navigation

Life in Between - XR App

GitHub

MIT Reality Hack 2023 | 3D Map Viewer by our team

Update (Jan 26th, 2026) - Added a lot more documentation, and a detailed conceptual product strategy for future deployment on:

two ideas:

  • "lifeinbetween.app": which is a future domain we could build a consumer app for this on, that allows social AR at city-scale for navigation
  • an API for selling to other map making app companies with spatial intelligence?

This app was designed to map all services and amenities available to you on the subway line you're currently riding.

HeaderInBetween

Team Members

Table of Contents

Overview

Our mixed reality experience, "Life in Between," allows users to view hyper-local environments around them using 3D mesh data of local buildings. By providing detailed information about the places around them, we aim to enhance people's sense of presence and connection to their community. Users can explore their neighborhood, discover new places and learn more about the history and architecture of the buildings around them.

Our experience can be used for a variety of purposes, including:

  • Community building
  • Tourism and local discovery
  • Educational and historical exploration
  • Real estate and property management

Features

View Features
Search One of our main functions is the ability to search like a wayfinding platform that focuses on public transportation. When a users makes a search on our app, we use Google Maps API to gather a lot of results and then we filter by the locations near the subway / bus stops. You can search services and places in the subway line of your choice so that you can make sure any detours or locations you visit are always convieniently along the route you travel. This is perfect for helping smaller, impoverished communities get business and traffic where they would otherwise be ignored.
Bookmarks Guess what? While you are out and about with our app, we will load a list of offline suggestions for places to visit that are on the subway / bus line you are currently taking. It enables them to see a 3D representation of the places that are on their subway line. Keep bookmarks of your favorite places or the places you intend to visit halfway through your next commute. Currently it is limited to just cafes and gyms near the user's subway stop
MapExplore We use ArchGIS to generate a 3D visualization to help people comfortably know what the city is like. Explore in 3D the places exactly above your subway line even as you traverse it!
Settings Adjust your settings for a more comfortable commute.

Key Components

  • Line Selection System: Choose and filter by subway/bus lines
  • Autocomplete Search: Fast, intuitive search with suggestions
  • 3D Map Rendering: Real-time 3D visualization of urban environments
  • Stop Management: Track and manage transit stops with color coding
  • UI Management: Smart UI that adapts to user context

Getting Started

Prerequisites

  • Unity 2021.3.16.1f or later
  • Android Studio (for Android builds)
  • ARCore compatible device
  • Git LFS (for large asset files)

Installation

  1. Clone the repository:

    git clone https://github.com/Caerii/XRTrainRide.git
    cd XRTrainRide
  2. Install Git LFS (if not already installed):

    git lfs install
    git lfs pull
  3. Open the project in Unity 2021.3.16.1f

  4. Configure your build settings (see Setup Guide)

  5. For detailed setup instructions, see docs/setup-guide.md

Project Structure

LifeInBetweenXR/
├── Assets/
│   ├── 3D Map/              # 3D map models (Boston.obj, etc.)
│   ├── Map Info/            # Building data (MITBuildings.csv)
│   ├── Rotary Heart/        # AutoCompletePopup system
│   ├── Scripts/             # Core application scripts
│   │   ├── Line.cs          # Transit line data structure
│   │   ├── LineSelector.cs  # Line selection logic
│   │   ├── Stop.cs          # Transit stop data structure
│   │   └── UIManager.cs     # UI state management
│   ├── Scenes/              # Unity scenes
│   │   ├── Scene00_MainMenu.unity
│   │   ├── Test00_Autocomplete.unity
│   │   ├── Test01_3dMap.unity
│   │   └── WoOz_00_Videogame.unity
│   └── Videogame Assets/    # Game assets and materials
├── docs/                    # Documentation
│   ├── api-reference.md     # API documentation
│   ├── arcpy-integration.md # ArcPy backend integration
│   ├── architecture.md      # System architecture
│   ├── changelog.md         # Version history
│   ├── contributing.md      # Contributing guidelines
│   ├── data-formats.md      # Data format documentation
│   ├── deployment.md        # Deployment guide
│   ├── features.md          # Feature documentation
│   ├── integration-guides.md # External service integration
│   ├── performance.md       # Performance optimization
│   ├── product-strategy.md  # Market analysis and growth strategy
│   ├── b2b-infrastructure-strategy.md # B2B/API infrastructure positioning
│   ├── smart-glasses-integration-strategy.md # Meta Ray-Ban integration analysis
│   ├── meta-map-strategic-partnership.md # Meta Map strategic partnership analysis
│   ├── meta-map-financial-analysis.md # Meta Map financial analysis
│   ├── meta-map-data-platform-strategy.md # Data platform strategy for Gaussian splats and spatiotemporal queries
│   ├── styly-netsync-integration-strategy.md # STYLY NetSync multiplayer social AR integration
│   ├── papers/              # Research papers and academic documentation
│   │   ├── collaborative-gaussian-splatting.md # Collaborative data collection for Gaussian splats
│   │   └── README.md        # Papers folder documentation
│   ├── project-highlights.md # Project impact and potential
│   ├── setup-guide.md       # Setup instructions
│   ├── testing.md           # Testing procedures
│   └── troubleshooting.md  # Troubleshooting guide
└── README.md

For more details, see docs/architecture.md.

Documentation

Comprehensive documentation is available in the docs/ folder:

Getting Started:

  • Setup Guide: Detailed installation and configuration instructions
  • Architecture: System architecture and design patterns
  • API Reference: Complete API documentation for scripts and components
  • Features: Detailed feature documentation and usage guides

Development:

Reference:

Dependencies

Core Dependencies

  • Unity 2021.3.16.1f: Game engine
  • ARCore: Augmented Reality framework for Android
  • Eris ARCGis (3D Mapping data) SDK: 3D mapping and visualization
  • Vive XR Elite: Passthrough Mixed Reality support

Unity Packages

  • AR Foundation: Cross-platform AR framework
  • TextMesh Pro: Advanced text rendering
  • Rotary Heart AutoComplete: Autocomplete UI system
  • Adaptive Performance: Performance optimization

External Services

  • Google Maps API: Location search and filtering
  • ArcGIS Services: 3D map data

For a complete list of dependencies, see docs/setup-guide.md.

Development

Building the Project

  1. Open Unity and load the project
  2. Select your target platform (Android recommended)
  3. Configure build settings (see docs/setup-guide.md)
  4. Build and deploy to your device

Contributing

  1. Create a feature branch from main
  2. Make your changes
  3. Test thoroughly on target devices
  4. Submit a pull request

For development guidelines, see docs/architecture.md.

Testing Scenes

  • Test00_Autocomplete.unity: Test autocomplete search functionality
  • Test01_3dMap.unity: Test 3D map rendering
  • WoOz_00_Videogame.unity: Demo/prototype scene

License

See LICENSE file for details.


Note: This project was developed for MIT Reality Hack 2023. For questions or issues, please open an issue on GitHub.

About

Reality Hack 2023 3D Map Viewer

Resources

License

Contributing

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published

Contributors 3

  •  
  •  
  •