Directory Hierarchy#

Required roles: AIS Charts API, AIS Charts Data via Cloud — Roles
Base endpoint: https://ais-charts-api.ibosoft.net.tr:2087
Reference documents: ICAO Doc 10066 PANS-AIM, Ed. 1, Amend. 3 (28/11/24) · ICAO Doc 8126 Aeronautical Information Services Manual, Ed. 7, Amend. 1 (30/07/24)
Attribution: show ibonav.aero wherever this data is displayed
Data sources: see the ibonav.aero User Guide; the source of each coverage is given in Coverage Match List
Last updated: 18 OCT 2026

About the reference documents: Related Documents and Resources
Depending on your use, the original data sources may also need to be credited.

How the folders of the AIS Charts API are arranged. The AIP coverages follow the structure of the AIP in PANS-AIM (Appendix 2, Contents of the AIP) and Doc 8126; the other sources keep a simpler coverage / version / folder layout.

{root directory}/{coverage}/…

The root directories and coverage folders are listed in API Usage and Coverage Match List.

AIP coverages#

Root directory aip-charts. The geolocation root directories follow the same layout (Geo Server › Chart Geolocation).

The hierarchy is planned to follow the AIP structure of PANS-AIM and, at the same time, to take in the non-standard practices of the various States (section numbers, section titles, extra parts, publication habits).

aip-charts/
└── {coverage}/                         e.g. IBOSOFT-LT, PAMS-LT
    ├── airac/                          content published by AIRAC cycle
    │   └── {AIRAC cycle}/              e.g. 2610 - Eff 01-OCT-2026, WEF 01-OCT-26
    │       ├── Part 1 - General (GEN)/
    │       ├── Part 2 - En-route (ENR)/
    │       ├── Part 3 - Aerodromes (AD0-AD1)/
    │       ├── Charts - AD2 Aerodromes/
    │       │   └── {aerodrome}/        one folder per aerodrome
    │       ├── Charts - AD3 Heliports/
    │       │   └── {heliport}/         one folder per heliport
    │       ├── Obstacle Data Sets/
    │       │   ├── En-route/
    │       │   └── {aerodrome}/
    │       └── Other Documents/        AIRAC content that fits none of the folders above
    └── non-airac/                      content not tied to an AIRAC cycle
        ├── Aeronautical Information Circulars (AIC)…/
        ├── AIP Amendments (AMDT)…/
        ├── AIP Supplements (SUP)…/
        └── Other Documents…/

The AIP and its folders#

A section folder exists only when the source has content for it; depending on the source, some section folders of a cycle can be missing.

For the standard AIP sections (GEN 0–4, ENR 0–6, AD 0–3, AD 2.1–2.24, AD 3.1–3.23), see PANS-AIM, Appendix 2 (Contents of the AIP).

Section names and numbers are those of the source, not of PANS-AIM. Files keep the section numbers and titles the publishing State uses; where a State departs from the standard numbering or titles, the files follow the State.

Non-standard parts: some States have main sections outside the standard, such as an AD 4. Depending on the producer of the coverage, such content is distributed to the AD 2 / AD 3 folders of the aerodromes it concerns; where distributing is impractical, it goes to Other Documents/. Take care with the coverages of these States: an expected document may sit in another folder than in the standard.

Aerodrome / heliport folders

• Folder name: starts with the aerodrome identifier: its ICAO location indicator, or an AIXM identifier of up to 6 characters when it has none (LT1401). Ibosoft coverages add IATA code, city and name (LTAC - ESB - ANKARA - Esenboğa); PAMS coverages use the identifier only (LTAC).
• File name: {identifier} - {chart type} - {title}, e.g. LTAC - ADC - Aerodrome Chart. The chart type part (ADC, SID, STAR, IAC …) is matched by the chartLabels of get-shared-config.

AIRAC cycle folders#

Information that changes on AIRAC dates (PANS-AIM; Doc 8126) is grouped by cycle; each cycle folder holds the complete AIP valid from that date.

Sort by effective date, not by name: WEF names do not sort in date order. Older cycles of a coverage may use earlier folder names (e.g. AD2 Aerodromes/ instead of Charts - AD2 Aerodromes/); the section patterns in get-shared-config (aip.sectionPatterns) recognise both.

Non-AIRAC folders#

AIRAC AMDT and AIRAC SUP are also placed here, not in the AIRAC cycle folders: several States publish AIRAC and non-AIRAC amendments and supplements in the same way, so the two cannot always be told apart.

Folder names may carry the date of the last update (AIP Supplements (SUP) - Last Uptd 02-OCT-2026); recognise them by their beginning (aip.nonAiracPatterns: AIC, AMDT, SUP). Some coverages have additional folders.

Other coverages#

Root directory other-charts. The geolocation root directories follow the same layout (Geo Server › Chart Geolocation). There is no AIP structure here; each source keeps its own folders below a version level.

other-charts/
└── {coverage}/                          e.g. US-TPP-…, FLIP-CENOR-…
    └── {version}/                       e.g. 2610 - (WEF 01-OCT-2026 TIL 29-OCT-2026)
        └── {section / aerodrome}/       e.g. KJFK - JFK - JOHN F KENNEDY INTL
            └── [{subfolders}/]          optional, any depth
                └── {file}

Version folders#

The current version is the latest one whose validity has started; skip (Next) versions unless you want the coming edition.

Section / aerodrome folders#

The first folder below the version depends on the source:

Below it, further subfolders may follow (e.g. historical chart sets); list them with get-directory-index or read all files at once with get-file-index. File names are the chart or document titles (APD - AIRPORT DIAGRAM, AERODROME CHART).