Downloading Bookmarks

Bookmarks can be created outside of Geosphere and then downloaded in the same manner utilized by the “Geosphere Mobile Downloads” web page which is viewable from within Geosphere. This allows for easier editing of complex javascript routines and enables bookmarks to be shared with other users.


The file format expected by Geosphere when loading bookmarks is Apple’s plist format. A plist is simply a way to provide elements such as strings, numbers, arrays and dictionaries in a list form. There are several plist editors available supporting both Mac OS and Windows. Both XML as well as binary plists are supported by Geosphere.


Once a bookmark plist is created it can be loaded from Geosphere’s browser by downloading it in the same manner used to download GPX files.


User created bookmarks can also be shared by attaching them to support forum postings.

The root structure in the bookmark plist (aside from appropriate xml and plist headers) is an array with a minimum of two elements as follows:

Root Structure

<bookmark_dictionary>

The structure of a bookmark is a dictionary with the following case-sensitive string keys:

1.

2.

3.

string

dictionary

dictionary

bookmarks

<bookmark_dictionary>

<bookmark_dictionary>

Required entry. Must have “bookmarks” value.

Required entry.

Optional additional bookmarks.

array order

type

value

Comments

key

_name_

_url_

_javascript_

_min_app_version_

_min_os_version_

type

string

string

string

string

string

value

<bookmark name>

<bookmark URL>

<bookmark javascript>

<Geosphere version>

<iOS version>

Comments

Required entry. Will overwrite bookmarks with same name.

Required entry. String may be blank to retain existing browser web page.

Optional javascript which will execute after URL is loaded.

Optional entry which restricts versions on which bookmark execute.

Optional entry which restricts versions on which bookmark execute.

XML Example

<?xml version="1.0" encoding="UTF-8"?>

<!DOCTYPE plist PUBLIC "-//Apple//DTD PLIST 1.0//EN" "http://www.apple.com/DTDs/PropertyList-1.0.dtd">

<plist version="1.0">

<array>

<string>bookmarks</string>

<dict>

<key>_name_</key>

<string>Gmail Mail</string>

<key>_url_</key>

<string>http://mail.google.com/mail</string>

</dict>

</array>

</plist>