May 01, 2025

Get Started

The easiest way to display location-based maps with minimal integration effort

1. Overview
2. Example
3. Basic steps
4. First steps
5. Usages and Limits

Overview

The Woosmap Static Maps API lets you generate customizable, embeddable map images using simple HTTP requests. It’s a lightweight alternative to interactive maps—ideal for emails, reports, or websites where dynamic JavaScript maps aren’t needed.

You provide parameters such as location, zoom level, size, and markers, and the API returns a map image that can be embedded directly into any webpage or application.

For a detailed reference, see the API specification here.

Example

As for all our other APIs, the Woosmap Static Map API is a fully hosted service with first class SLA accessible through HTTP requests of the following form:

        https://api.woosmap.com/maps/static...

    

Here’s the simplest way to request a static map:

        https://api.woosmap.com/maps/static?lat=48.8584&lng=2.294351&zoom=15.4&width=600&height=400&retina=yes&key=YOUR_API_KEY

    

A 600 × 400 pixel map centered on the Eiffel Tower in Paris, zoom level 15,4.

Make sure a proper referer value is set in the header of your request to avoid 403 error

Basic steps

Generated images are defined according to 5 main parameters:

• lat: latitude of the center of the final image
• lng: longitude of the center of the final image
• height: value in pixels for the vertical size of the final image
• width: value in pixels for the horizontal size of the final image

You can tune your final image with additional paramters accoridng to your use cases:

• Language labels visible on the map can be set through the language parameter (Chinese, Corean and Japanese not supported).
• Static maps can be enriched with a marker, a polyline and/or a polygon drawn on top.

Woosmap Static API generates images in PNG only.

First steps

To use the Woosmap Static Maps API, you need an API key dedicated to authenticate and secure requests to the service:
1- Visit the Woosmap Console.
2- Log in or create an account.
3- Navigate to Projects and make sure Woosmap Map product is activated.
4- Retrieve an API Keys, in the security tab.
5- Restrict usage by HTTP referrer for security (optional but highly recommended).

Usages and Limits

The following usage limits are in place for the Static Map endpoint of Distance API:

• Maximum of 20 queries per second (QPS) per Project (so possibly the sum of client-side and server-side queries)
• Size of images can’t exceed 640 x 640 or be smaller than 40 x 40

‹ Distance Do your first static maps ›

Was this article helpful?

Have more questions? Submit a request