Show
const url = 'https://api.wink.travel/api/managing-entity/d5b8a3c2-9e6f-4a1b-8d34-7c2e1f0a5b69/studio/map/f8a3d7e1-2b6c-4f9a-8c15-3e7d1a9c5b42';const options = { method: 'GET', headers: {'Wink-Version': '2.0', Authorization: 'Bearer <token>'}};
try { const response = await fetch(url, options); const data = await response.json(); console.log(data);} catch (error) { console.error(error);}curl --request GET \ --url https://api.wink.travel/api/managing-entity/d5b8a3c2-9e6f-4a1b-8d34-7c2e1f0a5b69/studio/map/f8a3d7e1-2b6c-4f9a-8c15-3e7d1a9c5b42 \ --header 'Authorization: Bearer <token>' \ --header 'Wink-Version: 2.0'Retrieve a single map configuration by its UUID, scoped to the owning managing entity.
Authorizations
Section titled “Authorizations”Parameters
Section titled “Parameters”Path Parameters
Section titled “Path Parameters”UUID of the managing entity that owns the map.
Example
d5b8a3c2-9e6f-4a1b-8d34-7c2e1f0a5b69UUID of the map to retrieve.
Example
f8a3d7e1-2b6c-4f9a-8c15-3e7d1a9c5b42Header Parameters
Section titled “Header Parameters”Responses
Section titled “Responses”Map configuration matching the given identifier
object
GeoJSON point defining map center (longitude, latitude)
object
Optional circular overlay regions on the map
object
Circle center point
object
Circle radius from center
UUID of the customization context (e.g., Wink Links, channel manager)
Which data to display initially (NATIVE, MODIFIED, or AFFILIATE)
Allow users to pan the map by dragging
Unique identifier of this map (assigned by server)
Initial zoom level (0-21, where 0 shows the entire world)
Height of the embedded map in pixels
Hexadecimal color code for map markers
Map visual style (normal, clean, or bluish)
Optional custom markers to display on the map
object
A GeoJSON point
object
Display name for this map
UUID of the managing entity that owns this map
Optional polygonal overlay regions on the map
object
A GeoJSON polygon
object
object
object
object
Optional rectangular overlay regions on the map
object
A GeoJSON rectangle
object
North-east corner of the geographic bounding rectangle
object
South-west corner of the geographic bounding rectangle
object
Category of inventory being displayed (SINGLE, LIST, or SEARCH)
UUID of the inventory source: single channel inventory, curated list, or dynamic search
Allow users to zoom in and out
Example
{ "center": { "coordinates": [ 100.5581533, 13.7370197 ], "type": "Point" }, "circles": [ { "radius": 2.5 } ], "customizationIdentifier": "3c6b1a5d-8e2f-4a0b-9c7d-6e4f0a8b2c51", "displayType": "NATIVE", "draggable": true, "identifier": "3c6b1a5d-8e2f-4a0b-9c7d-6e4f0a8b2c51", "initialZoomLevel": 15, "mapHeight": 500, "mapMarkerColor": "cc2138", "mapStyle": "normal", "name": "Premium Hotels in Southeast Asia", "ownerIdentifier": "d5b8a3c2-9e6f-4a1b-8d34-7c2e1f0a5b69", "type": "LIST", "typeIdentifier": "7a0c5d9e-2f6b-4c1a-8e4d-3b9f1a0c6d52", "zoomable": true}Bad Request — missing or invalid request parameter or body
object
object
Example
Unauthorized — authentication is required or the session has expired
object
object
Example
Forbidden — authenticated but lacking the required permission or scope
object
object
Example
Not Found — the requested resource does not exist
object
object
Example
Method Not Allowed — the HTTP verb is not supported on this endpoint
object
object
Example
Conflict — the resource was modified by someone else since you read it; re-read it and retry with the new version
object
object
Example
Unsupported Media Type — use application/json
object
object
Example
Internal Server Error — an unexpected failure occurred on the server
object
object
Example
Service Unavailable — a downstream dependency is unreachable