Navigation

Hotelplan Data & Use-Case Access

Logins for Data Access

You can get your credentials by filling out this form.

Use-Case description

Sustainable travel planning

Designing AI-based platforms that provide personalized recommendations for eco-friendly travel options. An AI considers factors such as climate-friendly transportation, eco-friendly accommodations, and responsible tourism practices. Helps travelers minimize their environmental impact before and/or during travel. 

Examples

Example 1

I'm seeking a hotel suitable for a two-week family holiday in May, accommodating two adults and two children. The ideal establishment would offer child-friendly amenities, including a swimming pool and an entertainment team. Our preferred travel duration is no more than six hours. We anticipate a location with minimum temperatures of 20 degrees and predominantly sunny weather. 

Example 2

Kids have school holiday in a month and our family of 4 wants to go on a week holiday with no more than combined 5h travel one way. Something warm like Mallorca but, if possible, no flying. Separate rooms for kids, preferably one apartment or big suite. If an electric car is possible, I’d like to rent one for us, big enough for all of us and a load station at the hotel. 

Example 3

Flights are too expensive to go to Paris and I’d like to take my partner there. What's the best way to go there when ist not too hot and crowded without flying? I’d like to make it into a trip with sightseeing but also eating in restaurants in local areas and staying a bit outside the main tourist areas. Budget per night is 150 CHF for hotel.  

Data

All data is provided in JSON format, with a supporting schema containing detailed field descriptions for data interpretation and manipulation. You can find this in the zip file 'hotelplancase.zip'.

Export contents and structure

Data export contains all geographical and hotel data available to be booked on hotelplan.ch. The export is a directed acyclic graph that has the following structure:

Hotelplan

You will have access to a wealth of structured and unstructured data relating to geographical entities and associated products.

Since exporting graph is not easily done using a simple json document without duplicating tons of data, the export is provided in a tree form with optional relationships only listing node ids:

continents
  all attributes of continents
  countryGroups
    all attributes of countryGroups
    countries
      id
  countries
    all attributes of countries
    regions
      destionations
        id
    destionations
      all attributes of destinations
      resorts
       all attributes of resorts
         hotels
           all attributes of hotels

Each node within this tree structure holds a set of structured attributes, including: 

  • Boolean Flags: Binary attributes indicating specific resort features, such as the presence of a "sandy-beach" or a "cobble-stone-beach", and others. 
  • Numerical Values: Quantifiable metrics such as the average number of sunny hours per day in a given month, and others. 

The unstructured attributes: 

  • Text: Free-form "LeadText" descriptions providing detailed insights about geographical nodes and related products. 
  • Images: Visual content showcasing geographical objects and products. 

Field descriptions and types

GraphQL schema with field descriptions is in the enclosed file `schema.graphql`. You can use this schema for reference only or feed it to a code generator (e.g.https://the-guild.dev/graphql/codegen) so that it's easier to parse.

The root type is `FdrGeoResponse`.
 

Generating links to hotelplan.ch

You can use `https://www.hotelplan.ch/<publicId>` URL to navigate users to a specific object on our website.

For example, a hotel with `publicId` of `h-826` can be accessed via a URL of https://www.hotelplan.ch/h-826.

External data sources

In addition to the provided data, participants are encouraged to incorporate relevant external data sources to enrich their solutions. This open-data approach will enable the creation of more comprehensive and accurate AI-driven recommendations. These external data sources may include carbon dioxide emissions data, sustainable route information from mapping APIs, data on local sustainable practices, climate data, and sustainability ratings from trusted third-party sources. 


Some API examples: