Локации#
Типы для работы с географическими точками (аэропорты, города).
Location#
Географическая точка — аэропорт или город.
| Поле | Тип | Обязательно | Описание |
|---|---|---|---|
code | string | Да | Код аэропорта или города (3 буквы) |
codeType | LocationCodeType | Да | Тип кода |
type | LocationType | Да | Тип локации |
Примеры#
Аэропорт Шереметьево:
1{
2 "code": "SVO",
3 "codeType": "iata",
4 "type": "airport"
5}Город Москва:
1{
2 "code": "MOW",
3 "codeType": "iata",
4 "type": "city"
5}Использование#
Используется для указания:
- Точки отправления и назначения (
origin/destination) в поиске - Пунктов пересадки (
connectionPoint) - Точек маршрута в ответах поиска (например,
departure/arrivalрейсов в/api/avia/search,/api/avia/offer_price)
Для пунктов вылета/прилета внутри сегментов бронирования и билетов (PNR, ticket-методы) используется отдельный, более простой тип — BoardOffPoint, а не Location.
LocationCodeType#
Тип кода локации.
Возможные значения#
| Значение | Описание |
|---|---|
iata | Код IATA (International Air Transport Association) |
tch | Внутренний код системы |
Примеры#
1"codeType": "iata"LocationType#
Тип географической точки.
Возможные значения#
| Значение | Описание |
|---|---|
airport | Аэропорт |
city | Город |
Примеры#
1"type": "airport"Особенности использования#
- При указании
cityпоиск выполняется по всем аэропортам этого города - При указании
airportпоиск выполняется только для конкретного аэропорта - Для Москвы:
MOW(city) включает SVO, DME, VKO, ZIA
BoardOffPoint#
Точка вылета или прилета рейса внутри сегмента бронирования или билета. Проще, чем Location: не содержит типа и схемы кода локации, зато включает дату/время и терминал.
| Поле | Тип | Обязательно | Описание |
|---|---|---|---|
airport | string | Да | Код аэропорта (IATA) |
dateTime | datetime | Да | Дата и время вылета/прилета (ISO 8601) |
terminal | string | Нет | Терминал |
Примеры#
1{
2 "airport": "SVO",
3 "dateTime": "2025-11-22T07:40:00",
4 "terminal": "D"
5}Использование#
Используется как origin/destination внутри сегментов маршрута — например, itinerary[].segments[].origin/.destination в ответе /api/avia/pnr_retrieve, flight.origin/flight.destination в ответах ticket-методов (ticket-exchange-calculation и др.). В параметрах поиска не используется — там применяется Location.