Supported Devices

Currently, SpotWalla supports the following devices and location interfaces:

  • APRS Device
  • Bubbler GPS for Android
  • DeLorme inReach
  • Email
  • Generic Device with GPX Support
  • gibbyTrip for iOS
  • INMARSAT Communications Device
  • SPOT Personal Tracker
  • SWConnect for iOS
  • The Wirie pro Device

APRS Device

The Automatic Position/Packet Reporting System (APRS) is a digital communication network built upon the amateur radio network. APRS is used primarily for transmitting position reports and weather data. SpotWalla will use the APRS network to periodically poll APRS devices for position updates.

Setup Instructions: Creating & Updating an APRS Device

Bubbler GPS

Bubbler GPS is an Android application that turns your Android-based phone into a tracking device. It's built upon the SpotWalla Web API. For more information see the Bubbler GPS website.

Setup Instructions: Creating & Updating a Bubbler GPS Device

DeLorme inReach

The DeLorme inReach is a satellite-based tracking device. The best place to learn more about the DeLorme inReach is straight from DeLorme, Inc.

SpotWalla supports the inReach through its MapShare Raw KML Feed. SpotWalla periodically polls this feed for new messages. More information about this interface and how to set it up is discussed below.

Setup Instructions: Creating & Updating a DeLorme InReach Device

Email

The email interface allows users to create messages for any device type. Typically, this interface is used when outside of a device's coverage area. For instance, a SPOT user traveling in the southern Pacific Ocean west of the Hawaian Islands and east of Fiji is outside of SPOT's coverage area, but may have access to email. The email interface allows the user to record positions until they're back in a SPOT coverage area. In the end, how you choose to use the email interface is entirely up to you.

More Information: Using the Email Interface

Generic Device with GPX Support

If you have a personal location device that stores location data in the GPX format, the location data can be imported into SpotWalla. This type of device cannot be used to join location pages, but it can be used for everything else in SpotWalla.

Setup Instructions: Creating & Updating a Generic Device with GPX Support

gibbyTrip iOS App Device

gibbyTrip is an iOS application that turns your iOS-based device into a tracking device. It's built upon the SpotWalla Web API. For more information see the gibbyTrip website.

Setup Instructions: Creating & Updating a gibbyTrip iOS App Device

Inmarsat Communication Device

Inmarsat provides global voice, data and IP communications capability. Some of their devices are capable of emailing a position report. SpotWalla's Inmarsat interface is capable of consuming the position report emails and storing the location data.

Setup Instructions: Creating & Updating an Inmarat Communications Device

SPOT Personal Tracker

The SPOT Personal Tracker devices are satellite-based personal tracking devices that are small enough to fit in the palm of your hand. They provide coverage across most of the globe. The best place to learn more about the SPOT device lineup and the coverage areas, costs and everything else SPOT-related is straight from SPOT Inc. Additionally, you can check out the FAQ page at My Live Tracks.

A SPOT device sends five primary types of messages:

  1. OK
  2. Help
  3. Custom
  4. Tracking
  5. 911/SOS

Ok, Help and Custom messages are sent manually by pushing the appropriate button. Tracking messages are sent automatically in 2.5, 5, 10, 30 or 60-minute intervals. SpotWalla can import all of these messages and store them forever.

SpotWalla does not receive or process in any way, shape or form 911/SOS messages from SPOT, Inc. Additionally, while SpotWalla does receive Help messages from SPOT, Inc., SpotWalla does not provide value-added services associated with Help messages. For instance, SPOT, Inc. provides Road Side Service assistance for an additional monthly fee.

Jodie Tice Lawrosky has created an excellent document of clear, concise instructions about how to use SPOT. You may download Jodie's document by clicking this link: Jodie's SPOT Instructions.

Setup Instructions: Creating & Updating a SPOT Personal Tracker

SWConnect iOS App Device

SWConnect is an iOS application that turns your iOS-based device into a tracking device. It's built upon the SpotWalla Web API. For more information see the SWConnect website.

Setup Instructions: Creating & Updating an SWConnect iOS App Device

The Wirie pro Device

The Wirie pro is a long range WiFi and 3G/4G device typically used in marine and RV environments. This device integrates with SpotWalla using the SpotWalla Web API. For more information see the The Wirie website.

Setup Instructions: Creating & Updating The Wirie pro Device

Top

Creating & Updating an APRS Device

To create/update and configure an APRS device, follow these steps...

  1. Log into SpotWalla, click your username in the upper right corner of the window and choose Devices from the menu. This will take you to your devices page.
  2. If you're creating a device, click the button. If you're updating a device, click the device description and choose Update from the menu.
  3. Select APRS Device from the Device Type list.
  4. Enter a description for this device. This text will appear in your device list as well as any other place where a device description is displayed. Use something descriptive, but don't write a book.
  5. Select your Region and Timezone.
  6. If you want this device to be the default device, click the control until Yes is displayed.
  7. In the APRS Interface section enter your APRS Call Sign.
  8. If you want SpotWalla to poll your device for messages, ensure its message interface is active.
  9. Click the Update button.

Top

Creating & Updating a Bubbler GPS Device

To create/update and configure a Bubbler GPS device, follow these steps...

  1. Log into SpotWalla, click your username in the upper right corner of the window and choose Devices from the menu. This will take you to your devices page.
  2. If you're creating a device, click the button. If you're updating a device, click the device description and choose Update from the menu.
  3. Select Bubbler GPS from the Device Type list.
  4. Enter a description for this device. This text will appear in your device list as well as any other place where a device description is displayed. Use something descriptive, but don't write a book.
  5. Select your Region and Timezone.
  6. If you want this device to be the default device, click the control until Yes is displayed.
  7. Click the Update button.

You must now enable your Bubbler GPS device for Web API access. After completing the above steps you should be on the Devices screen. If so, you can skip steps 1 and 2 below.

  1. Log into SpotWalla, click your username in the upper right corner of the window and choose Devices from the menu. This will take you to your devices page.
  2. Find the Bubbler GPS device, click its description and choose Web API from the menu. This will display the Web API Settings and Statistics page.
  3. Click the Enabled/Disable Web API Access folder to display its content.
  4. If the device is enabled for Web API access, you'll see a green area that states as much and a Disable button underneath. If the device is not enabled for Web API Access, you'll see an red area that states as much and an Enable button underneath. Ensure your device is enabled.

The rest of the setup is accomplished in the Bubbler GPS application on your phone.

Top

Creating & Updating a DeLorme InReach Device

To create/update and configure a DeLorme InReach device, follow these steps...

  1. Log into SpotWalla, click your username in the upper right corner of the window and choose Devices from the menu. This will take you to your devices page.
  2. If you're creating a device, click the button. If you're updating a device, click the device description and choose Update from the menu.
  3. Select DeLorme InReach from the Device Type list.
  4. Enter a description for this device. This text will appear in your device list as well as any other place where a device description is displayed. Use something descriptive, but don't write a book.
  5. Select your Region and Timezone.
  6. If you want this device to be the default device, click the control until Yes is displayed.
  7. In the DeLorme InReach Interface section enter your device's IMEI number. This number is located inside the device's battery compartment and is also available in your DeLorme Explore account when viewing your devices.
  8. Enter your device's Raw KML Feed link. To determine your device's Raw KML Feed link, follow these steps:
    1. Log into Explore DeLorme.
    2. At the top of the page click the Social tab.
    3. Next to "Your MapShare" text there's a small link called "feeds". Click it. If the feeds link isn't present, click the MapShare: Off button and refresh the page.
    4. From the dialog window that appears, copy the Raw KML Feed URL and use that link to configure your device.
  9. If you assigned a password to the KML Feed, enter the password in the Feed Password field.
  10. If you want SpotWalla to poll your device for messages, ensure its message interface is active.
  11. Click the Update button.

Top

Creating & Updating a Generic Device with GPX Support

To create a Generic Device with GPX Support, follow these directions...

  1. Log into SpotWalla, click your username in the upper right corner of the window and choose Devices from the menu. This will take you to your devices page.
  2. If you're creating a device, click the button. If you're updating a device, click the device description and choose Update from the menu.
  3. Select Generic Device with GPX Support from the Device Type list.
  4. Enter a description for this device. This text will appear in your device list as well as any other place where a device description is displayed. Use something descriptive, but don't write a book.
  5. Select your Region and Timezone.
  6. If you want this device to be the default device, click the control until Yes is displayed.
  7. Click the Update button.

This device doesn't have an interface. Instead, messages are imported/uploaded to SpotWalla via a GPX file. Follow these instructions to load data to the device: Uploading GPX Data

Top

Creating & Updating a gibbyTrip iOS App Device

To create/update and configure a gibbyTrip iOS App device, follow these steps...

  1. Log into SpotWalla, click your username in the upper right corner of the window and choose Devices from the menu. This will take you to your devices page.
  2. If you're creating a device, click the button. If you're updating a device, click the device description and choose Update from the menu.
  3. Select gibbyTrip iOS App Device from the Device Type list.
  4. Enter a description for this device. This text will appear in your device list as well as any other place where a device description is displayed. Use something descriptive, but don't write a book.
  5. Select your Region and Timezone.
  6. If you want this device to be the default device, click the control until Yes is displayed.
  7. Click the Create or Update button.

You must now enable your gibbyTrip iOS App device for Web API access. After completing the above steps you should be on the Devices screen. If so, you can skip steps 1 and 2 below.

  1. Log into SpotWalla, click your username in the upper right corner of the window and choose Devices from the menu. This will take you to your devices page.
  2. Find the gibbyTrip device, click its description and choose Web API from the menu. This will display the Web API Settings and Statistics page.
  3. Click the Enabled/Disable Web API Access folder to display its content.
  4. If the device is enabled for Web API access, you'll see a green area that states as much and a Disable button underneath. If the device is not enabled for Web API Access, you'll see a red area that states as much and an Enable button underneath. Ensure your device is enabled.

The rest of the setup is accomplished in the gibbyTrip application on your phone. Check out the gibbyTrip home page for more information.

Top

Creating & Updating an Inmarsat Communications Device

The interface between Inmarsat and SpotWalla is via email. To create an Inmarsat Communications Device, follow the directions below.

  1. Log into SpotWalla, click your username in the upper right corner of the window and choose Devices from the menu. This will take you to your devices page.
  2. If you're creating a device, click the button. If you're updating a device, click the device description and choose Update from the menu.
  3. Select Inmarsat Communications Device from the Device Type list.
  4. Enter a description for this device. This text will appear in your device list as well as any other place where a device description is displayed. Use something descriptive, but don't write a book.
  5. Select your Region and Timezone.
  6. If you want this device to be the default device, click the control until Yes is displayed.
  7. In the Inmarsat Interface section enter your device's serial number. In this case, the device's serial number can be found in the email address used to send the email
  8. Click the Update button.
  9. In your Inmarsat account, when sending a position report simply add inmarsat@spotwalla.com to the TO-list.

Top

Creating & Updating a SPOT Personal Tracker

To create/update and configure a SPOT device, follow these steps...

  1. Log into SpotWalla, click your username in the upper right corner of the window and choose Devices from the menu. This will take you to your devices page.
  2. If you're creating a device, click the button. If you're updating a device, click the device description and choose Update from the menu.
  3. Select SPOT Personal Tracker from the Device Type list.
  4. Enter a description for this device. This text will appear in your device list as well as any other place where a device description is displayed. Use something descriptive, but don't write a book.
  5. Select your Region and Timezone.
  6. If you want this device to be the default device, click the control until Yes is displayed.
  7. In the SPOT XML Interface section enter your device's ESN number. You device's ESN can be found in the battery compartment of the device or in your SPOT account. An ESN looks like 0-7334932. Please type it in exactly as it's shown.
  8. Now log into your SPOT, Inc. account and create a Shared Page. This is the mechanism that allows SpotWalla to acquire your device's message data. When creating a Shared Page, keep these recommendations in mind...
    • Don't add multiple devices to the Shared Page. Each SPOT device requires its own shared page.
    • Give the page a name that describes its use. For instance, SPOT/SpotWalla XML Interface.
    • Include all message types on the page.
    • Include the message detail. This is the custom message you assign to each message type in your SPOT account.
    Create the page, copy its URL and enter it in the SPOT Shared Page field.
  9. If you assigned a password to the shared page, enter the password in the Password field.
  10. If you want SpotWalla to poll your device for messages, ensure its message interface is active.
  11. Click the Update button.

Top

Creating & Updating an SWConnect iOS App Device

To create/update and configure an SWConnect iOS App device, follow these steps...

  1. Log into SpotWalla, click your username in the upper right corner of the window and choose Devices from the menu. This will take you to your devices page.
  2. If you're creating a device, click the button. If you're updating a device, click the device description and choose Update from the menu.
  3. Select SWConnect iOS App Device from the Device Type list.
  4. Enter a description for this device. This text will appear in your device list as well as any other place where a device description is displayed. Use something descriptive, but don't write a book.
  5. Select your Region and Timezone.
  6. If you want this device to be the default device, click the control until Yes is displayed.
  7. Click the Create or Update button.

You must now enable your SWConnect iOS App device for Web API access. After completing the above steps you should be on the Devices screen. If so, you can skip steps 1 and 2 below.

  1. Log into SpotWalla, click your username in the upper right corner of the window and choose Devices from the menu. This will take you to your devices page.
  2. Find the SWConnect device, click its description and choose Web API from the menu. This will display the Web API Settings and Statistics page.
  3. Click the Enabled/Disable Web API Access folder to display its content.
  4. If the device is enabled for Web API access, you'll see a green area that states as much and a Disable button underneath. If the device is not enabled for Web API Access, you'll see a red area that states as much and an Enable button underneath. Ensure your device is enabled.

The rest of the setup is accomplished in the SWConnect application on your phone.

Top

Creating & Updating The Wirie pro Device

To create/update and configure The Wirie pro device, follow these steps...

  1. Log into SpotWalla, click your username in the upper right corner of the window and choose Devices from the menu. This will take you to your devices page.
  2. If you're creating a device, click the button. If you're updating a device, click the device description and choose Update from the menu.
  3. Select The Wirie pro Device from the Device Type list.
  4. Enter a description for this device. This text will appear in your device list as well as any other place where a device description is displayed. Use something descriptive, but don't write a book.
  5. Select your Region and Timezone.
  6. If you want this device to be the default device, click the control until Yes is displayed.
  7. Click the Create or Update button.

You must now enable the device for Web API access. After completing the above steps you should be on the Devices screen. If so, you can skip steps 1 and 2 below.

  1. Log into SpotWalla, click your username in the upper right corner of the window and choose Devices from the menu. This will take you to your devices page.
  2. Find The Wirie pro device, click its description and choose Web API from the menu. This will display the Web API Settings and Statistics page.
  3. Click the Enabled/Disable Web API Access folder to display its content.
  4. If the device is enabled for Web API access, you'll see a green area that states as much and a Disable button underneath. If the device is not enabled for Web API Access, you'll see a red area that states as much and an Enable button underneath. Ensure your device is enabled.

The rest of the setup is accomplished when setting up The Wirie pro device itself. For more information see: The Wirie pro SpotWalla Integration.

Top

Using the Email Interface

The email interface can be used to create a message for any SpotWalla-supported device by sending a well-defined and well-formatted message to SpotWalla via email. For all of this to work, the message itself should be sent using plain text and include the following lines at a bare minimum...

device key: <device key>
datetime: <date-time>
latitude: <latitude>
longitude: <longitude>

You may also include one or more of the following lines...

message: <short message>
type: <message type>
small url: <small pic URL>
large url: <large pic URL>
no-reply-on-success

Each field has a specific format and strict requirements. Each field is explained below...

Field Description
<device key>

This identifies your device specifically. You can find your device's key by...

  1. Log into SpotWalla, click your username in the upper right corner of the window and choose Devices from the menu. This will take you to your devices page.
  2. Find the device, click its description and choose Web API from the menu. This will display the Web API Settings and Statistics page.
  3. In the The Device's API Key folder to display its content, if it's not already displayed.
  4. Copy the device key to the clipboard.
  5. Ensure your device is Enabled for Web API access. Click the Enable/Disable Web API Access folder and ensure your device is enabled for Web API access. You should see a green line indicating the device is enabled.
<date-time>

This is the message's date/time stamp and must be in your device's timezone. SpotWalla does not adjust this time at all. Here's an example...

2013-02-01 13:05:00

The date part is in yyyy-MM-dd format. Be sure and zero-pad the month and day. The time part is in hh:mm:ss format. The hour is in 24-hour format. So 08 is 8AM and 20 is 8PM. Be sure and zero-pad all three components, if necessary.

<latitude>
<longitude>

Both coordinate values are in decimal format. So 34.3453 is a valid coordinate value.

<short message>

A short, one-line message. About 50 characters or less.

<type>

A one-character message type you want to send where O = OK, T = Tracking, C = Custom and H = Help. The default is O.

<small pic URL>
<large pic URL>

If you're storing pictures somewhere and want to associate a small/large pic, use these elements to indicate where the pictures are stored. These URLs must start with either http:// or https://

Since SpotWalla uses the HTTPS protocol throughout the website, ideally your picture URLs will use HTTPS as well. This will ensure that viewers of your trips will not see warnings about unencrypted content on SpotWalla.com.
no-reply-on-success

By default the email interface replies to each message it receives in order to inform the sender if the location data was processed successfully or failed. The email interface will always reply if errors are present, but if you want to supress the reply when successful, simply include this command on its own line in the email. Here's an example...

Putting all of this information together, here's a sample message:

device key: 876324923b23ae123
datetime: 2015-02-17 22:56:00
latitude: 35.12312
longitude: -95.23123
message: I was here.
type: O
small url: http://some.com/image1.jpg
large url: http://some.com/image2.jpg

When your message is complete, send it in a plain text message to messages@spotwalla.com. After processing the message, the interface will send a reply indicating success or failure.

Top

Activating a Disabled Device

To activate a disabled device, follow these steps...

  1. Log into SpotWalla, click your username in the upper right corner of the window and choose Devices from the menu. This will take you to your devices page.
  2. Find the device, click its description and choose Update from the menu.
  3. Toward the bottom of the form, activate the message interface by clicking the toggle to Yes.
  4. Click the Update button.

Top

Message Browsing & Downloading

Browsing a device's messages is a quick way to see the latest messages that have arrived and to also see more detailed information about each message. For instance, when browsing messages you can see each location's geocode (i.e. the address or geographic region of the location's coordinates). If your device has one or more secure zones, then you will also see the location's distance from the nearest secure zone and whether or not the location falls within a secure zone.

To browse a device's messages ensure you're logged into SpotWalla and click your name in the upper right corner of the window and choose Devices from the menu. Find the device you want to browse, click its description and choose Browse Messages from the menu. The table will display the following information for each location:

  • Number - Messages are displayed in descending order. This value is the sequential number assigned to the location. Clicking this number will allow you to associate a picture with this location. If this location has an assigned picture, a small camera icon will appear. For more information on locations and pictures see: Adding Pictures to Locations. A small trashcan icon appears next to the number. Clicking it allows you to delete the location.
  • Date - This is the date and time the message was captured by its source system. Hovering the mouse over the field will display the location's assigned timezone.
  • Type - The type of message sent. All locations entering SpotWalla are either Ok, Help, Custom or Tracking messages.
  • Source - The interface over which the message entered SpotWalla. SPOT indicates the message is from the SPOT XML Interface and GOOGLE LATITUDE indicates the message is from the Google Latitude interface.
  • Latitude - The location's latitude. Clicking this link allow you to quickly create a secure zone around this location.
  • Longitude - The location's longitude. Clicking this link allow you to quickly create a secure zone around this location.
  • Bearing - The bearing in degrees from true north between this location and the previous location. The intent of this value is to show your direction of travel at the time this location was acquired. It may not be representative of the entire route over time. The value consists of a number between 0 and 359 degrees and a direction indicator (e.g. N, S, E, W, NW, SE, etc).
  • Elevation - The location's elevation in meters. Note: For SPOT devices, there's a brief period of time after SpotWalla receives the location when elevation data will not be available.
  • MPH - Your calculated speed in Miles Per Hour.
  • KPH - Your calculated speed in Kilometers Per Hour.
  • KNOTS - Your calculated speed in KNOTS.
  • Location - The location's reverse GeoCode.
  • Message - The message sent along with this message.
  • Secure? - If the device is secured, this field will contain either YES or NO. YES indicates the location falls within a secure zone and NO indicates the location doesn't fall within a secure zone.
  • Distance - If the device is secured, this field shows the location's distance from the center of the closest secure zone.

You can download your device's messages while browsing. Toward the top of page you'll see these buttons...



Click the button for the type of download you desire. The following download types are supported:

  • GPX - A GPS eXchange file is compatible with most software and contains both tracks and waypoints. All tracking messages are downloaded as part of the "track" and all Ok, Help and Custom messages are represented as waypoints.
  • KML - A Keyhole Markup Language file is compatible with Google Earth and a lot of popular mapping related software.
  • CSV - A Comma-Separated Value file is compatible with practically every spreadsheet application ever written. The two most popular being Microsoft Excel and Open Office which can be downloaded for free from OpenOffice.org.

Top

Secure Zones

A secure zone is a region of the map where locations will not be displayed when the zone is activated. Each secure zone is defined by a set of coordinates and a radius. The coordinates determine the center of the zone and the radius determines the distance the secure zone extends from the center of the zone.

There are two types of secure zones - static and dynamic. A static secure zone has a static center. This type of secure zone is good for your home, place of business, grandma's house or any other specific location. A dynamic secure zone has a dynamic center that's defined by your last known location. A dynamic secure zone follows you as you travel.

Each device has a single dynamic secure zone that's inactive by default. You can configure zero or more static secure zones for your home, place of work, Grandma's house or anywhere else you may travel and desire a bit of privacy.

Each zone has the following attributes:

  • Active - SpotWalla will apply an active secure zone and disregard an inactive secure zone.
  • Description - A brief description of the zone.
  • Message - A short message that will be displayed by the Last Known Location widget when the last location falls within this secure zone. This field is optional.
  • Latitude - The zone's latitude coordinate.
  • Longitude - The zone's longitude coordinate.
  • Radius - The zone's radius measured in kilometers and in the range of 1 to 99.
You cannot set the description or coordinates of the device's dynamic secure zone. And it cannot be deleted either.

Follow these steps to manage a device's secure zones:

  1. Log into SpotWalla, click your username in the upper right corner of the window and choose Devices from the menu. This will take you to your devices page.
  2. Find the device, click its description and choose Secure Zones from the menu.
  3. A grid is displayed with all of the zones. To update an existing zone, simply make the update in place. To add a zone, use the empty row at the bottom of the grid. To delete a zone, check its Delete Zone? checkbox.
  4. When you're finished with the updates and/or additions, click the Update Zones button. Or click the Cancel button to abandon any changes and return to the devices page.

An easy way to find the coordinates for a new zone is by browsing the device's messages and clicking either the latitude or longitude coordinate.

A quick way to review the affect of these changes on your location data is to browse the device's messages. Two additional columns will be present indicating if the location falls within a secured perimeter and the distance in kilometers from the closest secure zone center.

For any device with one or more secure zones... All location pages you join using the device as well as the device's last location widget will not display any locations within an active secure zone. Trips, however, are slightly different. Each trip can be configured to apply the device's secure zones or not. This allows you to create a public trip for the world to see that honors active secure zones and a private trip for family and close friends that doesn't honor secure zones.

Top

Last Location Widget

A device's last location widget is essentially a URL to a page that displays the last known location on a map or as text. The URL can be used directly on a web page or wrapped in an IFRAME element and displayed in a blog or anything else you can think of.

By default, the widget is disabled. To enable and configure the widget, follow these steps:

  1. Log into SpotWalla, click your username in the upper right corner of the window and choose Devices from the menu. This will take you to your devices page.
  2. Find the device, click its description and choose Widget from the menu.
  3. You can enable or disable the widget.
  4. If you want the widget to display speed information, click the toggle to Yes. This can be a good indicator of movement and may be useful to those watching.
  5. You can control the type of locations that appear on the widget. By default all location types are selected. This can be useful if you're sharing your location publicly, but use certain message types to communicate with close friends and family only. For instance, if you use an OK message to indicate where you're spending the night, you may not want to display that information on the widget.
  6. Click the Update button.

At the bottom of the screen is the the widget's link. Click inside the field containing the link to highlight/select the link. You can now use the mouse or keyboard to copy it to the clipboard and paste it wherever you choose.

The widget's behavior can be customized to suit your needs using URL parameters. The widget's size is based purely on the container in which it's rendered. For instance, if you're using an IFRAME element, the size of the widget is the size of the IFRAME itself. The following parameters are accepted:

Parameter Acceptable Values Default Description
format map
text
map When set to 'map', the location will be shown on a map. When set to 'text', the location will be displayed using simple text. Additionally, 'text' format will always return the date/time of the last location. If the location falls outside an active secure zone, the coordinates are displayed. If the location falls inside an active secure zone, no coordinates are displayed. If the secure zone is configured with a custom message, it will be displayed.
mapType normal
satellite
hybrid
terrain
normal Determines the type of map displayed.
scale on
off
on When set to on a small scale control will be displayed at the bottom of the map.
scrollZoom on
off
on Turns scroll zooming on or off.
traffic on
off
off When set to on the traffic layer will appear on the map. Please note that the traffic layer isn't available in all areas of the globe or at all zoom levels.
zoomLevel >= 1
<= 20
12 Determines the initial zoom level of the displayed map.
All parameter names are case-sensitive.

When setting parameters in the URL take care not to modify the id parameter. This is the unique identifier assigned to this device.

If you feel that the widget's link has been compromised or for any other reason you want to generate a new one, click the button toward the top of the screen. This will invalidate the current link rendering it useless to anyone who has it and generate a new URL that you can use wherever you choose.

Generating a new link may come in handy under certain circumstances. For instance, you added the widget to your blog while on a trip. While you're gone, the widget's link can be found and stored by industrious and potentially nefarious people. When you get back from the trip, you remove the widget from your blog, but you don't disable the widget. The person who has your widget's link can still see where you are as long as the location falls outside an active secure zone. To quickly and easily safeguard your location, simply generate a new link and invalidate the old one.

Top

Uploading GPX Data

You can upload GPX data to any device in SpotWalla. If you're uploading data to a SPOT device, the GPX file must originate from SPOT, Inc. This allows SpotWalla to ensure all location data is uploaded correctly to your device. If you're uploading data to any other device, SpotWalla performs a generic import. All waypoints are stored as OK locations and all track segments are stored as tracking locations.

To upload GPX data to a device, follow these steps:

  1. Log into SpotWalla.
  2. Click your name in the upper right corner of the window and choose Devices from the menu.
  3. Now click the button.
  4. On the next screen you'll need to first select the device you want to own the uploaded location data.
  5. Click the Browse button and find the GPX file you want to upload.
  6. Click the Upload button.
  7. If any errors were encountered, you'll see the error on the next screen. If the error persists, please contact SpotWalla support. If the file was uploaded without error, the next screen will tell you how many locations were found in the file, how many were created for the device, the type of locations created...

Top

Email Notifications - Managing Profiles

Notification profiles determine both who receives an email as well as the message they receive. Profiles will be assigned to a device's messages in the next section - Email Notifications - Assigning Profiles.

Follow these steps to create a profile...

  1. Log into SpotWalla.
  2. Click your name in the upper right corner of the window and choose Devices from the menu.
  3. Click the button.
  4. If you've already created one or more profiles, you'll see a table listing the profiles. To view/update one of these profiles, click the button. To delete a profile, click the appropriate button. To create a new profile, click the button.
  5. Each profile needs a name. Give it a descriptive name, but don't write a book. Remember, you're going to assign a profile to a device's message types and categories.
  6. Each profile can have one to ten email recipients. Enter the email addresses. One in each text box.
  7. Now enter the message you want to send. Messages are limited to 2048 characters. You control the format of the message. You can also include one of more of the following message parameters and SpotWalla will substitute the appropriate value...
    Parameter Description
    %batteryStatus% The battery's known status. This only applies to those devices that are capable of reporting the device's battery status. For instance, SPOT devices.
    %category% The message's category. This only applies to device's that are capable of setting the message category. For instance, Bubbler GPS and SWConnect devices.
    %elevationFeet% The location's elevation in feet.
    %elevationMeters% The location's elevation in meters.
    %largePicture% The location's large picture URL, if it exists.
    %latitude% The location's latitude coordinate.
    %location% The nearest location information, when available.
    %longitude% The location's longitude coordinate.
    %messageDate% The date/time the device generated the message.
    %messageSource% The message's source (e.g. SPOT, BUBBLER, INREACH, etc.)
    %messageText% The message text received with the location data.
    %messageType% The type of message received.
    %privateTrips% The links to any active private trips. These links will contain the trip's password, if one has been assigned.
    %publicTrips% The links to any active public trips.
    %smallPicture% The location's small picture URL, if it exists.
    %speed% The speed/bearing information for this location.
    %timezone% The device's timezone.
    %widget% A link to the device's last known location widget.
  8. When you're finished editing the profile, click the Create or Update button.

Here's a sample of the message I use for short stops...

I'm stopping for a short period of time. I don't intend to stay here.

Date/Time: %messageDate% %timezone%
Coordinates: %latitude%, %longitude%
Battery Status: %batteryStatus%

If you want to see this location on a map, click this link...
https://spotwalla.com/showLocation.php?lat=%latitude%&lon=%longitude%

If you want to see the trip I'm on and where I've been, click this link...
%privateTrips%

Please don't share this trip link with anyone without my permission. Love you.

Jason

Top

Email Notifications - Assigning Profiles

Before assigning notification profiles to a device's message types and categories, you must first have created at least one profile. If you haven't, see the previous section - Email Notifications - Managing Profiles.

Profiles are assigned to a device's messages by the type of message received (e.g. Ok, Help, Custom or Tracking) and by the message's category (e.g. Food, Gas Stop, Hotel, etc). Depending upon the device, not all of the message types and categories will apply.

To assign your profiles to a device's messages, follow these steps...

  1. Log into SpotWalla.
  2. Click your name in the upper right corner of the window and choose Devices from the menu.
  3. Find the device you want to manage, click its description and choose Email Notifications from the menu.
  4. On the next screen select the message type and category.
  5. Now select the profile you want to assign and click the button.
  6. Repeat steps 4 and 5 for each profile assignment you wish to create. As profiles are assigned you will see them listed at the bottom of the page.

To remove an assignment follow steps 1-3 above and click the button for the assignment you want to remove.

Top