Static Map
This API returns a static image of a map based on the defined parameters in PNG format which users may overlay multiple point(s), polygon(s), or polyline(s) on the map
Users can also create personalised static maps via the Static Map Creator
Possible Error Responses
400 - Please select a valid map style
400 - Please enter a valid zoom level
400 - Please enter a pair of valid width and height(in pixels).
400 - The maximum resolution size is 512 x 512.
400 - Please enter a pair of valid latitude & longitude.
QUERY PARAMETERS
Choice of available base maps: night, grey, original, default and landlot
Latitude coordinates in WGS84 format.
Longitude coordinates in WGS84 format.
Either latitude/longitude or postal should be used.
Values: 11- 19. The zoom level of the static image. The lower the value, the more zoomed out the static image.
Values: 128- 512. The width of the static image.
Values: 128- 512. The height of the static image.
Coordinates of polygon(s) to be overlaid on the base map. Polygon(s) and its color are segregated by semicolon. Whereas each polygon is differentiated with a pipe. The start and end must be of the same point but all other points should be unique.
Coordinates of line(s) to be overlaid on the base map. Line(s), its color, and thickness are segregated by semicolon. Each line is differentiated with a pipe.
Coordinates of point(s) to be overlaid on the base map. Coordinates of individual point are segregated with a comma. Each point is differentiated with a pipe. This is an example of 2 points differentiated with pipe, [1.31955,103.84223,"255,255,178"]|[1.31801,103.84224,"175,50,0"]
Specifies the color of all lines. Color must be in RGB format. EG: 255, 0, 255.
Specifies the fill color of all polygons. Color must be in RGB format. EG: 0, 255, 0.
Sample Request
1const data = JSON.stringify(false);
2
3const xhr = new XMLHttpRequest();
4
5xhr.addEventListener("readystatechange", function () {
6 if (this.readyState === this.DONE) {
7 }
8 });
9
10xhr.open("GET", "https://www.onemap.gov.sg/api/staticmap/getStaticImage?layerchosen=default&latitude=1.31955&longitude=103.84223&postal=&zoom=17&width=400&height=512&polygons=[[1.31955,103.84223],[1.31755,103.84223],[1.31755,103.82223],[1.31755,103.81223],[1.31955,103.84223]]:255,0,0&lines=[[1.31955,103.84223],[1.3204859, 103.8438367]]:177,0,0:3&points=[1.31955,103.84223]|[1.3204859, 103.8438367]&color=255,0,255&fillColor=0,255,0");
11
12xhr.setRequestHeader("Authorization", "**********************");
13
14xhr.send(data);Sample Response
1Refer to the sample image shown below:
