Otel listesi

Otel listesi, veri göndermek istediğiniz otelleri belirten bir XML dosyasıdır. XML dosyası konaklama maliyetlerini belirtmez. Fiyat bilgileri API aracılığıyla gönderilir.

Entegrasyon şeması

  1. Ortak, otelleri listeleyen bir XML dosyası oluşturur ve bunu kendi web sitesinde barındırır.
  2. Ortak daha sonra bu XML dosyasına bir bağlantı sağlayarak bir bağlantı isteği gönderir.
  3. Bir ortak bağlandığında, XML dosyalarında listelenen oteller Yandex İşletme Dizini’ndeki ilgili girişlere bağlanır. Bağlantı süreci iki haftaya kadar sürebilir. Tamamlandığında, ortak Yandex İşletme Dizini’ndeki girişlere başarıyla bağlanan otellerin bir listesini alabilir.
  4. Robot, HTTP GET isteği kullanarak ortağın otel listesini günde bir kez indirir.
  5. Ortak, otel verilerini API aracılığıyla aktarır.

XML dosyaları için gereksinimler

  • Metin dosyası .xml formatında olmalıdır. Örneğin, hotel-list.xml.

  • Tek bir dosya 100 MB’ı aşamaz. Dosyanız daha büyükse, birden fazla dosyaya bölün.

  • Dosya, arama robotları tarafından taranabilir olmalıdır. Dosyanın bağlantısının endekslenmeye engellenmediğinden ve sunucunun bir HTTP 200 OK durumu döndürdüğünden emin olun.

    Dosyanın bağlantı kullanılabilirliğini ve sunucunun yanıtını Yandex Webmaster’da kontrol edin.

Bir XML dosyası nasıl oluşturulur

Örnek dosya


  <?xml version="1.0" encoding="UTF-8"?>
  <listings xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
      xsi:noNamespaceSchemaLocation="http://www.gstatic.com/localfeed/local_feed.xsd">
    <language>tr</language>
    <listing>
      <!-- <id> değeriniz her zaman sitenize özgü olmalıdır. Kimlikleri yeniden kullanmayın. -->
      <id>Hotel123</id>
      <name>Hotel Houston</name>
      <address format="simple">
        <component name="addr1">Cumhuriyet Mah., 703</component>
        <component name="addr2">Sok., No:1/101</component>
        <component name="city">Antalya</component>
        <component name="region">Antalya</component>
        <component name="postal_code">07010</component>
      </address>
      <country>TR</country>
      <latitude>36.900000</latitude>
      <longitude>30.683330</longitude>
      <category>hotel</category> <!-- Herhangi bir mülk türü kategorisi kullanabilirsiniz -->
    </listing>
    ...
  </listings>

“listings” öğesinin özellikleri

listings öğesi aşağıdaki gerekli özellikleri içerir:

Nitelik

Açıklama

xmlns:xsi

Belirtin: http://www.w3.org/2001/XMLSchema-instance.

xsi:noNamespaceSchemaLocation

Belirtin: http://www.gstatic.com/localfeed/local_feed.xsd.

Alan açıklamaları

Bileşen

Tip

Açıklama

listings içindeki öğeler

language*

dize

Gönderilen verilerin dili. ISO 3166-1 formatında iki karakterli kodu belirtin. Örneğin, Türkçe için tr.

listeleme*

listeleme

Otel bilgileri.

listing içindeki öğeler

id*

dize

Otelinizin benzersiz ID’si. Bu ID’yi yalnızca bu belirli otel için kullanın. Ayrı bir XML dosyasında olsalar bile, diğer oteller için yeniden kullanmayın.

ad*

dize

Otelin adı. Örneğin, <name>Citrus Park Hotel</name>.

adres*

Nesne veya dize

Otelin fiziksel adresi. Öğe, bir özellik alır, format, ve bu özellik basit olarak ayarlanmalıdır.

Otelin adresini, şehrini, ilini, bölgesini ve posta kodunu belirtin. Aşağıdaki adres bölümlerini tanımlamak için <component> alt öğelerini kullanın:

  • addr1: Birincil otel adresi.

  • addr2: İsteğe bağlı ikincil adres 1.

  • addr3: İsteğe bağlı ikincil adres 2.

  • city: Otelin bulunduğu şehrin adı.

  • province: Otelin bulunduğu ilin adı.

  • region: Otelin bulunduğu bölgenin adı.

  • postal_code: Otelin posta kodu.

Örneğin:


<address format="simple">
  <component name="addr1">Cumhuriyet Mah., 703</component>
  <component name="addr2">Sok., No:1/101</component>
  <component name="city">Antalya</component>
  <component name="province">Antalya</component>
  <component name="postal_code">07010</component>
</address>

country*

dize

Otelin bulunduğu ülke. İki karakterli ISO 3166 ülke kodunu belirtin. Örneğin, Türkiye TR, ve Rusya RU.

latitude*

kayan nokta

Otelin coğrafi enlemi. Örneğin, <latitude>41.006592</latitude>.

longitude*

kayan nokta

Otelin coğrafi boylamı. Örneğin, <longitude>28.974537</longitude>.

Koordinatları Yandex Haritalar gibi harita uygulamalarında bulabilirsiniz.

phone

dize

Otelin telefon numaraları. Bir veya daha fazla belirtebilir, türlerini type özelliği ile tanımlayabilirsiniz.

type özelliğinin olası değerleri:

  • main: Ana telefon numarası.

  • mobile: Mobil telefon numarası.

  • tdd: TDD (işitme engelliler için telekomünikasyon cihazı) telefon numarası.

  • tollfree: Ücretsiz telefon numarası.

Örneğin:

<!-- Türkiye (ülke kodu +90) -->
<phone type="main">90-242-1234567</phone>

kategori

dize

Mülk türü. Örneğin, otel. Mülkünüzü tanımlamak için “iş otelleri”, “tatil köyleri”, “moteller”, “villalar” gibi herhangi bir iç kategori kullanabilirsiniz.

content

dize

Daha fazla otel detayı: açıklama, olanaklar, derecelendirme.

* – Yıldız işaretiyle işaretlenmiş öğeler gereklidir.