TWiki> API_Doc Web>TypeProperty (2008/09/27, GeorgiKuzmanov)EditAttach

Структура на параметър от тип Property

Входящ/Изходящ параметър

  • Когато се използва при извикване на Web Service услуга, всички полета от тип (string) трябва да бъдат utf8 кодирани (За PHP utf8_encode, За Perl Encode::encode("utf8", $string_value))
  • Когато се използва като резултат от Web Service услуга, всички полета от тип (string) са utf8 кодирани (За PHP utf8_encode, За Perl Encode::encode("utf8", $string_value))

Документация на тип от данни Property

Комплексния тип от данни Property съдържа следните полета:

Тип Име Задължително Формат Описание
(int) $property_id Не цяло число ID на обявата. (Когато се изполва като входящ параметър за Web Service услуга, тази стойност не се взима под внимание)
(int) $my_property_id Да цяло число ID на обява от вашата система. Ако използвате тази стойност се уверете, че офертите Ви имат иникални ID стойности
(string) $property_offer_language Да Възможни стойности:
  • 'BG' - Обява на Български език.
  • 'EN' - Обява на Английски език.
 език на обявата.
(string) $property_offer_deal_type Да Възможни стойности:
  • 'sale' - Обява за продажба на имот.
  • 'rent' - Обява за отдаване под наем.
 тип на обявата.
(string) $property_offer_real_url Да http(s)://domainname адрес (URL) на който може да се разгледа детайлна информация за конкретната обява. Към този адрес ще бъдат препращани всички портебители изявили желание да се запознаят с по-детаилна информация относно дадения имот.
(date) $property_offer_publish_date Да YYYY-MM-DD дата на публикуване на обявата. Важни особености:
  • Пример: '2002-09-24' е '24 Септември 2002'.
  • Ако токущо сте актуализирали обявата, е нормално да поставите днешна дата в това поле.
  • Ако токущо сте създали обявата, е нормално да поставите днешна дата в това поле.
  • Ако сте актуализирали или добавили обявата преди 3 дни, е нормално да поставите датата преди 3 дни.
  • повече информация за тип DATE
(date) $property_offer_expire_date Не YYYY-MM-DD дата на изтичане на обявата. Важни особености:
(string) $property_title Да Свободен текст заглавие на овявата. Пример: "Продава двустаен апартамент в София" или "Отдава под наем гарсониера в Лозенец"...
(string) $property_type Да Свободен текст тип на продавания имот. Пример: "Къща", "Двустаен апартамент"
(int) $property_bedrooms Не цяло число брой на спални в имота. Ако не знаете броя или обявата е за земя, посочете 0 в това поле
(int) $property_full_bathrooms Не цяло число брой на бани в имота. Помещение с мивка, душ (тоалетната не е задължителна). Ако не знаете броя или обявата е примерно за земеделсказемя, посочете 0 в това поле
(int) $property_half_bathrooms Не цяло число брой на бани в имота. Помещение само с мирка и тоалетна (без душ). Ако не знаете броя или обявата е примерно за земеделска земя, посочете 0 в това поле
(string) $property_description Не Свободен текст детайлно описание на имота. Използвайте максимално детайлно описание. По този начин ще имате възможност да попаднете в повече критерии за търсене и обявата ви ще е по-известна!
(string) $property_utilities Не Списък характеристики на имота - списък от ключови думи, разделени със запетаи
(string) $property_price_currency Да Възможни стойности:
  • EUR
  • USD - Американски долари.
  • GBP - Британски лири.
  • BGN - Български лева.
вид на валута, в която е зададена цената на имота (Виж следващия параметър $property_price).
(double) $property_price Да   цена в съответната валута (Виж предишния параметър $property_price_currency). Цената може да бъде за квадратен метър (погледнете следващия параметър $price_per_sqm) или цена за целия имот.
(int) $price_per_sqm Да Възможни стойности:
  • 0 - зададената цена в параметър $property_price_eur е за целия имот.
  • 1 - зададената цена в параметър $property_price_eur е 1 квадратен метър.
тип на цената в евро.
(double) $property_living_sqm Не   жилищна площ на имота в квадратни метри. Пример: ако обявата се отнася за апартамент тук се посочва квадратурата на имота. Ако обявата е за къща в този параметър се посочва жилищната площ на къщата. Ако обявата е за земеделска земя или парцел тук стойността е 0.
(double) $property_land_sqm Не   площ в квадтатни метри (1 декар = 1000 квадратни метра). Ако обявата е за земеделска земя или парцел тук стойността е площа на имота. Ако обявата е за къща в този параметър се посочва площа на дора или градината към къщата.Ако обявата е за апартамент тук се посочва стойност 0.
(int) $building_completion_year Не YYYY година на завършване на сградата (Пример: 2001). Важни особености:
  • За новостроящи се сгради - планирана година на завършване
  • За вече построени сгради - година, през която е завършило строителството
  • * Вижте и следващия параметър $building_completion_month
      • .
(int) $building_completion_month Не MM месец на завършване на сградата (Пример: 11). Важни особености:
  • За новостроящи се сгради - планиран месец на завършване
  • За вече построени сгради - месец на завършване на строителството.
  • * Вижте и предишния параметър $building_completion_year
      • .
(int) $building_floors Не   брой етажи на сградата, в която се намира офертирания имот. Примери:
  • Ако обявата е за отдаване под наем на апартамент на 3-ти жилищен етаж от кооперация с общо 6 застроени етажа, в този параметър трябва да поставите стойност 6
  • Ако обявата е за продажба на втори етаж от двуетажна къща, в този параметър трябва да поставите стойност 2.
  • Ако обявата е за продажба на земеделска земя, е логично да поставите стойност 0.
(int) $property_floor Не   етаж, на който се намира офертирания имот. Примери:
  • Ако обявата е за отдаване под наем на апартамент на 3-ти жилищен етаж от кооперация с общо 6 застроени етажа, в този параметър трябва да поставите стойност 3
  • Ако обявата е за продажба на втори етаж от двуетажна къща, в този параметър трябва да поставите стойност 2.
  • Ако обявата е за продажба на парцел, е логично да поставите стойност 0.
(string) $property_image_url_1 Не http(s)://domain/picture_location адрес на картинка на публикувания имот. Задължително е задаването на пълен адрес. Пример: http://www.yourdomain.com/pic/show_pic.php?id=1
(string) $property_image_url_2 Не http(s)://domain/picture_location адрес на картинка на публикувания имот. Задължително е задаването на пълен адрес. Пример: http://www.yourdomain.com/pic/show_pic.php?id=2
(string) $property_image_url_3 Не http(s)://domain/picture_location адрес на картинка на публикувания имот. Задължително е задаването на пълен адрес. Пример: http://www.yourdomain.com/pic/show_pic.php?id=3
(string) $property_image_url_4 Не http(s)://domain/picture_location адрес на картинка на публикувания имот. Задължително е задаването на пълен адрес. Пример: http://www.yourdomain.com/pic/show_pic.php?id=4
(string) $property_image_url_5 Не http(s)://domain/picture_location адрес на картинка на публикувания имот. Задължително е задаването на пълен адрес. Пример: http://www.yourdomain.com/pic/show_pic.php?id=5
(string) $property_image_url_6 Не http(s)://domain/picture_location адрес на картинка на публикувания имот. Задължително е задаването на пълен адрес. Пример: http://www.yourdomain.com/pic/show_pic.php?id=6

Вижте още

Функции

Сложни типове от данни

-- GeorgiKuzmanov - 2008/09/27

Edit | Attach | Print version | History: r7 < r6 < r5 < r4 < r3 | Backlinks | Raw View | Raw edit | More topic actions
Topic revision: r7 - 2008/09/27 - 13:39:27 - GeorgiKuzmanov
 
www.Bulgarian-Offers.com Documentation
This site is powered by the TWiki collaboration platformCopyright © by the contributing authors. All material on this collaboration platform is the property of the contributing authors.
Ideas, requests, problems regarding TWiki? Send feedback