Ero sivun ”Aprs.fi user guide” versioiden välillä

Radioamatööriwikistä
Siirry navigaatioon Siirry hakuun
>Oh7lzb
>Oh7lzb
 
(153 välissä olevaa versiota 3 käyttäjän tekeminä ei näytetä)
Rivi 1: Rivi 1:
This page should eventually evolve into a comprehensive user guide for the [http://aprs.fi/ aprs.fi] web service. It's still in it's early stages. This is a Wiki page, so you're welcome to expand the document!
This is the official manual for the [http://aprs.fi/ aprs.fi] web service. This is also a Wiki page, so you're welcome to expand the document!


=Introduction=
=Introduction=


The [http://aprs.fi/ aprs.fi] web service collects information from the Automatic Packet (or Position) Reporting System Internet network (APRS-IS). APRS is used by amateur (ham) radio operators to transmit real-time position information, weather data, telemetry and messages over the radio. A vehicle equipped with a GPS receiver, a VHF transmitter or HF transceiver and a small computer device called a tracker transmits it's location, speed and course in a small data packet, which is then received by a nearby iGate receiving site which forwards the packet on the Internet. Systems connected to the Internet can send information on the APRS-IS without a radio transmitter, or collect and display information transmitted anywhere in the world.
The [http://aprs.fi/ aprs.fi] web service collects information from the Automatic Packet (or Position) Reporting System Internet network (APRS-IS). APRS is used by amateur (ham) radio operators to transmit real-time position information, weather data, telemetry and messages over the radio. A vehicle equipped with a GPS receiver, a VHF transmitter or HF transceiver and a small computer device called a tracker transmits it's location, speed and course in a small data packet, which is then received by a nearby iGate receiving site which forwards the packet on the Internet. Packets are also retransmitted on the radio channel by digipeaters to enhance the coverage of the system. Systems connected to the Internet can send information on the APRS-IS without a radio transmitter, or collect and display information transmitted anywhere in the world.


In addition to that, aprs.fi also displays [http://en.wikipedia.org/wiki/Automatic_Identification_System AIS] data transmitted by most large ships. AIS transmissions are [http://aprs.fi/page/ais_sites received by volunteers at numerous sites], but most areas are largely uncovered.
In addition to that, aprs.fi also displays [http://en.wikipedia.org/wiki/Automatic_Identification_System AIS] data transmitted by most large ships. AIS transmissions are [http://aprs.fi/page/ais_sites received by volunteers at numerous sites], but most areas are largely uncovered.


This guide aims to become an user guide for the aprs.fi web site, and as such does not attempt to describe the APRS or AIS systems in detail. To get started with APRS, please consult the following pages:
This guide aims to become a comprehensive manual for the aprs.fi web site, and as such does not attempt to describe the APRS or AIS systems in detail. To get started with APRS, please consult the following pages:


* [http://en.wikipedia.org/wiki/Automatic_Packet_Reporting_System Wikipedia: Automatic Packet Reporting System]
* [http://en.wikipedia.org/wiki/Automatic_Packet_Reporting_System Wikipedia: Automatic Packet Reporting System]
* [http://www.g4ilo.com/aprs.html G4ILO: APRS - Putting ham radio on the map]
* [http://www.g4ilo.com/aprs.html G4ILO: APRS - Putting ham radio on the map]
* [http://home.comcast.net/~k9dci/site/?/page/APRS_Beginner_INFO/ K9DCI: APRS Beginner Guide] (PDF)
* [http://home.comcast.net/~k9dci/site/?/page/APRS_Beginner_INFO/ K9DCI: APRS Beginner Guide] (PDF)
AIS is described well on the Wikipedia page for [http://en.wikipedia.org/wiki/Automatic_Identification_System Automatic Identification System].


====Languages and localisation====
====Languages and localisation====
Rivi 23: Rivi 25:
The site also supports different measurement units (metric, imperial and nautical), which can be selected in the '''preferences'''.
The site also supports different measurement units (metric, imperial and nautical), which can be selected in the '''preferences'''.


=Real-time map=
====Site navigation links====


The real-time map which opens up first when you arrive on the site displays, in nearly real time, APRS and AIS data on top of maps or satellite images provided by Google Maps. By default, it opens up showing the real-time situation in an area which should be relatively near your current location. The location guess is based on your IP address and it is a bit rough, but usually it opens up at least in the correct country. It is possible to select and save an initial view, but more on that later!
[[Tiedosto:Aprsfi-shot-info-toplinks.png|center]]


[[Tiedosto:Aprsfi Shot main.png|500px]]
Each page has a set of navigation links at the top of the page, and another at the bottom. On the real-time map, the links are provided in the navigation bar the right side of the map, which can be hidden by clicking the button in the top right corner of the page.


On the left side of the map you'll find the familiar Google Maps map controls which can be used to zoom and pan around the map. You can also use the mouse to drag the map, and the wheel of a mouse (if you have one) to zoom.
The general idea is that the links on the top provide links to different data views. If you have already looked up a specific station, the links will contain that callsign, and clicking on the '''weather''' link when viewing the '''info''' page of a weather station will give you that station's weather history graphs.


On the top of the map there is a box showing the coordinates and locator currently under the mouse pointer, a controls to switch between different map layers (street map, terrain map, satellite images and hybrid satellite+street map), and a control to enable additional layers on top of the map (traffic info, bicycle routes, and so forth).
The links at the bottom page provide links to static content pages such as the '''FAQ''' and this user guide, which give general information about the whole site.


On the right side of the map is a menu area containing the search boxes, links to switch views, links to information pages, and possibly some advertisements or links to news about the aprs.fi site. Near the bottom, right above the advertisement is a small status box which indicates the rather frequent updates of the real-time map data. The updates normally happen once every few seconds.
There are a few exceptions to these rules, of course – the '''My account''' and '''Moving stations''' links, for example.


Clicking on any of the ship or vehicle symbols will open up an info balloon showing current information on that tracking target.
=Sections=


==Controlling the amount of data displayed==
To ease up browsing and editing the guide has been split into separate pages for each section.


[[Tiedosto:Aprsfi shot show last select.png|right]]Near the top right corner there is a drop-down selection for the amount of history shown. When looking at the real-time view of an area (and not tracking a station), the maximum setting is 24 hours. Beware – if you're looking at a busy area, or have zoomed out to see a lot of APRS stations, selecting 24 hours will likely make your browser slow down to a halt, just because it needs to display so many symbol graphics and path lines.
;[[Aprs.fi Common features|Common features]]
: Describes features which are common to many or all of the different views of the site, such as searching using wildcards and table sorting.


If you're tracking a single target, the maximum selection is 7 days.
;[[Aprs.fi Real-time map|Real-time map]]
: Describes the main feature of the site, the real-time map.


If you're having trouble with the map being too slow, or the browser freezing, please take a look at the '''troubleshooting''' section.
;[[Aprs.fi Preferences|Preferences]]
: Goes through the Preferences dialog, which allows you to customize aprs.fi to your liking.


==Searching for an APRS callsign or AIS vessel==
;[[Aprs.fi Info pages|Info pages]]
: Describes the station info and station graph views.


The first input field in the top right corner of the page, labelled '''Track callsign''' is used for looking up a specific station by it's amateur radio callsign. Ships can be looked up by either their names (which are not always unique) or by their unique MMSI numbers (think of it as a phone number for the ship). Enter the callsign of the station in the box and click on '''Search'''. The most recent known position of that transmitter will be shown. For example:
;[[Aprs.fi Static maps|Static maps]]
: Introduces the static maps feature.


* [http://aprs.fi/?call=OH2RCH OH2RCH]
;[[Aprs.fi KML|KML and Google Earth]]
: Describes how to view aprs.fi in 3D using Google Earth.


(Please right-click the link and select '''Open in new window''' or '''new tab''' to avoid navigating away from this page.)
;[[Aprs.fi Web stations|Web stations]]
: Updating your position on aprs.fi using a web browser, a mobile phone, or Google Latitude.


After looking up the station, no other stations in the area will be shown. You can bring other stations into view by clicking on '''Show all''', while still tracking the selected station. If the tracked station moves, the map will center on the new position.
;[[Aprs.fi Messages and Status|Messages, status messages and the Bulletin Board]]
: Describes the messages, status messages and bulletin board views.


To stop tracking stations, click on '''Clear'''. This will reset the page to a real-time view at the same location and zoom level.
;[[Aprs.fi Weather|Weather]]
: Describes the weather data visualization features of aprs.fi.


====Looking up multiple targets at the same time====
;[[Aprs.fi Telemetry|Telemetry]]
: Describes telemetry collection and viewing.


It's possible to search for multiple targets at once by separating the callsigns or names with commas:
;[[Aprs.fi Raw packets and Beacons|Raw packets and Beacons]]
: Raw APRS and beacon packet listings.


* [http://aprs.fi/?call=OH2RCH,OH2RDK-5,OH2TI OH2RCH,OH2RDK-5,OH2TI]
;[[Aprs.fi Prefix browsing|Prefix browsing]]


====SSIDs - identifying multiple stations owned by the same operator====
;[[Aprs.fi Network tools|Network tools]]
: Tools for people who run the digipeaters and igates of the APRS network.


[[Tiedosto:Aprsfi shot other ssids.png|right]]More often than not, a single amateur radio operator has multiple stations: one at home, one in the car, and maybe a hand-held walkie-talkie too. These are identified by their SSID (Secondary System Identifier) numbers, which range from 1 to 15. OH7LZB could be the home station, OH7LZB-9 is probably the car, and OH7LZB-14 could be a motorcycle. After you have successfully looked up one of these, links to the other available SSIDs for that station are shown below the search boxes. The ones which have most recently transmitted their position are shown with a larger font.
;[[Aprs.fi Exporting data|Exporting data]]
: How to download APRS position data from aprs.fi to your computer.


==Searching for an address==
;[[Aprs.fi Troubleshooting|Troubleshooting]]
: If you're having problems using aprs.fi, or if you think you've found a bug, please start reading here.


The second input field on the right searches for '''an address, a city, or a QTH locator'''. Given a specific address it will center the map at that address. Example searches:
=Discussion group, blog and other points of communication=
 
* [http://aprs.fi/?addr=Kuopio Kuopio] - searches for the city of Kuopio in Finland.
* [http://aprs.fi/?addr=Paris Paris] - searches for the city of Paris. It is quite likely to jump to Paris, the capital city of France, but if you are located in the USA, it might as well come up with the city of Paris in Illinois, USA. Many city and town names are not unique!
* [http://aprs.fi/?addr=Paris,%20IL,%20USA Paris, IL, USA] - searches for Paris in the state of Illinois, USA.
* [http://aprs.fi/?addr=Paris,%20France Paris, France] - searches for Paris in France.
* [http://aprs.fi/?addr=Paris,%20FI Paris, FI] - searches for a Paris in Finland, and manages to find Pariisinkatu (Paris Street) in Helsinki.
 
Enter the components of the address from the most specific to the least specific, separating them by comma characters. For example:
 
* [http://aprs.fi/?addr=10%20Downing%20Street,%20London,%20SW1A%202AA 10 Downing Street, London, SW1A 2AA]
 
In other countries and languages, use whatever addressing system is typically used. Google understands many languages. As an example, here is the Japanese address for the Kyoto tower. Zoom in and switch to the satellite view:
 
* [http://aprs.fi/?addr=京都府京都市下京区東塩小路721-1 京都府京都市下京区東塩小路721-1]
 
You can also enter coordinates in the address search box in several different formats:
 
* [http://aprs.fi/?addr=37.2527%20N%20115.8148%20W 37.2527 N 115.8148 W]
* [http://aprs.fi/?addr=37.2527,-115.8148 37.2527,-115.8148]
 
The address lookup service is provided by Google Maps, and functions similarly to [http://maps.google.com/ maps.google.com]. In other words, if it doesn't find something, it's Google's fault.
 
====QRA locator search====
 
Given a Maidenhead / QRA / QTH locator aprs.fi will center on the locator's middle point and draw a rectangle around the locator's borders. For example:
 
* [http://aprs.fi/?addr=KP32 KP32]
* [http://aprs.fi/?addr=IO83UL IO83UL]
* [http://aprs.fi/?addr=IO83UL42 IO83UL42]
* [http://aprs.fi/?addr=KO85RU97bp KO85RU97bp]
 
[[Tiedosto:Shot coordinate box.png|right]] You can also check the coordinates and locator of a position on the map by simply pointing at the position with your mouse and reading the coordinates from the box in top left corner of the map.
 
==Looking up historical data==
 
[[Tiedosto:Aprsfi shot serenade datebrowse.png|right]]To view past positions of a station, first look up the current position. A date browsing menu will appear on the right, consisting of the years for which data is available on aprs.fi. First, click on the year, then select the month, and finally, select the day you wish to view. The menus might open up a bit slowly at first, since aprs.fi needs to consult it's huge historical database to check the availability of data for the station in question.
 
aprs.fi normally stores position history data for about a year. If you wish to retain your tracks for a longer time, please use the [http://aprs.fi/export/ Data export tool] to download a KMZ file for offline viewing using Google Earth.
 
==Tool buttons==
In the top right corner of the real-time map you'll see a set of buttons. These are used for controlling different tools on the real-time map.
 
 
[[Tiedosto:Aprsfi shot tool hide.png|left]]The '''hide''' button hides and displays the menu bar on the right, effectively switching to a full-screen mode of a sort.
 
 
[[Tiedosto:Aprsfi shot tool home.png|left]]The '''home''' button jumps back to your '''initial view''', which might be a very rough guess of your location, or a specific view configured by yourself.
 
 
[[Tiedosto:Aprsfi shot tool phg.png|left]]The '''PHG''' button toggles between no PHG circles shown, half-size PHG circles and full-size circles. The PHG circles display estimated service areas of APRS digipeaters and igates. They are very rough estimates or guesses made by the operator of each digipeater and usually they are not based on any exact statistical measurements.
 
 
[[Tiedosto:Aprsfi shot tool ruler.png|left]]The '''ruler''' button enables the ruler tool, which can be used to measure distances and bearings on the map. After clicking on the tool button, click somewhere on the map, and a marker will appear. Use the mouse to drag the marker to another position on the map. Another marker will appear from below the first one, a line connecting the two will be shown, together with the distance and bearing from point A to point B. You can also click the markers to see the exact coordinates of the marker. Multiple rulers may be placed on the map at the same time, just click on the button again to start from the beginning!
 
==Selecting an initial default view==
 
You can save the current map view, including the map type, zoom level and tracking settings, so that they will be recalled when you next open up aprs.fi. It's a good idea to do this especially if the initial guessed location is far off from your area of interest.
 
# Click on '''Preferences''' to open up the settings window. It's under the '''Other views''' title.
# The first item in view is '''Save current map view as default view'''. Check the checkbox.
# Click on '''Save''' at the bottom of the page.
 
The preferences are stored in your browser's cookies, so they will not apply when you open up aprs.fi on another computer or using another browser. You do not need to have an user account aprs.fi to save the preferences.
 
==Street View==
 
'''Please note: The Street View feature is currently available on [http://beta.aprs.fi/ beta.aprs.fi] only.'''
 
[[Tiedosto:Aprsfi shot streetview.png|left|220px]]Google's Street View has been integrated in aprs.fi, allowing you to view street-view panoramic photos on the site.
 
You can open Street View by dragging the yellow ''pegman'' (from above the zoom control) to the map. When dragging the pegman, a yellow overlay will indicate the roads with panorama photos. Drop the pegman on a road and the panorama will open. You can drag the panorama to look around, and click on the arrows to advance along the streets.
 
If you click on '''Track in Street View''' in the info balloon of a station, the panorama which is closest to the current location of the station will be opened. You can also click on any red track point along the path of a station to jump there.
 
If the clicked station is transmitting a course (which generally requires that the station is moving), the Street View will open up pointing to that direction. If the station is not transmitting a course, the camera will point '''from''' the panorama picture's center coordinates (where Google's camera was when the panorama was taken) '''to''' the exact coordinates transmitted by the stations. This implies that clicking on a '''house''' symbol of someone's home station will often open up a photo of that house (with antennas on top).
 
If no panorama photos are available for the required position, the Street View will close automatically.
 
For more information on Street View, please consult [http://www.google.com/intl/en_us/help/maps/streetview/ Google's Street View documentation].
 
==Packet path lines==
 
==Map context menu==
 
TODO: describe the features behind the right-click.
 
==Keyboard shortcuts==
 
* '''Arrow keys''' – pan the map
* '''Page up, Page down, Home, End''' – pan the map quicker, one page at a time
* '''+, -''' – zoom in/out
 
=Common search features=
 
TODO: describe callsign and wildcard lookups.
TODO: describe date search field.


=Info page=
If you have any questions, answers, ideas, tips or tricks, please share them on the official [https://groups.google.com/forum/#!forum/aprsfi aprs.fi Google Group]. It's available as a web-based forum and as a regular mailing list. '''Before posting, please read the instructions on the forum's front page, especially the requirement for as many relevant details as possible (including exact callsigns and page links in question).''' The forum exists strictly for discussing the aprs.fi web service – please use the other relevant forums for discussion about generic APRS issues or tracker configuration problems.


TODO: describe the /info/ pages.
Please read through the [[Aprs.fi Troubleshooting|Troubleshooting]] section before posting to the discussion group about any problems. Thank you!


==Info graphs==
News about the aprs.fi service are posted on the [http://blog.aprs.fi/ aprs.fi blog], which can also be subscribed over email, or using an RSS reader such as [http://reader.google.com/ reader.google.com]. Headlines from the blog are shown regularly in the lower right corner of the real-time map.


TODO: describe the /info/graphs/ page.
[[Category:aprs.fi]]
 
[[Category:APRS]]
=Static maps=
[[Category:Pakettiradio]]
 
Since the real-time map is quite heavy on computing resources, and appears slow (or does not work at all) on many old devices and mobile phone browsers, there is a '''Static map''' feature. It even supports looking up multiple stations at the same time, but cannot show real APRS symbol graphics in that mode.
 
* [http://aprs.fi/static/OH2RCH OH2RCH on static map]
* [http://aprs.fi/static/OH2RCH,OH2TI,OH2RDK OH2RCH, OH2TI and OH2RDK on the same static map]
 
It is designed to be very simple and lightweight, and it should work fine on small devices or with slow Internet connections.
 
=Weather display=
 
TODO: describe the /weather/ graphs and the weather features of the real-time map.
 
=Telemetry=
 
TODO: describe /telemetry/.
 
=Preferences=
 
TODO: describe the Preferences view.
 
=Status packets=
 
TODO: describe status packets view.
 
=Beacon packets=
 
TODO: describe beacon packets view.
 
=Bulletin board=
 
TODO: describe bulletins view.
 
=Raw packets=
 
=Prefix browsing=
 
=Exporting and downloading position data=
 
=Troubleshooting=
 
===My position is not showing up on aprs.fi===
 
===The real-time map does not show===
 
===The real-time map is slow===
 
=Discussion group, blog and other points of communication=

Nykyinen versio 8. kesäkuuta 2011 kello 07.15

This is the official manual for the aprs.fi web service. This is also a Wiki page, so you're welcome to expand the document!

Introduction

The aprs.fi web service collects information from the Automatic Packet (or Position) Reporting System Internet network (APRS-IS). APRS is used by amateur (ham) radio operators to transmit real-time position information, weather data, telemetry and messages over the radio. A vehicle equipped with a GPS receiver, a VHF transmitter or HF transceiver and a small computer device called a tracker transmits it's location, speed and course in a small data packet, which is then received by a nearby iGate receiving site which forwards the packet on the Internet. Packets are also retransmitted on the radio channel by digipeaters to enhance the coverage of the system. Systems connected to the Internet can send information on the APRS-IS without a radio transmitter, or collect and display information transmitted anywhere in the world.

In addition to that, aprs.fi also displays AIS data transmitted by most large ships. AIS transmissions are received by volunteers at numerous sites, but most areas are largely uncovered.

This guide aims to become a comprehensive manual for the aprs.fi web site, and as such does not attempt to describe the APRS or AIS systems in detail. To get started with APRS, please consult the following pages:

AIS is described well on the Wikipedia page for Automatic Identification System.

Languages and localisation

The aprs.fi service has been translated by volunteer users to numerous different languages. The language shown to you will be selected based on your browser's language preference settings. If you wish to preview the site in different languages, please prepend the two-letter language code to the site URL:

The site also supports different measurement units (metric, imperial and nautical), which can be selected in the preferences.

Site navigation links

Aprsfi-shot-info-toplinks.png

Each page has a set of navigation links at the top of the page, and another at the bottom. On the real-time map, the links are provided in the navigation bar the right side of the map, which can be hidden by clicking the button in the top right corner of the page.

The general idea is that the links on the top provide links to different data views. If you have already looked up a specific station, the links will contain that callsign, and clicking on the weather link when viewing the info page of a weather station will give you that station's weather history graphs.

The links at the bottom page provide links to static content pages such as the FAQ and this user guide, which give general information about the whole site.

There are a few exceptions to these rules, of course – the My account and Moving stations links, for example.

Sections

To ease up browsing and editing the guide has been split into separate pages for each section.

Common features
Describes features which are common to many or all of the different views of the site, such as searching using wildcards and table sorting.
Real-time map
Describes the main feature of the site, the real-time map.
Preferences
Goes through the Preferences dialog, which allows you to customize aprs.fi to your liking.
Info pages
Describes the station info and station graph views.
Static maps
Introduces the static maps feature.
KML and Google Earth
Describes how to view aprs.fi in 3D using Google Earth.
Web stations
Updating your position on aprs.fi using a web browser, a mobile phone, or Google Latitude.
Messages, status messages and the Bulletin Board
Describes the messages, status messages and bulletin board views.
Weather
Describes the weather data visualization features of aprs.fi.
Telemetry
Describes telemetry collection and viewing.
Raw packets and Beacons
Raw APRS and beacon packet listings.
Prefix browsing
Network tools
Tools for people who run the digipeaters and igates of the APRS network.
Exporting data
How to download APRS position data from aprs.fi to your computer.
Troubleshooting
If you're having problems using aprs.fi, or if you think you've found a bug, please start reading here.

Discussion group, blog and other points of communication

If you have any questions, answers, ideas, tips or tricks, please share them on the official aprs.fi Google Group. It's available as a web-based forum and as a regular mailing list. Before posting, please read the instructions on the forum's front page, especially the requirement for as many relevant details as possible (including exact callsigns and page links in question). The forum exists strictly for discussing the aprs.fi web service – please use the other relevant forums for discussion about generic APRS issues or tracker configuration problems.

Please read through the Troubleshooting section before posting to the discussion group about any problems. Thank you!

News about the aprs.fi service are posted on the aprs.fi blog, which can also be subscribed over email, or using an RSS reader such as reader.google.com. Headlines from the blog are shown regularly in the lower right corner of the real-time map.

Noudettu kohteesta ”https://wiki.sral.fi/w/index.php?title=Aprs.fi_user_guide&oldid=1507”