specs-location

Implement GPS coordinates, heading orientation, and Snap Places API for location-based AR experiences on Spectacles.

16|2|Updated Apr 13, 2026
One-click install
npx skills add https://github.com/lens-studio-devs/ls-extensions --skill specs-location-lens-studio-devs
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: specs-location
Source: https://github.com/lens-studio-devs/ls-extensions/tree/main/plugins/ls-clad/skills/specs-location
Command: npx skills add https://github.com/lens-studio-devs/ls-extensions --skill specs-location-lens-studio-devs

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? Building location-aware AR experiences on Snap Spectacles requires correctly wiring GPS polling, north-aligned heading updates, accuracy modes, and the Snap Places API, along with the right permissions and platform version requirements. ## Core Features & Use Cases - GPS and Heading Access: Create a LocationService, poll getCurrentPosition, and subscribe to onNorthAlignedOrientationUpdate for continuous heading data. - 6DoF AR Placement: Use Navigation accuracy to activate FUSED_LOCATION and derive a world pose from latitude, longitude, altitude, and orientation. - Snap Places Integration: Call showNearbyPlaces with category filters like Restaurant or Café to render points of interest on a 2D map component. - Use Case: Build an outdoor navigation Lens that places AR pins at nearby restaurants, updates the user's heading on a 2D map, and keeps GPS coordinates refreshing every second. ## Quick Start Ask the agent to implement a Lens Studio script that polls GPS coordinates and heading using the LocationService API with Navigation accuracy for an outdoor AR experience.

Frequently Asked Questions about specs-location

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I get GPS coordinates in Lens Studio for Spectacles?

Declare the RawLocationModule permission with require('LensStudio:RawLocationModule'), create a LocationService via GeoLocation.createLocationService(), and call getCurrentPosition with success and error callbacks. Poll on a DelayedCallbackEvent for continuous updates.

How do I get heading or orientation on Snap Spectacles?

Subscribe to locationService.onNorthAlignedOrientationUpdate and convert the orientation with GeoLocation.getNorthAlignedHeading to get degrees. Multiply by Math.PI/180 to get a 2D rotation for map rendering.

Which GeoLocationAccuracy mode should I use for AR placement?

Use GeoLocationAccuracy.Navigation for AR content placement because it activates the FUSED_LOCATION source and enables a 6DoF pose from GPS. Best and Default modes trade precision for lower battery use.

Does the Snap Places API require special permissions?

Yes, the Snap Places API requires Extended Permissions when combined with the LocationService for automatic pin generation. Users must also be logged in, paired to Snapchat, and have location permission enabled.

Why is Spectacles location accuracy poor at night or after an OS update?

Navigation accuracy can degrade at night, and after a SnapOS update heading needs about 20 seconds of calibration by rotating the head in all directions. The first location fix may also be slow without an internet connection.