A utility that converts AIXM format into GeoJSON for Node. This tool is intended to work with the AIXM format
AIXM format. Currently, the logic only
supports reading airspace AIXM definitions.
Internally, the logic uses parts of our OpenAIR Parser to also validate the given AIXM definitions.
Reads AIXM airspace definition. Outputs a GeoJSON FeatureCollection with the following JSON schema:
{
"$schema": "https://json-schema.org/draft/2020-12/schema",
"$id": "https://adhoc-schemas.openaip.net/schemas/parsed-aixm-airspace.json",
"description": "JSON Schema for the GeoJSON FeatureCollection returned by this converter.",
"type": "object",
"properties": {
"type": {
"type": "string",
"enum": [
"FeatureCollection"
],
"description": "A GeoJSON FeatureCollection object that contains all airspace features."
},
"features": {
"type": "array",
"items": {
"allOf": [
{
"type": "object",
"properties": {
"type": {
"type": "string",
"enum": [
"Feature"
]
},
"properties": {
"type": "object",
"properties": {
"name": {
"type": "string",
"description": "The airspace's name."
},
"type": {
"type": "string",
"enum": [
"CTA",
"TMA",
"CTR",
"ATZ",
"DANGER",
"PROHIBITED",
"RESTRICTED",
"WARNING",
"AERIAL_SPORTING_RECREATIONAL",
"RMZ",
"TMZ",
"MATZ",
"GLIDING_SECTOR"
],
"description": "The airspace's type."
},
"class": {
"type": "string",
"enum": [
"A",
"B",
"C",
"D",
"E",
"F",
"G",
"UNCLASSIFIED"
],
"description": "The airspace's class."
},
"activity": {
"type": "string",
"enum": [
"NONE",
"PARACHUTING",
"AEROBATICS",
"AEROCLUB_AERIAL_WORK",
"ULM",
"HANG_GLIDING"
],
"description": "Property that adds metadata about specific type of arial/sporting areas. Is 'NONE' by default."
},
"upperCeiling": {
"$ref": "#/definitions/verticalLimit"
},
"lowerCeiling": {
"$ref": "#/definitions/verticalLimit"
},
"activatedByNotam": { "type": "boolean", "description": "If true, the airspace is activated by a NOTAM." },
"groundService": {
"type": "object",
"properties": {
"callsign": { "type": "string" , "example": "ABERDEEN APPROACH"},
"frequency": { "type": "string", "example": "118.000" }
},
"description": "The ground service callsign and frequency if available.",
"required": [
"callsign",
"frequency"
],
"additionalProperties": false
},
"remarks": {
"type": "string",
"description": "A remarks field. If available, this will contain content of the parsed 'rules' list to add more metadata on the airspace."
}
},
"required": [
"name",
"type",
"class",
"upperCeiling",
"lowerCeiling",
"activatedByNotam",
"activity"
],
"additionalProperties": false
},
"geometry": {
"type": "object",
"properties": {
"type": {
"type": "string",
"enum": [
"Polygon"
]
},
"coordinates": {
"type": "array",
"items": {
"type": "array",
"items": {
"type": "array",
"items": false,
"prefixItems": [
{
"type": "number",
"minimum": -180,
"maximum": 180
},
{
"type": "number",
"minimum": -90,
"maximum": 90
}
],
"minItems": 2,
"maxItems": 2
},
"minItems": 4
},
"minItems": 1,
"maxItems": 1
}
},
"required": [
"type",
"coordinates"
],
"additionalProperties": false,
"example": {
"type": "Polygon",
"coordinates": [
[
[
9.1234,
45.42432
],
[
10.1234,
45.42432
],
[
10.1234,
47.42432
],
[
9.1234,
45.42432
]
]
]
}
}
},
"required": [
"type",
"properties",
"geometry"
],
"additionalProperties": false
}
]
}
}
},
"required": [
"type",
"features"
],
"additionalProperties": false,
"definitions": {
"verticalLimit": {
"type": "object",
"properties": {
"value": {
"type": "integer"
},
"unit": {
"type": "string",
"enum": [
"FT",
"FL"
]
},
"referenceDatum": {
"type": "string",
"enum": [
"GND",
"STD",
"MSL"
]
}
},
"required": [
"value",
"unit",
"referenceDatum"
],
"description": "Defines an airspace vertical limit. The vertical limit is a combination of an integer value, a measurement unit and a reference datum.",
"additionalProperties": false
}
}
}npm install -g @openaip/aixm-to-geojsonconst { AixmConverter } = require('@openaip/aixm-to-geojson');
const inputFilePath = './path/to/input-aixm-file.txt';
const converter = new AixmConverter({ fixGeometries: true, strictSchemaValidation: true });
// or alternatively call "convertFromBuffer" to read from Buffer
await converter.convertFromFile(inputFilepath, { type: 'airspace' });
const geojson = converter.toGeojson();node cli.js -h
Usage: cli [options]
Options:
-f, --input-filepath <inputFilepath> The input file path to the AIXM file.
-o, --output-filepath <outputFilepath> The output filename of the generated GeoJSON file.
-T, --type The type to read from AIXM file. Currently only "airspace" is supported. (default: "airspace")
-V, --validate If specified, converter will validate geometries.
-F, --fix-geometry If specified, converter will try to fix geometries.
-S, --strict-schema-validation If specified, converter will strictly validate the created GeoJSON against the underlying schema. If the GeoJSON does not match the JSON schema, the converter will throw an error.
-h, --help Outputs usage information.Simple command line usage:
node cli.js --type=airspace -f ./path/to/input-aixm-file.txt -o ./path/to/output-geojson-file.geojson