# Радионавигационные средства Поиск радионавигационных средств (VOR, NDB, ILS, DME, TACAN) по идентификатору, аэропорту, типу, стране или bounding box с координатами для карт. Поиск по инфраструктуре радионавигации — **[VOR](https://en.wikipedia.org/wiki/VHF_omnidirectional_range)** (всенаправленный азимутальный радиомаяк ОВЧ-диапазона, основное радионавигационное средство на маршруте), **[NDB](https://en.wikipedia.org/wiki/Non-directional_beacon)** (ненаправленный радиомаяк), **[ILS](https://en.wikipedia.org/wiki/Instrument_landing_system)** (система посадки по приборам), **[DME](https://en.wikipedia.org/wiki/Distance_measuring_equipment)** (дальномерное оборудование), **[TACAN](https://en.wikipedia.org/wiki/Tactical_air_navigation_system)** (тактическая аэронавигационная система) и комбинированные объекты, такие как **[VORTAC](https://en.wikipedia.org/wiki/VORTAC)** (совмещённые [VOR](https://en.wikipedia.org/wiki/VHF_omnidirectional_range) и [TACAN](https://en.wikipedia.org/wiki/Tactical_air_navigation_system)). Используйте этот эндпоинт для наложения маршрутов, панелей с контекстом захода на посадку или слоёв карты, где нужны радионавигационные средства сверх того набора, который встроен в [Аэропорты](/docs/v31/airports). Требуется хотя бы один фильтр (`ident`, `airport`, `type`, `country` или `bbox`). Глобальная выгрузка без фильтров заблокирована. ## Запрос [#request] | Параметр | Тип | Обязательный | По умолчанию | Описание | | --------- | ------- | ------------------------- | ------------ | ----------------------------------------------------------------------------------------------------------------------------------------------- | | `ident` | string | Нужен хотя бы один фильтр | - | Идентификатор радионавигационного средства, например `JFK` | | `airport` | string | Нужен хотя бы один фильтр | - | Код аэропорта ICAO для связанных радионавигационных средств | | `type` | string | Нужен хотя бы один фильтр | - | Тип радионавигационного средства, например `VOR`, `NDB`, `VORTAC`, `ILS`, `DME` | | `country` | string | Нужен хотя бы один фильтр | - | Код страны ISO 3166-1 alpha-2 | | `bbox` | string | Нужен хотя бы один фильтр | - | Ограничивающий прямоугольник (bounding box): `lat1,lon1,lat2,lon2` — сначала юго-западный угол, затем северо-восточный. Пример: `40,-74,41,-73` | | `limit` | integer | Нет | `100` | Максимальное число возвращаемых записей (не более `500`) | Комбинируйте фильтры (например, `country=US&type=[VOR](https://en.wikipedia.org/wiki/VHF_omnidirectional_range)`), чтобы сузить большие наборы результатов. ## Ответ [#response] ```json { "navaids": [ { "id": 89475, "ident": "JFK", "name": "Kennedy", "type": "VOR-DME", "frequency_khz": 115900.0, "latitude_deg": 40.63290023803711, "longitude_deg": -73.77140045166016, "elevation_ft": 11.0, "iso_country": "US", "dme_frequency_khz": 115900.0, "dme_channel": "106X", "slaved_variation_deg": -12.001, "magnetic_variation_deg": -13.182, "usageType": "BOTH", "power": "HIGH", "associated_airport": "KJFK" } ], "total": 1, "filters_applied": { "ident": "JFK" } } ``` ### Поля верхнего уровня [#top-level-fields] | Поле | Тип | Обязательный | Описание | | ----------------- | ------- | ------------ | ------------------------------------------------------------- | | `navaids` | array | **Да** | Найденные записи радионавигационных средств (может быть `[]`) | | `total` | integer | **Да** | Количество возвращённых записей | | `filters_applied` | object | **Да** | Повтор принятых фильтров | #### Элемент радионавигационного средства (`navaids[]`) [#navaid-item-navaids] | Поле | Тип | Обязательный | Может быть null? | Описание | | ------------------------ | -------------- | ------------ | ---------------- | -------------------------------------------------------------------------------------------------------------------- | | `id` | integer | **Да** | Никогда | Числовой идентификатор записи | | `ident` | string | **Да** | Никогда | Идентификатор радионавигационного средства | | `name` | string | **Да** | Никогда | Название радионавигационного средства | | `type` | string | **Да** | Никогда | Тип объекта (`VOR-DME`, `NDB` и т. д.) | | `frequency_khz` | number \| null | Нет | **Да** | Основная частота в кГц | | `latitude_deg` | number | **Да** | Никогда | Широта WGS-84 | | `longitude_deg` | number | **Да** | Никогда | Долгота WGS-84 | | `elevation_ft` | number \| null | Нет | **Да** | Превышение в футах над MSL | | `iso_country` | string \| null | Нет | **Да** | Код страны | | `dme_frequency_khz` | number \| null | Нет | **Да** | Частота DME, если применимо | | `dme_channel` | string \| null | Нет | **Да** | Канал DME, например `106X` | | `slaved_variation_deg` | number \| null | Нет | **Да** | Магнитное склонение, на которое выставлен радиомаяк (slaved variation) | | `magnetic_variation_deg` | number \| null | Нет | **Да** | Местное магнитное склонение (угол между истинным и магнитным севером в точке установки радионавигационного средства) | | `usageType` | string \| null | Нет | **Да** | Класс использования (например, `BOTH`) | | `power` | string \| null | Нет | **Да** | Класс мощности передатчика | | `associated_airport` | string \| null | Нет | **Да** | Код аэропорта ICAO, если средство привязано к аэропорту | `dme_frequency_khz`, `dme_channel`, `slaved_variation_deg` и `magnetic_variation_deg` в зависимости от типа объекта часто равны `null`. `associated_airport` может быть `null` для радионавигационных средств на маршруте. Рассматривайте `type` радионавигационного средства как открытую строку — не прерывайте обработку с ошибкой при неизвестных значениях. ## Клиентские типы [#client-types] ## Интеграция [#integration] Получите радионавигационные средства в районе аэропорта и верните готовые для карты объекты для наложения маршрутов. Пример ниже кэширует результаты запросов на 6 часов и использует явные таймауты, чтобы отрисовка карты не зависала из-за медленного ответа. ### Примечания по реализации [#implementation-notes] **Фильтруйте как можно раньше.** Комбинируйте фильтры `country`, `type` или `airport`, чтобы уменьшить объём ответа и не перегружать карту. **Формат BBox.** Используйте `lat1,lon1,lat2,lon2` (юго-запад → северо-восток), как в [Ветер на высотах](/docs/v31/winds-aloft), [PIREP](/docs/v31/pireps) и [AIRMET/SIGMET](/docs/v31/airsigmet), — а не `minLon,minLat,maxLon,maxLat`. **Радионавигационные средства аэропорта.** [Аэропорты](/docs/v31/airports) встраивают для каждого аэродрома лишь часть средств. Используйте этот эндпоинт для запросов по bbox, фильтров по типу и стране или наложений, выходящих за рамки запроса по одному аэропорту. ## Ответы с ошибками [#error-responses] Общие ошибки: [Обработка ошибок](/docs/errors). Ошибки, специфичные для эндпоинта: ### 400 - не передано ни одного фильтра [#400---no-filters-provided] ```json { "detail": "At least one filter is required: ident, airport, type, country, or bbox. Returning the full navaid dataset unfiltered is not supported." } ``` ### 400 - недопустимый bbox [#400---invalid-bbox] ```json { "detail": "Invalid bbox: could not convert string to float: 'bad'" } ``` ### Руководства по интеграции [#integration-guides] | Руководство | Охватывает | | ------------------------------------------------------------------------- | --------------------------------------- | | [Аэропорты](/docs/v31/airports-integration) | Поиск, частоты, сравнение ВПП | | [Поиск аэропортов](/docs/v31/airport-search-integration) | Автодополнение и поиск ближайших по GPS | | [Радионавигационные средства](/docs/v31/navaids-integration) | Наложение на карту и фильтр ILS | | [Обработка ошибок](/docs/v31/airport-data-integration-errors) | 404, пустой поиск, валидация | | [Кэширование и мониторинг](/docs/v31/airport-data-integration-production) | TTL и логирование квоты | *** См. также: [Аэропорты](/docs/v31/airports) · [Поиск аэропортов](/docs/v31/airport-search) · [Аэронавигационные карты](/docs/v31/charts)