{"id":38835122,"url":"https://github.com/dark/faa-mva-kml","last_synced_at":"2026-01-17T13:55:25.310Z","repository":{"id":66839661,"uuid":"333314345","full_name":"dark/faa-mva-kml","owner":"dark","description":"Convert the MVA charts from faa.gov into KML files and content packs for Foreflight","archived":false,"fork":false,"pushed_at":"2026-01-15T04:11:56.000Z","size":116081,"stargazers_count":25,"open_issues_count":2,"forks_count":1,"subscribers_count":10,"default_branch":"master","last_synced_at":"2026-01-15T09:46:27.219Z","etag":null,"topics":["faa","foreflight","kml","mva","xml"],"latest_commit_sha":null,"homepage":"","language":"Python","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"gpl-3.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/dark.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null,"notice":null,"maintainers":null,"copyright":null,"agents":null,"dco":null,"cla":null}},"created_at":"2021-01-27T05:30:14.000Z","updated_at":"2026-01-15T03:57:08.000Z","dependencies_parsed_at":"2025-09-27T02:45:11.426Z","dependency_job_id":null,"html_url":"https://github.com/dark/faa-mva-kml","commit_stats":null,"previous_names":[],"tags_count":0,"template":false,"template_full_name":null,"purl":"pkg:github/dark/faa-mva-kml","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/dark%2Ffaa-mva-kml","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/dark%2Ffaa-mva-kml/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/dark%2Ffaa-mva-kml/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/dark%2Ffaa-mva-kml/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/dark","download_url":"https://codeload.github.com/dark/faa-mva-kml/tar.gz/refs/heads/master","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/dark%2Ffaa-mva-kml/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":28509534,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-01-17T13:38:16.342Z","status":"ssl_error","status_checked_at":"2026-01-17T13:37:44.060Z","response_time":85,"last_error":"SSL_read: unexpected eof while reading","robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":false,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["faa","foreflight","kml","mva","xml"],"created_at":"2026-01-17T13:55:25.220Z","updated_at":"2026-01-17T13:55:25.299Z","avatar_url":"https://github.com/dark.png","language":"Python","funding_links":[],"categories":[],"sub_categories":[],"readme":"# FAA Minimum Vectoring Altitude (MVA) and Minimum IFR Altitude (MIA) Charts as KML Files\n\nThis repository contains a copy of the Minimum Vectoring Altitude\n(MVA) and Minimum IFR Altitude (MIA) charts from the Federal Aviation\nAdministration (FAA).\n\nThe originals are provided by the FAA in PDF and XML format, but they\nare unsuited for automatic import in EFBs like *ForeFlight*. This\nrepository includes automatically generated copies in **KML** format\n(that can be imported in programs like Google Earth), as well as\n**content packs** (that can be imported in ForeFlight).\n\nAs an example, this is how the MVAs are drawn over San Diego, CA, once\nthe Southern California TRACON MVA maps are imported:\n\n\u003cp align=\"center\"\u003e\n  \u003cimg width=\"600\" src=\"docs/img/san_diego.png\" /\u003e\n\u003c/p\u003e\n\n## Content\n\n* The original XML files from the FAA are in the `mva-faa-xml` and\n  `mia-faa-xml` directories respectively, as downloaded from the\n  [official\n  website](https://www.faa.gov/air_traffic/flight_info/aeronav/digital_products/mva_mia/).\n\n* The converted KML files are in the `mva-kml` and `mia-kml`\n  directories; each chart is available independently, and is named\n  after the original XML file.\n\n* ForeFlight content packs are in the `contentpack` directory. There\n  is a single directory for all maps. Each content pack includes all\n  charts from the same ATC TRACON facility of a given type (MVA or\n  MIA), and its name includes the map type and the three-characters\n  identifier of each facility. You can lookup the TRACON identifiers\n  at [this\n  link](https://www.faa.gov/about/office_org/headquarters_offices/ato/service_units/air_traffic_services/tracon/).\n  That directory also includes combined maps:\n  * `combined-MIA.zip`: overlays all MIA maps\n  * `combined-MVA-FUS3.zip`: overlays all MVA-FUS3 maps\n  * `combined-MVA-FUS5.zip`: overlays all MVA-FUS5 maps\n  * `combined-MVA-others.zip`: overlays all MVA maps that are not FUS3 nor FUS5\n\nEach TRACON facility usually publishes two MVA maps, named `FUS3` and\n`FUS5`. To the best of my knowledge, they are generated to give 3 and\n5 miles, respectively, horizontal clearance from terrain and\nobstacles. The `FUS5` maps are usually larger and cover much more\nairspace.\n\nYou can see how the Los Angeles, CA area (managed by the Southern\nCalifornia TRACON, or `SCT`) is covered by the current `SCT_MVA_FUS3`\nmap:\n\n\u003cp align=\"center\"\u003e\n  \u003cimg width=\"600\" src=\"docs/img/SCT3.png\" /\u003e\n\u003c/p\u003e\n\nAs opposed to the current `SCT_MVA_FUS5` map:\n\n\u003cp align=\"center\"\u003e\n  \u003cimg width=\"600\" src=\"docs/img/SCT5.png\" /\u003e\n\u003c/p\u003e\n\n## Instructions\n\nFor instructions on how to download and import the Content Packs into\nForeFlight (**recommended**), please browse the `contentpacks`\ndirectory of this repository and download/share them into the\napp. Detailed instructions about how to import Content Packs into\nForeFlight are available at their [support\npage](https://www.foreflight.com/support/content-packs/) (search for\n\"Importing Content Packs\").\n\nFor instructions on how to download and import KML files into\nForeFlight, please see [this page in the Support\nCenter](https://support.foreflight.com/hc/en-us/articles/360000219488-User-Content-Creation-and-Importation-Guide). Note:\nsome users have reported issues with downloading KML files from Github\nfrom their iPads. If you have issues with the download (e.g., the\nfiles are downloaded as plain text), please download them on your\ncomputer and import them with iTunes, or use a Content Pack instead\n(recommended).\n\nFor instructions on how to download and import KML files into another\nprogram (like Google Earth), please refer to the documentation\nprovided with that program.\n\n## History\n\nThis work was inspired by some episodes of the [Opposing\nBases](https://www.opposingbases.com/) podcast, where the hosts\ndiscussed various uses of the MVA charts by the Air Traffic\nControllers. Specifically, [episode\n161](https://opposingbases.libsyn.com/ob161-heading-shmeading/)\nincluded feedback from one of the listeners about how to convert the\nXML originals into KML in a semi-automated way. This project was then\nfeatured on [episode\n168](https://opposingbases.libsyn.com/ob168-under-there-under-where).\n\n# Legal Disclaimer\n\nAll MVA and MIA chart files are property of the FAA. The attached\nlicense notice applies to the conversion scripts only.\n\nAll files are provided for educational purposes only. They are not to\nbe used as a navigation tool. No claim is made regarding the accuracy\nof these charts and their contents.\n\nPlease direct any comments and discrepancies in the displayed data to\nthe FAA Air Traffic facility in question.\n\nMore information at:\n\u003chttps://www.faa.gov/air_traffic/flight_info/aeronav/digital_products/mva_mia/\u003e\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fdark%2Ffaa-mva-kml","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fdark%2Ffaa-mva-kml","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fdark%2Ffaa-mva-kml/lists"}