GeographicDestinationTree
Method Goals
This method returns the supplier’s geographic tree where each node indicates whether the request is accessible from availability, indicated with a parameter with values true or false. The main difference between the methods GeographicalTree and DestinationTree is that GeographicalTree has this boolean parameter.
Request Format
The request not requires any element, it is empty.
Response Format
The result returns a list of DestinationTree with corresponding sub-destinations.
Remarks
The maximum time permitted in our system before the connection is closed is 240000 milliseconds.
GeographicDestinationTreeRQ Example
In the request of this call it is only necessary to use the object: “HotelBaseRQ”. You can find the info in the ‘Common Elements’ section.
<GeographicDestinationTreeRQ>
</GeographicDestinationTreeRQ>
Important information about Number (Cardinal):
Go to Common-Elements for more information.
GeographicDestinationTreeRQ Description
Element | Number | Type | Description |
---|---|---|---|
GeographicDestinationTreeRQ | 1 | Root node. |
GeographicDestinationTreeRS Example
<GeographicDestinationTreeRS>
<UpgradeUTCDate>2016-10-18T13:18:03+02:00</UpgradeUTCDate>
<DestinationTree code = "ES" name = "España" avail = "false">
<DestinationLeaf code = "BAL"/>
<DestinationLeaf code = "AST"/>
<DestinationLeaf code = "AND"/>
</DestinationTree>
<DestinationTree code= "IT" name = "Italia" avail = "false">
<DestinationLeaf code = "AA"/>
<DestinationLeaf code = "BB"/>
. . .
</DestinationTree>
<DestinationTree code = "EN" name = "England" avail = "false">. . .</DestinationTree>
<DestinationTree code = "BAL" name = "Baleares" avail = "true">
<DestinationLeaf code = "PAL0"/>
<DestinationLeaf code = "ALC0"/>
</DestinationTree>
<DestinationTree code = "AST" name = "Asturias" avail = "true"/>
<DestinationTree code = "AND" name = "Andalucia" avail = "true"/>
. . .
<DestinationTree code = "PAL0" name = "Palma de Mallorca" avail = " true"/>
<DestinationTree code = "ALC0" name = "Alcudia" avail = "true"/>
. . .
</GeographicDestinationTreeRS>
GeographicDestinationTreeRS Description
Element | Number | Type | Description |
---|---|---|---|
GeographicDestinationTreeRS | 1 | Root node. | |
UpgradeUTCDate | 1 | DateTime | Indicates the update date of the information in UTC format. |
DestinationTree / | 1..n | Father node. | |
@code | 1 | String | |
@name | 1 | String | |
@avail | 1 | Boolean | |
DestinationTree /DestinationLeaf | 0..n | Childs node. | |
@code | 1 | String |
Detailed description
<GeographicDestinationTreeRS>
<DestinationTree code = "ES" name = "España" avail = "false">
<DestinationLeaf code = "BAL"/>
<DestinationLeaf code = "AST"/>
<DestinationLeaf code = "AND"/>
</DestinationTree>
<DestinationTree code= "IT" name = "Italia" avail = "false">
<DestinationLeaf code = "AA"/>
<DestinationLeaf code = "BB"/>
. . .
</DestinationTree>
<DestinationTree code = "EN" name = "England" avail = "false">. . .</DestinationTree>
<DestinationTree code = "BAL" name = "Baleares" avail = "true">
<DestinationLeaf code = "PAL0"/>
<DestinationLeaf code = "ALC0"/>
</DestinationTree>
<DestinationTree code = "PAL0" name = "Palma de Mallorca" avail = "true"/>
<DestinationLeaf code = "SAR"/>
<DestinationLeaf code = "IND"/>
<DestinationTree code = "AST" name = "Asturias" avail = "true"/>
<DestinationTree code = "AND" name = "Andalucia" avail = "true"/>
. . .
<DestinationTree code = "ALC0" name = "Alcudia" avail = "true"/>
<DestinationTree code = "SAR" name = "Son Sardina" avail = "false"/>
<DestinationTree code = "IND" name = "Indioteria" avail = "false"/>
. . .
</GeographicDestinationTreeRS>
There are two essential definitions which need to be clear in order to understand the difference between city and zone:
- types of nodes
- if these nodes are accessible or not.
Let’s start with the two types of nodes. There are two types of nodes: the parent node, also called DestinationTree node, and the child node, also named Destination leaf node. A parent can have zero to n children ( 0..n ) and a child can only one parent ( 1..1 ). For example, the DestinationTree code = “ES” is the parent of the DestinationLeaf code = “BAL”, “AST” and “AND” and at the same time DestinationTree code = “BAL” is also a the parent of the DestinationLeaf code = “PAL0” and “ALC0”, and so on.
Accessible on an availability level means that it is possible to perform an availability for that zone. A node is accessible when the tag avail is set to true. If it is set to false the node is not accessible and consequently, not available.
Therefore:
- City: Lowest accessible node.
- Zone: Not the lowest accessible node.
Note: In rare occasions, it is possible to find nodes lower than cities, which won’t be accessible, but the standard scenario is not to find lower nodes than cities.