Navigation

There have been some changes in format for older versions of Locify. See documentation for Locify 0.8.1 and older.
If you plan support for versions older than 0.8.5, you need to detect client version and serve correct screen.

Now you can navigate your users to your locations! Best way is to return an KML waypoint. User will read the waypoint description and decides, if he wants to navigate to this point. Howewer, you can call navigation directly.

Format

<?xml version="1.0" encoding="UTF-8"?>
<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Strict//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-strict.dtd">
<html xmlns="http://www.w3.org/1999/xhtml" xmlns:locify="http://client.locify.com/locify_ns/1.0" xml:lang="en" lang="en">
  <head>
    <meta http-equiv="refresh" content="0;url=locify://navigator?lat=Latitude&lon=Longitude&name=Name-of-point" />
    <title></title>
  </head>
  <body></body>
</html>

Parameters

  • Latitude - Latitude of point in decimal format
  • Longitude - Longitude of point in decimal format
  • Name-of-point - Name of point shown in navigation

You don't have to send special screen with empty body for redirection to navigation - it is possible to use locify://navigator as URL in links, eg. in list.

Examples

Extra screen

<?xml version="1.0" encoding="UTF-8"?>
<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Strict//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-strict.dtd">
<html xmlns="http://www.w3.org/1999/xhtml" xmlns:locify="http://client.locify.com/locify_ns/1.0" xml:lang="en" lang="en">
  <head>
    <meta http-equiv="refresh" content="0;url=locify://navigator?lat=50.1234&lon=14.1234&name=Prague" />
    <title></title>
  </head>
  <body></body>
</html>

In list

<?xml version="1.0" encoding="UTF-8"?>
<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Strict//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-strict.dtd">
<html xmlns="http://www.w3.org/1999/xhtml" xmlns:locify="http://client.locify.com/locify_ns/1.0" xml:lang="en" lang="en">
  <head>
    <title>My cool menu</title>
  </head>
  <body class="list">
    <ul>
      <li><a href="http://www.mycoolservice.com/friends" class="listItem">View nearby friends</a></li>
      <li><a href="locify://navigator?lat=50.1234&lon=14.1234&name=Prague" class="listItem">Navigate to our HQ</a></li>
    </ul>
  </body>
</html>

How it looks like

Navigation screenshot