User Map Shapes

ForeFlight allows you to import and display custom KML shape files in ForeFlight’s Maps view. This page provides a step-by-step guide for importing and displaying the files, as well as guidance on supported shapes and other data types, and a sample KML file that you can download and import into ForeFlight.

 

Step-By-Step

 

Step 1: Build your KML files

KML (Keyhole Markup Language) is a common file type used for displaying geographic information. There are many programs that allow you to build and export custom map shapes as KML files, one of the simplest being Google’s “My Maps” program. After creating a new map, follow the instructions here to download the map as a KML file.

KML Files must be smaller than 4MB to appear in ForeFlight.

Step 2: Connect your device to iTunes

Plug your iPad or iPhone into your computer via the Apple USB cord. Start iTunes on your computer, or wait for it to automatically start.

Step 3: Click on your device name in iTunes

Inside iTunes, click on the icon for your iPad, iPhone, or iPod Touch. You will find the device icons at the top of the iTunes screen. Make sure you click on the device that you want to copy procedures to.

If you don't see your device name listed, make sure it is plugged in properly. Try disconnecting the USB cable from both your device and the computer, and then plugging it in again.

Step 4: Click on the 'Apps' tab for your device

Inside the window for your device, click on the 'Apps' listing on the left. It should show all of the apps you have installed on your device. Scroll to the 'File Sharing' section at the bottom of the page and click on 'ForeFlight'. 

Step 5: Drag your KML files into iTunes

On the right, you will see a listing of 'ForeFlight Documents'. If this is the first time you've imported anything to the app, this listing will be empty.

Drag your KML files and drop them onto the 'ForeFlight Documents' table. While the files are copying over to your device, you will see a brief 'Sync in Progress' message on your device.

 

Step 6: Launch ForeFlight and display your map shapes

 

Your newly-imported map shapes appear at the bottom of the layer selector, on the right. The names are taken directly from the filename, excluding the extension. Tap on one of the shape layers to display it on the map. You can display one map shape layer at a time. If your shape layer contains points, you can tap on them to view their name and geographic coordinates, and create a direct to route from your current position to the point.

 

Supported Data Types

 

The full KML standard supports a very large variety of different data types, allowing you to specify things like simple geometries, time-dependent feature, camera perspectives, and even guided tours. A full list of data types supported by KML can be found at the top of Google’s KML developer reference page.

ForeFlight’s User Map Shapes feature supports only a small subset of these data types, contained primarily in the Geometry, StyleSelector, and SubStyle groupings (using the organization defined on the reference page). This is sufficient for creating simple or complex arrangements of shapes, lines, and points with support for labels and icon styles.

Below is the full list of data types that ForeFlight supports. If you import a file that includes elements not listed here, the unsupported elements should be simply ignored by ForeFlight and the rest of the file will display correctly.

  • Point
  • LineString
  • LinearRing
  • Polygon
  • MultiGeometry
  • Style
  • StyleMap (only the "normal" style is supported)
  • LineStyle
  • PolyStyle
  • IconStyle
  • gx:LabelVisibility (only Google extension namespace currently supported)

 

Sample Files

 

The following files provide some examples of the flexibility of User Map Shapes. You can view the contents of each file by opening them in a simple text editor like TextEdit. Click on a filename to download it through your browser.

UserMapShapesSample.kml (65 KB) - Demonstrates the supported icon styles and examples of lines, polygons, and circles.
US_Crude_Oil_Pipelines.kml (134 KB) - Basic map showing the network of crude oil pipelines in the US.
US_HGL_Pipelines.kml (71 KB) - Basic map showing the network of HGL pipelines in the US.
Texas_Counties.kml (1.5 MB) - Shows all county borders in the state of Texas.
Alaskan_Coast.kml (3 MB) - Detailed map outlining the state of Alaska. As with other large KML files, there will be a delay of up to a few seconds between tapping on the layer and it appearing on the map as the app works to render the file.