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