User Tools

Site Tools


data:request:regions

Inquiry: regions

Descriptions

File with the list of regions is always available at: https://mdswsdata.merlinx.eu/mdsws/regions.zip It contains two types of data, a list of countries and regions (the type of value is controlled 3rd field), the regions with the same numbers can be repeated, the first value is always that we use in our system, all others are variations of the name of the region that have come from tour-operators and were joined. In addition, filtered list is generated with utf-8 encoding https://mdswsdata.merlinx.eu/mdsws/regions_utf8.zip: it includes regions that have occurred in the data up to 7 days back. Relationship between country and its regions can be downloaded from the address https://mdswsdata.merlinx.eu/mdsws//regions_tree_utf8.zip

Inquiry

Field nametypecontains
obj_xCityIdtextThe city in which the object is assigned by MerlinX (original or revised)
external_search_idtextexternal search id
excludeFromRulestextrule name
wtr_tnintsearch by forecast tennis score (1-10)
wtr_biintsearch by forecast biking activities score (1-10)
wtr_cintsearch by forecast camping activities score (1-10)
wtr_uvintsearch by UV index
wtr_sdintsearch by sun hours duration
wtr_pintsearch by forecast precipitation (mm)
wtr_wkintsearch by forecast walking activities score (1-10)
wtr_tintsearch by forecast temperature ( in degrees Celsius )
obj_luggagecharMain baggage is included or not
geo_xPolygonintSearch in polygon described by at least 3 pairs of lat,long
trp_flightChangeCountintNumber of stops for ongoing flight
geo_xCircleintSearch in max radius='dstance' (in kilometers) from lat,long
rFlightChangeCountintNumber of stops for return flight
obj_zScoreintsearch based of Zoover rating
obj_xDistSkiintDistance from ski lift
obj_zScoreCntintsearch based of amount of Zoover opinions
wtr_pcintsearch by forecast precipitation chance (%)
ofr_candybitmaskCandy (bonus)
obj_xServiceIdintID meal/service assigned by MerlinX
obj_categoryintCategory of the object multiplied by 10
useMerlinMarginboolreturns price with agency margin
par_chdintNumber of children
ofr_catalogcharCatalog code
trp_rDepCodechardeparture code of the return place
ofr_transferTypecharTransfer included or not
totalPriceboolreturns the total price for the asked product
obj_xAttributesbitmaskObject's attributes / flag offer
obj_roomcharRoom code/ accommodation
obj_xDistBeachintDistance from beach
minPriceintminimum price per adult
obj_xNametextObject's name that is assigned by MerlinX (original or revised)
includeFromRulestextrule name
ofr_xCatalogcharcatalogs unified by MerlinX
ofr_tourOpchartouroperator code
trp_durationintnumber of days
wtr_bintsearch by forecast beach activities score (1-10)
trp_skiDestinationintDestination regions for ski.
ofr_typecharType of offer
obj_xAttributesCountintMinimum number of required attributes that match the offer
trp_rDesCodechardestination code of the return trip
trp_depDatedateDate of departure / departure / start of trip
trp_durationMintnumber of days
trp_depNametextplace of departure / start
obj_bookBedsboolIf reservation on individual beds is possible
obj_xAttributesNotInbitmaskObject's attributes / flag offer
par_infintnumber of infants
trp_destinationintRegion of the trip/event
wtr_wtintsearch by forecast water sports activities score (1-10)
obj_xCodeintID assigned to the hotel by MerlinX
par_adtintnumber of adults
obj_typecharObject type (hotel/round trip/cruise /...)
obj_nametextThe name of the object (the hotel / cruise / circuit / package)
obj_xRoomDescCountintMinimum number of required Room description that match the offer
obj_codecharhotel code
ofr_xStatuscharoffer availability
obj_codeNameFtstextEnabling search of offers based by string name of the hotel
obj_xCityFtstextString allows searching offers by town name
obj_xRoomDesccharRoom description processed by MerlinX
trp_retDatedatepossible late date of the return trip
maxPriceintmaximum price for an adult
wtr_trintsearch by forecast terrace activities score (1-10)
par_chdAgetextage of children or children bitrh dates
ofr_refundablecharOffer have some flex rules or not
ofr_residentcharResident is available or not
<?xml version='1.0'?>
<mds>
    <auth>
        <login>login</login>
        <pass>pass</pass>
    </auth>
   <request>
     <type>regions</type>
     <conditions>
       <par_adt>2</par_adt>     
       <ofr_tourOp>ITAK</ofr_tourOp>
       <trp_depDate>20101020:20101124</trp_depDate>
       <obj_codeNameFts>Resort</obj_codeNameFts>
     </conditions>
   </request>
</mds>

Answer

Field nametypecontains
reg_idcharregion ID {country}_{region}
reg_priceintlowest offer for the region
trp_destinationintRegion of the trip/event
<response>
  <reg id="38_57" price="1349"/>
  <reg id="11_154" price="1494"/>
  <reg id="11_203" price="1739"/>
  <reg id="11_2323" price="1849"/>
  <reg id="6_17" price="2319"/>
  <reg id="15_50" price="3110"/>
  <reg id="243_2541" price="3539"/>
  <reg id="36_4105" price="3880"/>
  <reg id="19_4191" price="3899"/>
  <reg id="19_116" price="3949"/>
  <reg id="36_4104" price="4289"/>
  <reg id="49_2503" price="6380"/>
  <reg id="49_1316" price="6880"/>
  <reg id="413_20" price="6989"/>
</response>
data/request/regions.txt · Last modified: 2023/07/18 15:08 by Maciej Pokrzywa