Versionshinweise

25.11.2009 Version 2.3

Änderungen bei den Sortierungskriterien in der Ergebnisliste
Es betrifft diejenigen, die die Sortierungsfunktion unserer API in der Ergebnisliste verwenden.

Folgende Sortierkriterien entfallen:

• API-Suchfelder (SearchField1, SearchField2, SearchField3)
• Statusfelder (StatusIS24 ,StatusHP, StatusAllianz, StatusVBM)
• Erstellungsdatum (CreationDate) -> Alternativ können Sie nach Scout-Objekt-ID (UUID) - sortieren: das basiert auch auf Erstellungsdatum
• Deaktivierungsdatum (DeactivationDate)
• Überschrift (Heading)
• Gruppennummer (groupNumber) -> anbieterbezogen, nicht objektbezogen
• Straße (street)
• Hausnummer (houseNo)
• PLZ (zip)
• Ort (addressCity)
• Anbieterobjektnummer (forignKey)

Preisattribute: es kann nur noch nach MarketingPrice sortiert werden

Eine Sortierung nach z.B: netRent ist nicht mehr möglich.
Wir mappen automatisch alle Preissortierungskriterien auf MarketingPrice: Sie müssen es nicht unbedingt anpassen.
Sortierung nach mehreren Kriterien ist nicht mehr möglich
Es ist nicht mehr möglich, mehr als 1 Sortierungkriterium in einer Sortierung anzugeben (z.B. zuerst nach API-Suchfeld 1, dann nach Ort sortieren).
Wir fangen das auf und nehmen das erste gültige Sortierungskriterium und sortieren danach.
defaultsortierung eingerichtet
Damit die Änderungen 100% abwärtskompatibel sind, haben wir eine Defaultsortierung eingerichtet:

• Normale Suche: nach Scout-Objekt-ID (UUID)
• Umkreissuche: nach Distanz

Auch wenn Sie die Änderungen nicht (rechtzeitig) übernehmen, wird kein Fehler ausgegeben und Ihre Ergebnislistesortierung funktioniert weiterhin, es wird bei
den betroffenen Änderungen dann automatisch nach Scout-Objekt-ID bzw. nach Distanz sortiert

22.04.2009 Version 2.2

Alle Änderungen in Version 2.2 sind abwärtskompatibel

• Bei Multimediadateien wird die Dateieindung ausgeliefert. Damit können Sie Icons (z.B. pdf, video) zusteuern oder eine Suche nach Objekten mit Videos kreieren.
  (Anpassung von attachment und attachmenturl beim MultiQueryRequest,VendorRealEstatesRequests und ExposeRequest)
  
• Im multiqueryrequest und VendorRealEstate wird zu der quarter id wird auch der quarter name ausgegeben.
  Damit können Sie z.B. den Bezirksnamen in der Ergebnisliste anzeigen
• Bei Auslandobjekten werden die Indexzahlen zu Kontinent und Land ausgegeben(geostatistics AuslandGeoHierarchyStatisticsRequest)
• Die Anzahl der ausgegebene Immobilientypen wurde von 13 auf 30 erhöht (RegionsRequest, QuartersRequest, CitiesRequest)
• Durch die Gruppennummer ist es für Ihre Kunden möglich, verschiedene Objekte zu verknüpfen und als alternative Immobilien anzeigen zu lassen.
  Dieses Feature ist nun auch mit der API möglich. Hat ein Anbieter mehreren Immobilien z.B. die Gruppennummer 1 gegeben, dann werden bei einem ExposeRequest alle Objekte, außer das aufgerufene, mit der Überschrift und der ID mit ausgegeben.

17.09.2008 Version 2.1

Kartenmaterial (Exposékarte) entfernt
Wir haben den GeoMapRequest, sowie den damit verbundenen GeoMapResult entfernt. In der Übergangszeit wird bei einem Request ein 1x1Pixel zurückgeliefert. Bitte benutzen Sie nun die Latitude/Longitude Werte im Exposé und eine Karten API. Die Grundlagen dazu bekommen Sie in unserem VirtualEarth/GoogleMaps Tutorial.

• Feature: PictureType "ExtraLarge" 1000x1000px hinzugekommen
• Feature: WGS84 (GPS) Daten werden als Longitude/Latitude im Exposé ausgeliefert
  expose.xsd: Alle Objekte
  Die GPS-Kooradinaten werden als Latitude/Logitude-Werte mit dem Expose-Request ausgeliefert, wenn die Adress-Anzeige aktiviert worden ist. Dadurch ist eine einfache Anbindung an verschiedene Karten API's möglich.
• Feature: "AttachementUrl" um das Attribut "isFloorPlan" erweitert (Grundriss)general.xsd: AttachmentUrl
  Ist dieser Wert "true" dann ist das Bild ein Grundriss.
• Feature: Impressum um ein formatiertes Textfeld erweitert
  contact.xsd: MastheadResult um Element mastheadText erweitert.
  In diesem Element sind alle Impressumdaten zusammengefasst.

28.05.2008 Version 2.0

Neue API-Version 2.0 (Wichtige Änderungen):

• Bugfix: "nachVereinbarung" auf "nach Vereinbarung" geändert
  general.xsd: Enumeration in AllowedType
• Bugfix: "hasFoerderung” heißt jetzt "hasPromotion"
• request.xsd: Element in AppartmentRentQuery expose.xsd: Element in AppartmentRent
• Bugfix: "WazImmoType auf "wazImmoType" im WazProxy geändert
  result.xsd: Schreibweise des Elements "Gebäudeart" angepasst
• Feature: "wheelchair" entfernt (Dafür ist barrierFree hinzugekommen)
  request.xsd und result.xsd: Rollstuhlgerecht wurde aus allen Immobilientypen entfernt. Betrifft die Elemente in AppartmentRentQuery, AppartmentBuyQuery, HouseRentQuery und HouseBuyQuery. expose.xsd: Betrifft zusätzlich noch Office
• Feature: "Erdgeschoss" auf "Erdgeschosswohnung" geändert
  general.xsd: Enumeration in AppartmentCategoryType
• Feature: "SiteQuery" entfällt und wird auf "SiteLivingBuy" gemapped
  request.xsd: Für Grundstücke sind 3 neue Immobilienypen hinzugekommen, deshalb gibt es einen allgemeinen Grundstückstyp nicht mehr. SiteQuery wird somit für mind. 3 Monate auf SiteLivingBuy gemapped.
• Feature: "SiteProxy" gelöscht
  result.xsd: Als Result wird bei einer SiteQuery-Anfrage der SiteLivingBuyProxy ausgeliefert
• Feature: "hasLanCables" (boolean-Wert) auf "lanCables" (Enumeration Typ) geändert
  request.xsd/expose.xsd: Anstatt des Boolean-Wertes (true) bei hasLanCables wird nun der "YesNoType" ausgegebenBetrifft den "Office" (Büro/Praxis) Immobilientyp
• Feature: "hasCourtage" und "courtage" wurden in den Typen "Courtage" verlagert. Dieser beinhaltet zusätzlich "courtageDescription". Das Element unter dem sich dieser Typ befindet heißt "courtageInfo"
  expose.xsd: Betrifft alle Immobilientypen. Es handelt sich hierbei um die Provision.
• Feature: "hasParking" als boolean-Wert weggefallen, dafür ist das Element "noParking" hinzugekommen
  expose.xsd: Betrifft alle Immobilientypen

Neue Immobilientypen:

• FlatshareRoom (WG-Zimmer)
• SeniorCare (Altenpflege)
• AssistedLiving (Betreutes Wohnen)
• SiteTrade (Grundstück Gewerbe)
• SiteLivingBuy (Grundstück Kauf)
• SiteLivingRent (Grundstück Miete)
• GarageBuy (Garage Kauf)
• GarageRent (Garage Miete)

Erweiterungen:

• Bugfix: "totalArea" darf als Suchkriterium in GastronomyQuery nur einmal vorkommen request.xsd: maxOccurs="1" im Element "totalArea" in GastronomyQuery
• Feature: "VendorRealEstatesRequest" hinzugefügt
  request.xsd: Dieser Request liefert alle angegebenen Immobilientypen eines Vendors zurück, ohne das mehrere Multiquerys erstellt werden müssen.
  (Momentan auf den Anbieter beschränkt.)
• Feature: "NoBusinessCard" als ErrorCode hinzugefügt
  general.xsd: Enumeration "NoBuisinessCard" in Fehlercodes
• Feature: "Hochparterre" und "Souterrain" hinzugefügt
  general.xsd: Enumeration in AppartmentCategoryType
• Feature: "Reiheneckhaus" und "Reihenmittelhaus" hinzugefügt
• general.xsd: Enumeration in HouseCategoryType
• Feature: "Miete" hinzugefügt
  general.xsd: Enumeration in SiteMarketingType
• Feature: "Wohn- und Geschäftsgebäude" und "Büro- und Geschäftsgebäude" hinzugefügt
  general.xsd: Enumeration in OfficeCategoryType
• Feature: "keine Angabe" hinzugefügt
  general.xsd: Enumeration in AllowedType
• Feature: "barrierFree" als Suchkriterium in den Querys hinzugefügt
  request.xsd: Element "Barrierefreiheit” in AppartmentRentQuery , AppartmentBuyQuery, HouseRentQuery, HouseBuyQuery, OfficeQuery und WazQuery
• Feature: "yearConstructed" als Suchkriterium in den Querys hinzugefügt
  request.xsd: Element "Baujahr” in AppartmentRentQuery , AppartmentBuyQuery, HouseRentQuery und HouseBuyQuery
• Feature: "hasBasement" als Suchkriterium in den Querys hinzugefügt
  request.xsd: Element "Keller” in AppartmentRentQuery , AppartmentBuyQuery, HouseRentQuery, HouseBuyQuery, OfficeQuery, GastronomyQuery, StoreQuery und WazQuery
• Feature: "hasGuestToilet" als Suchkriterium in den Querys hinzugefügt
  request.xsd: Element "Gästetoilette” in AppartmentRentQuery , AppartmentBuyQuery, HouseRentQuery, HouseBuyQuery und WazQuery
• Feature: "buildingPhase” als Suchkriterium in HouseBuyQuery hinzugefügt
  request.xsd: Element "Bauphase” in HouseBuyQuery
• Feature: "minDivisible” als Suchkriterium in MiscQuery und StoreQuery hinzugefügt
  request.xsd: Element "teilbar ab” in MiscQuery und StoreQuery
• Feature: "noBeds” und "noSeats” als Suchkriterium in GastronomyQuery hinzugefügt
  request.xsd: Elemente "Anzahl Betten” und "Anzahl Sitzplätze” in GastronomyQuery
• Feature: "noParking" als Suchkriterium in WazQuery hinzugefügt
  request.xsd: Element "Anzahl Parkplätze" in WazQuery
• Feature: "pictureURL" liefert nun als Attribut den "pictureType" mit
  result.xsd: Das Element "pictureURL" wurde von string auf einen Typ geändert, damit wird der pictureType als Attribut mit ausgegeben. Für die Auswertung der Bild-Url ändert sich nichts, da die Url trotzdem als String ausgegeben wird.
• Feature: Exposés bei allen Immobilientypen erweitert
  Hier eine Liste der erweiterten Elemente in der expose.xsd:
  • AppartmentRent: heatingStuff, lastModernizationYear, parkingType, noParking, interiorQuality, hasGuestToilet, hasBasement, energyConsumption, barrierFree
  • AppartmentBuy: heatingStuff, lastModernizationYear, parkingType, noParking, hasGuestToilet, hasBasement, energyConsumption, interiorQuality, isAHolidayHomeUsable, hasMonumentProtection, barrierFree
  • HouseRent: heatingStuff, lastModernizationYear, parkingType, noParking, petsAllowed, hasGuestToilet, hasBasement, energyConsumption, interiorQuality, barrierFree
  • HouseBuy: hasMonumentProtection, lastModernizationYear, heatingStuff, parkingType, noParking, interiorQuality, buildingPhase, hasGuestToilet, hasBasement, energyConsumption, isAHolidayHomeUsable, barrierFree
  • Office: lastModernizationYear, hasHeavyCurrent, kitchenComplete, hasBasement, hasMonumentProtection, heating, heatingStuff, airCondition, energyConsumption, interiorQuality, barrierFree
  • Gastronomy: lastModernizationYear, interiorQuality, hasBasement, hasMonumentProtection, energyConsumption, heating, heatingStuff
  • Industry: heating, heatingStuff, lastModernizationYear, interiorQuality, energyConsumption
  • HouseType: completionState, energyStandard
  • Misc: lastModernizationYear, hasMonumentProtection, hasBasement, heating, heatingStuff, energyConsumption, interiorQuality
  • Investment: lastModernizationYear, hasMonumentProtection, heating, heatingStuff, energyConsumption, interiorQuality
  • Waz: heatingStuff, parkingType, noParking, hasGuestToilet, hasBasement, energyConsumption, barrierFree

28.11.2007 Version 1.9

• Bugfix: gender Attribut in WAZ
  Nur für Frauen verfügbar gemacht.
• Bugfix: Sortierung Ergebnisliste nach Adresscity
  Sortierung der Ergebnisliste repariert, so dass nach Adresscity sortiert werden kann.
• Bugfix: Fehlendes API-Mapping für Site buildingType
  general-1.0.xsd: In simpleType "SiteBuildObjectType" wurden folgende Werte korrigiert:"Buero" zu "Büro", "Doppelhaus" zu "Doppelhaushälfte", "Einzelhandel-klein" zu "Einzelhandel - klein", "Einzelhandel-gross" zu "Einzelhandel - groß", "keineBebauung" zu "Keine Bebauung".
• Bugfix: API: buildObject im SiteExpose wird nie befüllt
  expose-1.0.xsd: Das Attribut "buildObject" im SiteExpose wird jetzt korrekt befüllt.
• Bugfix: WazProxy erbt von GISProxy und nicht von Proxy
  Result-1.0.xsd: Der complexType "WazProxy" erbt jetzt von "GISProxy" anstelle von "Proxy"
• Bugfix: Das Attribut "logderFlat" (Einliegerwohnung) korrigiert in "lodgerFlat"
  expose-1.0.xsd: Im complexType "HouseBuy"
• Neues Kartenmaterial (Exposékarte)
  Wir haben auf Microsoft-Karten umgestellt. Die bisher über die API ausgelieferten statischen Karten wurden mit MS Mappointkarten ersetzt, an den Aufruf hat sich nichts geändert, wenn Sie den Kartenaufruf verwenden, müssen Sie also nichts anpassen.

02.08.2006 Version 1.8

• Geodaten-Update seit 02.08.2006 online
  Die Geodaten, womit bei ImmobilienScout24 eingestellten Objekten geokodiert werden, wurden ergänzt/geändert. Das erste GIS-Update enthält Änderungen für 24 Städten/Gemeinden. Auch die per API aufgerufenen Objekte sind davon betroffen.
  Klicken Sie hier um die pdf-Datei mit allen Änderungen aufzurufen. Stadtteile/Ortsteile, die mit dem Update gelöscht wurden, stehen auch per API nicht mehr zur Verfügung.
• Das "ResultLine" Element hat jetzt ein optionales Attribute "distance" bekommen
  Double, in Kilometer, dass befüllt wird sobald man eine Query mit TargetAddress an die API schickt.
  Vorher gab es nur die Möglichkeit, die Ergebnisse nach der Distanz zu sortieren (über Sorting name="Distance"). Nun wurde die ResultLine um ein optionales Attribut "distance" erweitert, in dem die Entfernung in km übermittelt wird, sofern die Query eine TargetAddress enthält.
• Die Originalbilder werden nicht ausgeliefert (API ExposeRequest PictureURL)PictureType = Original. Aus betrieblicher Sicht können wir die Abfrage der Originalbilder nicht zur Verfügung stellen.
• GeoHierarchyElemente in der GISAddress sind jetzt optional
  Falls die Adresse als TargetAddress einer Umkreissuche benutzt wird.
• Die Objektattribute petAllowed und hasElevator werden ausgeliefert
  Die Attribute erscheinen nur dann, wenn im Web die entsprechenden Attribute einer Immobilie auch gesetzt wurden.

26.04.2006 Version 1.7

• Sortierung nach API-Suchfeldern nun möglich
• Sortierung nach "Marketingprice" möglich
• Objektzahlen auf Ebene Stadt/Kreis werden angezeigt
  Erweiterung des RegionsRequest, CitiesRequest und QuartersRequests zur Berechnung von Statistiken für Immobilien-Typen. Das heisst, die Objektzahlen des Anbieters oder der Börse werden auf Bundesland, Stadt/Kreis und Stadtteil/Ort angezeigt, nicht aber auf Bundesebene
• Wenn eine Session mit einem Anbieter (Scout-Kunden-ID) geöffnet wird, erfolgen die Queries jetzt in der View "HP" (d.h. alle Homepage-aktiven Objekte)
  Der Anbieter sollte bei der Objektveröffentlichung den Wert "Homepage" setzen, wenn die Objekte per API aufrufbar sein sollen.
• Wenn eine Session mit einer Börse (GRID) geöffnet wird, erfolgen die Queries jetzt in der View "MGM" (d.h. alle Objekte, die in der jeweiligen Anbietergruppe aktiv sind)
  Der Anbieter sollte das Objekt auf der gewünschte Börse veröffentlichen, wenn das Objekt per API für die gewünschte Börse aufrufbar sein soll. Es werden alle Börsen, bei der der Anbieter angemeldet ist, bei der Objektveröffentlichung angezeigt.
• "kaution" und "availableDate" sind jetzt vom Typ string. Betrifft alle Immobilientypen.
• "quarterId" wird jetzt im Proxy gesetzt
• "houseNo" in ContactAddress wird nun korrekt befüllt
  Es wurde folgender Fehler behoben: die Hausnummer wurde bei den Anbieterkontaktdaten nicht übergeben.
• "geoCode" wurde als deprecated gesetzt

09.11.2005 Version 1.5

• SOAP-Abfrage rausgenommen, da noch nicht freigegeben.
• Neue xsd-Dateien in Zip-Datei

19.10.2005 Version 1.4

• Korrektur: "xml-status" heisst nun "xmlhttp-status"
• Korrektur in Beschreibung ExposeRequest pictureType
• Korrektur: API-PageBug gefixed

12.10.2005 Version 1.3

Es darf nur noch maximal ein vendorid oder eine Börsen-ID angegeben werden (CreateSessionRequest)

07.10.2005 Version 1.2

• PingSessionRequest hinzugefügt
• ExposeRequest akzeptiert nun auch "vendor" und "foreign key"

22.09.2005 Version 1.1

Errorcodes hinzugefügt

08.09.2005 Version 1.0

CreateSessionRequest, accessKey ist Pflicht