Place a real-time APRS map on your web page!

Simply paste the following HTML code on your web page, and you'll have an automatically updating real-time APRS Google map running in minutes. Put the APRS callsign of your car in the he_track variable (replacing Rautauoma, a rescue vessel in Helsinki), and the map will show the position of your car!

	<p>
	<script type="text/javascript">
	he_track = "Rautauoma"; // track this callsign
	</script>
	<script type="text/javascript" src="//aprs.fi/js/embed.js">
	</script>
	</p>

Important:

The map really does update automatically every few seconds. When any information shown on the map is updated on the APRS-IS, the real-time map will update within seconds. So please, do not use the 'meta refresh' tag to automatically reload a page containing a real-time map. It will only slow down the browser, and place unnecessary load on the server and the network. And it will annoy your page's visitors - if he or she has moved or zoomed the map view, the automatic reload will reset the selected view back to the initial settings.

This map is generated by the HTML code shown above:

Options which can be set in the javascript:

• he_width
  The width of the map in pixels (defaults to 550 pixels)
• he_height
  The height of the map in pixels (defaults to 350 pixels)
• he_zoom
  Initial zoom level as an integer value between 0 and 17. 0 will show the whole earth, 17 is the maximum zoom level. Defaults at 11, which is a good starting point.
• he_maptype
  Initial map type, takes a string value:
  • 'm': Normal map
  • 'k': Satellite view
  • 'h': Hybrid satellite/map
  • 'p': Physical map
• he_track
  The APRS station or object/item name to track, takes a string value: he_track = 'N0CALL-15';
  To track multiple stations, separate them with a comma (','): he_track = 'CALL1,CALL2';
• he_show_others
  A value of 1 will make other stations than the tracked one visible, but the map will still center on the tracked station in the beginning, and as new position reports are received. There is a caveat - if there are no recent position reports from the tracked station (within 1 hour), it will not be visible. The map will just start centered on it's last known position. Example: he_show_others = 1;
• he_lat and he_lng
  Initial latitude and longitude when the map starts in decimal (he_lat = 42.715517;). Positive latitude is northern hemisphere, negative latitude is southern hemisphere. Positive longitude is eastern hemisphere, negative longitude is western hemisphere. If he_track is set, the map will start at the position of the tracked target and these options will not apply.
• he_hide_tcp
  A value of 1 will only show stations heard over the radio (hiding stations with a TCP* path).
• he_show_aprs
  Show APRS stations (which are neither weather stations or items/objects), takes a string value:
  • '' (empty string): do not show
  • 'p': only show current position
  • 't': show track line
  • 'w': show track line and waypoints
  The default for embedded maps is 't' (show track line).
• he_show_aprs_w
  Show APRS weather stations, takes a string value like he_show_aprs
• he_show_aprs_i
  Show APRS items and objects, takes a string value like he_show_aprs
• he_show_ais
  Show AIS vessels, takes a string value like he_show_aprs

A more complicated example:

	<p>
	<script type="text/javascript">
	// latitude and longitude of Miami, Florida
	he_lat = 25.696;
	he_lng = -80.174;
	he_zoom = 10; // zoom out a bit
	he_maptype = 'h'; // hybrid map
	// select what to show
	he_hide_tcp = 1; // do not show Internet stations
	he_show_aprs = 'w'; // show APRS stations with waypoints
	he_show_aprs_w = ''; // do not show APRS weather stations
	he_show_aprs_i = 'p'; // only show the current position of items without track
	he_show_ais = ''; // do not show AIS ships
	</script>
	<script type="text/javascript" src="//aprs.fi/js/embed.js">
	</script>
	</p>

The usual disclaimer:

This service is provided free of charge. There is no warranty. If it breaks, you get to keep both pieces. Please don't abuse the service. Please do not alter the javascript code. Do not try to hide the 'powered by Google', map copyright or aprs.fi tags or links. The embedding functionality is intended for web sites, not for apps duplicating aprs.fi functionality. This is a beta-quality service - the API might change without notice, or the service might end if it causes too much load on the server.

Happy HTML hacking, have fun!