Files

You can send geo files in KML format to user and user can use them offline or do some actions with them (navigate to them, map them, ...). All our files are in KML format, so you can view (or create) them in Google Earth. We support three KML types - place, route and multi-point KML. We also support NetworkLink, which can be used for repeated retrieval of other KMLs.

Place

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 place</name>
    <description>This place is really cool like my cool service.</description>
    <Point>
      <coordinates>-122.0822035425683,37.42228990140251</coordinates>
    </Point>
  </Placemark>
</kml>

How it looks like

Place screenshot

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>Cool route</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>

How it looks like

Route screenshot

Multi-point file

Multi point is a compilation of more than one places. User can view them all on the maps.

Format

<?xml version="1.0" encoding="UTF-8"?>
<kml xmlns="http://earth.google.com/kml/2.0">
  <Document>
    <name>Compilation-name</name>
    <Folder>
      <Placemark>
        <name>Place-1-name</name>
        <description>Description-1</description>
        <Point><coordinates>Longitude,Latitude,Altitude</coordinates></Point>
      </Placemark>
      <Placemark>
        <name>Place-2-name</name>
        <description>Description-2</description>
        <Point><coordinates>Longitude,Latitude,Altitude</coordinates></Point>
      </Placemark>
      ...
    </Folder>
  </Document>  
</kml>
  • Compilation-name - Name of the whole places compilation
  • Place-x-name - Name of individual places
  • Description-x - Description of individual places
  • Latitude - Latitude of one point in decimal format
  • Longitude - Longitude of one point in decimal format
  • Altitude - Altitude of one point in decimal format
<?xml version="1.0" encoding="UTF-8"?>
<kml xmlns="http://earth.google.com/kml/2.0">
  <Document>
    <name>My cool places</name>
    <Folder>
      <Placemark>
        <name>Destil's home</name>
        <description>Here lives the chief client locify developer</description>
        <Point><coordinates>14.223450,49.910850,0</coordinates></Point>
      </Placemark>
      <Placemark>
        <name>Menion's home</name>
        <description>Here lives the client developer responsible for maps, navigation and other offline parts.</description>
        <Point><coordinates>14.459853,50.051614,0</coordinates></Point>
      </Placemark>
    </Folder>
  </Document>  
</kml>

How it looks like

Multi point screenshot

NetworkLink

NetworkLink is used for automated retrieval of other KMLs. You can create simple GPS games with it!

Format

<?xml version="1.0" encoding="UTF-8"?>
<kml xmlns="http://earth.google.com/kml/2.2">
  <NetworkLink>
    <name>Random points</name>
    <description>Random points for testing.</description>
    <open>1</open>
    <visibility>1</visibility>
    <refreshVisibility>1</refreshVisibility>
    <Link>
      <href>http://locify.destil.cz/char/generatekml.php</href>
      <refreshMode>onInterval</refreshMode>
      <refreshInterval>5</refreshInterval>
      <viewRefreshMode>onStop</viewRefreshMode>
    <viewFormat>bbox=[bboxWest],[bboxSouth],[bboxEast],[bboxNorth]&amp;lat=
      [lookatLon]&amp;lon=[lookatLat]</viewFormat>
    </Link>
</NetworkLink>
</kml>

How it looks like

Network link screenshot