# Transportation objects

You can define ways to travel to a property from the airport inside a `Transportations` element. This page describes the elements and attributes in the `Transportations` descendants tree.

## Related calls

* [OTA_HotelDescriptiveContentNotif][ota-hoteldescriptivecontentnotif] – Set a property's details.
* [OTA_HotelDescriptiveInfo][ota-hoteldescriptiveinfo] – Retrieve a property's details.

## Sample XML

The sample below is an excerpt and not a valid XML document.

```xml
<Transportations>
   <Transportation>
     <TPA_Extensions>
       <Route>
         <Leg>
           <Start Type='airport' Code='AMS' />
           <TransportType Code='5000' />
           <Departure UponArrangement='1' />
         </Leg>
         <JourneyTime Minutes='20' />
         <Price Amount='10' CurrencyCode='EUR' />
       </Route>
     </TPA_Extensions>
   </Transportation>
   <Transportation>
     <TPA_Extensions>
       <Route>
         <Leg>
           <Start Type='airport' Code='AMS' />
           <TransportType Code='3' />
           <Line Name='10'/>
           <Departure Interval='20' />
         </Leg>
         <JourneyTime Minutes='20' />
         <Price Amount='5.5' CurrencyCode='EUR' />
       </Route>
     </TPA_Extensions>
   </Transportation>
   <Transportation>
     <TPA_Extensions>
       <Route>
         <Leg>
           <Start Type='airport' Code='AMS' />
           <TransportType Code='5' />
           <Motorway Name='A2'/>
           <Junction Name='Amsterdam Zuid' />
         </Leg>
         <JourneyTime Minutes='30' />
       </Route>
     </TPA_Extensions>
   </Transportation>
</Transportations>
```

## Transportation

Contains details of a transportation method/route from an airport to the property. Child of `Transportations` (see [Sample XML][sample-xml]).

| Field | Description  | Type | Required | Notes  |
|---------|--------------|------|----------|--------|
| `TPA_Extensions` | - | array of [Route] | Optional | - |

## Route

Contains price, journey time, and leg details for a travel route to the property. Child of `TPA_Extensions` (see [Transportation]).

| Field | Description  | Type | Required | Notes  |
|---------|--------------|------|----------|--------|
| `Leg` | See [Leg]. | object | Required | A `Route` parent must have only one `Leg` child. |
| `JourneyTime` | - | object | Required | - |
| `JourneyTime[@Minutes]` | Approximate journey time, in minutes. | integer | Required | - |
| `Price` | - | object | Optional | - |
| `Price[@Amount]` | The estimated price of the journey leg. | real | Optional | Indicate currency with `[@CurrencyCode]`. |
| `Price[@CurrencyCode]` | The [ISO 4217 currency code][iso-4217]. | string | Optional | - |

## Leg

Contains start location, motorways to take, and other details of a travel route leg. Child of [Route].

| Field | Description  | Type | Required | Notes  |
|---------|--------------|------|----------|--------|
| `Start` | - | object | Required | - |
| `Start[@Type]` | The type of start point. Currently only accepts `airport`. | enum | Required | Accepted values: `airport`. |
| `Start[@Code]` | The [3-letter IATA code][iata-code] of the airport that serves as the leg's start location. | string | Required | - |
| `TransportType` | - | object | Required | - |
| `TransportType[@Code]` | The [Transportation Code][codes-trp] for the leg's transportation type. | enum | Required | Accepts the values listed under [TRP][codes-trp]. |
| `Departure` | - | object | Optional | - |
| `Departure[@Interval]` | The departure interval, in minutes, if the transportation departs multiple times a day. | | Optional | - |
| `Departure[@UponArrangement]` | Indicates whether the transportation is available only by arrangement. | integer | Optional | Boolean expressed as integer. Accepts these values: `1` (true), `0` (false). |
| `Line` | - | object | Optional | - |
| `Line[@Name]` | The name or number of the line to take, if travelling by shuttle or public transport. | string | Optional | Only allowed when `TransportType[@Code]` is `3`, `10`, `18`, `22`, or `5001`. |
| `Motorway` | - | object | Optional | - |
| `Motorway[@Name]` | The name of the motorway to take, if travelling by car. | string | Optional | Only allowed when `TransportType[@Code="5"]` (car). |
| `Junction` | - | object | Optional | - |
| `Junction[@Name]` | The name of the junction/exit to take, if travelling by car. | string | Optional | `TransportType[@Code="5"]` (car). |

<!-- the - in description of some elements like Start, Transport type and Departure, Line, Motorway and Junction makes the page looks incomplete (even though it is not) -->

<!-- Links and references -->

[Transportation]: /connectivity/docs/transportation.md#transportation
[Route]: /connectivity/docs/transportation.md#route
[Leg]: /connectivity/docs/transportation.md#leg
[iso-4217]: https://en.wikipedia.org/wiki/ISO_4217#Active_codes
[iata-code]: http://www.iata.org/publications/Pages/code-search.aspx
[codes-trp]: /connectivity/docs/codes-trp.md
[sample-xml]: /connectivity/docs/transportation.md#sample-xml
[ota-hoteldescriptivecontentnotif]: /connectivity/docs/ota-hoteldescriptivecontentnotif.md
[ota-hoteldescriptiveinfo]: /connectivity/docs/ota-hoteldescriptiveinfo.md