Customer Service

Demos/Documentation

Synthesizers Samplers/Controllers Music Analysis Drum Apps
Geospatial Photo/Video Science Apps OSX Apps

KML Map/KML Map HD

KML Map HD includes all of the functionality of KML Map plus the ability to create ground overlays and edit map features. Features specific to KML Map HD are shown in red

Keyhole markup language (KML) is a standard format used by Google Earth and other mapping and navigation tools to represent geographical information. KML Map lets you create, edit, display, and store KML map data and attached media content (often called metadata) on the iPad. Use KML Map to view photographs on maps from the location and direction they were taken, to create your own custom maps containing point, line, and polygonal data, to display your maps over Google Map layers, to acess pictures, audio, and video data at specific locations, to visualize scientific data and metadata for a variety of applications, and much more.

Here are some of the features of KML Map:

  • Display KML point, line, and polygonal features, ground and photo overlays. Computes range from current location to points, length of lines, and area of polygons.

  • Standard north up or rotating map that points in your look direction. Display current latitude/longitude.

  • Portrait or landscape mode.

  • Display KML content from Safari or embedded in email. Just click and see the data in KML Map.

  • Add new map features. Compute range, length, and area of features. Edit lines and polygons. Change color, intensity, saturation, line width, and description.

  • Assign address information to new objects using reverse geocoding.

  • Display ground overlays (e.g., your own maps and images) over base maps/images

  • Create ground overlays (screenshots) to use as base maps/images when you don't have an Internet connection.

  • Photo overlays are rendered on a map from the location and direction they were taken.

  • Supports multiple, variable-transparency map layers

  • Merge KML files

  • Read compressed KMZ files

  • Transfer files between KML Map and your computer using iTunes File Sharing

  • Download KML and KMZ content from network URLs

  • Supports standard and custom pushpins/placemark icons

  • Shows/hides names on map

  • Quickly find an object of interest in the current map layer by name

  • Display full HTML content contained in CDATA tag (text, pictures, sound files, or movies)

Important Notice: KML Map understands a subset of the KML language, specifically points, line strings, and polygons (without holes). It can display ground overlays and render photo overlays in 2D. HTML contained within CDATA tags (including pictures, sound files, and video) are rendered in a web view window. Files containing unsupported tags will not load. File sizes should be limited to 5-7 Mbytes. If the file is too large KML Map will quit. The size of files that can be emailed is limited by the operating system. KML Map also reads compressed KML or KMZ files. However, depending on the internal structure and contents of the file, KML Map may only be able to display one KMZ file at a time.

How to Use

The app contains two control bars (top and bottom), an information field at the bottom right, and a number of secondary menus.

The bottom bar selects one of four top menus:

  • FILE
  • OBJECT
  • MAP
  • SETTINGS

FILE

LOAD - Loads a KML file (either .kml or .kmz) stored on your iPad in the documents directory into the current map layer. Note when a KMZ is loaded it is expanded and saved with the name "doc.kml"

SAVE - Saves the contents of the current map layer in three ways. First, the data are saved to a file "YYYYMMDD_hhmmss.kml" automatically generated from the current date/time. Second, a copy is saved in the file specified in the "New File Name" field in the add/edit menu. Third, the KML data are copied into the pasteboard. This last way allows the data to be emailed (in the document not as an attachment).

TRASH - Deletes a KML file from the documents directory.

OBJECT

ROAM, SELECT - ROAM allows you to scroll and zoom the map. Tap SELECT to select an object for editing.

ADD - Adds a new point, line, or polygonal placemark, or a ground overlay to the current map layer). Tapping ADD reveals a secondary menu, which is described below.

TRASH - Removes an object in the current map layer by selecting the object by name from a list of objects in the layer.

FIND - Lists all objects in the current map layer. Selecting an object updates the display so the object is in the center of the screen. This can also be used to select an object for editing.

EDIT - Edits an existing point, line, or polygonal object. Tapping EDIT reveals a secondary menu, which is described below.

META - Reveal a window containing the selected object's metadata. Specifically this is either plain text or HTML contained within a CDATA section in the description tag of the KML object.

As stated above, tapping either ADD or EDIT reveals a secondary menu.

To add an object tap either POINT, LINE, POLYGON, or GROUND OVERLAY. Touch the screen to place and move the point. To add a point placemark tap the map once. Drag the placemark to the desired position. Tap two or more times to create lines, and three or more times to create polygons, depending on the type of feature you are adding. Point, line, and poly features must be saved.

Ground overlays are generated for the current map view and may be used a map backgrounds when your are off-line. The data are saved automatically in NEW FILE NAME. Sometimes it is necessary to zoom in/out and scroll around the area of interest before creating a ground overlay in order for the Google Map server to fill in the necessary data for our renderer.

If parts of the line or polygon you wish to add are outside the area shown on the map, tap SELECT/ROAM to switch back to ROAM to move the map. Tap ROAM to toggle back to continue.

If you make a mistake, touch DELETE to remove the last placemark, or point along a line or vertex of a polygon.

New point placemarks are drawn as a simple pin. The intensity, hue, and saturation sliders change the color of pins, lines and polygons. The other sliders control transparency, and line width. Polygons are rendered simply as a filled in region (KML Map does not draw holes using the innerBoundaryIs tag). If you are editing an object, the top buttons are disabled. Tap "Done" to exit.

If you want to save to a specific file name you can specify the name in the yellow top left text view. Although features are assigned a unique name they can be given a specific name in the middle left text view. The lower left text view allows you to add descriptive text to the object.

To edit an object you must first select it. This can be done in two ways: either by touching the object in SELECT mode, or by selecting the object in the list presented by tapping FIND on the top tool bar.

There are five additional buttons at the bottom of the secondary menu:

DELETE removes the current point in a line or polygonal object

REVERSE changes the direction (order) of the points in the line or polygon

NEXT POINT moves to the next point in the feature

UNDO reverts to the original object

DUPLICATE makes a copy of the current object

Deleting all points in an object causes the object to be erased after tapping "Done". This cannot be undone.

MAP

SEARCH BAR - The search bar can be used for finding cities and towns. The built-in gazetteer contains 86,000 place names from all over the world. Just type a city (e.g., 'Gen¸ve' for Geneva, Switzerland). You can also type a latitude and longitude (in decimal degrees with a comma in between) to go to that location.

LAYER 1, 2, 3, 4 - Selects one of four map layers. The selected layer is also known as the current map layer.

SHOW/HIDE - Use to turn on/off display of map layers. Tap APP SETTINGS to change transparency.

CLEAR - Erases the current map layer.

STANDARD, SATELLITE, HYBRID - Changes the Google base map/image.

SETTINGS

NORTH UP/LOOK - Toggles between either displaying the map so that up is north, or continuously rotating the map to point in the direction you are looking and holding the iPad.

GPS ON/GPS OFF - GPS re-centers the map view each time there is a GPS update. If the GPS is off, the center of the map window, marked by cross-hairs, is the current location.

INFORMATION - Exposes a secondary menu with the following controls:

DISPLAY NAMES - "On" displays the name of the object (points, lines, and polygons) on the map.

IMAGE ICONS - "On" uses pins or placemark icons from the designated URL, which can either be at a network URL or be stored locally in the app's documents directory along with the KML file. "Off" renders placemarks using a simple colored pin (loads faster).

CLEAR THEN LOAD - "On" clears the previous contents of a map layer when a new KML file is loaded. "Off" adds to the data that was previously there. This can be used to combine KML files.

NETWORK LINK URL - Specifies KML data that you wish to load from the network. KML Map supports basic HTTP authentication; i.e.,

http://userID:password@website/filename.kml.

The password is not hidden and neither the userID nor the password are encrypted. You can also load KML data from a PHP script.

LINK UPDATE - "On" loads the data specified in the yellow "Network Link URL" text window into the current map data. The data are loaded after tapping "Done", which is revealled when you touch the text window. KML files are transferred and loaded automatically. KMZ files are tranferred and decompressed into a KML file, which must be manually loaded.

AUTO REFRESH - "On" loads the data specified in the yellow "Network Link URL" repeatedly. The rate is controlled with the slider. "Off" Loads the data just once.

N.B. You must touch the URL Link text window and tap Done to activate the dynamic link.

DYNAMIC LINK UPDATE RATE - Controls how often the dynamic link is reloaded.

LAYER TRANSPARENCY - Changes the transparency of all KML objects (points, lines, polygons, and ground overlays) in the current map layer.

Information window

Displays the latitude/longitude at the center of the screen. If you have selected a point it shows the distance between the current location (your GPS location or center of the screen) and the point. If you have selected a line string, it shows its total length; if you have selected a polygon, it shows its area.

Transferring Files

KML files can be transferred to/from the iPad in several ways. The easiest way is to move files between the KML Map documents directory and your computer using iTunes File Sharing. To do this connect your iPad up to a computer and open iTunes. Select your device and tap its "Apps" tab. File Sharing appears at the bottom (you might have to scroll down to see it). Select KML Map to see the contents of the documents directory on the right.

To load a file from an email, hold your finger down on the attachment until a window pops up that asks you to specify how you wish to open the file. KML files can be loaded from web pages using Safari in a similar manner.

To email KML data, save the file, close KML Map, open email, and paste the contents of the pasteboard into the body of the email. Data can also be download from a network URL as mentioned in the previous section.

Links to Sample KML data

N.B. Links are available only in English.

Here are links to a number of global data sets. Let us know if there are other data sets that you would like to make available to the KML Map community.

Copy a link, tap APP SETTINGS to open the settings window, paste into the Network Link URL, turn on Link Update, and tap Done.

Citizen Weather Observer Program (Weather Stations)

NOAA Tide Stations

Marine Observations

Earthquake Data (by age)

Earthquake Data (by depth)

Note the KMZ files do not automatically load after downloading. Look for the unzipped KML files and load manually.

© 2007-2017 Intelligent Gadgets