OctopusPro s.r.o. Webové služby pro služby OctopusPro 1 CENOVÉ MAPY Verze: 1.0 Datum vytvoření: 21.10.2015 Datum poslední aktualizace: 21.10.2015 Copyright OctopusPro s.r.o, Praha, 2012-2015
S t r á n k a 2 Obsah: 1 ÚVOD... 3 1.1 Základní popis... 3 2 Popis práce s webovými službami... 3 2.1 Základní třídy požadavku a odpovědi (RequestBase a ResponseBase)... 3 2.2 Příklad použití WS... 3 3 Webové služby 1. cenové mapy popis funkcí... 5 3.1 wscm_01... 5 4 Datové typy... 5 4.1 LocalityDTO... 5 4.2 InputDataDTO... 5 4.3 OutputDataDTO... 6 5 Číselníky... 7 5.1 LocalityDefinitionDTO... 7 5.2 ccbuildingcondition... 7 5.3 ccbuildingtype... 7 5.4 ccmonthinpast... 7 5.5 ccviewcm... 7
S t r á n k a 3 1 ÚVOD Úkolem webových služeb poskytovaných společností OctopusPro s.r.o. je zpřístupnění dat pro software třetích stran. Jejich využívání je podmíněno vytvořením aplikace na straně klienta, který bude poskytnutá data dále zpracovávat. 1.1 Základní popis Webové služby jsou veřejně dostupné na následující adrese: https://ws.1cenovemapy.cz/cmservice.svc?wsdl K úspěšnému přihlášení do webové služby je nutné mít zřízený účet na http://www.1cenovemapy.cz/ a povoleny webové služby. 2 POPIS PRÁCE S WEBOVÝMI SLUŽBAMI 2.1 Základní třídy požadavku a odpovědi (RequestBase a ResponseBase) Třídy RequestBase a ResponseBase jsou základní třidy. O těchto základních tříd dědí všechny další typy Request a Response v jednotlivých funkcích. RequestBase základní třída pro vstupní parametr web.služby Název elementu Typ Možné hodnoty Poznámka ClientUserName string Neprázdný string Uživatelské jméno, které je totožně s loginem do aplikace 1. CENOVÉ MAPY na http://aplikace.1cenovemapy.cz/ ClientPassword string Neprázdný string Heslo, které je totožné s loginem do aplikace na http://aplikace.1cenovemapy.cz/ ResponseBase základní třída pro výstupní parametr web.služby Název elementu Typ Možné hodnoty Poznámka Acknowledge AcknowledgeType Success, Failed Udává výsledek volání webové služby. V případě chyby vrací Failed Message String Prádný string v případě úspěchu V případě chyby (Acknowledge) je zde možné nalézt detailnější popis, proč se volání nezdařilo 2.2 Příklad použití WS Všechny příklady jsou uvedeny v jazyce C# (.NET Framework). Princip je ale stejný ve všech programovacích jazycích. Nejdříve je potřeba přidat WS do Service References v daném projektu. Ukázka nastavení připojení k WS z web.config <system.servicemodel> <bindings> <basichttpbinding>
S t r á n k a 4 <binding name="basichttpbinding_icenovemapyservice" /> </basichttpbinding> </bindings> <client> <endpoint address=" https://ws.1cenovemapy.cz/cmservice.svc" binding="basichttpbinding" bindingconfiguration="basichttpbinding_icenovemapyservice" contract="cmreferencews.icenovemapyservice" name="basichttpbinding_icenovemapyservice" /> </client> </system.servicemodel> V následujícím příkladu je ukázka volání funkce wscm_01 wscm_01_request RQ = new wscm_01_request(); RQ.ClientUserName = tbjmeno.text; RQ.ClientPassword = tbheslo.text; var LocalityDefinitionEn = (cclocalitydefinition)enum.parse(typeof(cclocalitydefinition), ddltypruian.selectedvalue); var viewcm = (CM_StructuresccViewCM)Enum.Parse(typeof(CM_StructuresccViewCM), ddlviewcm.selectedvalue); var PastInMth = (MonthInPast)Enum.Parse(typeof(MonthInPast), ddlmonthinpast.selectedvalue); RQ.Locality = new LocalityDTO() { KOD = Convert.ToInt32(tbRuaianKod.Text), LocalityDefinition = LocalityDefinitionEn }; RQ.PropertyData = new InputDataDTO() { viewcm = viewcm }; RQ.MonthInPathEnum = PastInMth; CMReferenceWS.CenoveMapyServiceClient Client = new CenoveMapyServiceClient(); wscm_01_response Response=Client.wsCM_01(RQ);
S t r á n k a 5 3 WEBOVÉ SLUŽBY 1. CENOVÉ MAPY POPIS FUNKCÍ 3.1 wscm_01 [OperationContract] [WebMethod(Description = "Vrátí informaci o tržní ceně nemovitosti v dané lokalitě")] public wscm_01_response wscm_01(wscm_01_request Request); wscm_01_request vstupní parametry Název elementu Typ Poznámka Locality LocalityDTO Definice dotazované lokality nemovitosti, v které má být poskytnuta tržní cena. Viz 4. datové typy PropertyData InputDataDTO Definice dotazované nemovitosti a dalších parametrů pro zpřesnění ceny Viz 4. datové typy MonthInPathEnum MonthInPast Definice, v jaké časovém rozmezí realizovaných transakcí se bude prohledávat. Možnosti jsou 6, 12 a 24 měsíců zpětně. 4 DATOVÉ TYPY 4.1 LocalityDTO LocalityDTO informace o lokalitě Název elementu Typ Možné hodnoty Poznámka LocalityDefinition LocalityDefinitionDTO Ulice Stavba Určuje, na jaké úrovni rozlišení oblasti (lokality) se bude tržní cena dotazovat, jedná se o enumerátor. V případě STAVBA, se bude dotazovat na cenu na úrovni adresního místa, v případě ULICE, se bude dotazovat na průměrnou cenu v rámci vybrané ulice. KOD Int64 - Jendná se o kód RUIAN (Ulice: ULICE_KOD, Stavby: STAVOBJ_KOD). Zda se jedná o kod ulice nebo stavby je určeno parametrem LocalityDefinition 4.2 InputDataDTO LocalityDTO informace o lokalitě Název elementu Povinný parametr viewcm ANO CM_Structures. ccviewcm Typ Možné hodnoty Poznámka Byt_Prodej Byt_Prodej_Novostavba Byt_Prodej_NeNovostavba Dum_Prodej Dum_Prodej_Novostavba Dum_Prodej_NeNovostavba Parcela_Stavebni Parcela_Pozemkova Parcela_Pozemkova_OrbnaPuda Parcela_Pozemkova_Zahrada výběr datové vrstvy (zdroje) pro poskytnutí tržní ceny. Detailní popis viz kapitola 5. Číselníky. Tento parametr definuje výběr kategorie nemovitost na kterou se dotazujeme + další související parametry.
S t r á n k a 6 Parcela_Pozemkova_Lesy usable_area NE int Užitná plocha, parametr využit pro nemovitosti z kategorie BYT, DŮM estate_area NE int Plocha pozemku, parametr využit pro nemovitosti z kategorie POZEMKY, případně pro zpřesnění ceny u DOMU. rooms_count NE CM_Structures. irooms Obsahuje 3 int proměnné: kuchyn_count počet kuchyní (zde se nejdená o kuchyňský kout, ale o místnost s oknem sloužící jako kuchyň.), pokoj_count počet pokojů, a rooms_count - celkový počet obytných místnsotí buildingcondition NE ccbuildingcondition VelmiDobry Dobry Spatny VeVystavbe Projekt Novostavba PredRekonstrukci PoRekonstrukci buildingtype NE ccbuildingtype drevo cihla kamen montovany panel skelet smiseny Informace o tom, kolik obytných místností má dotazovaný byt. Pokud se zadá tento parametr, aplikace koriguje v rámci jedné stavby cenu pro různé typy dispozice. Informace o stavu nemovitosti, jedná se o číselník viz 5. Pokud se zadá tento parametr, aplikace koriguje cenu nemovitosti na základě významu vložené hodnoty. Informace, za jakého materiálu má být budova postavena, jedná se o číselník viz 5. Pokud se zadá tento parametr, aplikace koriguje cenu nemovitosti na základě významu vložené hodnoty. 4.3 OutputDataDTO Výstupní informace o ceně nemovitosti Název elementu Typ Poznámka Price_m2_mean Double Podobně jako medián, ale jedná se o aritmetický průměr. Hodnota v Kč / m 2. Price_m2_min Double Minimální zjištěná tržní cena. Hodnota v Kč / m 2. (statisticky výrazně odlehlé hodnoty se nezohledňují) Price_m2_max Double Maximální zjisštěná tržní cena. Hodnota v Kč / m 2. (statisticky výrazně odlehlé hodnoty se nezohledňují) Price_m2_std Double Směrodatná odchylka z hodnot tržních cen, z kterých se počítá průměr a medián. Hodnota v Kč / m 2. Price_m2_median Double Tržní cena nemovitosti definovaná pro danou oblast, vstupní parametry a stáří dat. Obecně se jedná o hodnotu pořízenou z tržních cen více nemovitostí statistky vyhodnocenou jako medián. Zatím není implementováno. Hodnota v Kč / m 2. PropertyCount int Počet nemovitostí, jejichž tržní ceny jsou použity pro výpočet průměru a mediánu. PriceOfProperty int Konečná tržní cena nemovitosti v Kč. Ta je k dispozici pouze pokud se zadá usable_area (byt, dům) nebo estate_area (pozemek) IsCalculatedByInterpolation Boolean Pokud cena nemovitosti v aktuální adrese není k dispozici, je hodnota IsCalculatedByInterpolation=True. V takovém případě se hodnota tržní ceny získá ze 3 nejbližších staveb, u kterých je k dispozici tržní cena.
S t r á n k a 7 5 ČÍSELNÍKY 5.1 LocalityDefinitionDTO Id Name 1 Ulice 4 Stavba 5.2 ccbuildingcondition Id Name 1 VelmiDobry 2 Dobry 3 Spatny 4 VeVystavbe 5 Projekt 6 Novostavba 8 PredRekonstrukci 9 PoRekonstrukci 5.3 ccbuildingtype Id Name 1 drevo 2 cihla 3 kamen 4 montovany 5 panel 6 skelet 7 smiseny 5.4 ccmonthinpast Id Name 6 Month6 12 Month12 24 Month24 5.5 ccviewcm Id Name Popis 1 Byt_Prodej Základní kategorie Byt, prodej, bez korekcí 11 Byt_Prodej_Novostavba Kategorie Byt, prodej, pouze pro stáří stavby do 3 let, cena je zpřesněna 12 Byt_Prodej_NeNovostavba Kategorie Byt, prodej, pouze pro stavby starší než 3 roky, cena je zpřesněna 3 Dum_Prodej Základní kategorie Dům, prodej, bez korekcí 31 Dum_Prodej_Novostavba Kategorie Dům, prodej, pouze pro stáří stavby do 3 let, cena je zpřesněna
S t r á n k a 8 32 Dum_Prodej_NeNovostavba Kategorie Dům, prodej, pouze pro stavby starší než 3 roky, cena je zpřesněna 4 Parcela_Stavebni Základní kategorie Stavební parcela, prodej, bez korekcí 5 Parcela_Pozemkova Základní kategorie Pozemková parcela, prodej, bez korekcí 51 Parcela_Pozemkova_OrbnaPuda Pozemkový parcela, pouze Orná půda, prodej, bez korekcí 52 Parcela_Pozemkova_Zahrada Pozemkový parcela, pouze Zahrada, prodej, bez korekcí 53 Parcela_Pozemkova_Lesy Pozemkový parcela, pouze Lesy, prodej, bez korekcí