What is a Location Page?
A location page is a map showing the last known location of multiple users. While it doesn't show each user's history, it's an easy way for event coordinators and user groups to know where their participants and members were last located as opposed to viewing each user's trip page individually.
Creating a Location Page
If you're interested in creating a location page for your event or group or whatever, email us at email@example.com and provide the following information:
- Name - A short name for the location page.
- Description - A brief description of the page.
- Timezone - The default timezone for the page's start/end dates is America/Chicago. If you want the page to honor a different timezone, please let us know.
- Start Date - The date the page should activate.
- End Date - The date the page should deactivate.
- View Password - If you want a private location page, a view password must be supplied by anyone trying to view the page.
- Join Password - If you want to restrict the users that can join the page, a join-password should be used.
- Show Coordinates? - Each location's popup window contains the coordinates of the location. You can choose to not display the coordinates.
- Show Time? - Each location's popup window contains the date and time of the location. You can choose to not display the time component for each location.
- Show Username? - When hovering the mouse over a user's icon, the username is displayed. This option can be disabled in order to help protect the user's anonymity.
- Show Speed? - SpotWalla calculates the speed for each location. This data is merely an approximation and and is not accurate. It's a good indicator of movement. If this option is enabled, the user's speed (MPH, KPH and Knots) will be displayed in the popup window when clicking on an icon.
- Map Type - Your choices are Normal (default), Satellite, Hybrid (satellite with map overlay) or Terrain.
Viewing Location Pages
Follow these steps to view the list of currently active location pages:
- Navigate to the SpotWalla home page.
- In the lower half of the screen is a series of folders. Click the Active/Future Location Pages folder.
- The folder will expand and display the list of location pages. The location pages with a red background are not currently active. A green background indicates the page is currently active. If the page is private, it will have a icon next to the name.
- Find the location page you want to view and click its name. The location page viewer will display the page. Clicking an icon on the map will display a popup window with the detail for that location.
At the top of the page is a navigation bar that looks similar to the following...
From left to right... the house icon, when clicked, will take you back to the home page. The location page name, when clicked, will display a menu of options discussed below and then there are some statistics about the page - how many users have joined and are displayed and the number of times the location page has been viewed.
Clicking the location page name displays a menu. Clicking Information will display detail information about the page. Clicking Users will display user information. Clicking a user in the list will zoom in on that user's location. Clicking Adjustments allows you to display the current traffic layer. Clicking Legend displays information about how to interpret the various icons used to mark a user's location.
Joining a Location Page
Users must explicitly join a location page. Because a user's location is regarded as personal/private information, SpotWalla will never auto-join a user to a location page. The prerequisites for joining a page are:
- You must have a SpotWalla account. For more information see Creating an Account.
- You must configure a supported device and activate its message interface. For more information see Message Interfaces.
Once the prerequisites are satisfied, follow these steps to join a page:
- Login to your SpotWalla account.
- From the SpotWalla homepage, click the Active/Future Location Pages folder in the lower half of the screen.
- Find the page you wish to join.
- To the right of that page in the Actions column, click the Add Me link.
- If the location page requires a join password, you must supply it here. If it doesn't have a join password, this field will not be shown on the screen.
- Choose the device you want to use for this location page. Only messages from this device will update your location on this page.
- Choose the location ID you want to use on this page. The default is the value from your Preferences, but you can change it here, if desired or required.
- Select the types of messages that will update your location on this location page. For security reasons
you may want to control this behavior. For instance, if you use the OK message to mark where you're
the evening, you may not want to advertise that location on a public location page.
This option only applies to devices capable of sending different message types (e.g. SPOT, Garmin/DeLorme InReach, Bubbler GPS and SWConnect).
- Click the Join button.
- Depending upon how you've set the above options, SpotWalla may find a suitable location automatically. If it doesn't, your location won't appear on the page until you send a location that meets the above options.
Embedding Location Pages
Embedding allows you to include a fully-functional map of your location page in a webpage or blog post. The only requirement is that the HTML IFRAME element must be supported by your browser as well as the system where your page or blog is hosted.
The basic syntax of the IFRAME element used to embed a location page is:
<iframe src='location viewer link goes here' width='800' height='600' scrolling='false' frameborder='0'> Embedding failed because inline frames are not supported by your browser or the web server. </iframe>
If the viewer's browser doesn't support IFRAMEs, the Embedding failed... message will appear instead of the location page. The width and height parameters determine the width and height of the IFRAME respectively. The other parameters affect the IFRAME's characteristics. For more information on the IFRAME element, refer to your favorite HTML documentation.
The location viewer link goes here text will be replaced by the link to the location page that you received in the email sent to you after creation. Simply replace the location viewer link goes here text with it. For example:
<iframe src='http://spotwalla.com/locationViewer.php?id=1' width='800' height='600' scrolling='false' frameborder='0'> Embedding failed because inline frames are not supported by your browser or the web server. </iframe>
If your location page is configured with a view password, consider adding the password to the link using the p parameter. Otherwise, the viewer will be prompted for the password. Here's an example of how to add the view password to the link:
<iframe src='http://spotwalla.com/locationViewer.php?id=1&p=aPassword' width='800' height='600' scrolling='false' frameborder='0'> Embedding failed because inline frames are not supported by your browser or the web server. </iframe>
One issue with embedding a location page like the one above is that a link to the SpotWalla Home page is present in the top navigation pane. If the viewer clicks the link, they will navigate to the home page within the IFRAME. Not really a good option. To remove this link, add the showHome parameter to the link like this:
<iframe src='http://spotwalla.com/locationViewer.php?id=1&showHome=no' width='800' height='600' scrolling='false' frameborder='0'> Embedding failed because inline frames are not supported by your browser or the web server. </iframe>
You can choose to not display the top navigation bar altogether by adding the showInfo parameter to the link. For instance...
<iframe src='http://spotwalla.com/locationViewer.php?id=1&showInfo=no' width='800' height='600' scrolling='false' frameborder='0'> Embedding failed because inline frames are not supported by your browser or the web server. </iframe>
Location Page Parameters
Whether you're embedding a location or simply viewing a location page, the following parameters allow you to customize how the location page is displayed...
|lat||>= -90, <= 90||Determined automatically based upon the locations on the map.||The latitude of the center of the map.|
|lon||>= -180, <= 180||Determined automatically based upon the locations on the map.||The longitude of the center of the map.|
|zoom||>= 1, <= 20||Determined automatically based upon the locations on the map.||Determines the initial zoom level of the map.|
All parameter names are case-sensitive.