Otel Listesi

Otel listesi, verilerini aktarmak istediğiniz otelleri içeren bir XML dosyasıdır. XML dosyasında konaklama ücreti belirtilmez. Fiyat verileri API aracılığıyla iletilir.

Etkileşim şeması

  1. Bir İş Ortağı, XML formatında bir otel listesi oluşturur ve bunu sitesine yerleştirir.
  2. İş Ortağı bir bağlantı isteği doldurur ve otellerin listesini içeren XML dosyasına bir bağlantıyı belirtir.
  3. İş ortağının bağlantı aşamasında, XML dosyasında listelenen oteller Yandex Rehber'deki tesislere bağlanır. Bağlama işlemi iki hafta kadar sürer. İşlem tamamlandığında, iş ortağı rehberdeki tesislere başarıyla bağlanan otellerin bir listesini alabilir
  4. Robot, HTTP GET sorgusunu kullanarak günde bir kez iş ortağının otel listesini indirir.
  5. İş ortağı otel verilerini API aracılığıyla iletir.

XML dosyası gereksinimleri

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

  • Tek bir dosyanın maksimum boyutu 100 MB’ı geçmemelidir. Dosya daha ağırsa, birkaç dosyaya bölün.

  • Dosya arama robotları için erişilebilir olmalıdır: dosyanın bağlantısı indekslemeye kapalı olmamalı, sunucunun HTTP durumu 200 OK kodunu vermelidir.

    Dosyanın bağlantısının kullanılabilirliğini ve sunucu yanıtını Yandex Webmaster'de kontrol edebilirsiniz:

XML dosyası nasıl oluşturulur

Dosya örneği


  <?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>
      <!-- The value of <id> must be unique to your site for all time. Do NOT reuse IDs. -->
      <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> <!-- You can use whatever property type categories you wish -->
    </listing>
    ...
  </listings>

Listings öğesinin öznitelikleri

Listings öğesi aşağıdaki zorunlu öznitelikleri içerir:

Öznitelik

Açıklama

xmlns:xsi

http://www.w3.org/2001/XMLSchema-instance değerini ayarlayın.

xsi:noNamespaceSchemaLocation

http://www.gstatic.com/localfeed/local_feed.xsd değerini ayarlayın.

Alan açıklaması

Öğe

Tipi

Açıklama

Listings içindeki öğeler

language*

string

Veri iletimi yaptığınız dil. ISO 3166-1 formatında iki basamaklı bir kod belirtin, örneğin Türkçe tr.

listing*

listing

Otel hakkında bilgi.

Listing içindeki öğeler

id*

string

Oteliniz için benzersiz tanımlayıcı. Bu tanımlayıcıyı sadece bu otel için kullanın. Farklı bir XML dosyasında tanımlanmış olsalar bile, bunu diğer oteller için çoğaltmayın.

name*

string

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

address*

Object or string

Otelin fiziksel adresi. Bu öğe, değerinin, simple olarak ayarlanması gereken tek bir format özniteliğini kabul ediyor.

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

  • addr1 – otelin ana adresi;

  • addr2 – gerekli ise ek adresi;

  • addr3 – gerekli ise ikinci bir ek adres;

  • 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*

string

Otelin bulunduğu ülke. İki basamaklı ISO 3166 ülke kodunu girin. Örneğin, Türkiye – TR, Rusya – RU.

latitude*

float

Otelin bulunduğu coğrafi enlem. Örneğin, <latitude>41.006592</latitude>.

longitude*

float

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

Koordinatlar, Yandex Haritalar gibi elektronik coğrafi haritalarda bulunabilir.

phone

string

Otelin iletişim telefon numaraları. Type özniteliği ile tanımlayarak bir veya daha fazlasını belirtebilirsiniz.

Type özniteliği aşağıdaki değerlere sahip olabilir:

  • main – ana telefon numarası;

  • mobile – cep telefonu numarası;

  • tdd – işitme engelliler için telekomünikasyon cihazının (TDD) telefon numarası;

  • tollfree – ücretsiz telefon numarası.

Örneğin:

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

category

string

Tesis türü, örneğin hotel. Tesisinizi tanımlamak için “iş otelleri”, “tatil köyleri”, “moteller”, “villalar” vb. gibi herhangi bir alt kategori kullanabilirsiniz.

content

string

Otel hakkında ek bilgi: açıklama, konaklama koşulları, puanlama.

* – zorunlu bileşenler yıldız işareti ile işaretlenmiştir.

Önceki
Oteller
Sonraki
Fiyat alma API'sı