XML dosyası aracılığıyla verilerin güncellenmesi

Ağınızda 30'dan fazla şube varsa Rehberdeki verileri XML dosyası yardımıyla güncelleyebilirsiniz.

Dosyanın hazırlanması

  1. Dosyayı XML formatında hazırlayın.

  2. Dosyayı güncellenen bağlantıdan sitenize yükleyin.

    Veriler HTTP veya HTTPS protokolüne göre erişilebilir olmalıdır.

Dosya hazırlama ve düzenleme bir kez yapılır. Tüm güncellemeler otomatik olarak gerçekleşir.

Uyarı. Ağ bilgisi aktarılırken:
  1. Aktif olan tüm şubelerle ilgili veriler sunmak,
  2. Verileri güncel tutmak zorunludur.

Dosyanın arayüzde yüklenmesi

  1. Ağ sayfasında Şubeler bölümüne geçin. Şube yönetimi bloğunda Dosya sekmesini seçin.

  2. Hazırlanan dosya için bağlantı belirtin, “xml” türünü seçin ve Denetle butonuna tıklayın. Dosya denetimi birkaç saat sürebilir.

  3. Dosya denetimi başarılı olursa Denetim sonuçları butonuna tıklayın. Açılan pencerede şubelerdeki değişiklikleri kontrol edin. Haritada değişiklikler içeren en fazla 50 şube gösterilebilir. Her şey doğru. Veritabanına yüklemeyi başlat butonuna tıklayın. Dosyadaki veriler moderasyondan geçecek ve rehber veritabanına yüklenecektir. Büyük hacimli verilerin yüklenmesi birkaç gün sürebilir.

    Dosya denetimi sonucunda hatalar tespit edilirse, bu konuda bir mesaj göreceksiniz. Hataları düzeltin ve dosyayı tekrar denetlemeye gönderin.

Dosyadan Rehber veritabanına yüklenen şubelerdeki değişiklikleri görmek için Yükleme geçmişi butonuna tıklayın. Buton, ilk yüklemeden 24 saat sonra erişilebilir olacaktır.

Yandex Haritalar'da yeni şubeler ve diğer değişiklikler birkaç gün sonra erişebilir olacaktır.

Şube verilerinin dosya aracılığıyla yüklenmesi ile ilgili sorularınız kaldıysa bize ulaşın.

XML dosyası formatı

Aktarılan veriler XML formatı özellikleri ile uyumlu olmalıdır.

  1. Genel Koşullar
  2. Adres
  3. Kategori
  4. Ek parametreler
  5. XML dosyası örneği
  6. Öğe açıklaması

Genel Koşullar

  1. XML dosyası UTF-8 kodlamasında oluşturulmalıdır.
  2. Standart XML Başlığı ilk satırdan boş karakterle başlamalıdır.

    Örneğin:
    <?xml version="1.0" encoding="UTF-8"?>
  3. Kök öğe şu şekilde olmalıdır:
    <companies></companies>
  4. Şubeler, kök öğe içine yerleştirilmiş company öğeleri yardımıyla tanımlanır. company öğe sayısı isteğe bağlı olabilir.
  5. Her şube özelliği ayrı bir öğeye sarılmalıdır. Daha fazla bilgi için bkz Öğe açıklaması.

    Bu örnekte şu site seçildi:

    <url>http://www.anchor.com</url>
  6. Ana ve ek öğeler, örnek ve öğe açıklaması içeren tablo üzerinde gösterildiği gibi yerleştirilmelidir.
  7. Aşağıdakiler her şube için mutlaka belirtilmelidir:
    • eşsiz ve değiştirilemeyen kimlik tanımlayıcısı: company-id öğesi,
    • ad: name öğesi,
    • binaya kadar kesinliğe sahip tam konum adresi,
    • çalışma saatleri: working-time öğesi,
    • site: url öğesi,
    • XML dosyası güncellenme tarihi: actualization-date öğesi,
    • koordinatlar (şubeler için adres kesinliği olmaksızın): coordinates öğesi.

    Kullanıcıların kurumunuzla ilgili bilgileri netleştirebilmesi için telefon numaranızı phone öğesi içinde belirtin.

    Not. İndeks aktarımı gerekmez.
  8. Bir özellik için birkaç değer varsa (örneğin telefonlar), aynı adlara sahip birkaç öğe aktarılmalıdır.
  9. Dosyada sadece Öğe açıklaması alt bölümünde belirtilen öğeler aktarılabilir.
  10. Bazı öğeler çok dilli olabilir. name, name-other, address, country, address-add, working-time öğeleri bunlara dahildir. lang özelliği aşağıdaki değerleri alabilir:

    • tr: Türkçe
    • en: İngilizce
  11. Kurum ağı ile ilgili bilgilerin eksiksiz olması amacıyla her bir şube için (ek öğeler dahil) maksimum öğe kümesi aktarın.
  12. Her şube ayrı bir kartta sunulmalıdır; her şube için farklı bir öğe kümesi içeren kendi kimlik tanımlayıcısı belirtilmelidir.
  13. Verilerde HTML öğeleri olmamalıdır. XML standardında, metin alanlarında 0 ile 31 değer aralığında ASCII kodlarına sahip karakterler geçersizdir. 9, 10, 13 istisnadır: sekme, satır sonu, satır başı. Ayrıca bu standart, katı bir şekilde metindeki bazı karakterleri değiştirmeyi gerektirir: & --> &.

Adres

Tam adresi address, ülkeyi country, alışveriş merkezi adı, iş merkezi, ofis numarası ve katını address-add öğesinde tek satırla belirtin.

<address lang="tr">Barbaros Blv., No:108, Beşiktaş, İstanbul</address>
<country lang="tr">Türkiye</country>
<address-add lang="tr">Papatya AVM, 2. kat, ofis 123</address-add>

Kategori

Kategori listesini almak için partner@sprav.yandex.ru adresine yazın.

Ek parametreler

XML dosyası aracılığıyla ağınız veya şubeniz için ek parametreleri aktarabilirsiniz (örneğin, alışveriş merkezinizin yakınında park yeri olup olmadığını veya ATM'lerinizden hangi para birimlerinde para çekilebileceğini belirtebilirsiniz).

Bu bilgi ek öğeler yardımıyla iletilir. Kategoriniz için olası öğelerin listesini içeren bir XML dosyası almak için:

  1. Ağ sayfasında Şubeler sekmesine geçin.
  2. Şube yönetimi bloğunda Dosya sekmesini seçin.
  3. İşaretleri yükle butonunu tıklayın.

Ek parametrelere sahip dosyanın yüklenmesi ile ilgili sorularınız varsa lütfen partner@sprav.yandex.ru adresine yazın.

XML dosyası örneği

<?xml version="1.0" encoding="UTF-8"?> 
<companies>
    <company>
        <company-id>770704034</company-id>
        <name lang="tr">Anchor</name>
        <shortname lang="tr">Anchor</shortname>
        <address lang="tr">Barbaros Blv., No:108, Beşiktaş, İstanbul</address>
        <country lang="tr">Türkiye</country>
        <address-add lang="tr">Papatya İş Merkezi, Kat 2, Ofis No.: 203</address-add>
        <phone>
            <number>+90 (212) 501-23-45</number>
            <ext>555</ext>
            <info>Sekreter</info>
            <type>phone</type>
        </phone>
        <phone>
            <type>phone</type>
            <number>+90 (212) 511-23-45</number>
            <info />
        </phone>
        <email>info@anchor.com</email>
        <url>http://www.anchor.com</url>
        <add-url>http://www.fb.com/anchor</add-url>
        <info-page>http://www.anchor.com/branch1/photos</info-page>
        <working-time lang="tr">her gün 10:00-21:00</working-time>
        <rubric-id>184106414</rubric-id>
        <rubric-id>184106394</rubric-id>
        <inn>123456789123</inn> 
        <ogrn>9876543219876</ogrn>
        <actualization-date>1511724300</actualization-date>
        <photos gallery-url="http://test.com/anchor/gallery">
            <photo url="http://test.com/anchor/11_b.jpg" alt="Ресторан отеля" type="interior" />
            <photo url="http://test.com/anchor/19_b.jpg" type="exterior" />
            <photo url="http://test.com/anchor/25_b.jpg" />
            <photo url="http://test.com/anchor/26_b.jpg" />
            <photo url="http://test.com/anchor/17_b.jpg" />
            <photo url="http://test.com/anchor/drink1.jpg" alt="Коктейль в баре отеля" type="food" />
        </photos>
        <feature-boolean name="internet" value="1" />
        <feature-enum-single name="star" value="five" />
        <feature-numeric-single name="room_number" value="15" />
        <feature-enum-multiple name="hotel_type" value="art_hotel" />
        <feature-text-single value="anchor_free_wi-fi" name="ssid" />
    </company>
</companies>

Öğe açıklaması

İsim Açıklama Örnek
company-id Şubenin eşsiz değiştirilemeyen kimlik tanımlayıcısı (ağ sahibi tarafından verilir). İstediğiniz rakam ve Latin harflerini içerebilir.
<company-id>770704034</company-id> 
name Şube adı. Tırnak işareti olmadan, büyük/küçük harf dikkate alınarak belirtilir. Çok dilli öğe.
<name lang="tr">Çapa</name>
shortname Haritalarda etiketlerin yanında, 25 karaktere kadar kısa şube adı. Tırnak işareti olmadan, büyük/küçük harf dikkate alınarak belirtilir. Çok dilli öğe.
<shortname lang="tr">Çapa</shortname>
name-other Şubenin alternatif adı (birden fazla adı varsa her biri ayrı bir öğe içinde belirtilir). Tırnak işareti olmadan, büyük/küçük harf dikkate alınarak belirtilir. Çok dilli öğe.
<name-other lang="tr">Ivanov Şahıs Şirketi</name-other>
address Şube adresi (tek satırla). Çok dilli öğe.
Not. Öğe sadece sokak adı ve ev numarası içeriyorsa kesinlikle yerleşim yeri belirtilerek locality-name öğesi kullanılmalıdır.
<address lang="tr">Barbaros Bulvarı, No:101</address>
 <locality-name lang="tr">İstanbul</locality-name>
<address lang="tr">Barbaros Bulvarı, No: 101, İstanbul</address>
country Ülke. Kısaltmasız tam olarak belirtilir. Çok dilli öğe.
<country lang="tr">Türkiye</country>
address-add Diğer öğelerle ilintili olmayan bir adrese ek bilgi. Parantez, tırnak işareti olmadan belirtilir. Çok dilli öğe.
<address-add lang="tr">Papatya İş Merkezi, kat 5, ofis 547</address-add>
coordinates Bileşik öğe. Enlem ve boylam koordinatları.
<coordinates>
   <lon>34.427524546763365</lon>
   <lat>53.219950313883814</lat>
</coordinates> 
lon Boylam koordinatı. Tam ve ondalık kısmı ayırmak için nokta kullanılır.
<lon>34.427524546763365</lon> 
lat Enlem koordinatı. Tam ve ondalık kısmı ayırmak için nokta kullanılır.
<lat>53.219950313883814</lat>
phone Bileşik öğe. Telefon numarası (birden fazla numara varsa her biri ayrı bir öğe içinde belirtilir).
<phone>
   <number>+90 (212) 512-23-45</number>
   <ext>555</ext>
   <type>phone</type>
   <info>sekreter</info>
</phone>
number Sabit hat veya cep telefonu numarası. Şu biçimde belirtilir: [ülke kodu] ([şehir kodu]) [telefon numarası].
<number>8 (800) 200-23-45</number>
<number>+7 (3456) 23-45-67</number>
ext Dahili numara (açıklama, sözcük ve ayırıcılar olmadan).
<ext>555</ext>
info Numara hakkında bilgi: örneğin, yönetmen, sekreter.
Not. Bu öğede telefon türü hakkında bilgi olmamalıdır.
<info>секретарь</info>
type Telefon türü. Üç değerden birini alır:
  • phone: telefon;
  • fax: faks;
  • phone-fax: telefon-faks.
<type>phone</type>
E-posta E-posta adresi (adresler birden fazla ise her biri ayrı bir öğe içinde belirtilir).
<email>info@anchor.com</email>
url Ağın ana sitesi. http:// veya https://dahil olmak üzere tamamen küçük harfle belirtilir.
<url>http://www.anchor.com</url>
add-url Ek ağ sitesi (örneğin, sosyal medya bağlantıları).
Not. Ağ sitesinde şube hakkında bilgi içeren sayfanın adresi info-page öğesi içinde gösterilir.
<add-url>http://www.fb.com/anchor-hotel</add-url>
info-page Ağ sitesinde şube hakkında bilgi içeren sayfanın adresi. http:// veya https://dahil olmak üzere tamamen küçük harfle belirtilir.
Not. Adres ağ sitesinin alan adının içermelidir.
<info-page>http://www.anchor.com/branch1/photos</info-page>
working-time Çalışma saatleri. Hafta sonu, çalışılmayan günler belirtilmez. Çok dilli öğe.
<working-time lang="tr">her gün 10:00-21:00</working-time>
<working-time lang="ru">Pt-Cu 9:00-19: 00, Ct-Pa 10: 00-18: 00
</working-time>

Öğle yemeği:

<working-time lang="tr">Pt-Cu: 10:00-19:00, öğle yemeği 13: 00-14: 00; 
Ct: 10:30-16:00, öğle yemeği 13: 00-13: 30</working-time>

Öğle arası:

<working-time lang="tr>Pt-Cu: 08: 00-17:00, 
öğle arası: 12:00-13:00</working-time>

24 saat:

<working-time lang="tr">24 saat</working-time>
rubric-id Bu şubenin ait olduğu kategori kimlik tanımlayıcısı (kategori birden fazla ise her biri ayrı bir öğe içinde belirtilir).
Not. Her şubenin en fazla üç kategorisi olabilir, fakat en az bir tanesi ağ kategorisiyle aynı olmalıdır.
<rubric-id>184106414</rubric-id>
<rubric-id>184106394</rubric-id>
inn Kurum vergi kimlik no
<inn>123456789123</inn>
ogrn Kurum ticari sicil no
<ogrn>9876543219876</ogrn>
actualization-date

Güncellenme Tarihi. Verilerin son güncellenme saatine karşılık gelir. Bir önceki denetlemede alınan bilgilerin indirilmemesi için kullanılır.

İçerik şu biçimde gösterilebilir:

  • GG.AA.YYYY;
  • UNIX-time. 00:00:00.000 01.01.1970 tarihinden itibaren milisaniye cinsinden belirtilir.
<actualization-date>13.11.2017</actualization-date>
<actualization-date>1511724300000</actualization-date>
photos

Ağ sitesinde tüm fotoğrafları içeren galeri veya sayfaya yönlendiren bağlantı. Birden fazla fotoğraf varsa her biri ayrı bir photo öğesi içinde belirtilir.

photo aşağıdaki öğeleri içerebilir:

  • alt - serbest biçimde fotoğraf metin açıklaması;
  • type - fotoğraf türü:
    • exterior - dış;
    • interior - iç;
    • food - yemekler, içecekler.
    • tag - fotoğraf etiketi:
      • GOODS - eşya;
      • ENTER - ENTER;
      • LOGO - LOGO.
<photos gallery-url="http://test.com/anchor/gallery">
<photo url="http://test.com/anchor/11_b.jpg" alt="Ресторан отеля" type="interior" />
<tag>ENTER</tag>
</photos>
<photos gallery-url="http://test.com/anchor/gallery">
<photo url="http://test.com/anchor/drink1.jpg" alt="Коктейль в баре отеля" type="food" />
</photos>
Ek öğeler
feature-boolean Şube özelliği. 1 ("Evet") veya 0 ("hayır") olmak üzere iki değer alabilir. Özellikler birden fazla ise her biri ayrı bir öğe içinde belirtilir.

Şubede Wi-Fi ağı var:

<feature-boolean name="wi_fi"   value="1"/> 
feature-enum-single Şube özelliği.

Tiyatro türü - absürd tiyatro:

<feature-enum-single name="theater_type" value="absurdist_theatre"/>
feature-enum-multiple Şube özelliği. Özellikler birden fazla ise her biri ayrı bir öğe içinde belirtilir.

Tur türü - otobüs turu:

<feature-enum-multiple name="tour_type" value="bus_tour"/>
feature-numeric-single Sayısal değerler içeren şube özelliği.

Şubede üç televizyon var:

<feature-numeric-single name="number_of_screen"  value="3"/> 
feature-numeric-multiple Sayısal değerler içeren şube özelliği. Özellikler birden fazla ise her biri ayrı bir öğe içinde belirtilir.

Lisans numarası:

<feature-numeric-multiple name="license_number" value= "004555"/>
feature-in-units-single Değeri ölçü birimlerinde belirlenen şube özelliği.

Minimum teslimat tutarı 15 TL'dir:

<feature-in-units-single name="minimum_order"  
unit="money"  unit-value="ytl"  value="15"/> 
feature-in-units-multiple Değeri ölçü birimlerinde belirlenen şube özelliği. Özellikler birden fazla ise her biri ayrı bir öğe içinde belirtilir.

Otelde 200 tek kişilik oda vardır:

<feature-in-units-multiple name="ats_by_type" 
 unit="apartment_type"  unit-value="single" value="200"/>
feature-range-single Sayı aralık değeri içeren şube özelliği.

Şubede 15-20 kişilik bir ziyafet salonu var:

<feature-range-single name="number_seats_banquet_hall" 
from="15"  to="20"/> 
feature-range-multiple Sayı aralık değeri içeren şube özelliği. Özellikler birden fazla ise her biri ayrı bir öğe içinde belirtilir.

Bilet fiyatları 40-60 TL arasındadır:

<feature-range-multiple name="tickets"  
unit="money" unit-value="ytl" from="40" to="60"/>
feature-in-units-single Ölçü birimlerinde aralık değeri içeren şube özelliği.

Bir dakikalık maliyet 3-6 TL'dir:

<feature-range-in-units-single name="price_1_min"  
unit="money" unit-value="ytl" from="3" to="6"/> 
feature-in-units-multiple Ölçü birimlerinde aralık değeri içeren şube özelliği. Özellikler birden fazla ise her biri ayrı bir öğe içinde belirtilir.

Stil içeren kadın saç kesim fiyatı 100-200 TL arasındadır.

<feature-range-in-units-multiple name="women_haircut" 
unit="money" unit-value="ytl" from="100" to="200"/> 
feature-text-single Metin biçiminde şube özelliği.

ANCOR Otel'deki ücretsiz Wi-Fi kullanıcı adı: “ssid”

<feature-text-single value="Yakor_free_wi-fi" name="ssid"/>