Skip to content

DgnsGui/DGNS-Nav-Map

Repository files navigation

License: MIT Status Platform Tech

DGNS Nav Map 1.1 - A Navigation experience for Spectacles

DGNS Nav Map is an interactive navigation Lens built for **Snapchat Spectacles (2024) using Lens Studio 5.15. It provides a futuristic way to explore your surroundings, find nearby places, drop map pins, and interact with an AI-powered navigation assistant, all within augmented reality.

Project Preview GIF


🕶️ Overview

An immersive AR navigation experience combining:

  • **Real-time Snap Places API
  • **Gesture-based map controls
  • **AI conversation assistant
  • **Custom pins & quest markers
  • **Built-in ambient music player

✨ Features

  • 🗺️ Interactive Map Navigation — Pan, zoom, and rotate using pinch & drag gestures
  • 📍 Custom Map Pins — Drop/remove pins directly on the map
  • 🤖 AI Map Assistant — Ask for facts about your geographical location and get answered in natural language
  • 🎶 Built-in Music Player — Play your soundtrack while exploring (SimpleMusicPlayer.ts)
  • 🎯 Quest & Landmark Markers — Dynamic AR waypoints (QuestMarker.ts)
  • 🧭 Smart Centering System — Auto-recenter on zoom/rotate (MapController.ts)
  • 🌍 Snap Places API Integration — Real nearby locations appears as pins on your map (SnapPlacesProvider.ts)

🧩 Architecture

Modular TypeScript components:

Script Description
AIMapAssistant.ts AI queries & conversational navigation helper
SnapPlacesProvider.ts Snap Places API → real-world location display
MapComponent.ts Core map rendering & state management
MapController.ts Zoom, drag, rotate, recenter logic
MapPin.ts Interactive pin creation & management
QuestMarker.ts Quest/objective AR markers
SimpleMusicPlayer.ts Lightweight in-Lens audio player UI

✅ Requirements

Before you begin, make sure you have the following installed:

  • Lens Studio – Version 5.15 or newer recommended.
  • Git – Version control system.
  • Git LFS – Required to handle large assets (audio tracks, textures).

##Install

📄 License This project is licensed under the MIT License. See the LICENSE file for details.

Developed with ❤️ by GuillaumeDGNS

About

Find places, set pins, and explore your surroundings through an intuitive AR map. A creative navigation Lens designed for Spectacles, with AI assistance!

Resources

Stars

Watchers

Forks

Packages

 
 
 

Contributors