Hotel- und Zimmerdaten von HotellerieSuisse stehen über das Infocenter von discover.swiss zur Verfügung. Diese Seite soll helfen die Daten von HotellerieSuisse abzurufen.
Zugriff¶
Die Daten können kostenfrei von über die Infocenter API abgerufen werden. Der freie Infocenterzugang ist jedoch in der Funktion eingeschränkt. Folgende Einschränkungen bestehen:
- Die umfangreichen Suchfunktionen stehen nicht zur Verfügung
- Wetterdaten können nicht abgerufen werden
- Der Media Service steht nicht zur Verfügung der z.B. Bilder automatisch zuschneiden kann, die Bilder über einen CDN zur Verfügung stellt sowie automatisch den Bildnachweis in das Bild hinzufügt
- Die Anzahl Anfragen ist limitiert (60 Anfragen pro Minute und 50'000 Anfragen pro Monat)
Diese Daten stehen auch über das kostenpflichtige Infocenter zur Verfügung. Auf der Seite How to get access ist beschrieben wie ein Subskription-Key erstellt werden kann. Für den kostenfreien Zugang muss das Produkt Infocenter Open verwendet werden.
Der Subskription Key muss bei allen API Anfragen im Header Ocp-Apim-Subscription-Key mitgegeben werden. Zusätzlich zu dem Subskription Key muss das Projekt dsod-hs als Query Parameter mitgegeben werden um nur die HotellerieSuisse spezifsichen Daten zu erhalten.
Hotels abrufen¶
Über den List-Enpunkt können alle Hotels abgerufen werden:
GET /info/v2/lodgingbusinesses/?project=dsod-content HTTP/1.1
Host: api.discover.swiss
Ocp-Apim-Subscription-Key: 1234
Accept-Language: de
Beispiel Antwort Hotels
{
"hasNextPage": true,
"nextPageToken": "[{\"token\":\"+RID:~TJwCAIyDkDgshAAAAAAAAA==#RT:1#TRC:10#ISV:2#IEO:65567#QCF:8#FPC:AgECBwIMACQEALAJLGd3AQB/hgQCAIO9BQIAx5AHJgDhhlKEkRIU+BNAXwMIAIAfa4AGwAAoAAJAgVRUFaBCADSHPokBgA==\",\"range\":{\"min\":\"\",\"max\":\"FF\"}}]",
"data": [
{
"amenityFeature": [
{
"propertyId": "general-lounge",
"typeName": "Allgemein",
"additionalType": "general",
"name": "Gesellschaftsraum"
},
{
"propertyId": "outdoor-terracebalcony",
"typeName": "Außenanlagen",
"additionalType": "outdoor",
"name": "Terrasse/Balkon"
},
{
"propertyId": "food-bar",
"typeName": "Essen",
"additionalType": "food",
"name": "Stab"
},
{
"propertyId": "sport-gym",
"typeName": "Sport und Freizeit",
"additionalType": "sport",
"name": "Fitnessstudio"
},
{
"propertyId": "outdoor-garden",
"typeName": "Außenanlagen",
"additionalType": "outdoor",
"name": "Garten"
},
{
"propertyId": "general-elevator",
"typeName": "Allgemein",
"additionalType": "general",
"name": "Aufzug"
},
{
"propertyId": "food-restaurant",
"typeName": "Essen",
"additionalType": "food",
"name": "Restaurant"
},
{
"propertyId": "wellness-sauna",
"typeName": "Wellness-Dienstleistungen",
"additionalType": "wellness",
"name": "Sauna"
},
{
"propertyId": "entertainment-playroom",
"typeName": "Unterhaltung und Lifestyle",
"additionalType": "entertainment",
"name": "Spielzimmer"
},
{
"propertyId": "wellness-whirlpoolorjacuzzi",
"typeName": "Wellness-Dienstleistungen",
"additionalType": "wellness",
"name": "Whirlpool oder Jacuzzi"
},
{
"propertyId": "general-wifi",
"typeName": "Allgemein",
"additionalType": "general",
"name": "WLAN"
},
{
"propertyId": "wellness-steambath",
"typeName": "Wellness-Dienstleistungen",
"additionalType": "wellness",
"name": "Dampfbad"
},
{
"propertyId": "sport-golfcourse",
"typeName": "Sport und Freizeit",
"additionalType": "sport",
"name": "Golfplatz"
},
{
"propertyId": "sport-indoorswimmingpool",
"typeName": "Sport und Freizeit",
"additionalType": "sport",
"name": "Hallenbad"
},
{
"propertyId": "sport-minigolf",
"typeName": "Sport und Freizeit",
"additionalType": "sport",
"name": "Minigolf"
},
{
"propertyId": "tom-sportAndFreetime-tbx00020010001909371",
"typeName": "Sport und freizeit",
"additionalType": "tom-sportAndFreetime",
"name": "Wellness/Spa"
},
{
"propertyId": "tom-services-tbx00020010001908819",
"typeName": "Dienstleistungen",
"additionalType": "tom-services",
"name": "Haustiere auf Anfrage"
},
{
"propertyId": "tom-theme-tbx00020010001909609",
"typeName": "Thema",
"additionalType": "tom-theme",
"name": "Aktiv und Sport"
},
{
"propertyId": "tom-theme-tbx00020010001909611",
"typeName": "Thema",
"additionalType": "tom-theme",
"name": "Familien"
},
{
"propertyId": "tom-theme-tbx00020010001909616",
"typeName": "Thema",
"additionalType": "tom-theme",
"name": "Romantik"
},
{
"propertyId": "tom-theme-tbx00020010001909607",
"typeName": "Thema",
"additionalType": "tom-theme",
"name": "Wellness"
}
],
"starRating": {
"name": "4 Stern Superior"
},
"accommodation": [
{
"@id": "https://api.discover.swiss/test/info/v2//acc_942_9t8aaacaabdgjgdajffb",
"identifier": "acc_942_9t8aaacaabdgjgdajffb"
},
{
"@id": "https://api.discover.swiss/test/info/v2//acc_942_9t8aaacaabdgjgdafega",
"identifier": "acc_942_9t8aaacaabdgjgdafega"
},
{
"@id": "https://api.discover.swiss/test/info/v2//acc_942_9t8aaacaabdgjgdbbcgf",
"identifier": "acc_942_9t8aaacaabdgjgdbbcgf"
}
],
"award": [
{
"award": {
"name": {
"de": "HotellerieSuisse Spezialisierung Medical Wellness & Spa",
"it": "HotellerieSuisse Spécialisation Medical Wellness & Spa",
"fr": "HotellerieSuisse Specializzazione Medical Wellness & Spa",
"en": "HotellerieSuisse Specialization Medical Wellness & Spa"
},
"logo": {
"contentUrl": "https://hotelclass-uploads.s3-eu-west-1.amazonaws.com/Specialization62c82f0268c77Medical_Wellness_Spa_Hotel_eine_Hand_eine_Welle.jpg",
"dataGovernance": {
"provider": {
"acronym": "hcl",
"name": "Hotelclass",
"logo": {
"@id": "https://api.discover.swiss/test/info/v2/imageObjects/img_xs1_14w4",
"identifier": "img_xs1_14w4"
},
"identifier": "hcl"
},
"source": {
"acronym": "hs",
"name": "HotellerieSuisse",
"logo": {
"contentUrl": "https://cdn.discover.swiss/logos/hs.png",
"@id": "https://api.discover.swiss/test/info/v2/imageObjects/img_x8_14w4",
"identifier": "img_x8_14w4"
},
"link": [
{
"url": "https://www.hotelleriesuisse.ch/de/",
"type": "WebHomepage"
}
],
"identifier": "hs"
}
},
"@id": "https://api.discover.swiss/test/info/v2/imageObjects/img_xs1_cb_14w4",
"identifier": "img_xs1_cb_14w4"
},
"@id": "https://api.discover.swiss/test/info/v2/awards/hs_21_medicalwellnessspa",
"identifier": "hs_21_medicalwellnessspa"
}
},
{
"award": {
"name": {
"de": "HotellerieSuisse Spezialisierung Seminars",
"it": "HotellerieSuisse Spécialisation Seminars",
"fr": "HotellerieSuisse Specializzazione Seminars",
"en": "HotellerieSuisse Specialization Seminars"
},
"logo": {
"contentUrl": "https://hotelclass-uploads.s3-eu-west-1.amazonaws.com/Specialization62c82e26dbc53Seminar-Hotel.jpg",
"dataGovernance": {
"provider": {
"acronym": "hcl",
"name": "Hotelclass",
"logo": {
"@id": "https://api.discover.swiss/test/info/v2/imageObjects/img_xs1_14w4",
"identifier": "img_xs1_14w4"
},
"identifier": "hcl"
},
"source": {
"acronym": "hs",
"name": "HotellerieSuisse",
"logo": {
"contentUrl": "https://cdn.discover.swiss/logos/hs.png",
"@id": "https://api.discover.swiss/test/info/v2/imageObjects/img_x8_14w4",
"identifier": "img_x8_14w4"
},
"link": [
{
"url": "https://www.hotelleriesuisse.ch/de/",
"type": "WebHomepage"
}
],
"identifier": "hs"
}
},
"@id": "https://api.discover.swiss/test/info/v2/imageObjects/img_xs1_be_14w4",
"identifier": "img_xs1_be_14w4"
},
"@id": "https://api.discover.swiss/test/info/v2/awards/hs_14_seminars",
"identifier": "hs_14_seminars"
}
},
{
"award": {
"name": {
"en": "Swisstainable Level II - engaged",
"de": "Swisstainable Level II - engaged",
"fr": "Swisstainable Niveau II - engaged",
"it": "Swisstainable Livello II - engaged"
},
"logo": {
"contentUrl": "https://cdn.discover.swiss/img/stb-level-2.png",
"dataGovernance": {
"provider": {
"acronym": "stb",
"name": "Swisstainable",
"logo": {
"contentUrl": "https://cdn.discover.swiss/logos/stb.png",
"@id": "https://api.discover.swiss/test/info/v2/imageObjects/img_89r_14w4",
"identifier": "img_89r_14w4"
},
"link": [
{
"url": "https://www.stv-fst.ch/",
"type": "WebHomepage"
}
],
"identifier": "stb"
},
"source": {
"acronym": "stb",
"name": "Swisstainable",
"logo": {
"contentUrl": "https://cdn.discover.swiss/logos/stb.png",
"@id": "https://api.discover.swiss/test/info/v2/imageObjects/img_89r_14w4",
"identifier": "img_89r_14w4"
},
"link": [
{
"url": "https://www.stv-fst.ch/",
"type": "WebHomepage"
}
],
"identifier": "stb"
}
},
"@id": "https://api.discover.swiss/test/info/v2/imageObjects/img_89r_1ulu1-c-14w4",
"identifier": "img_89r_1ulu1-c-14w4"
},
"@id": "https://api.discover.swiss/test/info/v2/awards/stb_level-2",
"identifier": "stb_level-2"
}
}
],
"address": {
"addressCountry": "CH",
"addressLocality": "Bad Zurzach",
"addressRegion": "Aargau",
"postalCode": "5330",
"streetAddress": "Badstrasse 44",
"email": "info@parkhotel-bad-zurzach.ch",
"telephone": "+41 56 269 88 11"
},
"geo": {
"latitude": 47.5916,
"longitude": 8.28914
},
"photo": [
{
"contentUrl": "http://cdn.tomas-travel.com/tds/repository/TDS00020013694873623/TDS00020010010367324/TDS00020013694881441.jpg",
"caption": "Parkhotel",
"encodingFormat": "image/jpeg",
"dataGovernance": {
"provider": {
"acronym": "tom",
"name": "TOMAS",
"logo": {
"contentUrl": "https://cdn.discover.swiss/logos/tom.png",
"@id": "https://api.discover.swiss/test/info/v2/imageObjects/img_942_14w4",
"identifier": "img_942_14w4"
},
"link": [
{
"url": "https://www.tomas.ch",
"type": "WebHomepage"
}
],
"identifier": "tom"
},
"source": {
"acronym": "rgrbr",
"name": "Rhein Genuss Route (admin), (Bad Ragaz)",
"logo": {
"@id": "https://api.discover.swiss/test/info/v2/imageObjects/img_7w7r7_14w4",
"identifier": "img_7w7r7_14w4"
},
"link": [
{
"url": "https://www.rheinwelten.com/#",
"type": "WebHomepage"
}
],
"identifier": "rgrbr"
}
},
"@id": "https://api.discover.swiss/test/info/v2/imageObjects/img_942_9t8aaacaabdgjeiibeeb",
"identifier": "img_942_9t8aaacaabdgjeiibeeb"
}
],
"telephone": "+41 56 269 88 11",
"detailedInformation": ["Hotel"],
"category": [
{
"@id": "https://api.discover.swiss/test/info/v2/categories/ch_root",
"identifier": "ch_root"
},
{
"@id": "https://api.discover.swiss/test/info/v2/categories/ch_0708",
"identifier": "ch_0708"
},
{
"@id": "https://api.discover.swiss/test/info/v2/categories/ch_07",
"identifier": "ch_07"
}
],
"containedInPlace": [
{
"@id": "https://api.discover.swiss/test/info/v2/areas/osm_13623634",
"identifier": "osm_13623634"
},
{
"@id": "https://api.discover.swiss/test/info/v2/areas/osm_51701",
"identifier": "osm_51701"
},
{
"@id": "https://api.discover.swiss/test/info/v2/areas/osm_1685443",
"identifier": "osm_1685443"
},
{
"@id": "https://api.discover.swiss/test/info/v2/areas/osm_1686359",
"identifier": "osm_1686359"
},
{
"@id": "https://api.discover.swiss/test/info/v2/areas/plz_5330_0",
"identifier": "plz_5330_0"
}
],
"tag": [
{
"@id": "https://api.discover.swiss/test/info/v2/tags/tourismzone-countryside",
"identifier": "tourismzone-countryside"
},
{
"@id": "https://api.discover.swiss/test/info/v2/tags/tourismregion-aarauregion",
"identifier": "tourismregion-aarauregion"
},
{
"@id": "https://api.discover.swiss/test/info/v2/tags/okgo-externally-verified",
"identifier": "okgo-externally-verified"
},
{
"@id": "https://api.discover.swiss/test/info/v2/tags/profile-season-summer",
"identifier": "profile-season-summer"
},
{
"@id": "https://api.discover.swiss/test/info/v2/tags/profile-season-winter",
"identifier": "profile-season-winter"
}
],
"campaignTag": [
{
"@id": "https://api.discover.swiss/test/info/v2/tags/okgo-externally-verified",
"identifier": "okgo-externally-verified"
}
],
"profileTag": [
{
"@id": "https://api.discover.swiss/test/info/v2/tags/profile-season-summer",
"identifier": "profile-season-summer"
},
{
"@id": "https://api.discover.swiss/test/info/v2/tags/profile-season-winter",
"identifier": "profile-season-winter"
}
],
"@id": "https://api.discover.swiss/test/info/v2/lodgingbusinesses/log_942_9t8aaacaabdgjeihdgcd",
"identifier": "log_942_9t8aaacaabdgjeihdgcd",
"removed": false,
"dataGovernance": {
"origin": [
{
"datasource": "hs-d365",
"sourceId": "10189",
"created": "2021-12-07T20:46:47+00:00",
"lastModified": "2023-01-13T20:28:15+00:00",
"license": "CC BY-SA",
"provider": {
"acronym": "hs-d365"
},
"source": {
"acronym": "hs",
"name": "HotellerieSuisse",
"logo": {
"contentUrl": "https://cdn.discover.swiss/logos/hs.png",
"@id": "https://api.discover.swiss/test/info/v2/imageObjects/img_x8_14w4",
"identifier": "img_x8_14w4"
},
"link": [
{
"url": "https://www.hotelleriesuisse.ch/de/",
"type": "WebHomepage"
}
],
"identifier": "hs"
}
},
{
"datasource": "tom",
"sourceId": "TDS00020013694873623",
"lastModified": "2022-06-15T22:00:00+00:00",
"license": "CC BY-ND",
"provider": {
"acronym": "tom",
"name": "TOMAS",
"logo": {
"contentUrl": "https://cdn.discover.swiss/logos/tom.png",
"@id": "https://api.discover.swiss/test/info/v2/imageObjects/img_942_14w4",
"identifier": "img_942_14w4"
},
"link": [
{
"url": "https://www.tomas.ch",
"type": "WebHomepage"
}
],
"identifier": "tom"
},
"source": {
"acronym": "rgrbr",
"name": "Rhein Genuss Route (admin), (Bad Ragaz)",
"logo": {
"@id": "https://api.discover.swiss/test/info/v2/imageObjects/img_7w7r7_14w4",
"identifier": "img_7w7r7_14w4"
},
"link": [
{
"url": "https://www.rheinwelten.com/#",
"type": "WebHomepage"
}
],
"identifier": "rgrbr"
}
},
{
"datasource": "hs",
"sourceId": "10189",
"license": "CC BY-SA",
"provider": {
"acronym": "hs"
},
"source": {
"acronym": "hs"
}
},
{
"datasource": "st",
"sourceId": "567",
"created": "2010-05-15T06:31:37.093+00:00",
"lastModified": "2023-01-24T15:53:27.49+00:00",
"license": "CC BY-NC-SA 4.0",
"provider": {
"acronym": "st",
"name": "Schweiz Tourismus",
"logo": {
"@id": "https://api.discover.swiss/test/info/v2/imageObjects/img_89_14w4",
"identifier": "img_89_14w4"
},
"link": [
{
"url": "https://www.myswitzerland.com/",
"type": "WebHomepage"
}
],
"identifier": "st"
},
"source": {
"acronym": "st",
"name": "Schweiz Tourismus",
"logo": {
"@id": "https://api.discover.swiss/test/info/v2/imageObjects/img_89_14w4",
"identifier": "img_89_14w4"
},
"link": [
{
"url": "https://www.myswitzerland.com/",
"type": "WebHomepage"
}
],
"identifier": "st"
}
},
{
"datasource": "gin",
"sourceId": "bc9ad59a-7c5a-4413-b634-02f253c14461",
"created": "2021-11-01T20:45:58.507+00:00",
"lastModified": "2022-04-12T17:24:21.916+00:00",
"license": "ODbL v1.0",
"provider": {
"acronym": "gin",
"name": "Ginto",
"logo": {
"contentUrl": "https://cdn.discover.swiss/logos/gin.png",
"@id": "https://api.discover.swiss/test/info/v2/imageObjects/img_wy3_14w4",
"identifier": "img_wy3_14w4"
},
"link": [
{
"url": "https://www.ginto.guide/",
"type": "WebHomepage"
}
],
"identifier": "gin"
},
"source": {
"acronym": "pi",
"name": "Pro Infirmis",
"logo": {
"contentUrl": "https://cdn.discover.swiss/logos/pi.jpg",
"@id": "https://api.discover.swiss/test/info/v2/imageObjects/img_5y_14w4",
"identifier": "img_5y_14w4"
},
"link": [
{
"url": "https://www.proinfirmis.ch/",
"type": "WebHomepage"
}
],
"identifier": "pi"
}
},
{
"datasource": "hcl",
"sourceId": "32610",
"created": "2017-12-22T10:00:35+00:00",
"lastModified": "2023-08-19T11:08:49+00:00",
"license": "CC BY-SA",
"provider": {
"acronym": "hcl",
"name": "Hotelclass",
"logo": {
"@id": "https://api.discover.swiss/test/info/v2/imageObjects/img_xs1_14w4",
"identifier": "img_xs1_14w4"
},
"identifier": "hcl"
},
"source": {
"acronym": "hs",
"name": "HotellerieSuisse",
"logo": {
"contentUrl": "https://cdn.discover.swiss/logos/hs.png",
"@id": "https://api.discover.swiss/test/info/v2/imageObjects/img_x8_14w4",
"identifier": "img_x8_14w4"
},
"link": [
{
"url": "https://www.hotelleriesuisse.ch/de/",
"type": "WebHomepage"
}
],
"identifier": "hs"
}
}
],
"provider": {
"acronym": "hs-d365"
},
"source": {
"acronym": "hs",
"name": "HotellerieSuisse",
"logo": {
"contentUrl": "https://cdn.discover.swiss/logos/hs.png",
"@id": "https://api.discover.swiss/test/info/v2/imageObjects/img_x8_14w4",
"identifier": "img_x8_14w4"
},
"link": [
{
"url": "https://www.hotelleriesuisse.ch/de/",
"type": "WebHomepage"
}
],
"identifier": "hs"
}
},
"additionalProperty": [
{
"value": "17800",
"propertyId": "hsId",
"valueType": "string",
"name": "HotellerieSuisse Identifizierung"
},
{
"value": "ChIJnenVwedokEcRDDsUy6W4nds",
"valueStr": "ChIJnenVwedokEcRDDsUy6W4nds",
"propertyId": "google_place_id",
"valueType": "string"
}
],
"lastModified": "2024-01-10T17:43:52.9816453+00:00",
"availableDataLanguage": ["de", "en", "fr", "it"],
"autoTranslatedData": false,
"license": "CC BY-SA",
"disambiguatingDescription": "«Erleben, Geniessen und Erholen» – das sind die drei Erfahrungswelten, die Sie bei uns im Parkhotel auf verschiedene Weise entdecken können. Erleben: Wandern, Fahrradfahren, Museum-Besuche oder einfach Spazieren - Ihr Erlebnis-Highlight in Bad Zurzach startet genau hier. Geniessen: Saisonale und gesunde Speisen, zubereitet mit regionalen Zutaten, erwarten Sie in unserem Restaurant. Erholen: Das Parkhotel gehört zu den grössten Bäder- und Gesundheitshotels schweizweit. Als Gast können Sie das hoteleigene Solebad nutzen, haben aber ebenso freien Zutritt zu einem der grössten Thermalbäder der Schweiz – direkt über einen Verbindungstrakt. Wir setzen alles daran, Ihren Aufenthalt maximal erholsam zu gestalten und Ihr Wohlbefinden zu beflügeln. Wir freuen uns schon Sie bei uns begrüssen und verwöhnen zu dürfen.",
"image": {
"contentUrl": "http://cdn.tomas-travel.com/tds/repository/TDS00020013694873623/TDS00020010010367324/TDS00020013694881441.jpg",
"caption": "Parkhotel",
"encodingFormat": "image/jpeg",
"dataGovernance": {
"provider": {
"acronym": "tom",
"name": "TOMAS",
"logo": {
"contentUrl": "https://cdn.discover.swiss/logos/tom.png",
"@id": "https://api.discover.swiss/test/info/v2/imageObjects/img_942_14w4",
"identifier": "img_942_14w4"
},
"link": [
{
"url": "https://www.tomas.ch",
"type": "WebHomepage"
}
],
"identifier": "tom"
},
"source": {
"acronym": "rgrbr",
"name": "Rhein Genuss Route (admin), (Bad Ragaz)",
"logo": {
"@id": "https://api.discover.swiss/test/info/v2/imageObjects/img_7w7r7_14w4",
"identifier": "img_7w7r7_14w4"
},
"link": [
{
"url": "https://www.rheinwelten.com/#",
"type": "WebHomepage"
}
],
"identifier": "rgrbr"
}
},
"@id": "https://api.discover.swiss/test/info/v2/imageObjects/img_942_9t8aaacaabdgjeiibeeb",
"identifier": "img_942_9t8aaacaabdgjeiibeeb"
},
"additionalType": "Hotel",
"link": [
{
"url": "https://www.parkhotel-bad-zurzach.ch",
"type": "WebHomepage"
},
{
"url": "http://www.parkhotel-bad-zurzach.ch",
"type": "WebHomepage"
},
{
"url": "https://www.ginto.guide/entries/bc9ad59a-7c5a-4413-b634-02f253c14461?lnk_src=business",
"title": "Zugänglichkeitsinformationen anzeigen",
"type": "GintoWeb"
},
{
"url": "https://api.ginto.guide/entries/bc9ad59a-7c5a-4413-b634-02f253c14461",
"type": "GintoResource"
}
],
"name": "Parkhotel Bad Zurzach",
"type": "schema.org/LodgingBusiness"
}
]
}
Hinweise zu der Datenstruktur:
- Die Liste
amenityFeatureenthält die Ausstattungsmerkmale, welche durch HotellerieSuisse standardisiert wurden. Ausstattungsmerkmale, die nicht im Standard enthalten sind, jedoch durch ein System geliefert werden, starten mit einem 3 Stellingen Kürzel wie z.B. tom- frt-. - Das Hauptbild ist im Feld
imageenthalten - Das Feld
photoenthält alle Bilder sortiert noch der Priorität. Das Hauptbild entspricht dem ersten gelieferten Bild in der Liste. - Die Liste
awardenthält die offiziellen HotellerieSuisse Klassifizierungen sowie Labels wie z.B. von Swisstainable - Details zum Datenschema sowie zu den API-Endpunkten sind in der OpenAPI Definition im Developer Portal verfügbar.
- Die HotellerieSuisse ID ist in der
additionalPropertyListe mit der Property IDhsIdvorhanden. - Hier geht es zur Übersicht der LodgingBusiness-Properties.
Änderungen abfragen¶
Mit dem Query-Paremter updatedSince können über den Listen-Endpunkt alle Hotels abgerufen werden, welche sich nach einem Datum geändert haben.
Beispiel Aufruf:
GET /info/v2/lodgingbusinesses?project=dsod-content&includeCount=true&updatedSince=2024-07-20T07:00:00 HTTP/1.1
Host: api.discover.swiss
Ocp-Apim-Subscription-Key: 1234
Accept-Language: de
{
"count": 1,
"hasNextPage": false,
"data": [
{
"identifier": "log_x8-tdgf_bbhcb",
"name": "Steigenberger Icon Grandhotel Belvédère",
"type": "schema.org/LodgingBusiness"
}
]
}
Wird zusätzlich zum Parameter updatedSince der Query-Parameter deleted=true mitgegben, werden alle Hotels geliefert, welche seit diesem Datum gelöscht wurden.
Sprache¶
Die Inhalte werden in der Sprache zurückgeliefert, welche im Accept-Language mitgegeben wird. Default ist Deutsch.
Continuation Token¶
Beim List Enpunkt wird ein Continuation Token zurückgeliefert, über das die weiteren Seiten abgerufen werden können. Wie das Token verwenden werden kann ist auf folgender Seite erklärt:
How to get access to the API #continuationtoken
Bilder¶
Die Lizenz und Copyright Informationen in den Daten wie auch Bildern müssen eingehalten werden. Über die Informationen im DataGovernance Objekt können die nötigen Bildnachweis-Informationen zusammengestellt werden.
Siehe bibliography
Bilder können Tags zu verschiedenen Themen erhalten. Diese können mit tagToQuery abgefragt werden.
Beispiel
{
"tagToQuery": [
"image-amenity-bed",
"image-amenity-sitting-area",
"image-amenity-desk"
],
"contentUrl": "https://media-v2.discover.swiss/rawmedia/hs/00092590_5c2af1fd6833a05c56bc522de431460f_m.jpg",
"copyrightNotice": "Tschuggen Grand Hotel, HotellerieSuisse",
"dataGovernance": {
"provider": {
"acronym": "hs",
"name": "HotellerieSuisse",
"logo": {
"contentUrl": "https://cdn.discover.swiss/logos/hs.png",
"copyrightNotice": "discover.swiss",
"@id": "https://api.discover.swiss/info/v2/imageObjects/img_x8_14w4",
"identifier": "img_x8_14w4"
},
"link": [
{
"url": "https://www.hotelleriesuisse.ch/de/",
"type": "WebHomepage"
}
],
"identifier": "hs"
},
"source": {
"acronym": "hs",
"name": "HotellerieSuisse",
"logo": {
"contentUrl": "https://cdn.discover.swiss/logos/hs.png",
"copyrightNotice": "discover.swiss",
"@id": "https://api.discover.swiss/info/v2/imageObjects/img_x8_14w4",
"identifier": "img_x8_14w4"
},
"link": [
{
"url": "https://www.hotelleriesuisse.ch/de/",
"type": "WebHomepage"
}
],
"identifier": "hs"
},
"author": {
"familyName": "Tschuggen Grand Hotel"
}
},
"@id": "https://api.discover.swiss/info/v2/imageObjects/img_x8_y2w_jcfja",
"identifier": "img_x8_y2w_jcfja"
}
Zugänglichkeits Informationen (Barrierefreiheit)¶
Die Zugänglichkeitsinformationen können als strukturierte Daten über den Link im Link Array mit dem Typ GintoResource abgerufen werden. Ginto liefert eine fertige HTML Seite auf die referenziert werden kann. Diese Seite ist über den Link mit dem Typ GintoWeb verfügbar.
Beispiel:
{
"link": [
{
"url": "https://www.ginto.guide/entries/bc9ad59a-7c5a-4413-b634-02f253c14461?lnk_src=business",
"title": "Zugänglichkeitsinformationen anzeigen",
"type": "GintoWeb"
},
{
"url": "https://api.ginto.guide/entries/bc9ad59a-7c5a-4413-b634-02f253c14461",
"type": "GintoResource"
}
]
}
Zimmerkategorien abrufen¶
Über /info/v2/accommodations kann eine Liste von allen Zimmern abgerufen werden. Die Hotels enthalten einen Array mit allen Zimmerkategorien. Hier geht es zur Übersicht der Accommodation-Properties.
{
"accommodation": [
{
"@id": "https://api.discover.swiss/test/info/v2//acc_942_9t8aaacaabdgjgdajffb",
"identifier": "acc_942_9t8aaacaabdgjgdajffb"
},
{
"@id": "https://api.discover.swiss/test/info/v2//acc_942_9t8aaacaabdgjgdafega",
"identifier": "acc_942_9t8aaacaabdgjgdafega"
},
{
"@id": "https://api.discover.swiss/test/info/v2//acc_942_9t8aaacaabdgjgdbbcgf",
"identifier": "acc_942_9t8aaacaabdgjgdbbcgf"
}
]
}
In @id ist die vollständige URL enthalten und identifier enthält die ID des Objektes. Mit diesen Informationen kann das Zimmer anschliessend über den Accommodation Endpunkt abgerufen werden.
GET /info/v2/accommodations/acc_942_9t8aaacaabdgjgdajffb?project=dsod-content HTTP/1.1
Host: api.discover.swiss
Ocp-Apim-Subscription-Key: 1234
Accept-Language: de
Beispiel Antwort Zimmerkategorie
{
"numberOfRooms": [
{
"valueDescription": "Doppelzimmer"
}
],
"occupancy": [
{
"validFrom": "2022-05-18T22:00:00+00:00",
"validThrough": "2028-12-10T23:00:00+00:00",
"maxValue": 3.0,
"minValue": 1.0,
"valueDescription": "Person"
},
{
"validFrom": "2022-05-18T22:00:00+00:00",
"validThrough": "2028-12-10T23:00:00+00:00",
"maxValue": 3.0,
"minValue": 1.0,
"valueDescription": "Erwachsener"
},
{
"validFrom": "2022-05-18T22:00:00+00:00",
"validThrough": "2028-12-10T23:00:00+00:00",
"maxValue": 2.0,
"minValue": 0.0,
"valueDescription": "Kind"
}
],
"leaseLength": [
{
"validFrom": "2023-04-08T22:00:00+00:00",
"validThrough": "2023-12-21T23:00:00+00:00",
"minValue": 1.0,
"unitCode": "day"
},
{
"validFrom": "2023-12-21T23:00:00+00:00",
"validThrough": "2023-12-31T23:00:00+00:00",
"minValue": 2.0,
"unitCode": "day"
},
{
"validFrom": "2023-12-31T23:00:00+00:00",
"validThrough": "2025-01-18T23:00:00+00:00",
"minValue": 1.0,
"unitCode": "day"
}
],
"address": {
"addressCountry": "CH",
"addressLocality": "Bad Zurzach",
"postalCode": "5330",
"streetAddress": "Badstrasse 44 ",
"availableLanguage": ["de"],
"email": "info@parkhotel-bad-zurzach.ch",
"telephone": "+41 56 269 88 11"
},
"geo": {
"latitude": 47.5915333,
"longitude": 8.2888411
},
"photo": [
{
"contentUrl": "http://cdn.tomas-travel.com/tds/repository/TDS00020013696309551/TDS00020010010367324/TDS00020013696323308.jpg",
"caption": "Parkhotel Bad Zurzach",
"encodingFormat": "image/jpeg",
"dataGovernance": {
"provider": {
"acronym": "tom",
"name": "TOMAS",
"logo": {
"contentUrl": "https://cdn.discover.swiss/logos/tom.png",
"@id": "https://api.discover.swiss/test/info/v2/imageObjects/img_942_14w4",
"identifier": "img_942_14w4"
},
"link": [
{
"url": "https://www.tomas.ch",
"type": "WebHomepage"
}
],
"identifier": "tom"
},
"source": {
"acronym": "rgrbr",
"name": "Rhein Genuss Route (admin), (Bad Ragaz)",
"logo": {
"@id": "https://api.discover.swiss/test/info/v2/imageObjects/img_7w7r7_14w4",
"identifier": "img_7w7r7_14w4"
},
"link": [
{
"url": "https://www.rheinwelten.com/#",
"type": "WebHomepage"
}
],
"identifier": "rgrbr"
}
},
"thumbnailUrl": "https://media-test-v2.discover.swiss/image/img_942_9t8aaacaabdgjgdcddai",
"@id": "https://api.discover.swiss/test/info/v2/imageObjects/img_942_9t8aaacaabdgjgdcddai",
"identifier": "img_942_9t8aaacaabdgjgdcddai"
}
],
"@id": "https://api.discover.swiss/test/info/v2//acc_942_9t8aaacaabdgjgdajffb",
"identifier": "acc_942_9t8aaacaabdgjgdajffb",
"removed": false,
"dataGovernance": {
"origin": [
{
"datasource": "tom",
"sourceId": "TDS00020013696309551",
"lastModified": "2023-05-09T22:00:00+00:00",
"license": "CC BY-ND",
"provider": {
"acronym": "tom",
"name": "TOMAS",
"logo": {
"contentUrl": "https://cdn.discover.swiss/logos/tom.png",
"@id": "https://api.discover.swiss/test/info/v2/imageObjects/img_942_14w4",
"identifier": "img_942_14w4"
},
"link": [
{
"url": "https://www.tomas.ch",
"type": "WebHomepage"
}
],
"identifier": "tom"
},
"source": {
"acronym": "rgrbr",
"name": "Rhein Genuss Route (admin), (Bad Ragaz)",
"logo": {
"@id": "https://api.discover.swiss/test/info/v2/imageObjects/img_7w7r7_14w4",
"identifier": "img_7w7r7_14w4"
},
"link": [
{
"url": "https://www.rheinwelten.com/#",
"type": "WebHomepage"
}
],
"identifier": "rgrbr"
}
}
],
"provider": {
"acronym": "tom",
"name": "TOMAS",
"logo": {
"contentUrl": "https://cdn.discover.swiss/logos/tom.png",
"@id": "https://api.discover.swiss/test/info/v2/imageObjects/img_942_14w4",
"identifier": "img_942_14w4"
},
"link": [
{
"url": "https://www.tomas.ch",
"type": "WebHomepage"
}
],
"identifier": "tom"
},
"source": {
"acronym": "rgrbr",
"name": "Rhein Genuss Route (admin), (Bad Ragaz)",
"logo": {
"@id": "https://api.discover.swiss/test/info/v2/imageObjects/img_7w7r7_14w4",
"identifier": "img_7w7r7_14w4"
},
"link": [
{
"url": "https://www.rheinwelten.com/#",
"type": "WebHomepage"
}
],
"identifier": "rgrbr"
}
},
"lastModified": "2023-12-10T03:14:36.9306816+00:00",
"availableDataLanguage": ["de", "en", "es", "fr", "it"],
"autoTranslatedData": false,
"license": "CC BY-ND",
"disambiguatingDescription": "<p>Das komfortable und moderne Superior Zimmer ist mit einem TV, einer HiFI-Anlage, einer Nespresso-Minibar sowie einem Badezimmer mit Dusche ausgestattet. Das Zimmer verfügt auch über einen Balkon.<br>Die exklusive Badetasche mit Bademantel, Saunatuch und Badeslipper steht im Zimmer schon für Sie bereit.<br>Alle Hotelzimmer sind Nichtraucherzimmer.</p>",
"image": {
"contentUrl": "http://cdn.tomas-travel.com/tds/repository/TDS00020013696309551/TDS00020010010367324/TDS00020013696323308.jpg",
"caption": "Parkhotel Bad Zurzach",
"encodingFormat": "image/jpeg",
"dataGovernance": {
"provider": {
"acronym": "tom",
"name": "TOMAS",
"logo": {
"contentUrl": "https://cdn.discover.swiss/logos/tom.png",
"@id": "https://api.discover.swiss/test/info/v2/imageObjects/img_942_14w4",
"identifier": "img_942_14w4"
},
"link": [
{
"url": "https://www.tomas.ch",
"type": "WebHomepage"
}
],
"identifier": "tom"
},
"source": {
"acronym": "rgrbr",
"name": "Rhein Genuss Route (admin), (Bad Ragaz)",
"logo": {
"@id": "https://api.discover.swiss/test/info/v2/imageObjects/img_7w7r7_14w4",
"identifier": "img_7w7r7_14w4"
},
"link": [
{
"url": "https://www.rheinwelten.com/#",
"type": "WebHomepage"
}
],
"identifier": "rgrbr"
}
},
"thumbnailUrl": "https://media-test-v2.discover.swiss/image/img_942_9t8aaacaabdgjgdcddai",
"@id": "https://api.discover.swiss/test/info/v2/imageObjects/img_942_9t8aaacaabdgjgdcddai",
"identifier": "img_942_9t8aaacaabdgjgdcddai"
},
"additionalType": "HotelRoom",
"name": "Superior Doppelzimmer mit Balkon",
"type": "schema.org/Accommodation"
}
Number of Rooms¶
Wir versuchen, die Anzahl der Zimmer nach Kategorien aus verschiedenen Quellen zu harmonisieren. Derzeit unterstützen wir folgende Kategorien: 1. single 2. double 3. triple 4. suite 5. total
Zur Unterstützung von Kategorien wurde eine propertyId festgelegt. Es können jedoch nicht alle Daten strukturiert werden. Wenn keine Kategorie definiert werden kann, werden nur der Wert und der Name ohne propertyId bereitgestellt.
Beispiel Antwort numberOfRooms
{
"numberOfRooms": [
{
"propertyId": "single",
"unitCode": "count",
"value": "4",
"name": "Einzelzimmer"
},
{
"propertyId": "double",
"unitCode": "count",
"value": "362",
"name": "Doppelzimmer"
},
{
"propertyId": "suite",
"unitCode": "count",
"value": "11",
"name": "Suiten"
},
{
"propertyId": "total",
"unitCode": "count",
"value": "366",
"name": "Zimmer insgesamt"
}
]
}
Übersicht Eigenschaften¶
In der nachfolgenden Übersicht werden die einzelnen Properties der Infocenter-Klassen, hinsichtlich der AccommoDataHub-Verwendung ausführlicher erklärt.
Unterkunft (LodgingBusiness)¶
In der folgenden Tabelle werden die wichtigsten Eigenschaften der Unterkunft (LodgingBusiness) beschrieben:
| Property ID | Wert | Beschreibung |
|---|---|---|
| AdditionalProperty.hsId | Individuelle HotellerieSuisse Id | Offizielle eindeutige ID von HotellerieSuisse. |
| starRating | Siehe separate Tabelle | Offizielle Hotelklassifizierung |
| Tag | Siehe separate Tabelle | Enthält eine Liste von Tags wie z.B. die Tourismuszone oder Familienfreundlich etc. |
| ParentOrganization | Siehe separate Tabelle | Hotelgruppe |
| Award | Siehe separate Tabelle | Spezialisierungslabel HotellerieSuisse |
| AmenityFeatures | Siehe separate Tabelle | Unterkunftausstattungsmerkmale |
Labels¶
Labels wie HotellerieSuisse Spezialisierungen, Ibex, Swisstainable etc. sind in der Eigenschaft Awards verfügbar. Mögliche Awards sind:
| Id | Name | Beschreibung |
|---|---|---|
| hs_19_wellnessspa | HotellerieSuisse Specialisation Wellness & Spa | Spezialisierungslabel Hotelclass |
| hs_22_aparthotel | HotellerieSuisse Specialization Aparthotel | Spezialisierungslabel Hotelclass |
| hs_1_biking | HotellerieSuisse Specialization Biking | Spezialisierungslabel Hotelclass |
| hs_28_boutique | HotellerieSuisse Specialization Boutique | Spezialisierungslabel Hotelclass |
| hs_6_business | HotellerieSuisse Specialization Business | Spezialisierungslabel Hotelclass |
| hs_13_congresses | HotellerieSuisse Specialization Congresses | Spezialisierungslabel Hotelclass |
| hs_4_design | HotellerieSuisse Specialization Design | Spezialisierungslabel Hotelclass |
| hs_15_excellentcuisine | HotellerieSuisse Specialization Excellent Cuisine | Spezialisierungslabel Hotelclass |
| hs_11_familymore | HotellerieSuisse Spezialisierung Family & More | Spezialisierungslabel Hotelclass |
| hs_10_familyfriendly | HotellerieSuisse Spezialisierung Family-friendly | Spezialisierungslabel Hotelclass |
| hs_27_gasthof | HotellerieSuisse Spezialisierung Gasthof | Spezialisierungslabel Hotelclass |
| hs_17_golf | HotellerieSuisse Spezialisierung Golf | Spezialisierungslabel Hotelclass |
| hs_8_greenliving | HotellerieSuisse Spezialisierung Green Living | Spezialisierungslabel Hotelclass |
| hs_16_hiking | HotellerieSuisse Spezialisierung Hiking | Spezialisierungslabel Hotelclass |
| hs_12_historic | HotellerieSuisse Spezialisierung Historic | Spezialisierungslabel Hotelclass |
| hs_26_internationalchainhotel | HotellerieSuisse Spezialisierung International Chain Hotel | Spezialisierungslabel Hotelclass |
| hs_29_kurhaus | HotellerieSuisse Spezialisierung Kurhaus | Spezialisierungslabel Hotelclass |
| hs_23_landgasthof | HotellerieSuisse Spezialisierung Landgasthof | Spezialisierungslabel Hotelclass |
| hs_20_medicalwellness | HotellerieSuisse Spezialisierung Medical Wellness | Spezialisierungslabel Hotelclass |
| hs_21_medicalwellnessspa | HotellerieSuisse Spezialisierung Medical Wellness & Spa | Spezialisierungslabel Hotelclass |
| hs_14_seminars | HotellerieSuisse Spezialisierung Seminars | Spezialisierungslabel Hotelclass |
| hs_5_snowsports | HotellerieSuisse Spezialisierung Snowsports | Spezialisierungslabel Hotelclass |
| hs_3_suitehotel | HotellerieSuisse Spezialisierung Suitehotel | Spezialisierungslabel Hotelclass |
| hs_9_sustainableliving | HotellerieSuisse Spezialisierung Sustainable Living | Spezialisierungslabel Hotelclass |
| hs_7_unique | HotellerieSuisse Spezialisierung Unique | Spezialisierungslabel Hotelclass |
| hs_18_wellness | HotellerieSuisse Spezialisierung Wellness | Spezialisierungslabel Hotelclass |
| hs_19_wellnessspa | HotellerieSuisse Spezialisierung Wellness & Spa | Spezialisierungslabel Hotelclass |
| stb_level-1 | Swisstainable Level I - committed | Nachhaltigkeitsprogramm STV-FST |
| stb_level-2 | Swisstainable Level II - engaged | Nachhaltigkeitsprogramm STV-FST |
| stb_level-3 | Swisstainable Level III - leading | Nachhaltigkeitsprogramm STV-FST |
| ibex_bronze | ibex fairstay bronze | Nachhaltigkeitslabel für Beherbergungsbetriebe |
| ibex_gold | ibex fairstay gold | Nachhaltigkeitslabel für Beherbergungsbetriebe |
| ibex_platinum | ibex fairstay platinum | Nachhaltigkeitslabel für Beherbergungsbetriebe |
| ibex_silver | ibex fairstay silver | Nachhaltigkeitslabel für Beherbergungsbetriebe |
Tourismuszone¶
Die offiziellen Tourismuszonen des BFS sind als Tag auf dem LodgingBusiness ersichtlich. Folgende Tourismuszonen sind verfügbar:
| Id | Name |
|---|---|
| tourismzone-city | Grossstadt |
| tourismzone-town | Kleine Stadt |
| tourismzone-mountains | Berg |
| tourismzone-countryside | Land |
Tourismusregion¶
Die offiziellen Tourismusregionen des BFS sind als Tag auf dem LodgingBusiness ersichtlich. Folgende Tourismusregionen sind verfügbar:
| Id | Name |
|---|---|
| tourismregion-aarauregion | Aarau Region |
| tourismregion-baselregion | Basel RegionRegion |
| tourismregion-bernregion | Bern Region |
| tourismregion-fribourgregion | Fribourg Region |
| tourismregion-genf | Genf |
| tourismregion-genferseegebiet | Genferseegebiet |
| tourismregion-graubunden | Graubünden |
| tourismregion-jura | Jura & Drei-Seen-Land |
| tourismregion-luzern | Luzern / Vierwaldstättersee |
| tourismregion-ostschweiz | Ostschweiz |
| tourismregion-tessin | Tessin |
| tourismregion-wallis | Wallis |
| tourismregion-zuerichregion | Zürich Region |
Hotelgruppen¶
Hotelgruppen sind in der Eigenschaft parentOrganization mti dem additionalType HotelGroup verfügbar. Mögliche Hotelgruppen sind:
| Id | Gruppenname |
|---|---|
| loc_rmx | BWH Hotel Group |
| loc_xx49u18 | H-Hotels.com |
| loc_xy1943 | Hilton |
Um alle Hotelgruppen abzufragen:
GET info/v2/localbusinesses?select=identifier,name&additionalType=HotelGroup
Host: api.discover.swiss
Ocp-Apim-Subscription-Key: 1234
Accept-Language: de
StarRating¶
Die offizielle Hotelklassifizierung von HotellerieSuisse und GastroSuisse ist in der Eigenschaft starRating verfügbar.
| ID | Name | Beschreibung |
|---|---|---|
| AdditionalType | - Hotel - ServicedApartments - swissLodge |
Offizieller Subtyp |
| garni | true, false | Hotelclass Klassifikation |
| superior | true, false | Hotelclass Klassifikation |
| name | 1 Stern | Hotelclass Klassifikation |
| name | 2 Sterne | Hotelclass Klassifikation |
| name | 3 Sterne | Hotelclass Klassifikation |
| name | 4 Sterne | Hotelclass Klassifikation |
| name | 5 Sterne | Hotelclass Klassifikation |
| author | HS | Quellpartner HotellerieSuisse |
| author | GS | Quellpartner GastroSuisse |
Ausstattungsmerkmale (amenityFeature)¶
Die Ausstattungsmerkmale sind in der Eigenschaft amenityFeature verfügbar. Mögliche Ausstattungsmerkmale sind in der folgenden Tabelle ersichtlich (nicht abschliessend):
| Id | Name |
|---|---|
| bathroom | Badezimmer |
| bed | Betttype |
| breakfast | Frühstück |
| characteristics | Charaktereigenschaften |
| Conference and events | events |
| entertainment | Unterhaltung und Lifestyle |
| family | Dienstleistungen für Familien |
| food | Essen |
| furnishing | Ausstattung |
| general | Allgemein |
| location | Ort |
| media | Medien |
| meetings | Meetings |
| view | Aussenbereich und Aussicht |
| outdoor | Aussenanlagen |
| security | Sicherheit und Schutz |
| ski | Ski |
| sport | Sport und Freizeit |
| wellness | Wellness-Dienstleistungen |
Info
Alle Ausstattungsmerkmale sind in der Datenklassifizierungen von discover.swiss unter AmenityFeatures zu finden: Download
Zimmer (Accommodation)¶
In der folgenden Tabelle werden die wichtigsten Eigenschaften der Zimmer (Accommodation) beschrieben:
| ID | Name | Beschreibung |
|---|---|---|
| branchCode | Zimmercode (STC) | Offizieller Zimmercode STC |
| accommodationCategory | Siehe separate Tabelle | Offizielle Zimmerkategorie HotellerieSuisse |
| typeOfBed | Siehe separate Tabelle | offizieller Bettyp HotellerieSuisse |
| amenityFeatures | Siehe separate Tabelle | Zimmer Ausstattungsmerkmale |
Zimmerkategorien¶
Zimmerkategorien sind in der Eigenschaft accommodationCategory verfügbar. Mögliche Zimmerkategorien sind:
| Id | Name |
|---|---|
| economy | Zimmerkategorie Economy |
| moderate | Zimmerkategorie Moderate |
| standard | Zimmerkategorie Standard |
| superior | Zimmerkategorie Superior |
| deluxe | Zimmerkategorie Deluxe |
Betttypen¶
Die Betttypen sind in der Eigenschaft typeOfBed verfügbar. Mögliche Betttypen sind:
| Id | Name |
|---|---|
| single | Betttyp Single |
| twin | Betttyp Twin |
| queen | Betttyp Queen |
| king | Betttyp King |
| double | Betttyp Double |