Локации#

Типы для работы с географическими точками (аэропорты, города).


Location#

Географическая точка — аэропорт или город.

ПолеТипОбязательноОписание
codestringДаКод аэропорта или города (3 буквы)
codeTypeLocationCodeTypeДаТип кода
typeLocationTypeДаТип локации

Примеры#

Аэропорт Шереметьево:

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: не содержит типа и схемы кода локации, зато включает дату/время и терминал.

ПолеТипОбязательноОписание
airportstringДаКод аэропорта (IATA)
dateTimedatetimeДаДата и время вылета/прилета (ISO 8601)
terminalstringНетТерминал

Примеры#

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.