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

Radioamatööriwikistä
Siirry navigaatioon Siirry hakuun
>Oh7lzb
>Oh7lzb
 
(174 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]
Rivi 13: Rivi 13:
* [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)


=Real-time map=
AIS is described well on the Wikipedia page for [http://en.wikipedia.org/wiki/Automatic_Identification_System Automatic Identification System].


TODO: describe the '''basic''' features of the real-time map. Provide a separate page for the advanced features.
====Languages and localisation====


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. It might or might not work, 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!
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:


[[Tiedosto:Aprsfi Shot main.png|500px]]
* [http://fi.aprs.fi/ http://fi.aprs.fi/] - aprs.fi in Finnish
* [http://ja.aprs.fi/ http://ja.aprs.fi/] - aprs.fi in Japanese
* [http://en.aprs.fi/ http://en.aprs.fi/] - aprs.fi in English


==Searching for an APRS callsign or AIS vessel==
The site also supports different measurement units (metric, imperial and nautical), which can be selected in the '''preferences'''.


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:
====Site navigation links====


* [http://aprs.fi/?call=OH2RCH OH2RCH]
[[Tiedosto:Aprsfi-shot-info-toplinks.png|center]]


(Please right-click the link and select '''Open in new window''' or '''new tab''' to avoid navigating away from this page.)
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.


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.
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.


To stop tracking stations, click on '''Clear'''. This will reset the page to a real-time view at the same location and zoom level.
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.


====Looking up multiple targets at the same time====
There are a few exceptions to these rules, of course – the '''My account''' and '''Moving stations''' links, for example.


It's possible to search for multiple targets at once by separating the callsigns or names with commas:
=Sections=


* [http://aprs.fi/?call=OH2RCH,OH2RDK-5,OH2TI OH2RCH,OH2RDK-5,OH2TI]
To ease up browsing and editing the guide has been split into separate pages for each section.


====SSIDs - identifying multiple stations owned by the same operator====
;[[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.


[[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, the other available SSIDs for that station are shown below the search boxes.
;[[Aprs.fi Real-time map|Real-time map]]
: Describes the main feature of the site, the real-time map.


==Searching for an address==
;[[Aprs.fi Preferences|Preferences]]
: Goes through the Preferences dialog, which allows you to customize aprs.fi to your liking.


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:
;[[Aprs.fi Info pages|Info pages]]
: Describes the station info and station graph views.


* [http://aprs.fi/?addr=Kuopio Kuopio] - searches for the city of Kuopio in Finland.
;[[Aprs.fi Static maps|Static maps]]
* [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!
: Introduces the static maps feature.
* [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:
;[[Aprs.fi KML|KML and Google Earth]]
: Describes how to view aprs.fi in 3D using Google Earth.


* [http://aprs.fi/?addr=10%20Downing%20Street,%20London,%20SW1A%202AA 10 Downing Street, London, SW1A 2AA]
;[[Aprs.fi Web stations|Web stations]]
: Updating your position on aprs.fi using a web browser, a mobile phone, or Google Latitude.


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:
;[[Aprs.fi Messages and Status|Messages, status messages and the Bulletin Board]]
: Describes the messages, status messages and bulletin board views.


* [http://aprs.fi/?addr=京都府京都市下京区東塩小路721-1 京都府京都市下京区東塩小路721-1]
;[[Aprs.fi Weather|Weather]]
: Describes the weather data visualization features of aprs.fi.


You can also enter coordinates in the address search box in several different formats:
;[[Aprs.fi Telemetry|Telemetry]]
: Describes telemetry collection and viewing.


* [http://aprs.fi/?addr=37.2527%20N%20115.8148%20W 37.2527 N 115.8148 W]
;[[Aprs.fi Raw packets and Beacons|Raw packets and Beacons]]
* [http://aprs.fi/?addr=37.2527,-115.8148 37.2527,-115.8148]
: Raw APRS and beacon packet listings.


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.
;[[Aprs.fi Prefix browsing|Prefix browsing]]


====QRA locator search====
;[[Aprs.fi Network tools|Network tools]]
: Tools for people who run the digipeaters and igates of the APRS network.


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:
;[[Aprs.fi Exporting data|Exporting data]]
: How to download APRS position data from aprs.fi to your computer.


* [http://aprs.fi/?addr=KP32 KP32]
;[[Aprs.fi Troubleshooting|Troubleshooting]]
* [http://aprs.fi/?addr=IO83UL IO83UL]
: If you're having problems using aprs.fi, or if you think you've found a bug, please start reading here.
* [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.
=Discussion group, blog and other points of communication=


==Looking up historical data==
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.


[[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.
Please read through the [[Aprs.fi Troubleshooting|Troubleshooting]] section before posting to the discussion group about any problems. Thank you!


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.
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.


==Tool buttons==
[[Category:aprs.fi]]
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.
[[Category:APRS]]
 
[[Category:Pakettiradio]]
[[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==
 
==Packet path lines==
 
==Map context menu==
 
TODO: describe the features behind the right-click.
 
=Common search features=
 
TODO: describe callsign and wildcard lookups.
TODO: describe date search field.
 
=Info page=
 
TODO: describe the /info/ pages.
 
==Info graphs==
 
TODO: describe the /info/graphs/ page.
 
=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=
 
=Troubleshooting=

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”