Bu sayfada, özelliklerin ve alt öğelerin açıklamaları, değerleri ve koşulları ele alınmaktadır. Bu değerler yalnızca kiralık yer özellikli tesisler için geçerlidir.
Genel XML yapısı, otel listeleme feed'leriyle benzer bir biçime sahiptir. Otel listesi XML referansı başlıklı makaleyi inceleyin.
Aşağıdaki zorunlu öğelerin eklenmemesi, listelemeyi otomatik olarak devre dışı bırakır:
- Zorunlu XML alt öğeleri:
id,name,latitude,longitude,address. - Zorunlu özellikler:
capacityvewebsite. Listeleme feed'inizdeki Kiralık yerler için doğrudan bağlantılar bölümüne bakın. Bu sayede kullanıcılar tesisin web sitesini ziyaret edebilir.
Gerekli XML alt öğeleriyle ilgili ayrıntılar için XML alt öğeleri bölümüne bakın.
Kiralık yerler hakkında daha fazla bilgi için Kiralık yerlere özgü özellikler başlıklı makaleyi inceleyin.
Son olarak, Google diğer kaynaklardan bir özelliğin değerinin, kiralık yer girişi için feed'de belirtilenden farklı olduğunu belirlediğinde Google, girişin değerini gösterir. Örneğin, Google bir girişin fotoğraflarından mutfak olduğunu belirlerse ancak kitchen özelliği yoksa veya No olarak ayarlanmışsa Google, girişi mutfaklı olarak değerlendirir. Bu özelliklere "çıkarılan özellikler" adı verilir ve yalnızca çıkarım doğruluğuyla ilgili büyük ölçüde kesinlik sağlanması durumunda gösterilirler.
<review>
Kullanıcı yorumu veya editoryal yorum içerir. Bir giriş için yapılan tüm yorumları <listing> öğenize dahil etmeniz gerekmez. Bu öğenin amacı, bu girişin özelliklerini veya kalitesini gösteren seçili yorumları eklemenizdir.
<review> öğesi, otel listesi feed'i XML hiyerarşisinde şu konumda görünür:
+ <listings>
+ <language>
+ <listing>
+ <content>
+ <review>
Söz dizimi
<review> öğesi şu söz dizimini kullanır:
<?xml version="1.0" encoding="UTF-8"?>
<listings ... >
<listing>
<content>
...
<!-- Specify <review>'s child elements in the order shown below. -->
<review type="editorial">
<link>review_link</link>
<title>review_title</title> <!-- Title is for reviews of type "editorial" only -->
<author>review_author</author>
<rating>review_rating</rating>
<body>review_text</body>
<date>review_date</date>
<servicedate>review_servicedate</servicedate>
</review>
<review type="user">
<link>review_link</link>
<author>review_author</author>
<date month="MM" day="DD" year="YYYY"/> <!-- Date is for reviews of type "user" only -->
<servicedate month="MM" day="DD" year="YYYY"/> <!-- Service Date is for reviews of type "user" only -->
<rating>review_rating</rating>
<body>review_text</body>
</review>
</content>
</listing>
</listings>
Özellikler
<review> öğesi şu özelliklere sahiptir:
| Özellik | Zorunlu mu? | Açıklama |
|---|---|---|
| type | Required | Yorum türü. Aşağıdaki değerlerden birine ayarlayın:
|
Alt öğeler
<review> öğesi aşağıdaki alt öğelere sahiptir:
| Alt öğe | Zorunlu mu? | Tür | Açıklama |
|---|---|---|---|
| <link> | Optional | string | Yorumun bağlantısı Bu öğeye "http://" veya "https://" ekleyin. |
| <title> | Optional | string | (Yalnızca editoryal yorumlar) Yorumun başlığıdır. |
| <author> | Optional | string | Yorumun yazarıdır. Örneğin, "Selin Toprak". Bu aynı zamanda, yorumun isimsiz olması durumunda gösterildiği bir web sitesinin veya yayının adı da olabilir. |
| <rating> | Optional | string | Yorumun puanını temsil eden, 0-10 (bu sayılar dahil) arasındaki bir kayan noktalı sayıdır. Örneğin, "8.9". |
| <body> | Optional | string | Yorumun metni. Bu öğe HTML içermemelidir. |
| <date month="MM" day="DD" year="YYYY"/> | Optional | Object | (Yalnızca kullanıcı yorumları) Yorumun tarihidir. Bu öğenin aşağıdaki özellikleriyle belirtilir:
Örneğin, 7 Haziran 2023 şu şekilde yazılır: <date month="6" day="7" year="2023"/> |
| <servicedate month="MM" day="DD" year="YYYY"/> | Optional | Object | (Yalnızca kullanıcı yorumları) Yorumcunun incelenen girişi ziyaret ettiği tarihtir. Biçim <date> ile aynıdır.
Örneğin, 7 Haziran 2023 şu şekilde yazılır: <servicedate month="6" day="7" year="2023"/> <servicedate> için en azından ayın ve yılın doldurulmadığı yorumlar gösterilmeyebilir. Gün gerekli değildir. |
Örnek
Aşağıdaki örnekte, editoryal yorum ve kullanıcı yorumu içeren bir girişin yer aldığı kısmi bir otel listesi gösterilmektedir:
<?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>en</language>
<listing>
<id>123456</id>
<name>My Apartment</name>
<address format="simple">
<component name="addr1">1 Sandstone Building</component>
<component name="city">Los Angeles</component>
<component name="postal_code">90210</component>
<component name="province">CA</component>
</address>
<country>US</country>
<latitude>40.730610</latitude>
<longitude>-73.935242</longitude>
<phone type="main">12345678</phone>
<category>hotel</category> <!-- You can use whatever property type categories you wish -->
<content>
<text type="description">
<link>https://examplelisting.com/listings/12345</link>
<title>3 bedrooms with ocean views</title>
<body>Stay in this newly renovated 3BR house with ocean views.</body>
<date month="7" day="23" year="2023"/>
</text>
<review type="editorial">
<link>https://example.com/reviews/42</link>
<title>A little piece of heaven</title>
<author>EXAMPLE.COM</author>
<rating>8</rating>
<body>This place is really good.</body>
</review>
<review type="user">
<link>https://exampleperson.org/reviews/82</link>
<author>Susan von Trapp</author>
<rating>6</rating>
<body>Not a bad place, but I prefer to be closer to the beach.</body>
<date day="6" month="7" year="2023"/>
<servicedate day="16" month="6" year="2023"/>
</review>
<attributes>
<website>https://hotel.example.com</website>
<client_attr name="rating">8.2</client_attr>
<client_attr name="num_reviews">14</client_attr>
</attributes>
<image type="photo" url="https://image_url">
<link>https://image_url</link>
<title>Main hotel picture</title>
</image>
</content>
</listing>
...
</listings>
attribute_name yer tutucusunun değerleri
Aşağıdaki tabloda, <client_attr name="attribute_name"> öğesinde attribute_name için geçerli değerlerin bir listesi verilmiştir. Bununla birlikte, varsa ek attribute_name değerlerinizi sağlamanız önerilir.
attribute_name için değerler |
Zorunlu mu? | Açıklama | Geçerli içerik değerleri |
|---|---|---|---|
| capacity | Required | Tesisin kabul edebileceği maksimum konuk sayısıdır. Bu değer, "number_of_bedrooms" değerine eşit veya bu değerden büyük olmalıdır. | Non-negative integer value |
| website | Required | Mülkün web sitesi URL'si. | Free text |
| partner_hygiene_link | Strongly recommended | Girişin hijyen bilgileri hakkında daha fazla bilgi sağlayan harici iş ortağı sitesine giden bağlantıdır. | Free text (the site's URL) |
| number_of_bathrooms | Strongly recommended | Banyo sayısıdır. | Non-negative float value, for example, 1, 1.5, 2 |
| number_of_bedrooms | Strongly recommended | Yatak odası sayısıdır. | Non-negative integer value |
| number_of_beds | Strongly recommended | Tüm odalardaki yatak sayısı. | Non-negative integer value |
| self_checkin_checkout | Recommended | Tesisin kendi kendine check-in ve çıkış işlemlerine izin verip vermediğidir. | Yes/No/Unknown |
| rating | Strongly recommended | Tesisin ortalama puanını temsil eden bir kayan noktalı sayıdır. Bu sayı genellikle 0-5, 0-10 veya 0-100 arasındadır ancak puan sisteminizi temsil eden herhangi bir aralığı kullanabilirsiniz. | Non-negative float value |
| rating_num | Strongly recommended | Tesisin aldığı puan sayısıdır. | Non-negative integer value |
| rating_scale | Strongly recommended | Bir tesis için mümkün olan maksimum puan. Örneğin, 5 puanlık bir ölçekte tesis puanı 3 veya 4 olmalıdır.
Not: Belirtilmediği takdirde varsayılan rating_scale değeri 0-10'dur. |
Non-negative integer value |
| instant_bookable | Strongly recommended | Tesisin, ödeme işlemi ile anında rezerve edilebilir olup olmadığıdır. Bunun alternatifi, onay beklenmesidir. | Yes/No/Unknown |
| description | Strongly recommended | Tesisin benzersiz özelliklerini açıklayan serbest biçimli metin | Free text |
| category | Strongly recommended | Tesisin türü (ör. villa, bungalov, kabin veya daire) | Free text |
| ac | Recommended | Tesisin klimalı olup olmadığını gösterir. | Yes/No/Unknown |
| beach_access | Recommended | Tesisin, yakındaki bir halk plajına erişim imkanının olup olmadığını gösterir. | Yes/No/Unknown |
| check_in_time | Recommended | Tesise giriş için tam saattir. HHMM, HH:MM veya HH:MM:SS biçimi kabul edilir. Örneğin, 14:00 yerine 14:00'ı kullanın. Diğer tüm biçimler ayrıştırılmaz veya gösterilmez. | Time |
| check_out_time | Recommended | Tesisten çıkış için tam saattir. HHMM, HH:MM veya HH:MM:SS biçimi kabul edilir. Örneğin, 11am veya 11:00am yerine 11:00'ı kullanın. Diğer tüm biçimler ayrıştırılmaz veya gösterilmez. | Time |
| child_friendly | Recommended | Tesisin çocuklar için uygun olup olmadığını gösterir. | Yes/No/Unknown |
| crib | Recommended | Tesisin beşik temin edip olmadığını gösterir. | Yes/No/Unknown |
| elevator | Recommended | Tesiste asansör olup olmadığını gösterir. | Yes/No/Unknown |
| gym_fitness_equipment | Recommended | Tesiste spor salonu veya fitness ekipmanı olup olmadığıdır. | Yes/No/Unknown |
| heating | Recommended | Tesiste ısıtma olup olmadığını gösterir. | Yes/No/Unknown |
| hot_tub | Recommended | Tesiste jakuzi olup olmadığını gösterir. | Yes/No/Unknown |
| ironing_board | Recommended | Tesiste ütü masası olup olmadığını gösterir. | Yes/No/Unknown |
| kitchen | Recommended | Tesiste mutfak olup olmadığını gösterir. | Yes/No/Unknown |
| microwave | Recommended | Tesiste mikrodalga fırın olup olmadığını gösterir. | Yes/No/Unknown |
| min_days_advance_purchase | Recommended | Tesis için rezervasyonun varış tarihinden önce yapılabileceği minimum gün sayısıdır. | Non-negative integer value |
| min_night_stay | Recommended | Konukların tesis için rezervasyon yapabileceği minimum gece sayısıdır. | Positive integer (more than zero) |
| max_night_stay | Recommended | Konukların tesis için rezervasyon yapabileceği maksimum gece sayısıdır. | Positive integer (more than zero) |
| outdoor_grill | Recommended | Tesiste ızgara olup olmadığını gösterir. | Yes/No/Unknown |
| oven_stove | Recommended | Tesiste ocak olup olmadığını gösterir. | Yes/No/Unknown |
| parking_type | Recommended | Tesiste bulunan otopark türü. | Free/Paid/None |
| patio | Recommended | Tesiste veranda olup olmadığını gösterir. | Yes/No/Unknown |
| pets_allowed | Recommended | Odaların bazıları veya tamamı, konukların evcil hayvanlarını (rehber hayvan olmayan köpekler veya kediler) getirmesine olanak tanır. | Yes/No/Unknown |
| pool_type | Recommended | Tesisin sahip olduğu havuz (havuz erişimi) türüdür. | Indoors, Outdoors, Indoors/Outdoors, None |
| room_type | Recommended | Odanın türü. Yalnızca ENTIRE_PLACE değeri desteklenir. |
ENTIRE_PLACE
|
| smoking_free_property | Recommended | Tesisin dumansız saha (sigara içilmez) özellikli olup olmadığıdır. | Yes/No/Unknown |
| special_service_level | Recommended | Listelemenin hizmet düzeyinin bir şekilde özel olup olmadığı.
Örneğin, verified, luxury,
premium |
Yes/No/Unknown |
| square_footage | Recommended | Tesisin fitkare cinsinden alanı. | Non-negative float value |
| square_meters | Recommended | Tesisin metrekare cinsinden alanı. | Non-negative float |
| tv | Recommended | Tesiste televizyon olup olmadığını gösterir. | Yes/No/Unknown |
| washer_dryer | Recommended | Tesiste çamaşır yıkama imkanı olup olmadığını gösterir. | Yes/No/Unknown |
| wheelchair_accessible | Recommended | Tesisin tekerlekli sandalye kullanımına uygun olup olmadığını gösterir. | Yes/No/Unknown |
| internet_type | Recommended | Tesis tarafından sağlanan WiFi internet erişimi türü. | Free/Paid/None |
| airport_shuttle | Optional | Tesis sahibinin havaalanına veya başka terminallere ulaşım imkanı sağlayıp sağlamadığıdır. | Yes/No/Unknown |
| balcony | Optional | Tesisin balkonlu olup olmadığını gösterir. | Yes/No/Unknown |
| fire_place | Optional | Tesiste şömine olup olmadığını gösterir. | Yes/No/Unknown |
| free_breakfast | Optional | Tesiste ücretsiz kahvaltı servisi olup olmadığıdır. | Yes/No/Unknown |
| host_description | Optional | Kiralık yer sahibinin açıklaması. | Free text |
| host_language | Optional | Tesis sahibinin konuşabildiği dillerdir. | Virgülle ayrılmış dil kodları listesi (ör. de, en) |
| host_name | Optional | Kiralık yer sahibinin adı. | Free text |
| host_response_rate | Optional | Ev sahibinin ortalama yanıt oranı. | Non-negative float value, for example, 1, 0.75, 0.5 |
| host_response_time | Optional | Ev sahibinin ortalama yanıt süresi. | Free text |
| license_num | Optional | Dünyanın belirli bölgelerinde tesisler için gösterilmesi gereken lisans numarasıdır (turist veya işletme). Tekrarlanabilir. Birden fazla lisans varsa lisans yetkilendirmesi bağlamı eklemenizi öneririz. Örneğin: "Paris: 123456ABC". | Free text |
| number_of_half_bathrooms | Optional | Yarım banyo sayısıdır. | Non-negative integer value |
| number_of_living_rooms | Optional | Oturma odası sayısıdır. | Non-negative integer value |
| private_beach_access | Optional | Tesisin halka açık olmayan bir plaja özel erişim imkanının olup olmadığını gösterir. | Yes/No/Unknown |
| refund_policy | Optional | Tesisin geri ödeme politikası. | Free text |
XML alt öğeleri
Aşağıdaki XML alt öğeleri gereklidir:
| Alt öğe | Zorunlu mu? | Tür | Açıklama |
|---|---|---|---|
| <country> | Strongly recommended | string | Bu girişin bulunduğu ülke. Bu değer, ISO 3116'ya uygun 2 harften oluşan ülke kodu olmalıdır. Örneğin, Amerika Birleşik Devletleri için US, Kanada için CA:
<country>US</country> |
| <id> | Required | string | Tesisin benzersiz tanımlayıcısı. Her kiralık yerin, sitenize özgü bir kimliği olması gerektiğini ve bu kimliğin hiçbir zaman yeniden kullanılmaması gerektiğini unutmayın. |
| <latitude> | Required | float | Tesisin konumuna karşılık gelen enlem. Örneğin:
<latitude>37.423738</latitude> Bu değer, Google Maps API gibi coğrafi kodlama araçlarıyla oluşturulabilir. |
| <longitude> | Required | float | Tesisin konumuna karşılık gelen boylam. Örneğin:
<longitude>-122.090101</longitude> Bu değer, Google Maps API gibi coğrafi kodlama araçlarıyla oluşturulabilir. |
| <name> | Required | string | Tesisin adı. En fazla 300 karakter. |
| <address> | Required | string or Object | Tesisin tam fiziksel konumu (dize olarak). Adres, sokak adı ve numarası içermelidir. Yoksa adreste Plus Code olmalıdır. Varsa apartman veya daire numaraları da eklenmelidir. Alternatif olarak "bileşik" bir adres de sağlayabilirsiniz. Adresin aşağıdaki bölümlerinin her birini açıklamak için
Posta kutularının veya sadece posta gönderilebilen adreslerin tam fiziksel adres olarak kabul edilmediğini unutmayın. Aşağıda, eksiksiz bir adres örneği verilmiştir: <address>6 Acacia Ave Apt. 2, Nottingham NG8 6FT, UK/address> <address> <component name="addr1">6 Acacia Ave</component> <component name="addr2">Apt. 2</component> <component name="city">Nottingham </component> <component name="postal_code">NG8 6FT</component> <component name="country">UK</component> </address> Artı kodu kullanılarak oluşturulmuş eksiksiz adres örneklerini aşağıda bulabilirsiniz: <address>XQHM+7VF Nottingham NG8 6FT, UK/address> <address> <component name="addr1">XQHM+7VF</component> <component name="city">Nottingham </component> <component name="postal_code">NG8 6FT</component> <component name="country">UK</component> </address> Aşağıdakilerden kaçının:
|
Kiralık yer listeleme örneği
<?xml version="1.0" encoding="UTF-8"?> <listings> <language>en</language> <listing> <id>123456</id> <name>Apartment Name</name> <address format="simple"> <component name="addr1">18733 Clark Way</component> <component name="addr2">#C10</component> <component name="city">Mountain View</component> <component name="postal_code">94043</component> <component name="province">California</component> </address> <country>US</country> <latitude>37.4182515</latitude> <longitude>-122.0742354</longitude> <phone type="main">12345678</phone> <category>vacation_villa</category> <date day="21" month="12" year="2017"/> <content> <text type="description"> <link>https://list_url</link> <title>Description Title</title> <body>Description Body</body> </text> <review type="editorial"> <link>https://example.com/reviews/42</link> <title>A little piece of heaven</title> <author>EXAMPLE</author> <rating>8</rating> <body>This place is really good.</body> </review> <review type="user"> <link>https://exampleperson.org/reviews/82</link> <author>Susan von Trapp</author> <rating>6</rating> <body>Not a bad place, but I prefer to be closer to the beach.</body> <date day="6" month="7" year="2017"/> <servicedate day="16" month="6" year="2017"/> </review> <attributes> <website>https://hotel.example.com/123456</website> <client_attr name="capacity">7</client_attr> <client_attr name="cleaning_disinfection">Yes</client_attr> <client_attr name="min_days_between_stays">3</client_attr> <client_attr name="enhanced_cleaning_practices">Yes</client_attr> <client_attr name="partner_hygiene_link">http://www.example.com/hygiene/</client_attr> <client_attr name="number_of_bathrooms">2</client_attr> <client_attr name="number_of_bedrooms">3</client_attr> <client_attr name="number_of_beds">4</client_attr> <client_attr name="self_checkin_checkout">Yes</client_attr> <client_attr name="rating">4.8</client_attr> <client_attr name="rating_num">5373</client_attr> <client_attr name="rating_scale">5</client_attr> <client_attr name="ac">Yes</client_attr> <client_attr name="airport_shuttle">Yes</client_attr> <client_attr name="balcony">No</client_attr> <client_attr name="beach_access">Yes</client_attr> <client_attr name="check_in_time">15:00</client_attr> <client_attr name="check_out_time">11:00</client_attr> <client_attr name="child_friendly">Yes</client_attr> <client_attr name="crib">Unknown</client_attr> <client_attr name="elevator">Yes</client_attr> <client_attr name="fire_place">Unknown</client_attr> <client_attr name="free_breakfast">Yes</client_attr> <client_attr name="gym_fitness_equipment">Yes</client_attr> <client_attr name="heating">Yes</client_attr> <client_attr name="host_description">A short description about the host and their interests</client_attr> <client_attr name="host_name">The name of the host</client_attr> <client_attr name="host_language">en, da, el</client_attr> <client_attr name="host_response_rate">0.75</client_attr> <client_attr name="host_response_time">1 hour</client_attr> <client_attr name="hot_tub">Yes</client_attr> <client_attr name="instant_bookable">Yes</client_attr> <client_attr name="internet_type">Free</client_attr> <client_attr name="ironing_board">No</client_attr> <client_attr name="kitchen">Yes</client_attr> <client_attr name="license_num">Free text. If multiple licenses exist, we suggest adding authority of the licence as context</client_attr> <client_attr name="license_num">Paris: 123456ABC</client_attr> <client_attr name="microwave">Yes</client_attr> <client_attr name="max_night_stay">7</client_attr> <client_attr name="min_days_advance_purchase">2</client_attr> <client_attr name="min_night_stay">3</client_attr> <client_attr name="number_of_living_rooms">1</client_attr> <client_attr name="outdoor_grill">No</client_attr> <client_attr name="oven_stove">Yes</client_attr> <client_attr name="parking_type">Free</client_attr> <client_attr name="patio">Unknown</client_attr> <client_attr name="pets_allowed">Yes</client_attr> <client_attr name="pool_type">Indoors</client_attr> <client_attr name="private_beach_access">Unknown</client_attr> <client_attr name="room_type">ENTIRE_PLACE</client_attr> <client_attr name="refund_policy">The refund policy for the property</client_attr> <client_attr name="smoking_free_property">Yes</client_attr> <client_attr name="special_service_level">No</client_attr> <client_attr name="square_footage">1200</client_attr> <client_attr name="tv">Yes</client_attr> <client_attr name="washer_dryer">Yes</client_attr> <client_attr name="wheelchair_accessible">Yes</client_attr> </attributes> </content> </listing> </listings>