skip navigation
See Also
Customize spud code
URL parameters
Longitude URL parameter

Latitude URL parameter

The lat parameter is an optional parameter that can be:

  • Included in the url argument in the $Trumba.addSpud() method.
  • Appended to the trumbaEmbed parameter in a URL-encoded query string.
  • Appended to the base URL for an RSS, Atom (XML), iCalendar (ICS), Comma Separated Value (CSV), or JSON calendar feed.

I'd like to see a complete list of URL parameters.

I'd like to know more about calendar feeds.

Application

Limits the events a spud displays to those that occur at or within a specific radius of a geographic location identified by a latitude value.

Must be accompanied by the longitude (lon) and radius (radius) URL parameters.

Note The latitude parameter works only when events listed in a spud are mapped.

How do I map events?

Values

  • Any latitude value between and including +90 (90 degrees north) and -90 (90 degrees south).

    Tip Latitude values that omit the plus or minus sign are assumed to be north.

  • No limit on the number of decimal places.

Works with

  • Main calendar spud
  • Promotion spuds
  • Date finder spud
  • Monthlist spud

Examples

url argument, $Trumba.addSpud() method, Main calendar spud

In the default main calendar view, displays only events that occur within 50 miles of the location specified by the latitude and longitude values.

<script type="text/javascript">
$Trumba.addSpud(
{ webName: "calendarname",
  spudType: "main",
  url: {lat:47.66417, lon:-122.387695, radius:50}
});
</script>

url argument, $Trumba.addSpud() method, Upcoming events promotion spud

In an upcoming promotion spud, displays only events that occur within 250 miles of the location specified by the latitude and longitude values.

<script type="text/javascript">
$Trumba.addSpud(
{ webName: "calendarname",
  spudType: "upcoming",
  url: {lat:-14.235004, lon:-51.925280, radius:250},
  teaserBase: "http://www.yoursite.com/calendar.html" });
</script>

The teaserBase property directs visitors who interact with the spud to the appropriate main calendar page.

URL-encoded query string

In the appropriate spuds embedded at the base URL, displays only events that occur within 100 miles of the location specified by the latitude and longitude values.

http://www.yoursite.com/calendar.html?trumbaEmbed=lat%3D47.677896%26lon%3D-122.303537%26radius%3D100

Tip %3D is the URL-encoded equals sign (=). %26 is the URL encoded ampersand (&).

Calendar feed URL

In the RSS feed at the base URL, displays only events that occur within 100 miles of the location specified by the latitude and longitude values.

http://www.trumba.com/calendars/calendarwebname.rss?lat=47.677896&lon=-122.303537&radius=100

Tip In calendar feed URLs, do not include trumbaEmbed= and do not URL-encode parameters.