# Map
Specialized endpoints for map applications that need coordinate-based queries and bulk place data. Optimized for displaying places on a visual map interface.
## Get places for map display
> Retrieve places organized by coordinates, optimized for map visualization.\
> \
> \*\*Map Response Format:\*\* Returns an object with coordinates as keys and place data as values,\
> making it easy to display places on a coordinate grid.\
> \
> \*\*Use Case:\*\* Building interactive maps of Genesis City showing which places exist at each parcel.\
> \
> \*\*Performance:\*\* Higher limit (1000 default) for bulk map loading.
```json
{"openapi":"3.0.3","info":{"title":"Decentraland Places API","version":"1.0.0"},"tags":[{"name":"Map","description":"Specialized endpoints for map applications that need coordinate-based queries and bulk place data.\nOptimized for displaying places on a visual map interface.\n"}],"servers":[{"url":"https://places.decentraland.org/api","description":"Production server"},{"url":"http://localhost:4000/api","description":"Development server"}],"security":[],"paths":{"/map":{"get":{"tags":["Map"],"summary":"Get places for map display","description":"Retrieve places organized by coordinates, optimized for map visualization.\n\n**Map Response Format:** Returns an object with coordinates as keys and place data as values,\nmaking it easy to display places on a coordinate grid.\n\n**Use Case:** Building interactive maps of Genesis City showing which places exist at each parcel.\n\n**Performance:** Higher limit (1000 default) for bulk map loading.\n","operationId":"getMapPlaces","parameters":[{"name":"limit","in":"query","description":"Maximum number of places (default 1000, suitable for maps)","required":false,"schema":{"type":"integer","minimum":0,"maximum":2000,"default":1000}},{"name":"offset","in":"query","required":false,"schema":{"type":"integer","minimum":0,"default":0}},{"name":"positions","in":"query","description":"Filter by specific coordinates","required":false,"schema":{"type":"array","items":{"type":"string","pattern":"^-?\\d{1,3},-?\\d{1,3}$"}},"style":"form","explode":true},{"name":"only_favorites","in":"query","required":false,"schema":{"type":"boolean"}},{"name":"only_highlighted","in":"query","required":false,"schema":{"type":"boolean"}},{"name":"order_by","in":"query","required":false,"schema":{"type":"string","enum":["like_score","most_active","updated_at","created_at"]}},{"name":"order","in":"query","required":false,"schema":{"type":"string","enum":["asc","desc"]}},{"name":"with_realms_detail","in":"query","description":"Include real-time realm data for each place","required":false,"schema":{"type":"boolean"}},{"name":"search","in":"query","required":false,"schema":{"type":"string","minLength":3}},{"name":"categories","in":"query","required":false,"schema":{"type":"array","items":{"type":"string"}},"style":"form","explode":true}],"responses":{"200":{"description":"Map data retrieved successfully","content":{"application/json":{"schema":{"type":"object","description":"Places indexed by coordinates for map display","properties":{"ok":{"type":"boolean"},"data":{"type":"object","description":"Object with coordinates as keys and place data as values","additionalProperties":{"type":"object","description":"A place (scene) in Genesis City or a Decentraland World.\n\n**Place ID Persistence:** The UUID is preserved across scene redeployments when:\n- New deployment contains all previous parcels (growing)\n- New deployment keeps the same base parcel (reshaping/shrinking)\n\nThe UUID changes when the scene moves to different parcels with a different base.\nThis ensures favorites, likes, and social data persist through scene updates.\n","properties":{"id":{"type":"string","format":"uuid","description":"Persistent unique identifier for the place. This UUID is maintained across scene\nredeployments as long as the scene keeps the same base parcel or contains all\nprevious parcels. See \"Place ID Semantics\" in the API description for details.\n"},"title":{"type":"string","maxLength":50,"description":"Display name of the place","nullable":true},"description":{"type":"string","maxLength":5000,"description":"Long-form description of the place content","nullable":true},"image":{"type":"string","format":"uri","description":"URL to the place thumbnail/preview image (from navmapThumbnail or generated)","nullable":true},"owner":{"type":"string","maxLength":42,"description":"Ethereum address of the place owner","nullable":true},"positions":{"type":"array","description":"All parcel coordinates occupied by this place. Places can span multiple parcels.\n**UUID Preservation:** If a new deployment contains all these parcels plus additional ones,\nthe Place UUID is preserved (scene growth). However, if parcels are removed or changed,\nthe UUID may change unless the base_position remains the same.\n","items":{"type":"string","pattern":"^-?\\d{1,3},-?\\d{1,3}$"}},"base_position":{"type":"string","pattern":"^-?\\d{1,3},-?\\d{1,3}$","description":"Primary/spawn coordinate for the place. This is the main parcel where users spawn\nwhen entering the scene. **Important:** The base parcel is key to Place ID persistence -\nkeeping the same base parcel across deployments preserves the Place UUID and all\nassociated user data (favorites, likes, etc.).\n"},"contact_name":{"type":"string","maxLength":5000,"description":"Contact person name for the place","nullable":true},"contact_email":{"type":"string","maxLength":5000,"description":"Contact email for the place","nullable":true},"content_rating":{"type":"string","maxLength":1,"description":"Age appropriateness rating:\n- PR: Pre-Teen (10+)\n- E: Everyone (all ages)\n- T: Teen (13+)\n- A: Adult (18+)\n- R: Restricted (18+, explicit)\n","enum":["PR","E","T","A","R"]},"likes":{"type":"integer","minimum":0,"description":"Total number of likes received"},"dislikes":{"type":"integer","minimum":0,"description":"Total number of dislikes received"},"like_score":{"type":"number","minimum":0,"maximum":1,"description":"Quality score (0-1) based on VP-weighted likes/dislikes.\nHigher score = better quality. Null if insufficient votes.\n","nullable":true},"like_rate":{"type":"number","minimum":0,"maximum":1,"description":"Simple like ratio (likes / total votes), not VP-weighted","nullable":true},"ranking":{"type":"number","description":"External ranking value for custom ordering","nullable":true,"default":0},"highlighted":{"type":"boolean","description":"True if this place is highlighted/featured by administrators.\nHighlighted places appear at the top of listing endpoints.\n"},"favorites":{"type":"integer","minimum":0,"description":"Number of users who favorited this place"},"disabled":{"type":"boolean","description":"True if place is disabled (not shown publicly)"},"disabled_at":{"type":"string","format":"date-time","description":"Timestamp when place was disabled","nullable":true},"created_at":{"type":"string","format":"date-time","description":"When the place was first created"},"updated_at":{"type":"string","format":"date-time","description":"Last update to place metadata"},"deployed_at":{"type":"string","format":"date-time","description":"Last scene deployment timestamp"},"user_like":{"type":"boolean","description":"True if authenticated user liked this place"},"user_dislike":{"type":"boolean","description":"True if authenticated user disliked this place"},"user_favorite":{"type":"boolean","description":"True if authenticated user favorited this place"},"user_count":{"type":"integer","minimum":0,"description":"Current number of users in the place (real-time)"},"user_visits":{"type":"integer","minimum":0,"description":"Total unique users who visited in the last 30 days"},"categories":{"type":"array","description":"Categories/tags assigned to this place","items":{"type":"string"}},"realms_detail":{"type":"array","description":"Per-realm user distribution (only if with_realms_detail=true)","items":{"type":"object","description":"A Decentraland realm (server) with real-time user data","properties":{"serverName":{"type":"string","description":"Human-readable realm server name"},"url":{"type":"string","format":"uri","description":"Realm connection URL"},"usersCount":{"type":"integer","minimum":0,"description":"Total users currently in this realm"},"userParcels":{"type":"array","description":"Coordinates where users are located in this realm","items":{"type":"array","minItems":2,"maxItems":2,"items":{"type":"integer"},"description":"[x, y] coordinate pair"}}}}},"sdk":{"type":"string","description":"SDK/runtime version (e.g., \"7\" for SDK7)","nullable":true},"connected_addresses":{"type":"array","description":"List of wallet addresses currently connected to this place.\nOnly included when `with_connected_users=true` query parameter is set.\n","items":{"type":"string","pattern":"^0x[a-fA-F0-9]{40}$"}}}}},"total":{"type":"integer","description":"Total number of unique coordinates with places"}}}}}},"400":{"description":"Bad request - Invalid parameters or malformed request","content":{"application/json":{"schema":{"type":"object","description":"Standard error response","properties":{"ok":{"type":"boolean","description":"Always false for errors"},"error":{"type":"string","description":"Human-readable error message"}}}}}},"500":{"description":"Internal server error - Something went wrong on the server","content":{"application/json":{"schema":{"type":"object","description":"Standard error response","properties":{"ok":{"type":"boolean","description":"Always false for errors"},"error":{"type":"string","description":"Human-readable error message"}}}}}}}}}}}
```
## Get all places and worlds for map
> Retrieve both Genesis City places AND Decentraland Worlds in a single query.\
> \
> \*\*Combined Data:\*\* Merges places and worlds into one result set for comprehensive map display.\
> \
> \*\*Use Case:\*\* Applications that need to show all available content (places + worlds) on a single map interface.\
> \
> \*\*Higher Limits:\*\* Default limit of 2000 to accommodate both places and worlds.
```json
{"openapi":"3.0.3","info":{"title":"Decentraland Places API","version":"1.0.0"},"tags":[{"name":"Map","description":"Specialized endpoints for map applications that need coordinate-based queries and bulk place data.\nOptimized for displaying places on a visual map interface.\n"}],"servers":[{"url":"https://places.decentraland.org/api","description":"Production server"},{"url":"http://localhost:4000/api","description":"Development server"}],"security":[],"paths":{"/map/places":{"get":{"tags":["Map"],"summary":"Get all places and worlds for map","description":"Retrieve both Genesis City places AND Decentraland Worlds in a single query.\n\n**Combined Data:** Merges places and worlds into one result set for comprehensive map display.\n\n**Use Case:** Applications that need to show all available content (places + worlds) on a single map interface.\n\n**Higher Limits:** Default limit of 2000 to accommodate both places and worlds.\n","operationId":"getAllMapPlaces","parameters":[{"name":"limit","in":"query","description":"Maximum results (default 2000 for places + worlds)","required":false,"schema":{"type":"integer","minimum":0,"maximum":5000,"default":2000}},{"name":"offset","in":"query","required":false,"schema":{"type":"integer","minimum":0,"default":0}},{"name":"positions","in":"query","description":"Filter places by coordinates","required":false,"schema":{"type":"array","items":{"type":"string","pattern":"^-?\\d{1,3},-?\\d{1,3}$"}},"style":"form","explode":true},{"name":"names","in":"query","description":"Filter worlds by names","required":false,"schema":{"type":"array","items":{"type":"string"}},"style":"form","explode":true},{"name":"only_favorites","in":"query","required":false,"schema":{"type":"boolean"}},{"name":"only_highlighted","in":"query","required":false,"schema":{"type":"boolean"}},{"name":"order_by","in":"query","required":false,"schema":{"type":"string","enum":["like_score","most_active","updated_at","created_at"]}},{"name":"order","in":"query","required":false,"schema":{"type":"string","enum":["asc","desc"]}},{"name":"with_realms_detail","in":"query","required":false,"schema":{"type":"boolean"}},{"name":"search","in":"query","required":false,"schema":{"type":"string","minLength":3}},{"name":"categories","in":"query","required":false,"schema":{"type":"array","items":{"type":"string"}},"style":"form","explode":true}],"responses":{"200":{"description":"Combined places and worlds retrieved","content":{"application/json":{"schema":{"type":"object","properties":{"ok":{"type":"boolean"},"data":{"type":"array","items":{"type":"object","description":"A place (scene) in Genesis City or a Decentraland World.\n\n**Place ID Persistence:** The UUID is preserved across scene redeployments when:\n- New deployment contains all previous parcels (growing)\n- New deployment keeps the same base parcel (reshaping/shrinking)\n\nThe UUID changes when the scene moves to different parcels with a different base.\nThis ensures favorites, likes, and social data persist through scene updates.\n","properties":{"id":{"type":"string","format":"uuid","description":"Persistent unique identifier for the place. This UUID is maintained across scene\nredeployments as long as the scene keeps the same base parcel or contains all\nprevious parcels. See \"Place ID Semantics\" in the API description for details.\n"},"title":{"type":"string","maxLength":50,"description":"Display name of the place","nullable":true},"description":{"type":"string","maxLength":5000,"description":"Long-form description of the place content","nullable":true},"image":{"type":"string","format":"uri","description":"URL to the place thumbnail/preview image (from navmapThumbnail or generated)","nullable":true},"owner":{"type":"string","maxLength":42,"description":"Ethereum address of the place owner","nullable":true},"positions":{"type":"array","description":"All parcel coordinates occupied by this place. Places can span multiple parcels.\n**UUID Preservation:** If a new deployment contains all these parcels plus additional ones,\nthe Place UUID is preserved (scene growth). However, if parcels are removed or changed,\nthe UUID may change unless the base_position remains the same.\n","items":{"type":"string","pattern":"^-?\\d{1,3},-?\\d{1,3}$"}},"base_position":{"type":"string","pattern":"^-?\\d{1,3},-?\\d{1,3}$","description":"Primary/spawn coordinate for the place. This is the main parcel where users spawn\nwhen entering the scene. **Important:** The base parcel is key to Place ID persistence -\nkeeping the same base parcel across deployments preserves the Place UUID and all\nassociated user data (favorites, likes, etc.).\n"},"contact_name":{"type":"string","maxLength":5000,"description":"Contact person name for the place","nullable":true},"contact_email":{"type":"string","maxLength":5000,"description":"Contact email for the place","nullable":true},"content_rating":{"type":"string","maxLength":1,"description":"Age appropriateness rating:\n- PR: Pre-Teen (10+)\n- E: Everyone (all ages)\n- T: Teen (13+)\n- A: Adult (18+)\n- R: Restricted (18+, explicit)\n","enum":["PR","E","T","A","R"]},"likes":{"type":"integer","minimum":0,"description":"Total number of likes received"},"dislikes":{"type":"integer","minimum":0,"description":"Total number of dislikes received"},"like_score":{"type":"number","minimum":0,"maximum":1,"description":"Quality score (0-1) based on VP-weighted likes/dislikes.\nHigher score = better quality. Null if insufficient votes.\n","nullable":true},"like_rate":{"type":"number","minimum":0,"maximum":1,"description":"Simple like ratio (likes / total votes), not VP-weighted","nullable":true},"ranking":{"type":"number","description":"External ranking value for custom ordering","nullable":true,"default":0},"highlighted":{"type":"boolean","description":"True if this place is highlighted/featured by administrators.\nHighlighted places appear at the top of listing endpoints.\n"},"favorites":{"type":"integer","minimum":0,"description":"Number of users who favorited this place"},"disabled":{"type":"boolean","description":"True if place is disabled (not shown publicly)"},"disabled_at":{"type":"string","format":"date-time","description":"Timestamp when place was disabled","nullable":true},"created_at":{"type":"string","format":"date-time","description":"When the place was first created"},"updated_at":{"type":"string","format":"date-time","description":"Last update to place metadata"},"deployed_at":{"type":"string","format":"date-time","description":"Last scene deployment timestamp"},"user_like":{"type":"boolean","description":"True if authenticated user liked this place"},"user_dislike":{"type":"boolean","description":"True if authenticated user disliked this place"},"user_favorite":{"type":"boolean","description":"True if authenticated user favorited this place"},"user_count":{"type":"integer","minimum":0,"description":"Current number of users in the place (real-time)"},"user_visits":{"type":"integer","minimum":0,"description":"Total unique users who visited in the last 30 days"},"categories":{"type":"array","description":"Categories/tags assigned to this place","items":{"type":"string"}},"realms_detail":{"type":"array","description":"Per-realm user distribution (only if with_realms_detail=true)","items":{"type":"object","description":"A Decentraland realm (server) with real-time user data","properties":{"serverName":{"type":"string","description":"Human-readable realm server name"},"url":{"type":"string","format":"uri","description":"Realm connection URL"},"usersCount":{"type":"integer","minimum":0,"description":"Total users currently in this realm"},"userParcels":{"type":"array","description":"Coordinates where users are located in this realm","items":{"type":"array","minItems":2,"maxItems":2,"items":{"type":"integer"},"description":"[x, y] coordinate pair"}}}}},"sdk":{"type":"string","description":"SDK/runtime version (e.g., \"7\" for SDK7)","nullable":true},"connected_addresses":{"type":"array","description":"List of wallet addresses currently connected to this place.\nOnly included when `with_connected_users=true` query parameter is set.\n","items":{"type":"string","pattern":"^0x[a-fA-F0-9]{40}$"}}}},"description":"Array containing both places and worlds"},"total":{"type":"integer","description":"Total count of places and worlds"}}}}}},"400":{"description":"Bad request - Invalid parameters or malformed request","content":{"application/json":{"schema":{"type":"object","description":"Standard error response","properties":{"ok":{"type":"boolean","description":"Always false for errors"},"error":{"type":"string","description":"Human-readable error message"}}}}}},"500":{"description":"Internal server error - Something went wrong on the server","content":{"application/json":{"schema":{"type":"object","description":"Standard error response","properties":{"ok":{"type":"boolean","description":"Always false for errors"},"error":{"type":"string","description":"Human-readable error message"}}}}}}}}}}}
```
---
# Agent Instructions: Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.
Perform an HTTP GET request on the current page URL with the `ask` query parameter:
```
GET https://docs.decentraland.org/apis/apis/places/map.md?ask=
```
The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.
Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.