Map Images

Endpoints for generating PNG images of the Decentraland map. Images can be customized with various parameters such as size, center, and highlighted parcels.

Generate a PNG image of the map

get

/v2/map.png

Generates a customizable PNG image of the Decentraland map. You can control the dimensions, tile size, center point, and highlight specific parcels. Optional overlays include parcels on sale and rental listings.

Parameters

• width/height: Image dimensions (100-4096px, default: 1024)

• size: Size of each tile in pixels (5-50px, default: 20)

• center: Coordinates to center the map on

• selected: Semicolon-separated list of coordinates to highlight

• on-sale: Show parcels listed for sale in blue

• listed-for-rent: Show parcels available for rent

Query parameters

widthinteger · min: 100 · max: 4096Optional

Width of the image in pixels

Default: 1024Example: 2048

heightinteger · min: 100 · max: 4096Optional

Height of the image in pixels

Default: 1024Example: 2048

sizeinteger · min: 5 · max: 50Optional

Size of each tile in pixels

Default: 20Example: 20

centerstringOptional

Center coordinates in format "x,y"

Example: 0,0

selectedstringOptional

Semicolon-separated list of coordinates to highlight (format "x1,y1;x2,y2;...")

Example: 10,10;10,11;11,10;11,11

on-salebooleanOptional

Highlight parcels that are on sale

Default: falseExample: true

listed-for-rentbooleanOptional

Highlight parcels that are listed for rent

Default: falseExample: true

Responses

200

PNG image of the map

image/png

Responsestring · binary

500

Error generating image

application/json

503

Service not ready

get/v2/map.png

GET /v2/map.png HTTP/1.1
Host: api.decentraland.org
Accept: */*

binary

Generate a PNG image of the map (v1)

get

/v1/map.png

Version 1 of the map image endpoint. Functionally identical to v2.

Query parameters

widthinteger · min: 100 · max: 4096OptionalDefault: 1024

heightinteger · min: 100 · max: 4096OptionalDefault: 1024

sizeinteger · min: 5 · max: 50OptionalDefault: 20

centerstringOptional

selectedstringOptional

on-salebooleanOptional

listed-for-rentbooleanOptional

Responses

200

PNG image

image/png

string · binaryOptional

500

Error

application/json

503

Not ready

get/v1/map.png

GET /v1/map.png HTTP/1.1
Host: api.decentraland.org
Accept: */*

binary

Generate a minimap PNG image

get

/v1/minimap.png

Generates a minimap view of the entire Decentraland world. This endpoint uses extended caching (10 minutes) for better performance.

Responses

200

PNG minimap image

image/png

Responsestring · binary

500

Error generating minimap

application/json

503

Service not ready

get/v1/minimap.png

GET /v1/minimap.png HTTP/1.1
Host: api.decentraland.org
Accept: */*

binary

Generate an estate-focused minimap PNG image

get

/v1/estatemap.png

Generates a minimap view with emphasis on estate boundaries. Uses extended caching (10 minutes) for better performance.

Responses

200

PNG estate map image

image/png

string · binaryOptional

500

Error

application/json

503

Not ready

get/v1/estatemap.png

GET /v1/estatemap.png HTTP/1.1
Host: api.decentraland.org
Accept: */*

binary

Generate a map image centered on a specific parcel

get

/v2/parcels/{x}/{y}/map.png

Generates a PNG image of the map centered on and highlighting a specific parcel. The parcel is automatically selected and centered in the generated image.

Path parameters

xintegerRequired

X coordinate of the parcel

Example: 23

yintegerRequired

Y coordinate of the parcel

Example: -23

Query parameters

widthinteger · min: 100 · max: 4096OptionalDefault: 1024

heightinteger · min: 100 · max: 4096OptionalDefault: 1024

sizeinteger · min: 5 · max: 50OptionalDefault: 20

on-salebooleanOptional

listed-for-rentbooleanOptional

Responses

200

PNG image centered on the parcel

image/png

string · binaryOptional

500

Error

application/json

503

Not ready

get/v2/parcels/{x}/{y}/map.png

GET /v2/parcels/{x}/{y}/map.png HTTP/1.1
Host: api.decentraland.org
Accept: */*

binary

Generate a map image centered on a specific parcel (v1)

get

/v1/parcels/{x}/{y}/map.png

Version 1 of the parcel map endpoint. Functionally identical to v2.

Path parameters

xintegerRequired

yintegerRequired

Query parameters

widthintegerOptional

heightintegerOptional

sizeintegerOptional

on-salebooleanOptional

listed-for-rentbooleanOptional

Responses

200

PNG image

image/png

string · binaryOptional

500

Error

503

Not ready

get/v1/parcels/{x}/{y}/map.png

GET /v1/parcels/{x}/{y}/map.png HTTP/1.1
Host: api.decentraland.org
Accept: */*

binary

Generate a map image centered on a specific estate

get

/v2/estates/{estateId}/map.png

Generates a PNG image of the map centered on and highlighting all parcels that belong to a specific estate. If the estate has been dissolved, redirects to a dissolved estate image.

Path parameters

estateIdstringRequired

Estate ID

Example: 12345

Query parameters

widthinteger · min: 100 · max: 4096OptionalDefault: 1024

heightinteger · min: 100 · max: 4096OptionalDefault: 1024

sizeinteger · min: 5 · max: 50OptionalDefault: 20

on-salebooleanOptional

listed-for-rentbooleanOptional

Responses

200

PNG image centered on the estate

image/png

string · binaryOptional

302

Redirect to dissolved estate image

500

Error

application/json

503

Not ready

get/v2/estates/{estateId}/map.png

GET /v2/estates/{estateId}/map.png HTTP/1.1
Host: api.decentraland.org
Accept: */*

binary

Generate a map image centered on a specific estate (v1)

get

/v1/estates/{estateId}/map.png

Version 1 of the estate map endpoint. Functionally identical to v2.

Path parameters

estateIdstringRequired

Query parameters

widthintegerOptional

heightintegerOptional

sizeintegerOptional

on-salebooleanOptional

listed-for-rentbooleanOptional

Responses

200

PNG image

image/png

string · binaryOptional

302

Redirect to dissolved estate image

500

Error

503

Not ready

get/v1/estates/{estateId}/map.png

GET /v1/estates/{estateId}/map.png HTTP/1.1
Host: api.decentraland.org
Accept: */*

binary