search

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.

hashtag
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.

hashtag
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
chevron-right
200

PNG image of the map

image/png
Responsestring · binary
get
/v2/map.png

hashtag
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
chevron-right
200

PNG image

image/png
string · binaryOptional
get
/v1/map.png

hashtag
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
chevron-right
200

PNG minimap image

image/png
Responsestring · binary
get
/v1/minimap.png

hashtag
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
chevron-right
200

PNG estate map image

image/png
string · binaryOptional
get
/v1/estatemap.png

hashtag
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
chevron-right
200

PNG image centered on the parcel

image/png
string · binaryOptional
get
/v2/parcels/{x}/{y}/map.png

hashtag
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
chevron-right
200

PNG image

image/png
string · binaryOptional
get
/v1/parcels/{x}/{y}/map.png

hashtag
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
chevron-right
200

PNG image centered on the estate

image/png
string · binaryOptional
get
/v2/estates/{estateId}/map.png

hashtag
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
chevron-right
200

PNG image

image/png
string · binaryOptional
get
/v1/estates/{estateId}/map.png
PreviousTilesNextNFT Metadata

Last updated