Maps
Maps describe published destinations and the content that belongs to them. Set BASE_URL as shown in the API overview before running these examples.
Get a map
Section titled “Get a map”GET /maps/:map_id
Returns a map and the requested related sections. Each section flag is passed as a string; use true to request it.
| Parameter | In | Required | Description |
|---|---|---|---|
map_id | Path | Yes | Map UUID. |
info | Query | No | Include map information. |
all_categories | Query | No | Include all categories. |
categories | Query | No | Include categories. |
markers | Query | No | Include markers. |
paths | Query | No | Include paths. |
polygons | Query | No | Include polygons. |
publisher | Query | No | Include publisher data. |
map_data | Query | No | Include map data. |
contact | Query | No | Include contact data. |
map_sponsors | Query | No | Include map sponsors. |
version_id | Query | No | Return content from this map-version UUID. |
tag_counts | Query | No | Comma-separated tag IDs (from GET /places-of-interest/items/:map_id). Returns how many POIs carry each one. Not a boolean: tag_counts=true returns null. |
contents | Query | No | Include map content blocks. |
curl --get "$BASE_URL/maps/c2025939-af64-4371-a281-c6818b2cd96e" \ --data-urlencode "info=true" \ --data-urlencode "categories=true" \ --data-urlencode "publisher=true"Get map details
Section titled “Get map details”GET /maps/:map_id/details
Returns identity and presentation details for one map. This endpoint can also return the limited identity and branding needed to represent a disabled map.
| Parameter | In | Required | Description |
|---|---|---|---|
map_id | Path | Yes | Map UUID. |
curl "$BASE_URL/maps/c2025939-af64-4371-a281-c6818b2cd96e/details"Get map contents
Section titled “Get map contents”GET /maps/:map_id/contents
Returns the content blocks associated with a map.
| Parameter | In | Required | Description |
|---|---|---|---|
map_id | Path | Yes | Map UUID. |
curl "$BASE_URL/maps/c2025939-af64-4371-a281-c6818b2cd96e/contents"Publishers
Section titled “Publishers”Publishers are the destination organizations that maintain maps and their content.
Get a publisher
Section titled “Get a publisher”GET /publisher/:publisher_id
Returns one publisher by ID.
| Parameter | In | Required | Description |
|---|---|---|---|
publisher_id | Path | Yes | Publisher UUID. |
curl "$BASE_URL/publisher/d20f7613-0cc3-4586-a95c-7cd2575127ca"List a publisher’s maps
Section titled “List a publisher’s maps”GET /publisher/:publisher_id/maps
Returns the publisher, with its published maps in a maps array: { id, name, handle, logo, …, maps: [...] }. You can provide a coordinate to order the maps by proximity. Maps that are not published to Wander discovery are left out.
| Parameter | In | Required | Description |
|---|---|---|---|
publisher_id | Path | Yes | Publisher UUID. |
lng | Query | No | Longitude used with lat. |
lat | Query | No | Latitude used with lng. |
curl --get "$BASE_URL/publisher/d20f7613-0cc3-4586-a95c-7cd2575127ca/maps" \ --data-urlencode "lat=40.7128" \ --data-urlencode "lng=-74.0060"