Facts Accommodations

Wir erfassen strukturierte Metadaten zu Unterkünften – wir nennen sie “Fakten”. Diese Informationen stehen über unsere API zur Verfügung und können auf deiner Website ausgespielt werden. Zugleich verbessern sie die Sichtbarkeit deiner Seiten in Suchmaschinen.

In diesem Leitfaden zeigen wir, wie du auf die “Fakten” zugreifst und sie nutzen kannst.

Voraussetzungen

Aktuell stellen wir Fakten für Ferienwohnungen zur Verfügung. Dabei handelt es sich um eine klar definierte Datenstruktur, die jedem Unterkunftsobjekt beigefügt ist und über GET /accommodations abgerufen werden kann.

Ein Beispiel für das Facts-Objekt der Ferienwohnung “Les Bouleaux” in Nendaz:

{ 
    "type": "apartment",
    "name" : {
        "de": "Les Bouleaux"
    },
    "city": "Nendaz",
    "facts" : {
        "apartment" : {
            "bedrooms" : 1, 
            "maxAdults" : 2, 
            "sqm" : 25, 
            "type" : "apartment"
        }
    }
}

Struktur der facts-Objekte

Das Facts-Objekt enthält immer einen Schlüssel mit dem Namen der Unterkunftsart. Für ein Objekt vom Typ apartment findest du mindestens den Schlüssel apartment – analog für weitere Unterkunftsarten.

Verfügbare Fakten

  • apartment:
    • bedrooms: Anzahl Schlafzimmer
    • maxAdults: Maximale Anzahl erwachsener Gäste
    • maxChildren: Maximale Anzahl Kinder
    • sqm: Wohnfläche in Quadratmetern
    • type: Subtyp der Unterkunft, mögliche Werte:
      • chalet
      • apartment
      • farmhouse
      • rustico

Für Nutzer:innen des Whitelabel

In unserem Whitelabel werden Fakten bereits dargestellt, wie im folgenden Beispiel:

Facts Display

Für Nutzer:innen des JavaScript-SDKs

Wenn du unser JavaScript SDK verwendest, sind die facts Teil der Unterkunftsobjekte, die du mit getAccommodations() und ähnlichen Methoden erhältst.

Einschränkungen

Derzeit bieten wir Fakten nur für Ferienwohnungen an.