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.

Poin Penting: Penting untuk memastikan bahwa Anda telah memperbarui data terstruktur di situs web Anda yang sesuai dengan nilai yang ditampilkan kepada pengguna di UI untuk memberikan informasi yang kredibel dan juga sesuai dengan Harga Google Kebijakan Akurasi.

Catatan: Untuk pertanyaan umum tentang penyalinan dan pengindeksan, lihat Google Penelusuran FAQ crawling dan pengindeksan.

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:

• name dan address properti

• makesOffer properti

• Hotel priceSpecification properti

• hasMerchantReturnPolicy properti

• eligibleCustomerType properti

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

Poin Penting: Sebaiknya Anda menentukan tarif kamar jika memungkinkan.

Data terstruktur HotelRoom memiliki properti berikut:

• offers properti

• Properti bed dan occupancy

• Properti HotelRoom priceSpecification

• includesObject properti

• availability properti

• amenityFeature properti

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"]
    ...
  }
}

Poin Penting: jenis PostalAddress seperti addressCountry, postalCode, streetAddress dan kolom lainnya wajib diisi jika Anda memilih untuk menentukan address.

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": { ... }
  }
}

Poin Penting: Beberapa penawaran tingkat hotel dapat disertakan dalam makesOffer saat ini. Tarif yang ditampilkan oleh Google harus dicantumkan terlebih dahulu. Jumlah harga yang ditentukan mencakup semua pajak dan biaya yang berlaku.

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.

Poin Penting: Nilai @type untuk semua penawaran harus berupa array yang berisi keduanya Offer dan LodgingReservation.

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.

Poin Penting: Properti potentialAction digunakan saat pengguna harus membayar jumlah terutang atau biaya lain di hotel pada saat check in.

  {
    ...
    "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.

Poin Penting: Anda harus menentukan potentialAction untuk kedua pembayaran sekaligus pemesanan dan di hotel secara terpisah.

{
  "@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.

Poin Penting: Properti name dan eligibleCustomerType harus ditentukan di properti Offer.

{
  "@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.

Poin Penting: Waktu check-in dan check-out LodgingReservation harus ditentukan di properti @type tambahan di semua penawaran.

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.

Poin Penting: Sebaiknya Anda menyertakan anotasi untuk tarif tingkat kamar jika memungkinkan.

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"
        }
      ]
    }
  }
}

Poin Penting:Saat kamar hotel ditentukan, partner harus memberikan anotasi tarif tersebut di kamar, bukan di hotel.

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"
        }
      }
    ]
  }
}

Poin Penting: Saat kamar hotel ditentukan, Anda harus memberi anotasi pada tarif kamar dan bukan di hotel.

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": {...}
  }
}

Poin Penting: Offers harus ditentukan untuk itinerari yang terjual habis.

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"
      }
    }
  }
}