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:
curl "https://api.gsnap.dev/api/v1/streetview?lat=40.7484&lng=-73.9857&heading=270&width=640&height=480" -o streetview.jpgAerialSnap
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
}| Code | Meaning |
|---|---|
| 400 | Missing or invalid parameters |
| 404 | No data found for the given location or pano ID |
| 500 | Internal server error |
| 503 | Service unavailable |