Locations

Location data has been significantly improved. The Location object now supports named types and carries a references[] array that links each location to records on external mapping platforms.

🏢 Entity Hierarchy

Entity	Operational Function
Supplier	The legal business address of the operator - their Corporate Headquarters or central depot. This is not necessarily where experiences take place; it represents who the operator is and where they are based.
Product	The main venue or default meeting point for the experience. This is the physical address of the museum, the main entrance of the theme park, or the general starting point for the walking tour - where a guest should go unless a Rate specifies otherwise.
Rate	The option-specific touchpoint. Used when a particular Rate variation has a different logistical path from the Product's primary location. For example, a "VIP Dinner Cruise" Rate may depart from Pier 4 while the standard "Lunch Cruise" Rate departs from Pier 1.

Location Object

Field	Type	Description	Example	Notes
`name`	string	Technical or internal name of the location.	"meetingpoint main"	Optional for the supplier to populate.
`title` New	string	Customer-facing name of the location.	"Main Entrance - Clock Tower"	Optional for the supplier to populate.
`description` New	string	Informational description of the site.	"The historic clock tower built in 1892."	Optional for the supplier to populate.
`notes`	string	Essential arrival instructions or guide tips.	"Look for the guides wearing green umbrellas"	Optional for the supplier to populate.
`type` New	string	The operational role of this location.	"MEETING_POINT"	Optional for the supplier to populate.
`order` New	integer	The sequence of this location in the itinerary (starts at 1).	"1"	Optional for the supplier to populate.
`address[]`	object	A structured physical address for a venue, meeting point, or Supplier headquarters.		Some fields are required to be populated by the Supplier.
`longLat[]`	object	Geographic coordinates for mapping and proximity searches.		Optional for the supplier to populate.
`references[]` New	array[object]	Links to external mapping platforms		Optional for the supplier to populate.

Warning

Deprecated field: city, country, state, utcOffset, googlePlaceId

Location Types New

Every Location carries a type field defining its operational role. You can use the type to determine how to display and label the location in your UI.

Type	Description
`PRIMARY`	The operator's main headquarters or primary check-in point
`START`	Where the experience begins or launches from
`END`	Where the experience concludes or arrives
`VISITED`	A stop along the route; use `order` to sequence
`ITINERARY_ITEM`	An ordered stop in a structured itinerary; use `order` to sequence
POINT_OF_INTEREST	A notable landmark visited during the experience
`ADMISSION_INCLUDED`	A venue where entry is included in the ticket price
`REDEMPTION`	Where the guest exchanges or scans their voucher
`MEETING_POINT`	Where guests gather before the experience begins
`OTHER`	A secondary location or any other location role not covered by the existing enums

Location References New

Every Location can carry a references[] array linking it to records on external mapping platforms. Use these to build deep-links to maps, display venue pages, or enrich location data from third-party sources.

Field	Type	Description
`platform`	string	The external mapping or discovery service providing the reference ID. (see table below)
`id`	string	The unique identifier for the location on the specified platform. Example: `ChIJN1t_tDeuEmsRUsoyG83frY4` for a Google Place ID.
`name`	string	The name of the location as registered on the external platform.
`url`	string	The direct URL to the location's page on the platform.

Supported Platforms New

Platform Enums
`GOOGLE_PLACE_ID`
`APPLE_PLACE_ID`
`TRIPADVISOR_LOCATION_ID`
`YELP_PLACE_ID`
`FACEBOOK_PLACE_ID`
`FOURSQUARE_PLACE_ID`
`BAIDU_PLACE_ID`
`AMAP_PLACE_ID`
`OTHER`

"references": [ { "platform": "GOOGLE_PLACE_ID", "id": "ChIJN1t_tDeuEmsRUsoyG83frY4", "name": "Oceanic Adventures HQ", "url": "https://www.google.com/maps/place/?q=place_id:ChIJN1t_tDeuEmsRUsoyG83frY4" }, { "platform": "TRIPADVISOR_LOCATION_ID", "id": "8765432", "name": "Oceanic Adventures Barcelona", "url": "https://www.tripadvisor.com/Attraction_Review-g123-d8765432" } ]

🔗 Find the full details here: Reseller API Reference

Last updated on

Was this page helpful?