API Documentation

Street View imagery and aerial render APIs. All endpoints live under /api/v1/. Expand any endpoint below to see parameters and try it live with pre-made example locations.

All production requests require an API key. The demos on this page use the built-in preview mode with no key required.

StreetSnap

Street-level imagery API. Render images, fetch panoramas, get metadata, and map coverage. Drop-in compatible with the Street View Static API -- change the base URL and you're done.

Interactive Explorer

Rotate the heading and jump between connected panoramas:

Street view at 40.7484, -73.9857, heading 270
270
curl "https://api.gsnap.dev/api/v1/streetview?lat=40.7484&lng=-73.9857&heading=270&width=640&height=480" -o streetview.jpg

AerialSnap

Render aerial perspective views from 3D mesh data at any heading and tilt angle.

MapSnap

Decode map vector tiles to extract POIs and geometry features as GeoJSON.

Authentication

All API requests require a Bearer token in the Authorization header.

Authorization: Bearer YOUR_API_KEY

API keys are issued manually. Contact us at hello@gsnap.dev to request access.

Error Reference

All error responses return JSON:

{
  "error": "Description of what went wrong",
  "status": 400
}
CodeMeaning
400Missing or invalid parameters
404No data found for the given location or pano ID
500Internal server error
503Service unavailable