Filesystem

With filesystem, you can now save KML files from your service locally. You can send KML file to user and he will be able to view it, navigate to it or save it. You can also save new waypoints from form.

Waypoint

Format

<?xml version="1.0" encoding="UTF-8"?>
<kml xmlns="http://www.opengis.net/kml/2.2">
  <Placemark>
    <name>Waypoint-name</name>
    <description>Waypoint-description</description>
    <Point>
      <coordinates>Longitude,Latitude</coordinates>
    </Point>
  </Placemark>
</kml>

Parameters

  • Waypoint-name - Name of waypoint
  • Waypoint-description - Description of waypoint
  • Latitude - Latitude of waypoint in decimal format
  • Longitude - Longitude of waypoint in decimal format

Example

<?xml version="1.0" encoding="UTF-8"?>
<kml xmlns="http://www.opengis.net/kml/2.2">
  <Placemark>
    <name>My cool waypoint</name>
    <description>This waypoint is really cool like my cool service.</description>
    <Point>
      <coordinates>-122.0822035425683,37.42228990140251</coordinates>
    </Point>
  </Placemark>
</kml>

How it looks like

Waypoint screenshot

How to save waypoint from form

You can also save waypoint from form. Just set action parameter of form to "locify://filesystem/waypoint". Your form has to contain inputs with names "latitude" and "longitude". Optionally it can contain inputs with names "name" and "description".

Route

Since Locify 0.8.5, it is possible to store routes as well. They can be viewed on maps and user can navigate along them.

Format

<?xml version="1.0" encoding="UTF-8"?>
<kml xmlns="http://www.opengis.net/kml/2.2">
  <Placemark>
    <name>Route-name</name>
    <description>Route-description</description>
    <MultiGeometry>
      <LineString><coordinates>Longitude,Latitude,Altitude Longitude,Latitude,Altitude ...</coordinates></LineString>
    </MultiGeometry>
  </Placemark>
</kml>
  • Route-name - Name of waypoint
  • Route-description - Description of waypoint
  • Latitude - Latitude of one point in decimal format
  • Longitude - Longitude of one point in decimal format
  • Altitude - Altitude of one point in decimal format

You can obviously enter more points into <coordinates> element. They are separated by spaces (or any other whitespace characters). You can also use multiple <LineString> elements.

Example

<?xml version="1.0" encoding="UTF-8"?>
<kml xmlns="http://www.opengis.net/kml/2.2">
  <Placemark>
    <name>example track</name>
    <description>
      Route length: 10037.655669509852
      Route travel time: 1852742
      Route waypoints: 7
    </description>
    <MultiGeometry>
      <LineString>
        <coordinates>
          14.403168461222803, 50.07218272944884, 0.0
          14.419808836683474, 50.074464700449255, 0.0
          14.436577610648088, 50.07488147200408, 0.0
        </coordinates>
      </LineString>
      <LineString>
        <coordinates>
          14.436448333333333, 50.07497333333333, 0.0
          14.447521138748003, 50.07202128744002, 0.0
          14.452830793302294, 50.06435769450528, 0.0
          14.455917556120665, 50.05156045165457, 0.0
        </coordinates>
      </LineString>
    </MultiGeometry>
  </Placemark>
</kml>