Core Information Strings

This is a simple boolean - however for data constancy, or parsing reasons may have to be enforced as a string. Standard reads for a true would be 'true', 'TRUE', 'yes', 'YES', '1'

{
  "homeOwnersEnabled": "true",
  "whatsOnAutoSelectOwners": "false",
  "multiSiteShowDetail": "false",
}

Float and Double values are handled as normal JSON. Depending on the precision of the language sending/receiving the data can depend on the truncation of the decimal points. However due to the context of our data, only location lat/lng numbers will normally have more than 2-3 points.

{
  "cost": 55.5,
  "lat": 50.71245750791539,
  "lng":  -2.4619866156242995
}

Our app surfaces talk to an image engine on our infrastructure to process and resize images for different smart phone screen densities. Because of this the size of images are less relevant as they are delivered at optimum sizes anyway. However due to processing power and speed we do recommend that image urls are all 3000 pixels or below. The app surfaces will never need an image this large, so it gives you the option of still having a large quality image, but can be loaded in the apps and our infrastructure efficiently. We support both png, jpeg, and webp images. You can optionally include a '?v=' version integer so this can be used for versioning. If you do include this you can ensure images are reprocessed if the source image is changed on your servers.

{
  "imgUrl": "https://your-wordpress-site.com/wp-content/uploads/2023/08/a-large-image-3000x2100.jpg?v=1691481892",
  "image": "https://your-wordpress-site.com/wp-content/uploads/2023/08/a-smaller-image.png"
}

Standard JSON Integer - 0 is commonly considered to be a default value, unless it is an valid ID when -1 is used. For sort priorities 99 is used as the default.

{
  "key1": 9,
  "key2": 42,
  "arrayOfInts": [
    2,
    3,
    5,
    8
  ] 
}

This is a set of string definitions for filters available on some lists. These are mixed together for both the holiday homes for sale section, and the routes section - however when sending these values, single groups should be used. These should be semicolon delimited, out of the following available options :
• "difficulty" - Difficulty (Routes)
• "activity" - Activity (Routes)
• "terrain" - Terrain (Routes)
• "tags" - Tags (Routes)

• "location" - Location (Home Sales)
• "condition" - Condition (Home Sales)
• "rooms" - Rooms (Home Sales)
• "sleeps" - Sleeps (Home Sales)
• "size" - Size (Home Sales)
• "manufacturer": "Manufacturer (Home Sales)

{
  "routeFilters": "difficulty;activity;terrain;tags",
  "homesalesFilters": "location;condition;rooms;sleeps;size"
}

This is a single or set of several string definitions to set what sort options are available on some lists These are mixed together for both the holiday homes for sale section, and the routes section - however when sending these values, single groups should be used. If it is a set then these should be semicolon delimited, out of the following available options :
• "featured": "Featured (Routes & Home Sales)

• "distancelowhigh" - Distance From Park Low to High (Routes)
• "distancehighlow" - Distance From Park High to Low (Routes)
• "difficultylowhigh" - Difficulty From Park Low to High (Routes)
• "difficultyhighlow" - Difficulty From Park High to Low (Routes)
• "lengthlowhigh" - Length From Park Low to High (Routes)
• "lengthhighlow" - Length From Park High to Low (Routes)
• "durationlowhigh" - Duration From Park Low to High (Routes)
• "durationhighlow" - Duration From Park High to Low (Routes)

• "pricelowhigh" - Price Low to High (Home Sales)
• "pricehighlow" - Price High to Low (Home Sales)

{
  "routeSorts": "featured;distancelowhigh;distancehighlow;difficultylowhigh;difficultyhighlow;lengthlowhigh;lengthhighlow;durationlowhigh;durationhighlow",
  "routeDefaultSort": "distancelowhigh",
  "homesalesSorts": "pricelowhigh;pricehighlow",
  "homesalesDefaultSort": "pricelowhigh"
}

This is string definition to set how embedded google maps should render in the app. The options available are :
• "road" - Standard Google Maps Road
• "satellite" - Satellite Photo View

{
  "mapStyle": "satelitte"
}

This is string definition to set which PMS Booking login the app should use. The options available are :
• "guest" - Do not have a login process for whole app (Single Site Guest Mode)
• "manual" - Manual booking process (User adds own arrival / departure etc)
• "bex" - ParcVu Booking Experts PMS login
• "parcvu" - ParcVu Classic PMS login
• "gemapark" - GemaPark PMS login
• "rms" - RMS Cloud PMS login
• "elite" - Elite Dynamics PMS login
• "campmanager" - Campmanager PMS login
• "prophet" - Prophet Bookings PMS login
• "bespoke" - In-house / Bespoke PMS login

{
  "pmsType": "bex"
}

Acts the same as the standard String type, however If text is assumed to include line breaks then we use a place holder of #BREAK#. These will then be replaced by the relevant line breaks depending on the language, and device that is rendering the text. This is commonly used in entity copy, and addresses. Rich text should not include HTML or other markup. There should always be a contextual consideration as well - for example if you copy includes a html anchor link to 'Read More' - then simply removing the markup will then leave the text 'Read More' which will be a redundant, none clickable piece of text within the app surfaces.

{
  "textWithBullets": "This paragraph will now have two line breaks, and then a list of bullets#BREAK##BREAK#• Bullet 1#BREAK#• Bullet 2#BREAK#• Bullet 3",
  "address": "Holidaymaker App Ltd#BREAK#Stowey House#BREAK#Bridport Road#BREAK#Dorchester#BREAK#DT12SB"
}

This is a set of up to three string definitions to set what social icons to use. These should be semicolon delimited, out of the following available options :
• "none" - Do not show an icon is this position (default)
• "twitter" - Twitter using the legacy blue bird icon
• "twitterx" - Twitter using recent 'X' black logo
• "tiktok" - TikTok
• "facebook" - Facebook
• "instagram" - Instagram
• "youtube" - YouTube
• "threads" - Threads
• "logo" - Brand / Company logo - this will navigate to main park website - on CMS restricts users from selecting this option for the middle position only

{
  "socialIcons": "threads;instagram;tiktok"
}

Standard JSON String - Often will have certain characters escaped depending what system is writing the JSON packet, however our parser only requires to have double quotes (") escaped. UTF-8 encoding is our standard, but others may be accepted if required. If line breaks are required in the text then the Rich Text / Multiline String type is used instead.

{
  "key1": "A string value",
  "key2": "Another string with an some \"quotes\" that need escaping",
  "arrayOfStrings": [
    "Item one as a string",
    "Item two as a string",
    "Item three as a string",
  ] 
}

A Url is sent the same as a string. If our system knows this is a url it will check if it starts with http or https - Note that navigating from both iOS and Android should use https.

{
  "bookingUrl" : "https://portal.managebooking.pmssystem"
}

This is string definition of which weather source the app should currently have. The options available are :
• "metoffice - Met Office
• "openweathermap" - Open Weather Map

{
  "weatherType": "metoffice"
}

This is a single or set of several string definitions to set what date ranges are available in the what's on section. If it is a set then these should be semicolon delimited, out of the following available options :
• "all" - All
• "today" - Today
• "tomorrow" - Tomorrow
• "stay" - Your Stay
• "week" - This Week
• "month" - This Month

{
  "whatsOnDateRanges": "today;tomorrow;stay;week;month",
  "whatsOnDefaultRange": "week",
  "whatsOnDefaultRangeSignedIn": "stay",
  "whatsOnDefaultRangeOwners": "month"
}