Static Maps API: Generate Map Images Without JavaScript
6 min read
What Are Static Maps?
Static Maps API generates map images as PNG or JPEG files via a simple HTTP request. No JavaScript, no client-side rendering, no map library required. Perfect for server-side use cases.
Basic Usage
https://api.beta.vn/maps/staticmap?
center=40.714,-74.006
&zoom=13
&size=600x400
&key=YOUR_API_KEY
This returns a 600×400 pixel map image centered on New York City at zoom level 13.
Adding Markers
https://api.beta.vn/maps/staticmap?
size=600x400
&markers=color:red|40.714,-74.006
&markers=color:blue|40.718,-73.998
&key=YOUR_API_KEY
Common Use Cases
- Email confirmations: Show delivery location or store address in transactional emails. Email clients don't support JavaScript, making static maps the only option.
- PDF reports: Embed location maps in invoices, delivery receipts, or property reports generated server-side.
- Social media cards: Generate Open Graph images with map context for location-based content.
- Print materials: Flyers, business cards, and signage with embedded maps.
Performance Benefits
Static maps load as a single image request versus Dynamic Maps which require loading the entire Maps JavaScript SDK (200KB+). For pages where the map is supplementary content, static maps improve Core Web Vitals significantly.
Pricing
Beta Maps API plans start at $79/month for 100K requests across all endpoints. Compare that to Google's per-request pricing of $2.00/1,000 for static maps alone. See pricing details.