Devices

SpotWalla supports multiple devices, both satellite- and cellular-based devices. Satellite trackers include:

• Garmin Satellite Trackers - All InReach devices and other satellite-based devices from Garmin
• SPOT Trackers - All SPOT tracking devices.
• ZOLEO Satellite Communicator

Cellular-based phones apps support include:

• Bubbler GPS (Android)
• SWTracker (iOS)

Choosing the right device depends on where your travels will take you. If your travels are mostly within cellular coverage areas, then one of the smart phone applications will serve you well and provide the most cost-effective solution. But if you're a true globetrotter, a satellite-based tracker from Garmin, SPOT or ZOLEO is what you need.

To create a device go to the Device Manager and click the New Device button.

You will see a screen similar to this:

Enter a short description of the device. If you're into anonymity, don't use your name in the description. The description will appear in message detail popups and other places that appear on public location pages you may have joined.

Choose the type of device from the Device Type list. If you're creating a device for a phone app, no more information is required. If you're creating a Garmin, SPOT or ZOLEO device, additional information is required and will appear below the list after choosing the device type.

SPOT Device

The following information is required:

• Serial/ESN - This value uniquely identifies your device. No other SPOT device has the same number. You'll find this value somewhere on the device itself (e.g. battery compartment) or in the paperwork that came with the device. You will have found this value when activating your device with SPOT.
• XML Feed ID - SpotWalla acquires your device's location data by periodically polling SPOT for new locations. To do this, we use SPOT's XML Feed API. You will need to create an XML Feed in your SPOT account and configure your device in SpotWalla with the feed's ID. See the help links below.
• Feed Password - This is not your SPOT account password. This is a password you can assign to the XML Feed when you create it.

If you need help creating a SPOT XML Feed for your SPOT device, try one of these help pages:

Creating a SPOT XML Feed - New SPOT Account Manager
Creating a SPOT XML Feed - Old SPOT Account Manager

Garmin InReach

The following information is required:

• IMEI Number - This value uniquely identifies your device. No other device InReach device has the same number. You'll find this value somewhere on the device itself (e.g. battery compartment) or in the paperwork that came with the device.
• Raw KML Feed - SpotWalla uses the Garmin Raw KML Feed API to acquire location data for your device. Your device has a Raw KML Feed URL and you'll need to log into your Garmin account to find it. This URL will be used to configure your device in SpotWalla. See the help page link below for help on how to find this URL.
• Feed Password - This is not your Garmin account password. This is a password you can assign to Garmin MapShare page and, if assigned, will be needed to use the Raw KML Feed.

For more details on finding your device's Raw KML Feed URL:

Finding the Garmin Raw KML Feed URL

ZOLEO Satellite Communicator

The following information is required:

• IMEI Number - This value uniquely identifies your device on the Iridium Satellite network. No other device (ZOLEO, InReach, etc) has the same number. You'll find this value somewhere on the device itself (e.g. battery compartment) or in the paperwork that came with the device.

To configure your ZOLEO to send SpotWalla an email each time you send a Check-In message, log into your ZOLEO account and add a contact. Name the contact Zoleo Interface and assign it the email address zoleo@spotwalla.com. That last part is critical. This is the email address that will allow SpotWalla to receive and process your ZOLEO location data.

Now configure this contact to receive an email each time you send a Check-In message.

Click on Devices & Plans in the left panel and then click the Contacts tab. Now add the Zoleo Interface user as a Check-In and Location Share contact. That should do it.

Step 1. Log Into Your SPOT Account

The first step is logging into your SPOT Account. After logging in you'll see these options toward the top of the page:

Step 2. Click the Settings & Billing option.

Scroll the list down and find the XML Feed section. Click the View/Edit button. On the next page you'll see a Create XML Feed button highlighted below. Click that button.

Step 3. XML Feed Options

When setting the feed options, use this as a guide:

Set the feed name to SpotWalla/SPOT Interface or any other name that identifies this feed as the one you're using for SpotWalla.

If you have multiple SPOT devices, you'll need to create an XML Feed for each device you want to use with SpotWalla. So in the Devices list, only choose the one you're setting up now.

For "Location Messages to Share" click the Select All option. Choosing all available location messages to share will ensure SpotWalla receives all available messages.

We recommend sharing locations from the last 7 days - the maximum number of days.

We recommend sharing message detail. If you've configured messages for your OK, Custom and Help messages in your SPOT account, enabling this option will allow the messages to flow into SpotWalla.

We recommand making your feed private and setting a password. Please do not use your SPOT Account password here. Something simple will do.

Step 4. Acquiring the Feed ID

After setting the appropriate options, click the Create button. You will be returned to the XML Feed page. The new feed will appear in the list. Something like this:

Click the View Details link (highlighted above) to expose the feed details. You will see the XML Feed ID (also highlighted above). Copy the XML Feed ID.

Now log into your SpotWalla account and update your device. Use the XML Feed ID and password in the fields highlighted below:

Step 1. Log Into Your SPOT Account

The first step is logging into your SPOT Account. After logging in you'll see these options toward the top of the page:

Step 2. Find the Create XML Feed Link

Click the XML Feed link. On the next page you'll see a Create XML Feed link highlighted below. Click that link.

Step 3. Feed Options

When setting the feed options, use this as a guide:

If you have multiple SPOT devices, you'll need to create an XML Feed for each one you want to use with SpotWalla. So in the Devices list, only choose the one you're setting up now.

Choose all available location messages to share. The other options are fine, although we recommend making the feed private and protecting it with a password.

Step 4. Acquiring the Feed ID

After setting the appropriate options, click the Create button and a popup window will appear like this one:

Copy the XML Feed ID from the dialog. If you set a feed password, take note of it. When setting up your device in SpotWalla enter these values for the XML Feed ID and Feed Password attributes.

Step 1. Log Into Your Garmin Account

The first step is logging into your Garmin Explore Account. After logging in you'll see these options toward the top of the page:

Step 2. MapShare Settings

Click the Social link in the menu. On the next page you'll see your MapShare settings:

First, ensure that MapShare is enabled. You should see the green MapShare: On button. If MapShare isn't enalbed, enable it. We also recommend setting a password when enabling MapShare, but that's up to you. Click the MapShare Settings button to see the password and other options.

Step 3. The Raw KML Feed URL

Once MapShare is on, you will see a teeny-tiny Feeds link just to right of the MapShare URL. Click that link and you'll see this dialog:

Copy the Raw KML Data link. If you set a password on your MapShare page, make note of it. When configuring your device in SpotWalla set the Raw KML Feed and Feed Password attributes using these values.

The Message Browser is an easy way to see your device's messages. There are two ways to access the browser. First, your devices are listed on the Dashboard. Click the number in the Messages column.

You can also find the message browser from the Device Manager. Find you device and click its name. Then select Browse Messages from the menu.

Depending on what you're using (laptop, phone, tablet) to browse messages, the browser will tailor the amount of information displayed. If you're on a laptop with a big screen, you'll see all information like this:

The fields displayed are:

• # - The message number.
• Date - The date the message was received in your chosen timezone.
• Source - The type of device that produced the message.
• Type - The message type.
• Coordinates - The coordinates of the location in decimal format.
• Speed - The speed at the time the message was sent. In most cases, speed is calculated and is not a reliable indicator of the actual speed. It is a reliable indicator of movement.
• Heading - Like speed, this is a calculated value. The value is based on the angle from the previous location.
• Message - Any message text sent with the message.
• Picture - The picture associated with the message. If your device can submit pictures (e.g. Bubbler GPS and SWTracker), this is the picture. If your device cannot submit pictures, then you can add pictures by click the picture icon.

Adding Pictures & Viewing Message Detail

To view the message detail and/or add a picture click either the message number (first field) or picture icon (last field). You'll see this...

To add a picture to the message, enter the links to the small and large pictures in the appropriate fields and click the Update button.

Secure zones are circular regions of the map where you do not want to display your location in trips or location pages. Each zone is defined by a center location and a radius. There are two types of secure zones:

1. Dynamic Zone - Every device has one and only one dynamic zone. This zone follows you. Its center is always on your last known location. You can adjust the radius to suit your needs. A dynamic zone is useful when you want to share your travels publicly, but don't necessarily want to expose your last known location. For instance, where you stopped for the evening or for lunch or just to keep people guessing on your next move.
2. Static Zones - A device can have zero or more static zones. These zones have a static center and a radius. Static zones are useful to safeguard your home location, grandma's house, your place of work or any other region where anonymity is desired.

There are two ways to manage secure zones. First, from the Device Manager. Find your device and click its name. Choose Secure Zones from the menu. Second, from the device's Message Browser you can click the lock icon next to any message's coordinates. The secure zones page will appear and the coordinates you clicked on will prepopulate the form.

Device Manager

Message Browser

The secure zone management screen will look like this...

The tabs at the top, Static Zones and Dynamic Zone, are used to group your zones. Clicking either tab will display the zones of that type.

Since this device doesn't have any static secure zones defined, you just see the empty fields that are used to define a new static zone. The fields are:

• Description - A short description of this zone (e.g. Home, Work).
• Latitude - Used to define the center of this zone.
• Longitude - Used to define the center of this zone.
• Radius (Km) - The zone's radius in kilometers. One mile is about 1.6 kilometers.
• Active - Indicates if the zone is active or not. A checkmark indicates active.
• Delete> - For zones that exist, checking this box and clicking the Update Zones button will delete this zone.

All static zones will be displayed in the list. You can update any of them or check the box to delete a zone. Clicking the Update Zones button will apply any changes made.

The dynamic zone tab looks like this:

A device's dynamic zone cannot be deleted. You can update its description, radius and active status. By default, the dynamic zone is not active. To enable it, check the box next to Check to Acivate the Dynamic Zone and click the Update Zones button.

Click the Upload GPX Data button to start the upload process. You'll see:

Choose the device you want to use. Then click the Browse... button and find the GPX you want to upload and process. Now click the Upload button. When the file is finished processing you will see the results.

Email notifications allow you to send an email to any number of people when your device produces a chosen message type. Each device has its own notifications. You can manage them by going to the Device Manager. Find your device and click its name. Choose Email Notifications from the menu.

The notifications page will look similar to this:

If the device has notifications, you will see them in a list. To update or delete an existing notification, click its name and select Update or Delete from the menu. To create a new one, click the Create a Notification button. You'll see this page:

Enter a description and choose the message type. The list of message types is tailored to the type of device. So if it's a SPOT device, you'll see Ok, Help and Custom message types.

Now enter one or more email addresses in the Send To field. Separate each email address with a comma.

The message you want to send is customizable using parameters. Before sending the email, SpotWalla will replace each parameter in the message with the information it represents. You can easily add parameters to the end of your message by clicking a parameter name from the list to right of the message.

Here's the list of available parameters:

Here's a sample notification I send when sending an OK message from my SPOT device. I use OK messages to mark overnight stops.

The %privateTrips% parameter will be replaced with the list of active private trips and my loved ones will be able to click the link and see where I'm at.

You can choose to activate/disable a notification. Remember to click the Save or Update button at the bottom of the screen.

You can download your device data in three formats - CSV, KML and GPX. From the Device Manager click the

The downloads screen will appear:

Choose the type of download and the device you want to use. If you want the download to honor active secure zones, ensure the Apply Active Secure Zones? checkbox is checked.

Now choose the start/end dates and click the Downloads button. Depending on your operating system, how it's configured and what options you've set, you will likely get an option to open or save the download file.

When you're finished downloading files you can click the Devices button to get you back to the Device Manager screen.

The email interface allows anyone or anything to create messages for a device simply by sending an email message. For this to work, the message should be sent using plain text and contain the following fields at a minimum:

The following fields are optional:

Each field has a specific format and strict requirements:

<device key>

<datetime>

<latitude>

<longitude>

<message>

<message type>

<small pic URL>

<large pic URL>

no-reply-on-success

Putting all of this together and assuming the device key is 9e8a-9z0ac-c23d, here's a sample email message:

All you have to do is send the email to new-messages@spotwalla.com. A reply will be sent indicating the success or failure of the message. When you gain confidence in the interface, you can include the no-reply-on-success command to suppress the reply when the request is successful.

A user may want to purge the messages from a device or purge a device from SpotWalla in order to reduce the cost of using SpotWalla. We don't encourage removing data unless you are absolutely sure it's the right thing to do. These actions are permanent.

To purge messages or an entire device, follow these steps...

1. Log into SpotWalla
2. On the Dashboard, go to the Device Manager by clicking one of the highlighted elements below.
   
3. Find the device and click its name. Then select Delete from the menu.
   
4. On the next screen, confirm your intentions by typing delete all to purge the device from SpotWalla or type delete messages to delete the device's messages only.
   

   Then click the Delete button and you're done.