Referensi Data Terstruktur Harga Hotel

Halaman ini menyediakan referensi untuk menambahkan markup data terstruktur ke informasi hotel Anda data harga kami.

Ringkasan

Data terstruktur harga hotel digunakan untuk menjelaskan, memvalidasi, dan menampilkan secara mendetail harga hotel yang tercantum di situs Anda, terlepas dari antarmuka pengguna. Ini juga mencakup harga dasar, tarif, kamar, biaya & pajak dan harga.

Google merekomendasikan partner untuk memberi anotasi pada halaman mereka dengan data terstruktur yang dapat dibaca mesin oleh crawler; disediakan oleh schema.org, untuk menyalin harga secara akurat dari halaman web Anda.

Hal ini memungkinkan validasi akurasi harga penskalaan dengan meningkatkan keandalan crawler. Manfaatnya bagi Anda adalah peningkatan jumlah validasi akurasi harga dan kemampuan untuk men-debug masalah akurasi harga secara langsung, dan juga memiliki skor akurasi harga yang konsisten.

Jika Anda baru mengenal data terstruktur, pelajari lebih lanjut Kosakata data terstruktur dan formatnya.

Hotel di Google merekomendasikan format JSON-LD untuk memberi anotasi pada halaman web Anda. Rujuk ke Format yang didukung untuk mempelajari lebih lanjut tentang format lain yang dapat diterima. Dokumentasi ini memberikan konten referensi mendetail khusus untuk penerapan data terstruktur di Hotel.

Data terstruktur Hotel digunakan untuk menganotasi kolom khusus hotel di halaman web mereka. Data terstruktur Hotel memiliki properti berikut:

Data terstruktur HotelRoom digunakan untuk menganotasi kolom khusus ruangan di laman web Anda.

Data terstruktur HotelRoom memiliki properti berikut:

Data terstruktur hotel

Properti name dan address

Properti name dan address digunakan untuk memberi anotasi pada nama hotel dan lokasi HTTP/HTTPS. Berikut adalah properti name dan address:

  "@type": "Hotel",
    "name": "hotel-name",
    "identifier": "hotel-id-1234",
    "address": {
      "@type": "PostalAddress",
      "addressCountry": "XX",
      "addressLocality": "City Name",
      "addressRegion": "State Name",
      "postalCode": "01234",
      "streetAddress": "1234 Main St."
    },

Sintaksis

Properti name dan address menggunakan sintaksis berikut:

JSON-LD

{
  "@context": "https://schema.org",
  "@type": "Hotel",
  "name": "hotel-name",
  "identifier": "hotel-id-1234",
  "address": {
    "@type": "PostalAddress",
    "addressCountry": "XX",
    "addressLocality": "City Name",
    "addressRegion": "State Name",
    "postalCode": "01234",
    "streetAddress": "1234 Main St."
  },
  "makesOffer": {
    "@type": ["Offer", "LodgingReservation"]
    ...
  }
}

Properti

Berikut adalah properti name dan address:

Properti Wajib? Jenis Deskripsi
Hotel.name Required string Nama hotel
Hotel.identifier Required string

Partner ID hotel.

ID harus berupa string unik per hotel, dan harus sama persis dengan string yang digunakan dalam feed harga.

Hotel.address Optional PostalAddress Alamat atau lokasi hotel.

Contoh

Nama & Anda

Berikut adalah contoh dasar untuk menambahkan anotasi name dan address:

{
"@context": "https://schema.org",
"@type": "Hotel",
"name": "Mountain Hotel",
"identifier": "hotel-id-1234",
"address": {
  "@type": "PostalAddress",
  "addressCountry": "AT",
  "addressLocality": "Innsbruck",
  "addressRegion": "Tyrol",
  "postalCode": "6020",
  "streetAddress": "Technikerstrasse 21"
},
"makesOffer": {
  "@type": ["Offer", "LodgingReservation"],
  "checkinTime": "2023-03-10 15:00:00",
  "checkoutTime": "2023-03-16 10:00:00",
  "priceSpecification": {
    "@type": "CompoundPriceSpecification",
    "price": 1222.74,
    "priceCurrency": "USD"
  }
}
}

Properti makesOffer

Anotasi makesOffer digunakan untuk markup itinerari hotel Anda.

  "makesOffer": {
    "@type": ["Offer", "LodgingReservation"],
    "checkinTime": "YYYY-MM-DD[THH:mm:ss]",
    "checkoutTime": "YYYY-MM-DD[THH:mm:ss]",
    "availability": "https://schema.org/InStock",
    ...
  }

Sintaksis

Properti makesOffer menggunakan sintaksis berikut:

JSON-LD

{
  "@context": "https://schema.org",
  "@type": "Hotel",
  "name": "hotel-name",
  "identifier": "hotel-id-1234",
  "address": { ... },
  "makesOffer": {
    "@type": ["Offer", "LodgingReservation"],
    "checkinTime": "YYYY-MM-DD[THH:mm:ss]",
    "checkoutTime": "YYYY-MM-DD[THH:mm:ss]",
    "availability": "https://schema.org/InStock",
    "priceSpecification": { ... }
  }
}

Properti

Berikut adalah properti makesOffer:

Properti Wajib? Jenis Deskripsi
makesOffer Required Offer and LodgingReservation

Penawaran hotel untuk itinerari tertentu.

Properti makesOffer dapat berisi array penawaran.

LodgingReservation.checkinTime Required DateTime

Waktu check-in dalam zona waktu pengguna. Jika zona waktu Anda bukan disebutkan maka zona waktu hotel akan dipertimbangkan.

LodgingReservation.checkoutTime Required DateTime

Waktu check out dalam zona waktu pengguna. Jika zona waktu Anda bukan disebutkan maka zona waktu hotel akan dipertimbangkan.

Contoh

makesOffer

Berikut adalah contoh dasar untuk menandai penawaran hotel Anda. Anda dapat menentukan beberapa penawaran untuk itinerari, tetapi Anda harus menentukan Tarif yang ditampilkan Google terlebih dahulu diikuti dengan tarif lainnya. Jumlah harga yang ditentukan mencakup semua pajak yang berlaku.

{
  "@context": "https://schema.org",
  "@type": "Hotel",
  "name": "Mountain Hotel",
  "identifier": "hotel-id-1234",
  "address": { ... },
  "makesOffer": [
    {
      "@type": ["Offer", "LodgingReservation"],
      "checkinTime": "2023-03-10 15:00:00",
      "checkoutTime": "2023-03-16 10:00:00",
      "priceSpecification": {
        "@type": "CompoundPriceSpecification",
        "price": 1222.74,
        "priceCurrency": "USD"
      }
    },
    {
      "@type": ["Offer", "LodgingReservation"],
      "checkinTime": "2023-03-10 15:00:00",
      "checkoutTime": "2023-03-16 10:00:00",
      "priceSpecification": {
        "@type": "CompoundPriceSpecification",
        "price": 1200.74,
        "priceCurrency": "USD"
      }
    }
  ]
}

Properti Hotel priceSpecification

Properti ini digunakan untuk memberi anotasi pada informasi harga hotel atau hotel Anda ruangan. Ada dua properti tambahan yang diperlukan untuk memberi anotasi pada terkait harga dan pajak. Anda harus menggunakan CompoundPriceSpecification untuk menentukan informasi harga total seperti tarif dasar, pajak, dan diskon. Menggunakan UnitPriceSpecification untuk menentukan pajak tambahan atau jenis biaya khusus seperti ResortFee, GenericTax, dan ServiceFee. priceSpecification properti dipaketkan dengan properti Offer.

  {
    ...
    "priceSpecification": {
      "@type": "CompoundPriceSpecification",
      "price": "float",
      "priceCurrency": "currency",
      "priceComponent": [
        {
          "@type": "UnitPriceSpecification",
          "name": "GenericTax",
          "price": "float",
          "priceCurrency": "currency"
        },
        ...
      ]
    }
  }

Sintaksis

Properti Hotel priceSpecification menggunakan sintaksis berikut:

JSON-LD

{
  "@context": "https://schema.org",
  "@type": "Hotel",
  ...
  "makesOffer": {
    "@type": ["Offer", "LodgingReservation"],
    ...
    "priceSpecification": {
      "@type": "CompoundPriceSpecification",
      "price": "float",
      "priceCurrency": "currency",
      "priceComponent": [
        {
          "@type": "UnitPriceSpecification",
          "name": "",
          "price": "float",
          "priceCurrency": "currency"
        },
        {
          "@type": "UnitPriceSpecification",
          "name": "GenericTax",
          "price": "float",
          "priceCurrency": "currency",
          "priceComponentType": "GenericTax",
          "potentialAction": {
            "@type": "https://schema.org/PayAction",
            "recipient": {
              "@type": "OnlineBusiness",
              "name": "name-of-the-business"
            }
          }
        },
        {
          "@type": "UnitPriceSpecification",
          "name": "Discount",
          "price": "float",
          "priceCurrency": "currency",
          "priceComponentType": "Discount"
        }
      ]
    }
  }
}

Microdata

  <div itemscope itemtype="https://schema.org/Hotel">
    <meta itemprop="name" content="hotel-name"/>
    ...
    <div itemscope itemtype="https://schema.org/Offer https://schema.org/LodgingReservation" itemprop="makesOffer">
      ...
      <div itemscope itemtype="https://schema.org/CompoundPriceSpecification" itemprop="priceSpecification">
        <meta itemprop="price" content="float"/>
        <meta itemprop="priceCurrency" content="currency"/>
        <div itemscope itemtype="https://schema.org/UnitPriceSpecification" itemprop="priceComponent">
          <meta itemprop="name" content=""/>
          <meta itemprop="price" content="float"/>
          <meta itemprop="priceCurrency" content="currency"/>
        </div>
        <div itemscope itemtype="https://schema.org/UnitPriceSpecification" itemprop="priceComponent">
          <meta itemprop="name" content="GenericTax" />
          <meta itemprop="price" content="float"/>
          <meta itemprop="priceCurrency" content="currency"/>
          <meta itemprop="priceComponentType" content="GenericTax"/>
        </div>
        <div itemscope itemtype="https://schema.org/UnitPriceSpecification" itemprop="priceComponent">
          <meta itemprop="name" content="Discount"/>
          <meta itemprop="price" content="float"/>
          <meta itemprop="priceCurrency" content="currency"/>
          <meta itemprop="priceComponentType" content="Discount"/>
        </div>
      </div>
    </div>
  </div>

Properti

Berikut adalah properti hotel priceSpecification:

Properti Wajib? Jenis Deskripsi
Hotel.Offer.priceSpecification.price Required float

Total harga termasuk pajak dan biaya untuk hotel.

Tarif Google harus selalu dicantumkan di halaman landing bersama dengan detail tarif lengkap Anda. Dengan membuat anotasi detail tarif, Anda dapat menyelesaikan pemeriksaan akurasi harga. Google menerima tingkat hotel dan tingkat kamar harga.

Hotel.Offer.priceSpecification.priceCurrency Required currency Kode mata uang tiga huruf untuk harga yang ditentukan. Misalnya: "USD" .
Hotel.Offer.priceSpecification.priceComponent Optional UnitPriceSpecification[]

Perincian harga total termasuk pajak dan biaya untuk hotel. Ada dua jenis data terstruktur harga:

  • CompoundPriceSpecification memberikan perincian harga untuk meliputi hal berikut:

    • Tarif dasar: Harga dasar per malam

    • Pajak per kunjungan: Harga per malam termasuk pajak.

    • Biaya per tamu: Harga per malam per jumlah tamu.

    • Diskon: Jumlah potongan.

  • UnitPriceSpecification digunakan untuk menentukan jenis tagihan. Anda harus menyertakan PriceComponentTypeEnumeration untuk menentukan biaya tambahan.

    Nilai untuk PriceComponentTypeEnumeration adalah:

    • Discount: Diskon umum untuk harganya.

    • ResortFee: Ini adalah biaya tambahan yang harus dibayar di hotel. Jumlah ini dapat bervariasi berdasarkan jenis penginapan saat ini.

    • GenericTax: Ini adalah ragam tambahan pajak.

    • ServiceFee: Ini adalah biaya tambahan sebesar ditagih oleh saluran pemesanan.

    • TransferFee: Ini adalah biaya wajib de-facto untuk transportasi ke hotel, diambil oleh pihak hotel atau pemesanan saluran TV Anda.

Anda harus menetapkan nilai dalam properti priceComponentType . Semua nilai wajib diisi jika Anda memilih untuk menyertakan UnitPriceSpecification dan harus ditentukan di UnitPriceSpecification.

Hotel.Offer.priceSpecification.priceComponent. potentialAction Optional PayAction

Tempat pembayaran hotel.Alur pembayaran hotel mencakup harga yang dikenakan selama waktu check-out di situs pemesanan dan hotel saat check in.

Anda harus menggunakan properti potentialAction yang dipaketkan dengan PayAction recipient" untuk menunjukkan tempat pembayaran. Rujuk ke PayAction untuk mempelajari selengkapnya tentang properti recipient.

Google mendukung dua setelan berikut untuk PayAction penerima:

  • recipient.@type = "OnlineBusiness" mengacu pada pembayaran dikumpulkan pada saat pemesanan oleh penjual {i>online<i}. Ini adalah setelan default jika potentialAction tidak ditentukan.

  • recipient.@type = "Hotel" mengacu pada pembayaran dikumpulkan di hotel.

Contoh

Contoh JSON-LD

Harga

Berikut adalah contoh dasar untuk menambahkan data terstruktur harga ke halaman web mereka. Beberapa penawaran tingkat hotel dapat disertakan dalam makesOffer.

Jenis PostalAddress seperti addressCountry, postalCode, streetAddress dan kolom lainnya wajib diisi jika Anda memilih untuk menentukan address. Tarif yang ditampilkan oleh Google harus tercantum terlebih dahulu di makesOffer. Jumlah harga yang ditentukan mencakup semua hal yang berlaku pajak.

{
  "@context": "https://schema.org",
  "@type": "Hotel",
  "name": "ACME Hotel",
  "identifier": "hotel-id-1234",
  "address": {
    "@type": "PostalAddress",
    "addressCountry": "AT",
    "addressLocality": "Innsbruck",
    "addressRegion": "Tyrol",
    "postalCode": "6020",
    "streetAddress": "Technikerstrasse 21"
  },
  "makesOffer": [
    {
      "@type": ["Offer", "LodgingReservation"],
      "checkinTime": "2023-03-10 15:00:00",
      "checkoutTime": "2023-03-16 10:00:00",
      "priceSpecification": {
        "@type": "CompoundPriceSpecification",
        "price": 1222.74,
        "priceCurrency": "USD"
      }
    },
    {
      "@type": ["Offer", "LodgingReservation"],
      "checkinTime": "2023-03-10 15:00:00",
      "checkoutTime": "2023-03-16 10:00:00",
      "priceSpecification": {
        "@type": "CompoundPriceSpecification",
        "price": 1200.74,
        "priceCurrency": "USD"
      }
    },
    ...
  ]
}

Rincian harga

Berikut adalah contoh properti priceSpecification dengan atribut perincian harga. Tarif dasar, pajak seperti pajak umum dan diskon yang ditentukan menggunakan komponen UnitPriceSpecification. Ingatlah untuk menyetel Kolom priceComponentType dengan nilai yang sesuai dengan Komponen UnitPriceSpecification.

Harga total untuk lama menginap harus ditentukan dalam CompoundPriceSpecification. Perincian harga harus yang ditentukan di properti priceComponent.

{
  "@context": "https://schema.org",
  "@type": "Hotel",
  "name": "ACME Hotel",
  "identifier": "hotel-id-1234",
  "address": {...},
  "makesOffer": {
    "@type": ["Offer", "LodgingReservation"],
    "checkinTime": "2023-03-10 15:00:00",
    "checkoutTime": "2023-03-16 10:00:00",
    "priceSpecification": {
      "@type": "CompoundPriceSpecification",
      "price": 1222.74,
      "priceCurrency": "USD",
      "priceComponent": [
        {
          "@type": "UnitPriceSpecification",
          "name": "",
          "price": 1150,
          "priceCurrency": "USD"
        },
        {
          "@type": "UnitPriceSpecification",
          "name": "GenericTax",
          "price": 172.74,
          "priceCurrency": "USD",
          "priceComponentType": "GenericTax"
        },
        {
          "@type": "UnitPriceSpecification",
          "name": "Discount",
          "price": -100,
          "priceCurrency": "USD",
          "priceComponentType": "Discount"
        }
      ]
    }
  }
}

Metode Pembayaran

Berikut adalah contoh spesifikasi potentialAction dalam menggunakan Jenis penerima PayAction.

Harga total paket adalah $1.170 dan situs web {i>online<i} mengenakan biaya dari total harga, yaitu $1.150 pada saat pemesanan yang ditentukan menggunakan "@type": "OnlineBusiness" dan pengguna harus membayar sisa $20 di waktu check in di hotel yang ditentukan menggunakan @type": "Hotel".

Anda harus menentukan komponen potentialAction agar dapat memecah pembayaran pada saat pemesanan dan di hotel. Jika tidak ditentukan maka payAction menafsirkan pembayaran pada saat pemesanan sebagai default metode pembayaran Anda.

{
  "@context": "https://schema.org",
  "@type": "Hotel",
  "name": "ACME Hotel",
  "identifier": "hotel-id-1234",
  "makesOffer": {
    "@type": ["Offer", "LodgingReservation"],
    "checkinTime": "2023-03-10 15:00:00",
    "checkoutTime": "2023-03-16 10:00:00]",
    "priceSpecification": {
      "@type": "CompoundPriceSpecification",
      "price": 1170,
      "priceCurrency": "USD",
      "priceComponent": [
        {
          "@type": "UnitPriceSpecification",
          "price": 1150,
          "priceCurrency": "USD",
          "potentialAction": {
            "@type": "https://schema.org/PayAction",
            "recipient": {
              "@type": "OnlineBusiness",
              "name": "myonlinebusiness"
            }
          }
        },
        {
          "@type": "UnitPriceSpecification",
          "price": 20,
          "priceCurrency": "USD",
          "potentialAction": {
            "@type": "https://schema.org/PayAction",
            "recipient": {
              "@type": "Hotel",
              "name": "The Langham, Boston",
              "address": { ... }
            }
          }
        }
      ]
    }
  }
}

Contoh microservice

Rincian harga

Berikut adalah contoh properti priceSpecification dengan atribut perincian harga. Tarif dasar, pajak seperti pajak umum dan diskon yang ditentukan menggunakan komponen UnitPriceSpecification. Ingatlah untuk menyetel name dengan nilai yang sesuai dengan Komponen UnitPriceSpecification.

Harga total untuk lama menginap harus ditentukan dalam CompoundPriceSpecification. Perincian harga harus yang ditentukan di properti priceComponent.

<div itemscope itemtype="https://schema.org/Hotel">
  <meta itemprop="name" content="ACME Hotel"/>
  <meta itemprop="identifier" content="hotel-id-1234"/>
  <div itemscope itemtype="https://schema.org/PostalAddress" itemprop="address">
    <meta itemprop="addressCountry" content="US" />
    <meta itemprop="addressLocality" content="Mountain View" />
    <meta itemprop="addressRegion" content="Santa Clara" />
    <meta itemprop="postalCode" content="94040" />
    <meta itemprop="streetAddress" content="123 Main street" />
  </div>
  <div itemscope itemtype="https://schema.org/Offer   https://schema.org/LodgingReservation"  itemprop="makesOffer">
    <meta itemprop="checkinTime" content="2023-03-10 15:00:00" />
    <meta itemprop="checkoutTime" content="2023-03-16 10:00:00"/>
    <div itemscope itemtype="https://schema.org/CompoundPriceSpecification"   itemprop="priceSpecification">
    <meta itemprop="price" content="1222.74" />
    <meta itemprop="priceCurrency" content="USD" />
      <div itemscope itemtype="https://schema.org/UnitPriceSpecification"    itemprop="priceComponent">
        <meta itemprop="name" content="" />
        <meta itemprop="price" content="1150" />
        <meta itemprop="priceCurrency" content="USD" />
      </div>
      <div itemscope itemtype="https://schema.org/UnitPriceSpecification"  itemprop="priceComponent">
        <meta itemprop="name" content="GenericTax" />
        <meta itemprop="price" content="172.74" />
        <meta itemprop="priceCurrency" content="USD" />
        <meta itemprop="priceComponentType" content="GenericTax" />
      </div>
      <div itemscope itemtype="https://schema.org/UnitPriceSpecification"   itemprop="priceComponent">
        <meta itemprop="name" content="Discount" />
        <meta itemprop="price" content="-100" />
        <meta itemprop="priceCurrency" content="USD" />
        <meta itemprop="priceComponentType" content="Discount" />
      </div>
    </div>
  </div>
</div>

Properti hasMerchantReturnPolicy

Properti ini digunakan untuk memberi anotasi pada kebijakan pengembalian dana penjual dalam itinerari.

    "hasMerchantReturnPolicy": {
      "@type": "MerchantReturnPolicy",
      "returnPolicyCategory": "https://schema.org/MerchantReturnFiniteReturnWindow",
      "refundType": "https://schema.org/FullRefund",
      "merchantReturnDays": "YYYY-MM-DD[THH:mm:ss]",
      "restockingFee": 0
    }

Sintaksis

hasMerchantReturnPolicy memiliki sintaksis berikut:

JSON-LD

{
  "@context": "https://schema.org",
  "@type": "Hotel",
  ...
  "makesOffer": {
    "@type": ["Offer", "LodgingReservation"],
    "checkinTime": "YYYY-MM-DD[THH:mm:ss]",
    "checkoutTime": "YYYY-MM-DD[THH:mm:ss]",
    "priceSpecification": { ... },
    "hasMerchantReturnPolicy": {
      "@type": "MerchantReturnPolicy",
      "returnPolicyCategory": "https://schema.org/MerchantReturnFiniteReturnWindow",
      "refundType": "https://schema.org/FullRefund",
      "merchantReturnDays": "YYYY-MM-DD[THH:mm:ss]",
      "restockingFee": 0
    }
  }
}

Properti

Berikut adalah properti hasMerchantReturnPolicy:

Atribut Wajib? Jenis Deskripsi
Offer.hasMerchantReturnPolicy Optional MerchantReturnPolicy

Kebijakan pengembalian dana penjual. Sebaiknya partner menggunakan MerchantReturnPolicy.restockingFee untuk menunjukkan kebijakan pembatalan yang tidak mengembalikan dana penuh untuk dan panjang masa inap mereka.

Jika hasMerchantReturnPolicy tidak ditentukan atau dibiarkan kosong jumlah tersebut diasumsikan tidak dapat dikembalikan dananya. Anda dapat menentukan kebijakan pengembalian dana menggunakan properti returnPolicyCategory: MerchantReturnNotPermitted.

Contoh

Kebijakan pengembalian

Berikut adalah contoh dasar data terstruktur untuk hotel dengan kamar detail dan harga total termasuk pajak dan biaya. Contoh ini menunjukkan kunjungan yang dapat dibatalkan tanpa biaya apa pun hingga pukul 23.00 (UTC) pada 18 Desember 2023. Sebaiknya partner menggunakan "MerchantReturnPolicy.restockingFee" untuk menunjukkan kebijakan pembatalan yang tidak menerima pengembalian dana penuh. restockingFee default menjadi $0.

{
  "@context": "https://schema.org",
  "@type": "Hotel",
  "name": "ACME Hotel",
  "identifier": "hotel-id-1234",
  "description": "Beautiful resort in the outskirts of the city",
  "address": {...},
  "makesOffer": {
    "@type": ["Offer", "LodgingReservation"],
    "checkinTime": "2023-12-15 16:00:00",
    "checkoutTime": "2023-12-20 11:00:00",
    "priceSpecification": {...},
    "hasMerchantReturnPolicy": {
      "@type": "MerchantReturnPolicy",
      "returnPolicyCategory": "https://schema.org/MerchantReturnFiniteReturnWindow",
      "refundType": "https://schema.org/FullRefund",
      "merchantReturnDays": "2023-12-18 23:00:00",
      "restockingFee": 0
    }
  }
}

Properti eligibleCustomerType

Properti ini dapat digunakan untuk memberi anotasi pada program reward yang disediakan untuk hotel pelanggan.

"eligibleCustomerType": "RewardsMember",
"priceSpecification": {
    "@type": "CompoundPriceSpecification",
    "price": "float",
    "priceCurrency": "currency"
 }

Sintaksis

Properti eligibleCustomerType memiliki sintaksis berikut:

JSON-LD

{
  "@context": "https://schema.org",
  "@type": "Hotel",
  ...
  "makesOffer": {
    "@type": ["Offer", "LodgingReservation"],
    "checkinTime": "YYYY-MM-DD[THH:mm:ss]",
    "checkoutTime": "YYYY-MM-DD[THH:mm:ss]",
    "eligibleCustomerType": "RewardsMember",
    "priceSpecification": { ... }
  }
}

Properti

Berikut adalah properti eligibleCustomerType:

Atribut Wajib? Jenis Deskripsi
Offer.eligibleCustomerType Optional BusinessEntityType

Program loyalitas atau reward anggota yang ditawarkan untuk pelanggan.

Banyak halaman hotel menampilkan tarif anggota bersama dengan tarif publik, untuk mendorong pengguna mendaftar ke program loyalitas mereka. Tarif dibatasi kepada audiens tertentu, seperti tarif anggota, dapat ditentukan dengan menetapkan properti Offer.eligibleCustomerType.

Contoh

Tarif anggota

Berikut adalah contoh dasar harga khusus anggota atau tarif dengan pagar spesifikasi untuk program loyalitas. Pelanggan adalah "anggota reward" pengguna hotel.

{
  "@context": "https://schema.org",
  "@type": "Hotel",
  "name": "ACME Hotel",
  "identifier": "hotel-id-1234",
  "address": {...},
  "makesOffer": {
    "@type": ["Offer", "LodgingReservation"],
    "name": "RewardsMember",
    "checkinTime": "2023-12-15 16:00:00",
    "checkoutTime": "2023-12-20 11:00:00",
    "eligibleCustomerType": "RewardsMember",
    "priceSpecification": {
      "@type": "CompoundPriceSpecification",
      "price": 1342.74,
      "priceCurrency": "USD",
      "priceComponent": [
        {
          "@type": "UnitPriceSpecification",
          "name": "Base rate",
          "price": 1069.98,
          "priceCurrency": "USD"
        },
        {
          "@type": "UnitPriceSpecification",
          "name": "GenericTax",
          "price": 172.74,
          "priceCurrency": "currency"
        },
        {
          "@type": "UnitPriceSpecification",
          "name": "ResortFee",
          "price": 100,
          "priceCurrency": "USD"
        }
      ]
    }
  }
}

Anggota & tarif reguler

Ini adalah contoh anotasi harga tarif reguler dan anggota. Tujuan harga khusus anggota dicantumkan terlebih dahulu diikuti dengan tarif reguler.

{
  "@context": "https://schema.org",
  "@type": "Hotel",
  "name": "ACME Hotel",
  "identifier": "hotel-id-1234",
  "address": {...},
  "makesOffer": [
    {
      "@type": ["Offer", "LodgingReservation"],
      "name": "RewardsMember",
      "checkinTime": "2023-12-15 16:00:00",
      "checkoutTime": "2023-12-20 11:00:00",
      "eligibleCustomerType": "RewardsMember",
      "priceSpecification": {
        "@type": "CompoundPriceSpecification",
        "price": 1342.74,
        "priceCurrency": "USD",
        "priceComponent": [
          {
            "@type": "UnitPriceSpecification",
            "name": "Base rate",
            "price": 1069.98,
            "priceCurrency": "USD"
          },
          {
            "@type": "UnitPriceSpecification",
            "name": "GenericTax",
            "price": 172.74,
            "priceCurrency": "currency"
          },
          {
            "@type": "UnitPriceSpecification",
            "name": "ResortFee",
            "price": 100,
            "priceCurrency": "USD"
          }
        ]
      }
    },
    {
      "@type": ["Offer", "LodgingReservation"],
      "name": "regularRate",
      "checkinTime": "2023-12-15 16:00:00",
      "checkoutTime": "2023-12-20 11:00:00",
      "priceSpecification": {
        "price": 1572.24,
        "priceCurrency": "USD",
        "priceComponent": [
          {
            "@type": "UnitPriceSpecification",
            "name": "Base rate",
            "price": 1369.98,
            "priceCurrency": "USD"
          },
          {
            "@type": "UnitPriceSpecification",
            "name": "GenericTax",
            "price": 202.26,
            "priceCurrency": "currency"
          },
          {
            "@type": "UnitPriceSpecification",
            "name": "ResortFee",
            "price": 100,
            "priceCurrency": "USD"
          }
        ]
      }
    }
  ]
}

Data terstruktur HotelRoom

Properti offers

Anotasi offers digunakan untuk menandai ruang Anda itinerari. Anda harus menggunakan properti offers untuk spesifikasi HotelRoom.

"offers": {
  "@type": ["Offer", "LodgingReservation"],
  "identifier": "hotel-room-id-1234",
  "checkinTime": "YYYY-MM-DD[THH:mm:ss]",
  "checkoutTime": "YYYY-MM-DD[THH:mm:ss]",
  "priceSpecification": {...}
}

Sintaksis

Properti offers memiliki sintaksis berikut:

JSON-LD

{
  "@context": "https://schema.org",
  "@type": "HotelRoom",
  "identifier": "hotel-room-id-1234",
  "offers": {
    "@type": ["Offer", "LodgingReservation"],
    "checkinTime": "YYYY-MM-DD[THH:mm:ss]",
    "checkoutTime": "YYYY-MM-DD[THH:mm:ss]",
    "priceSpecification": {
      "@type": "CompoundPriceSpecification",
      "price": "float",
      "priceCurrency": "currency",
      ...
    }
  }
}

Properti

Berikut adalah properti offers:

Properti Wajib? Jenis Deskripsi
offers Required Offer and LodgingReservation

Spesifikasi harga kamar untuk itinerari yang ditentukan.

Properti offers dapat berisi array di seluruh platform Google.

LodgingReservation.checkinTime Required DateTime

Waktu check-in dalam zona waktu pengguna. Jika zona waktu Anda bukan disebutkan maka zona waktu hotel akan dipertimbangkan.

LodgingReservation.checkoutTime Required DateTime

Waktu check out dalam zona waktu pengguna. Jika zona waktu Anda bukan disebutkan maka zona waktu hotel akan dipertimbangkan.

Contoh

penawaran

Berikut adalah contoh dasar untuk menentukan offers di HotelRoom saat ini.

{
  "@context": "https://schema.org",
  "@type": "HotelRoom",
  "identifier": "hotel-room-id-1234",
  "offers": {
    "@type": ["Offer", "LodgingReservation"],
    "identifier": "rate-plan-id-of-member-rate",
    "checkinTime": "2023-03-10 15:00:00",
    "checkoutTime": "2023-03-16 10:00:00",
    "priceSpecification": {
      "@type": "CompoundPriceSpecification",
      "price": 1222.74,
      "priceCurrency": "USD"
    }
  }
}

bed dan occupancy properti

Properti bed digunakan untuk memberi anotasi jenis tempat tidur dan jumlah tempat tidur yang tersedia di dalam ruangan. Properti occupancy digunakan untuk menganotasi angka jumlah tamu yang ada di ruangan. Properti bed dan occupancy dapat ditentukan menggunakan properti HotelRoom.

"@type": "Hotel",
"identifier": "hotel-id-1234",
"containsPlace": {
    "@type": ["HotelRoom", "Product"],
    "identifier": "hotel-room-id",
  "bed": {
    "@type": "BedDetails",
    "numberOfBeds": "integer",
    "typeOfBed": "KING"
  },
  "occupancy": {
    "@type": "QuantitativeValue",
    "value": "integer"
  }
}

Sintaksis

Properti bed dan occupancy memiliki sintaksis berikut:

JSON-LD

{
  "@context": "https://schema.org",
  "@type": "Hotel",
  "name": "hotel-name",
  "identifier": "hotel-id-1234",
  "containsPlace": {
    "@type": ["HotelRoom", "Product"],
    "name": "room-name",
    "identifier": "hotel-room-id-1234",
    "bed": {
      "@type": "BedDetails",
      "numberOfBeds": "integer",
      "typeOfBed": "KING"
    },
    "occupancy": {
      "@type": "QuantitativeValue",
      "value": "integer"
    },
    "offers": {
      "@type": ["Offer", "LodgingReservation"],
      "identifier": "rate-plan-id-of-member-rate",
      "checkinTime": "YYYY-MM-DD[THH:mm:ss]",
      "checkoutTime": "YYYY-MM-DD[THH:mm:ss]",
      "priceSpecification": {
        "@type": "CompoundPriceSpecification",
        "price": "float",
        "priceCurrency": "currency",
        "priceComponent": {
          "@type": "UnitPriceSpecification",
          "name": "",
          "price": "float",
          "priceCurrency": "currency"
        },
        ...
      }
    }
  }
}

Properti bed dan occupancy hanya dapat disetel menggunakan HotelRoom saat ini. Informasi spesifik per kamar, termasuk tarif tingkat kamar, dapat disertakan ke properti Hotel melalui properti containsPlace. Lihat Contoh spesifikasi Hotel dan HotelRoom.

Properti

Berikut adalah properti bed dan occupancy:

Properti Wajib? Jenis Deskripsi
HotelRoom.bed Optional (Recommended) bed

Jenis tempat tidur yang termasuk dalam akomodasi dan jumlah penghuni dalam ruangan.

Nilai yang didukung adalah:

  • CALIFORNIA_KING
  • KING
  • QUEEN
  • FULL
  • DOUBLE
  • SEMI_DOUBLE
  • SINGLE
HotelRoom.occupancy Optional (Recommended) QuantitativeValue

Jumlah tamu di kamar hotel. Jenis jumlah tamu adalah QuantitativeValue.

Kehadiran adalah properti eksplisit dari HotelRoom, bukan untuk Offer tertentu. Tarif hanya boleh diberi tag untuk jumlah tamu yang diminta.

containsPlace Optional (Recommended) LocationFeatureSpecification

Ini digunakan untuk menganotasi tarif tingkat kamar yang terkait dengan ruangan. Juga dapat digunakan untuk menentukan fasilitas di kamar.

Pelajari lebih lanjut cara menggunakan containsPlace di amenityFeature.

Contoh

HotelRoom

Berikut adalah contoh dasar tempat tidur dan jumlah tamu untuk kamar spesifikasi pendukung.

{
  "@context": "https://schema.org",
  "@type": ["HotelRoom", "Product"],
  "name": "Deluxe Room, 1 King Bed",
  "identifier": "hotel-room-id-1234",
  "bed": [
    {
      "@type": "BedDetails",
      "numberOfBeds": 1,
      "typeOfBed": "KING"
    },
    {
      "@type": "BedDetails",
      "numberOfBeds": 1,
      "typeOfBed": "SINGLE"
    }
  ],
  "occupancy": {
    "@type": "QuantitativeValue",
    "value": 2
  },
  "offers": {
    "@type": ["Offer", "LodgingReservation"],
    "identifier": "rate-plan-id-of-member-rate",
    "checkinTime": "2023-03-10 15:00:00",
    "checkoutTime": "2023-03-16 10:00:00",
    "priceSpecification": {
      "@type": "CompoundPriceSpecification",
      "price": 1222.74,
      "priceCurrency": "USD"
    }
  }
}

Hotel dan HotelRoom

Berikut adalah contoh anotasi Hotel dan HotelRoom beserta bed, occupancy, dan priceSpecification.

{
  "@context": "https://schema.org",
  "@type": "Hotel",
  "name": "hotel-name",
  "identifier": "hotel-id-1234",
  "containsPlace": {
    "@type": ["HotelRoom", "Product"],
    "name": "Deluxe Room, 1 King Bed",
    "identifier": "hotel-room-id",
    "bed": {
      "@type": "BedDetails",
      "numberOfBeds": 1,
      "typeOfBed": "KING"
    },
    "occupancy": {
      "@type": "QuantitativeValue",
      "value": 2
    },
    "amenityFeature": {
      "@type": "LocationFeatureSpecification",
      "name": "Minibar",
      "value": true
    },
    "offers": {
      "@type": ["Offer", "LodgingReservation"],
      "identifier": "rate-plan-id-of-member-rate",
      "checkinTime": "2023-03-10 15:00:00",
      "checkoutTime": "2023-03-16 10:00:00",
      "priceSpecification": {
        "@type": "CompoundPriceSpecification",
        "price": 1222.74,
        "priceCurrency": "USD"
      }
    }
  }
}

Properti HotelRoom priceSpecification

Spesifikasi harga kamar hotel mirip dengan spesifikasi harga hotel. selisihnya adalah harga kamar ditentukan menggunakan properti Product.offers bukan properti Hotel.makesOffer.

"priceSpecification": {
  "@type": "CompoundPriceSpecification",
  "price": "float",
  "priceCurrency": "currency",
  "priceComponent": {
    "@type": "UnitPriceSpecification",
    "name": "GenericTax",
    "price": "float",
    "priceCurrency": "currency"
  }
  ...
}

Sintaksis

Properti priceSpecification untuk kamar hotel memiliki sintaksis berikut:

JSON-LD

{
  "@context": "https://schema.org",
  "@type": ["HotelRoom", "Product"],
  ...
  "bed": {
    "@type": "BedDetails",
    "numberOfBeds": "integer",
    "typeOfBed": "KING"
  },
  "occupancy": {
    "@type": "QuantitativeValue",
    "value": "integer"
  },
  "offers": {
    "@type": ["Offer", "LodgingReservation"],
    ...
    "priceSpecification": {
      "@type": "CompoundPriceSpecification",
      "price": "float",
      "priceCurrency": "currency",
      "priceComponent": [
        {
          "@type": "UnitPriceSpecification",
          "name": "",
          "price": "float",
          "priceCurrency": "currency"
        },
        {
          "@type": "UnitPriceSpecification",
          "name": "GenericTax",
          "price": "float",
          "priceCurrency": "currency",
          "priceComponentType": "GenericTax"
        },
        {
          "@type": "UnitPriceSpecification",
          "name": "Discount",
          "price": "float",
          "priceCurrency": "currency",
          "priceComponentType": "Discount"
        }
      ]
    }
  }
}

Properti

Berikut adalah properti HotelRoom priceSpecification:

Properti Wajib? Jenis Deskripsi
Hotel.Offer.priceSpecification.price Required float

Harga per kamar termasuk pajak dan biaya untuk Product.

Tarif Google harus selalu dicantumkan di halaman landing bersama dengan detail tarif lengkap Anda. Dengan membuat anotasi detail tarif, Anda dapat menyelesaikan pemeriksaan akurasi harga. Google menerima tingkat hotel dan tingkat kamar harga.

Hotel.Offer.priceSpecification.priceCurrency Required currency Kode mata uang tiga huruf untuk harga yang ditentukan. Misalnya: "USD" .
Hotel.Offer.priceSpecification.priceComponent Optional UnitPriceSpecification[]

Perincian harga total termasuk pajak dan biaya untuk hotel kamar dan jumlah tamu dengan penawaran yang ditautkan ke HotelRoom dan Product. Ada dua jenis data terstruktur harga:

  • CompoundPriceSpecification memberikan perincian harga untuk meliputi hal berikut:

    • Tarif dasar: Harga dasar per malam

    • Pajak per kunjungan: Harga per malam termasuk pajak.

    • Biaya per tamu: Harga per malam per jumlah tamu.

      occupancy adalah properti eksplisit dari HotelRoom, bukan untuk Offer tertentu. Tarif hanya boleh diberi tag untuk jumlah tamu.

    • Diskon: Jumlah potongan.

  • UnitPriceSpecification digunakan untuk menentukan jenis tagihan. Anda harus menyertakan PriceComponentTypeEnumeration untuk menentukan biaya tambahan.

    Nilai untuk PriceComponentTypeEnumeration adalah:

    • Discount: Diskon umum untuk harganya.

    • ResortFee: Ini adalah biaya tambahan yang harus dibayar di hotel. Jumlah ini dapat bervariasi berdasarkan jenis penginapan saat ini.

    • GenericTax: Ini adalah ragam tambahan pajak.

    • ServiceFee: Ini adalah biaya tambahan sebesar ditagih oleh saluran pemesanan.

    Anda harus menetapkan nilai dalam name properti UnitPriceSpecification. Semua nilai adalah diperlukan jika Anda memilih untuk menyertakan perincian harga dan hal itu harus yang ditentukan dalam komponen UnitPriceSpecification.

Contoh

Total harga kamar

Berikut adalah contoh dasar untuk menentukan harga total untuk durasi iklan masa inap dan harga per jumlah tamu.

{
  "@context": "https://schema.org",
  "@type": ["HotelRoom", "Product"],
  "name": "Deluxe Room King, 1 Single Bed",
  "identifier": "hotel-room-id-1234",
  "bed": [
    {
      "@type": "BedDetails",
      "numberOfBeds": 1,
      "typeOfBed": "KING"
    },
    {
      "@type": "BedDetails",
      "numberOfBeds": 1,
      "typeOfBed": "SINGLE"
    }
  ],
  "occupancy": {
    "@type": "QuantitativeValue",
    "value": 2
  },
  "offers": {
    "@type": ["Offer", "LodgingReservation"],
    "checkinTime": "2023-03-10 15:00:00",
    "checkoutTime": "2023-03-16 10:00:00",
    "priceSpecification": {
      "@type": "CompoundPriceSpecification",
      "price": 1232.74,
      "priceCurrency": "USD"
    }
  },
  ...
}

Perincian harga kamar

Berikut contoh harga per kamar atau paket. Perincian harga ditentukan untuk jenis kamar seperti Deluxe ruang serta bed dan occupancy tipe seperti tempat tidur KING dan SINGLE serta jumlah tamu 2 tamu.

{
  "@context": "https://schema.org",
  "@type": ["HotelRoom", "Product"],
  "name": "Deluxe Room King, 1 Single Bed",
  "identifier": "hotel-room-id-1234",
  "offers": {
    "@type": ["Offer", "LodgingReservation"],
    "identifier": "rate-plan-id-of-member-rate",
    "checkinTime": "2023-03-10 15:00:00",
    "checkoutTime": "2023-03-16 10:00:00",
    "bed": [
      {
        "@type": "BedDetails",
        "numberOfBeds": 1,
        "typeOfBed": "KING"
      },
      {
        "@type": "BedDetails",
        "numberOfBeds": 1,
        "typeOfBed": "SINGLE"
      }
    ],
    "occupancy": {
      "@type": "QuantitativeValue",
      "value": 2
    },
    "priceSpecification": {
      "@type": "CompoundPriceSpecification",
      "price": 1222.74,
      "priceCurrency": "USD",
      "priceComponent": [
        {
          "@type": "UnitPriceSpecification",
          "name": "Base rate",
          "price": 1150,
          "priceCurrency": "USD"
        },
        {
          "@type": "UnitPriceSpecification",
          "name": "GenericTax",
          "price": 172.74,
          "priceCurrency": "USD",
          "priceComponentType": "GenericTax"
        },
        {
          "@type": "UnitPriceSpecification",
          "name": "Discount",
          "price": -100,
          "priceCurrency": "USD",
          "priceComponentType": "Discount"
        }
      ]
    }
  }
}

Properti includesObject

Properti ini digunakan untuk memberi anotasi pada layanan khusus tarif yang disediakan di hotel atau kamar seperti pilihan makanan dan layanan valet. Anda dapat memberi anotasi includesObject di properti Hotel atau HotelRoom.

{
  "includesObject": [
    {
      "@type": "TypeAndQuantityNode",
      "typeOfGood": {
        "@type": "Service",
        "name": "Valet"
      }
    },
    {
      "@type": "TypeAndQuantityNode",
      "amountOfThisGood": "float",
      "unitText": "currency",
      "typeOfGood": {
        "@type": "FoodService",
        "name": "MealCredit"
      }
    }
  ]
}

Sintaksis

includesObject memiliki sintaksis berikut untuk layanan khusus tarif yang tersedia dalam ruang:

JSON-LD

{
  "@context": "https://schema.org",
  ...
  "@type": ["HotelRoom", "Product"],
  ...
  "offers": {
    "@type": ["Offer", "LodgingReservation"],
    ...
    "priceSpecification": {
      "@type": "CompoundPriceSpecification",
      "price": "float",
      "priceCurrency": "currency"
    },
    "includesObject": [
      {
        "@type": "TypeAndQuantityNode",
        "typeOfGood": {
          "@type": "Service",
          "name": "Valet"
        }
      },
      {
        "@type": "TypeAndQuantityNode",
        "amountOfThisGood": "float",
        "unitText": "currency",
        "typeOfGood": {
          "@type": "FoodService",
          "name": "MealCredit"
        }
      }
    ]
  }
}

Properti

includesObject memiliki properti berikut:

Atribut Wajib? Jenis Deskripsi
Offer.includesObject Optional TypeAndQuantityNode

Layanan yang disediakan di hotel atau kamar.

Fitur khusus tarif disertakan dalam includesObject. Isian nama pada "TypeAndQuantityNode.typeOfGood" harus digunakan untuk menunjukkan jenis layanan seperti layanan valet atau makanan.

Fitur khusus tarif juga dapat disertakan dalam penawaran tingkat dasar, atau dapat ditetapkan sebagai add-on dengan harga tambahan.

includesObject memerlukan nilai jenis TypeAndQuantityNode sebagai berikut:

  • BreakfastIncluded
  • DinnerIncluded
  • Valet
  • MealCredit

Contoh

Layanan

Berikut adalah contoh dasar fitur khusus tarif untuk parkir valet dan layanan makanan. Fitur khusus tarif harus ditentukan dengan "Offer.includesObject". Isian nama pada "TypeAndQuantityNode.typeOfGood" harus digunakan untuk menunjukkan jenis layanan.

{
  "@context": "https://schema.org",
  "@type": ["HotelRoom", "Product"],
  "name": "Deluxe Room, 1 King Bed",
  "identifier": "hotel-room-id-1234",
  "offers": {
    "@type": ["Offer", "LodgingReservation"],
    "identifier": "rate-plan-id-of-member-rate",
    "checkinTime": "2023-03-10 15:00:00",
    "checkoutTime": "2023-03-16 10:00:00",
    "priceSpecification": {
      "@type": "CompoundPriceSpecification",
      "price": 1222.74,
      "priceCurrency": "USD"
    },
    "includesObject": [
      {
        "@type": "TypeAndQuantityNode",
        "typeOfGood": {
          "@type": "Service",
          "name": "Valet"
        }
      },
      {
        "@type": "TypeAndQuantityNode",
        "amountOfThisGood": 50,
        "unitText": "USD",
        "typeOfGood": {
          "@type": "FoodService",
          "name": "MealCredit"
        }
      }
    ]
  }
}

Properti availability

Properti offer.availability digunakan untuk menganotasi itinerari yang terjual habis untuk kamar hotel.

"offers": {
    "@type": ["Offer", "LodgingReservation"],
    "checkinTime": "YYYY-MM-DD[THH:mm:ss]",
    "checkoutTime": "YYYY-MM-DD[THH:mm:ss]",
    "availability": "https://schema.org/SoldOut"
}

Sintaksis

Properti availability memiliki sintaksis berikut:

JSON-LD

{
  "@context": "https://schema.org",
  ...
  "@type": ["HotelRoom", "Product"],
  "name": "room-type",
  "identifier": "hotel-room-id-1234",
  "bed": {
    "@type": "BedDetails",
    "numberOfBeds": "integer",
    "typeOfBed": "KING"
  },
  "occupancy": {
    "@type": "QuantitativeValue",
    "value": "integer"
  },
  "offers": {
    "@type": ["Offer", "LodgingReservation"],
    "checkinTime": "YYYY-MM-DD[THH:mm:ss]",
    "checkoutTime": "YYYY-MM-DD[THH:mm:ss]",
    "availability": "https://schema.org/SoldOut"
  }
}

Properti

Berikut adalah properti availability:

Atribut Wajib? Jenis Deskripsi
Offer.availability Optional ItemAvailability

Ketersediaan hotel atau kamar.

Tarif diekstrak dari schema.org/Offer dan informasi tarif tersebut tidak dibuat menggunakan schema.org/Hotel atau schema.org/HotelRoom. Artinya, itinerari yang terjual habis juga harus memiliki penawaran.

Penawaran tanpa priceSpecification dianggap sebagai tidak tersedia. Penawaran yang tidak tersedia harus ditetapkan sebagai "Offer.availability= https://schema.org/SoldOut".

Offer.availability tidak harus jika penawaran dianotasikan dengan ID priceSpecification.

Contoh

Ketersediaan

Berikut adalah contoh dasar untuk menampilkan ketidaktersediaan kamar hotel. Anda harus menyertakan jenis tempat tidur, jumlah tempat tidur, dan detail hunian untuk ruangan yang ditentukan.

{
  "@context": "https://schema.org",
  "@type": ["HotelRoom", "Product"],
  "name": "Deluxe Room, 1 King Bed",
  "identifier": "hotel-room-id-1234",
  "bed": [
    {
      "@type": "BedDetails",
      "numberOfBeds": 1,
      "typeOfBed": "KING"
    },
    {
      "@type": "BedDetails",
      "numberOfBeds": 1,
      "typeOfBed": "SINGLE"
    }
  ],
  "occupancy": {
    "@type": "QuantitativeValue",
    "value": 2
  },
  "offers": {
    "@type": ["Offer", "LodgingReservation"],
    "checkinTime": "2023-03-10 15:00:00",
    "checkoutTime": "2023-03-16 10:00:00",
    "availability": "https://schema.org/SoldOut",
    "priceSpecification": {...}
  }
}

Properti amenityFeature

Fasilitas dapat ditentukan dalam jenis Hotel atau HotelRoom menggunakan amenityFeature. Anda harus menggunakan properti containsPlace untuk menentukan fasilitas yang disediakan di kamar.

{
  "@type": "Hotel",
  "amenityFeature": [
    {
      "@type": "LocationFeatureSpecification",
      "name": "HotTub",
      "hoursAvailable": {
        "@type": "OpeningHoursSpecification",
        "opens": "HH:mm:ss",
        "closes": "HH:mm:ss"
      }
    },
    {
      "@type": "LocationFeatureSpecification",
      "name": "GymFitnessEquipment",
      "value": "boolean"
    }
  ],
  "containsPlace": {
    "@type": "HotelRoom",
    "amenityFeature": [
      {
        "@type": "LocationFeatureSpecification",
        "name": "Minibar",
        "value": true
      },
      {
        "@type": "LocationFeatureSpecification",
        "name": "Smoking",
        "value": false
      }
    ]
  }
}

Sintaksis

Properti amenityFeature dan containsPlace memiliki hal berikut sintaksis:

JSON-LD

{
  "@context": "https://schema.org",
  "@type": "Hotel",
  ...
  "amenityFeature": {
    "@type": "LocationFeatureSpecification",
    "name": "HotTub",
    "hoursAvailable": {
      "@type": "OpeningHoursSpecification",
      "opens": "HH:mm:ss",
      "closes": "HH:mm:ss"
    }
  },
  "containsPlace": {
    "@type": "HotelRoom",
    "amenityFeature": {
      "@type": "LocationFeatureSpecification",
      "name": "Minibar",
      "value": "boolean"
    }
  }
}

Fasilitas

Fasilitas berikut diizinkan dan ditentukan di properti name.

Atribut Wajib? Jenis Deskripsi
amenityFeature.AC Optional boolean Apakah properti memiliki AC.
amenityFeature.AirportShuttle Optional boolean Apakah tuan rumah menyediakan transportasi ke dan dari bandara atau terminal lainnya.
amenityFeature.Balcony Optional boolean Apakah akomodasi memiliki balkon.
amenityFeature.BeachAccess Optional boolean Apakah properti memiliki akses ke pantai umum di dekat properti.
amenityFeature.ChildFriendly Optional boolean Apakah properti cocok untuk anak-anak.
amenityFeature.Crib Optional boolean Apakah properti menyediakan tempat tidur bayi.
amenityFeature.Elevator Optional boolean Apakah properti memiliki elevator.
amenityFeature.FirePlace Optional boolean Apakah akomodasi memiliki perapian.
amenityFeature.FreeBreakfast Optional boolean Apakah properti menyediakan sarapan gratis untuk semua tamu. Gunakan fitur tarif untuk menunjukkan apakah sarapan sudah termasuk dalam tarif tertentu paket.
amenityFeature.GymFitnessEquipment Optional boolean Apakah properti memiliki gym atau peralatan kebugaran.
amenityFeature.Heating Optional boolean Apakah akomodasi memiliki sistem pemanas.
amenityFeature.HotTub Optional boolean Apakah properti memiliki bak mandi air panas.
amenityFeature.InstantBookable Optional boolean Apakah properti dapat langsung dipesan melalui checkout {i>checkout<i}. Alternatifnya menunggu persetujuan.
amenityFeature.IroningBoard Optional boolean Apakah properti menyediakan papan setrika.
amenityFeature.Kitchen Optional boolean Apakah akomodasi memiliki dapur.
amenityFeature.Microwave Optional boolean Apakah akomodasi menyediakan microwave.
amenityFeature.OpenAirBath(Hotels only) Optional boolean Apakah akomodasi dilengkapi pemandian outdoor. Jika ditentukan di tingkat kamar, kamar mandi harus bersifat pribadi hanya untuk tamu kamar.
amenityFeature.OutdoorGrill Optional boolean Apakah properti memiliki pemanggang.
amenityFeature.OvenStove Optional boolean Apakah properti memiliki kompor.
amenityFeature.Patio Optional boolean Apakah properti memiliki teras.
amenityFeature.Pool Optional boolean Apakah akomodasi memiliki kolam renang.
amenityFeature.PrivateBeachAccess Optional boolean Apakah properti memiliki akses khusus ke pantai non-publik.
amenityFeature.SelfCheckinCheckout Optional boolean Apakah properti mendukung check in dan check out mandiri.
amenityFeature.WasherDryer Optional boolean Apakah akomodasi memiliki peralatan laundry.
amenityFeature.Wifi Optional boolean Apakah properti memiliki Wi-Fi.
amenityFeature.Smoking Optional boolean Apakah akomodasi mengizinkan merokok.
amenityFeature.InternetType Optional Enum

Jenis internet yang tersedia di properti.

Nilai yang didukung adalah:

  • FREE
  • PAID
  • NONE
amenityFeature.ParkingType Optional Enum

Jenis tempat parkir yang tersedia di properti.

Nilai yang didukung adalah:

  • FREE
  • PAID
  • NONE
amenityFeature.PoolType Optional Enum

Jenis kolam renang yang tersedia di properti.

Nilai yang didukung adalah:

  • INDOOR
  • OUTDOOR
  • NONE
amenityFeature.RoomStyle Optional Enum

Menunjukkan apakah ruangan adalah desain bergaya Jepang.

Nilai yang didukung adalah:

  • WESTERN
  • JAPANESE
  • JAPANESE_WESTERN
amenityFeature.LicenseNum Required string

Nomor izin usaha yang akan ditampilkan di properti di beberapa wilayah di dunia. Hal ini bisa diulang dan jika ada beberapa lisensi yang ada maka disarankan untuk menambahkan pemilik atau otoritas lisensi. Contoh, "Paris: 123456ABC"

Properti

Berikut adalah properti amenityFeature:

Properti Wajib? Jenis Deskripsi
amenityFeature Optional LocationFeatureSpecification

Fasilitas yang disediakan di hotel atau kamar. Dapat ditentukan menggunakan properti amenityFeature . Fasilitas seharusnya tersedia untuk semua tamu di hotel, terlepas dari paket tarif yang dipilih. amenityFeature ditentukan menggunakan atribut Nilai properti LocationFeatureSpecification.

Fasilitas dapat ditentukan di Hotel atau HotelRoom.

containsPlace Optional LocationFeatureSpecification

Fasilitas yang diberikan di hotel atau kamar untuk semua tamu hotel. Ini dapat ditentukan menggunakan amenityFeature . Fasilitas seharusnya tersedia untuk semua tamu di kamar hotel apa pun tarif yang dipilih rencana Anda sendiri.

Hotel.containsPlace.amenityFeature adalah fasilitasnya yang disediakan di hotel.

HotelRoom.containsPlace.amenityFeature adalah fasilitasnya yang disediakan di dalam ruangan.

Contoh

Fasilitas di hotel dan kamar

Berikut adalah contoh hotel dengan kolam renang yang buka dari pukul 10.00 hingga 22.00 dan tidak menyediakan gym di properti. Kamar hotel bebas rokok dan memiliki minibar.

{
  "@context": "https://schema.org",
  "@type": "Hotel",
  "name": "ACME Hotel",
  "address": { ... },
  "amenityFeature": [
    {
      "@type": "LocationFeatureSpecification",
      "name": "HotTub",
      "hoursAvailable": {
        "@type": "OpeningHoursSpecification",
        "opens": "10:00:00",
        "closes": "22:00:00"
      }
    },
    {
      "@type": "LocationFeatureSpecification",
      "name": "GymFitnessEquipment",
      "value": false
    }
  ],
  "containsPlace": {
    "@type": "HotelRoom",
    "amenityFeature": [
      {
        "@type": "LocationFeatureSpecification",
        "name": "Minibar",
        "value": true
      },
      {
        "@type": "LocationFeatureSpecification",
        "name": "Smoking",
        "value": false
      }
    ],
    "offers": {
      "@type": ["Offer", "LodgingReservation"],
      "identifier": "rate-plan-id-of-member-rate",
      "checkinTime": "2023-03-10 15:00:00",
      "checkoutTime": "2023-03-16 10:00:00",
      "priceSpecification": {
        "@type": "CompoundPriceSpecification",
        "price": 1222.74,
        "priceCurrency": "USD"
      }
    }
  }
}