@geoalgeria/aviation 1.0.0 → 2.0.0

package/data/metadata.json

@@ -1,8 +1,37 @@
 {
-  "source": "ANAC — Autorité Nationale de l'Aviation Civile (anac.dz)",
-  "origin": "https://www.anac.dz/en/carte-des-aeroports-3/",
-  "license": "Data © ANAC; redistributed for reference. See README.",
-  "airports": 33,
+  "package": "@geoalgeria/aviation",
+  "schema_version": "2.0.0",
+  "title_fr": "Aéroports d'Algérie",
+  "title_ar": "مطارات الجزائر",
+  "title_en": "Algeria airports",
+  "record_count": 33,
+  "geocoded_count": 33,
+  "geocoded_pct": 100,
+  "precision": {
+    "exact": 33,
+    "approximate": 0
+  },
+  "estimated_universe": null,
+  "coverage_pct": null,
+  "coverage_note": "Airports from the National Civil Aviation Authority (ANAC). Wilaya-level only (no commune linkage).",
   "wilayas_covered": 31,
-  "generated_at": "2026-06-14"
+  "bbox": [
+    -8.165434,
+    19.563939,
+    9.63789,
+    36.824416
+  ],
+  "sources": [
+    {
+      "key": "anac",
+      "name": "ANAC — Autorité Nationale de l'Aviation Civile",
+      "url": "https://www.anac.dz",
+      "license": "Factual public listing (ANAC)",
+      "retrieved": "2026-06-14",
+      "evidence_type": "official"
+    }
+  ],
+  "license": "Factual public listing (ANAC)",
+  "updated": "2026-06-14",
+  "with_iata": 0
 }

package/dataset-metadata.json

@@ -0,0 +1,50 @@
+{
+  "@context": "https://schema.org",
+  "@type": "Dataset",
+  "name": "Algeria airports",
+  "alternateName": "Aéroports d'Algérie",
+  "identifier": "@geoalgeria/aviation",
+  "description": "Airports from the National Civil Aviation Authority (ANAC). Wilaya-level only (no commune linkage).",
+  "conditionsOfAccess": "Factual public listing (ANAC)",
+  "isAccessibleForFree": true,
+  "creator": {
+    "@type": "Organization",
+    "name": "Yasser's Studio",
+    "url": "https://yasser.studio"
+  },
+  "spatialCoverage": {
+    "@type": "Place",
+    "name": "Algeria",
+    "geo": {
+      "@type": "GeoShape",
+      "box": "19.563939 -8.165434 36.824416 9.63789"
+    }
+  },
+  "variableMeasured": "33 records, 31 wilayas",
+  "distribution": [
+    {
+      "@type": "DataDownload",
+      "name": "airports (JSON)",
+      "encodingFormat": "application/json",
+      "contentUrl": "https://cdn.jsdelivr.net/npm/@geoalgeria/aviation/data/airports.json"
+    },
+    {
+      "@type": "DataDownload",
+      "name": "airports (CSV)",
+      "encodingFormat": "text/csv",
+      "contentUrl": "https://cdn.jsdelivr.net/npm/@geoalgeria/aviation/data/csv/airports.csv"
+    },
+    {
+      "@type": "DataDownload",
+      "name": "airports (GeoJSON)",
+      "encodingFormat": "application/geo+json",
+      "contentUrl": "https://cdn.jsdelivr.net/npm/@geoalgeria/aviation/data/geojson/airports.geojson"
+    }
+  ],
+  "dateModified": "2026-06-14",
+  "url": "https://geoalgeria.com",
+  "sameAs": "https://github.com/yasserstudio/geoalgeria",
+  "citation": [
+    "ANAC — Autorité Nationale de l'Aviation Civile — Factual public listing (ANAC)"
+  ]
+}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@geoalgeria/aviation",
-  "version": "1.0.0",
+  "version": "2.0.0",
   "type": "module",
   "description": "Algeria's 33 civil airports — official names, ICAO (OACI) codes, addresses, phones, websites, coordinates, and wilaya linkage. Sourced from ANAC (anac.dz). JSON, CSV, GeoJSON, TypeScript.",
   "main": "index.js",
@@ -13,7 +13,10 @@
     "./data/*": "./data/*"
   },
   "files": [
+    "dataset-metadata.json",
     "data/**/*.json",
+    "data/**/*.csv",
+    "data/**/*.geojson",
     "types/",
     "index.js"
   ],

package/types/index.d.ts

@@ -1,44 +1,99 @@
+// Type definitions for @geoalgeria/aviation (schema v2).
+// Civil airports of Algeria — the National Civil Aviation Authority (ANAC)
+// listing, geocoded from ANAC's own published coordinates.
+
+/** Coordinate provenance, coarse-grained. Detail lives in `geo_method`.
+ *  `null` when the record has no coordinate at all. */
+export type GeoPrecision = "exact" | "approximate" | null;
+
+/** How the coordinate was obtained — always ANAC's own published point. */
+export type GeoMethod = "source_point";
+
+/** External identifiers keyed by source system. */
+export interface Refs {
+  /** ICAO (OACI) code, duplicated from the top-level `icao` field. */
+  icao: string;
+}
+
 /** A civil airport, as published by ANAC. */
 export interface Airport {
-  /** Stable id — the ICAO code, lowercased (e.g. `"daag"`). */
+  /** Stable id — the ICAO code, lowercased (e.g. "daad"). */
   id: string;
-  /** Official airport name in French (e.g. `"Aéroport d'Alger – Houari Boumediene"`). */
+  /** Official airport name in French. */
   name: string;
-  /** ICAO (OACI) code — always matches `/^DA[A-Z]{2}$/` (e.g. `"DAAG"`). */
-  icao: string;
-  /** IATA code — not published by ANAC; always `null` (reserved for later enrichment). */
-  iata: string | null;
-  /** Postal address as listed by ANAC, or `null` if none is given. */
-  address: string | null;
-  /** Contact phone, or `null` if none is given. */
-  phone: string | null;
-  /** Official website URL, or `null` if none is given. */
-  website: string | null;
-  /** Wilaya code, zero-padded to 2 digits (`"01"`–`"69"`). Joins `geoalgeria` wilayas. */
+  /** Wilaya code, zero-padded 2-digit string ("01".."69"). */
   wilaya_code: string;
-  /** Latitude (WGS84). */
+  /** Always null — this dataset is wilaya-level only, no commune linkage. */
+  commune_code: null;
+  /** Always null — see `commune_code`. */
+  commune: null;
+  /** Latitude (WGS84). Every airport carries ANAC's own published point. */
   lat: number;
   /** Longitude (WGS84). */
   lng: number;
-  /** ANAC source page the record was derived from. */
-  source: string;
+  /** Always "exact": every point comes straight from ANAC, not a fallback. */
+  geo_precision: "exact";
+  /** Always "source_point" — see `geo_precision`. */
+  geo_method: GeoMethod;
+  /** Provenance key into `metadata.sources[]` — always "anac". */
+  source: "anac";
+  /** External identifiers: the ICAO code. */
+  refs: Refs;
+  /** ICAO (OACI) code — matches /^DA[A-Z]{2}$/ (e.g. "DAAD"). */
+  icao: string;
+  /** IATA code — not published by ANAC; always null today. Typed as
+   *  `string | null` so a future populated value is not a breaking change. */
+  iata: string | null;
+  /** Postal address as listed by ANAC. */
+  address: string;
+  /** Contact phone, or null if none is given. */
+  phone: string | null;
+  /** Official website URL. */
+  website: string;
 }
 
-/** Dataset provenance and counts. */
-export interface Metadata {
-  source: string;
-  origin: string;
+/** One provenance entry in `metadata.sources[]`. */
+export interface SourceRef {
+  key: string;
+  name: string;
+  url?: string;
   license: string;
-  airports: number;
+  retrieved?: string;
+  evidence_type?: "official" | "crowdsourced" | "derived";
+}
+
+/** Dataset metadata (data/metadata.json). */
+export interface Metadata {
+  package: "@geoalgeria/aviation";
+  schema_version: string;
+  title_fr: string;
+  title_ar: string;
+  title_en: string;
+  record_count: number;
+  /** Records with coordinates — equal to `record_count`: ANAC publishes a
+   *  point for every airport. */
+  geocoded_count: number;
+  geocoded_pct: number;
+  precision: { exact: number; approximate: number };
+  estimated_universe: number | null;
+  coverage_pct: number | null;
+  coverage_note: string;
   wilayas_covered: number;
-  generated_at: string;
+  /** `[minLng, minLat, maxLng, maxLat]`. */
+  bbox: [number, number, number, number] | null;
+  sources: SourceRef[];
+  license: string;
+  /** ISO date (YYYY-MM-DD) the dataset was regenerated. */
+  updated: string;
+  /** Airports with a published IATA code — currently 0 (ANAC does not publish them). */
+  with_iata: number;
 }
 
 /** All civil airports (33). */
 export function airports(): Airport[];
-/** One airport by ICAO code (case-insensitive), or `null` if none matches. */
+/** One airport by ICAO code (case-insensitive), or null if none matches. */
 export function airportByIcao(code: string): Airport | null;
-/** Airports in a wilaya — accepts `"16"`, `16`, or `"01"`. */
+/** Airports in a wilaya — accepts "16", 16, or "01". */
 export function airportsByWilaya(code: string | number): Airport[];
 /** Dataset metadata (counts, source, generated_at). */
 export function metadata(): Metadata;