How do I add User Waypoints in bulk?

ForeFlight Mobile allows you to import your own collection of user waypoints into the app using a CSV or KML file.  CSV is a simple comma-separated format which can be exported from Excel or Google Sheets. KML is an XML-based format that can be easily created from programs like Google Earth.  

STEP 1.  Create a CSV or KML data file

You will need to create a CSV or KML file.  For CSV files, use Excel or Google Sheets and organize the file with 4 columns where you will need to place the waypoint name, description, latitude, and longitude. The CSV file must be organized as follows:

WAYPOINT_NAME Waypoint description Latitude Longitude

Here is an example of how waypoint entries could look like in your spreadsheet:

MY_HOUSE My house 38.1 -79.2
PROPERTY_ALPHA First house to observe 40.588 -80.1295
ANOTHER "" 39.22 -81.966

Waypoint Names: In either a CSV or KML data file, waypoint names must:

• Be at least 3 characters long including at least one letter.  For example, "12A" is okay, but "123" is not.
• Be in ALL CAPS.  For example, "THE_CABIN" is okay, but "The_Cabin" is not.
• Have no spaces between words. Instead, Use a "_" or "-" between words. For example, "THE_CABIN" or "THE-CABIN" is okay, but "THE CABIN" is not.

Waypoint Description:  You can add a description of the User Waypoint to help you recall the user for the waypoint.  If you do not want to provide a description, you must use [""] in the description column.

NOTE: Only the first 30-40 characters of the description will be visible in ForeFlight Mobile, so keeping them short is a good idea. 

Latitude and Longitude:  You will need to format your Latitude and Longitude (Lat/Long) values in a simple numeric decimal-degree format (ie: 34.7 or -81.457, where "negative" Longitude indicates W). No other Lat/Long formats are supported for bulk importing.  

Naming Your CSV or KML File:  User Waypoint CSV file must be named
"user_waypoints.csv" with all lower case letters and no spaces.  

We recommend you also name a KML file "user_waypoints.kml", but any filename ending .kml is supported, provided it contains only user waypoints.

• For CSV file:  user_waypoints.csv

• For KML file:  user_waypoints.kml

Sample CSV or KML File: Sample CSV and KML files are available at the bottom of this article.

 

STEP 2. Import your user waypoints into ForeFlight.

ForeFlight allows you to import your own collection of user waypoints into the app in one of three ways:

Option 1. Importing from AirDrop (Works with KML files only)

Option 2. Importing from email (Works with KML files only)

Option 3. Importing using iTunes (Work with KML and CSV)

Note: if you import a waypoint with the same name as an existing waypoint, it will be used to overwrite the existing waypoint.

 

Option 1. Importing User Waypoints via AirDrop (KML only)

Step 1. Enable Bluetooth and Wi-Fi on both your Mac and iPad or iPhone.

Step 2. Drag a KML file from your computer's Finder into the AirDrop folder and drop it onto the device that you wish to transfer it to.

Step 3. A popup on the receiving device will ask what app you want to send the imported file to. Tap FOREFLIGHT.

Step 4. Confirm that you want to import the file contents as user waypoints. The new waypoints will then be added to the User Waypoints page in MORE > USER CONTENT.

 

Option 2. Importing User Waypoints via Email (KML only)

Step 1. Attach your user waypoints KML file to an email and send it to whatever recipient(s) you want to have the file (which may be your own email address).

Step 2. Open the email in the Apple Mail app

Step 3. Tap-hold on the attachment with the name of the file you want to import. 

Step 4. After the share option appears, swipe through the apps in the middle until you reach ForeFlight and tap COPY TO FOREFLIGHT.

Step 5. ForeFlight will open and the app will ask whether you want to import the file as a User Map Layers file or as a User Waypoints file. Make your selection.  

 

Option 3. Importing User Waypoints via iTunes (KML and CSV)

Step 1. Plug your iPad or iPhone into your computer via the Apple USB cord.

Step 2. Start iTunes on your computer.

Step 3. 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 files to.

Device_Button_in_iTunes.jpg

 Image 1.  Click on iPad, iPhone, or iPad Touch icon.

NOTE:  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 plug it in again.

Step 4. Inside the window for your device, click on the 'File Sharing' button on the left. 

Step 5. Click on 'FOREFLIGHT'. 

File_Sharing_ForeFlight.jpg

Image 2.  Click on FILE SHARING and Tap on FOREFLIGHT.

 Step 6. On the right, you will see a listing of 'ForeFlight Documents'. If this is the first time you've added procedures to the app, this listing will be empty. Drag your "user_waypoints" file and drop it onto the 'ForeFlight Documents' table. 

FF_Docs.png

 Image 3.  Drag your "user_waypoints" file onto the "ForeFlight Documents" table.

Step 7. Press the SYNC button in the lower right corner of iTunes.

Step 8. Launch ForeFlight on your iPad or iPhone.

Step 9. Go to the User Waypoints view inside the app (MORE > USER CONTENT > USER WAYPOINTS on the iPad, and MENU > USER CONTENT > USER WAYPOINTS on the iPhone). You will be prompted to imported the new data. 

Note: In iTunes, the imported file is renamed with "processed" in the name and will still be accessible via the iTunes file sharing view. It can then be deleted as needed. 

SAMPLE FILES:

CSV Example (111 bytes)

user_waypoints.kml (3.0 KB)