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

Radioamatööriwikistä
Siirry navigaatioon Siirry hakuun
>Oh7lzb
>Oh7lzb
 
(160 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. 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!
[[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.


Clicking on any of the ship or vehicle symbols will open up an info balloon showing current information on that tracking target.
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.


==Controlling the amount of data displayed==
=Sections=


TODO: the "show last" time selector
To ease up browsing and editing the guide has been split into separate pages for each section.


TODO: a lot of data makes it slow... preferences to filter...
;[[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.


==Searching for an APRS callsign or AIS vessel==
;[[Aprs.fi Real-time map|Real-time map]]
: Describes the main feature of the site, the real-time map.


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 Preferences|Preferences]]
: Goes through the Preferences dialog, which allows you to customize aprs.fi to your liking.


* [http://aprs.fi/?call=OH2RCH OH2RCH]
;[[Aprs.fi Info pages|Info pages]]
: Describes the station info and station graph views.


(Please right-click the link and select '''Open in new window''' or '''new tab''' to avoid navigating away from this page.)
;[[Aprs.fi Static maps|Static maps]]
: Introduces the static maps feature.


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 KML|KML and Google Earth]]
: Describes how to view aprs.fi in 3D using Google Earth.


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 Web stations|Web stations]]
: Updating your position on aprs.fi using a web browser, a mobile phone, or Google Latitude.


====Looking up multiple targets at the same time====
;[[Aprs.fi Messages and Status|Messages, status messages and the Bulletin Board]]
: Describes the messages, status messages and bulletin board views.


It's possible to search for multiple targets at once by separating the callsigns or names with commas:
;[[Aprs.fi Weather|Weather]]
: Describes the weather data visualization features of aprs.fi.


* [http://aprs.fi/?call=OH2RCH,OH2RDK-5,OH2TI OH2RCH,OH2RDK-5,OH2TI]
;[[Aprs.fi Telemetry|Telemetry]]
: Describes telemetry collection and viewing.


====SSIDs - identifying multiple stations owned by the same operator====
;[[Aprs.fi Raw packets and Beacons|Raw packets and Beacons]]
: Raw APRS and beacon packet listings.


[[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 Prefix browsing|Prefix browsing]]


==Searching for an address==
;[[Aprs.fi Network tools|Network tools]]
: Tools for people who run the digipeaters and igates of the APRS network.


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


* [http://aprs.fi/?addr=Kuopio Kuopio] - searches for the city of Kuopio in Finland.
;[[Aprs.fi Troubleshooting|Troubleshooting]]
* [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!
: 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=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:
=Discussion group, blog and other points of communication=
 
* [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.
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.


====QRA locator search====
Please read through the [[Aprs.fi Troubleshooting|Troubleshooting]] section before posting to the discussion group about any problems. Thank you!


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


* [http://aprs.fi/?addr=KP32 KP32]
[[Category:aprs.fi]]
* [http://aprs.fi/?addr=IO83UL IO83UL]
[[Category:APRS]]
* [http://aprs.fi/?addr=IO83UL42 IO83UL42]
[[Category:Pakettiradio]]
* [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==
 
==Street View==
 
==Packet path lines==
 
==Map context menu==
 
TODO: describe the features behind the right-click.
 
==Keyboard shortcuts==
 
=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.
 
=Static maps=
 
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”