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

Radius URL parameter

The radius 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

Identifies the distance away from a specific latitude and longitude location that an event can occur and still be displayed in a spud. (Distance is based on the flight rather than the driving distance.)

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

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

How do I map events?

Values

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 (or kilometers) 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 (or kilometers) 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 (or kilometers) 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.