Home | Advanced maps | Leader board | Moved gateways | FAQ | Acknowledgements | Contact



All data from TTNmapper.org should be considered under the PDDL v 1.0 license (http://opendatacommons.org/licenses/pddl/1.0/).

How can I contribute?

Using any node and a smartphone (prefered method)

  1. A node transmitting to The Things Network. An Arduino with a RN2483 radio is ideal. Have a look at my github for example code and wiring instructions for the RN2483 and Arduino. Your node can however be any hardware and run any code, as long as you know the address the device use to transmit data to The Things Network.
  2. An Android phone running the TTN Mapper App available on the playstore. -OR- An iPhone running the TTN Mapper app available from the iTunes store. -OR- By using the online javascript client available at https://www.lora-mapper.org/client (still in BETA testing)

Using a node with a GPS, transmitting GPS coordinates (like a Sodaq One)

If you have a GPS tracker that sends its own location in the payload of the LoRa packet, it is as easy as enabling the TTN Mapper integration to contribute data to the coverage map.

The assumption is that your end device with a GPS on it sends at least its latitude and longitude, but preferably also its altidude and HDOP values. If HDOP is not available, the accuracy of the GPS fix in metres will be accepted. As a last resort the satellite count can be used.

Make sure you have a Payload decoder function enabled on the TTN Console that decodes the raw payload into a json object. The JSON object should contain the keys "latitude", "longitude" and "altitude" and one of "hdop", "accuracy" or "sats". When using the Cayenne LPP data format, the GPS coordinates will be decoded into a different JSON format, but this format is also supported. Cayenne LPP does not contain a GPS accuracy, and therefore this data will be considered as inferior and will carry less weight in calculation of coverage, and will be deleted first during data cleanup.

On the TTN Console, open your application and then click on Integrations. Search for the TTN Mapper integration and click on it.

Which spreading factor should I transmit on?

We use SF7. This provides us with a map of "worst case" coverage. It also does not make sense to use a higher SF, as the performance decreases when you are mobile. The time between packets, and therefore distance between samples also increases with higher SF. SF7 is just good enough.

My results are not showing up on the map

Possibly the gateway that received your packets does not send its coordinates in its status update packets. If you know the gateway owner, please ask them to enable the GPS (and fake gps) so that the coordinates are sent through. If this is the reason for your measurements not showing, you can check under Advanced Maps, enter your node address, and view the map. If you now see circles without lines connecting them to a gateway, this issue is confirmed.

Did you mark your data as experimental? If so, the data will not show on the main map, but on a separate map containing only your experiment. Please disable experimental mode in the app so that you can contribute to the global map of TTN coverage.

The maps should show new data within a couple of minutes. A scheduled task starts executing every two minutes to aggregate data and create the GEOJSON files. The task may however take a long time to execute.

If this is not the case, likely the Android app is not uploading data to our server. It is also possible that the server is down (but then the website won't display), or that for some other reason stuff are breaking on our side. Best to log your coverage to a file and e-mail it to us if your results are not displayed within a day or two. When we get an email like this, it will also be seen as a bug report and the issue will be investigated.

My results were showing on the map before, but is gone now.

As I'm typing this it has not been implemented yet (feature implemented on 2016-03-20), but the idea is to hide all "old" measurements for a gateway if it has moved more than 100m. Therefore, if you mapped the coverage of a gateway, the measurements showed up on the map, but the gateway was then placed at a new location more than 100m from the original location, the old measurements will be hidden.

The major reason for this is that the map should be an indication of the current TTN coverage, not what it was a few weeks ago. Also, if a gateway moves, the origin of the radial lines will move too. It is possible to have multiple markers for a gateway, creating in essence two separate coverage maps, but again, the old coverage does not mean anything to us.

While I was measuring I saw a lot of points on the app for locations I measured, but only a few points are shown on your map. Did some of the data points go missing, or not upload?

To be safe, e-mail me your log file (if you also logged to a file).

It is possible that some datapoints did not upload correctly to our server because your internet connection did not work correctly, however this is unlikely.

The most likely reason is that the gateway that received your packets does not report its location. We therefore are not able to plot the datapoints as we also do not know the path the packet was received along.

We aggregate datapoints accross a region of 0.005 degrees to make displaying it on a map faster. Click on a gateway and choose to view only that one's coverage, and you will see data aggregated over a 0.0005 degrees area, thus more data points.

Can I integrate your data into my map?
Can I download my data which I uploaded to you?
Public API access.

All data is dumped into tab-delimited files at an irregular interval. The dumps are available at http://ttnmapper.org/dumps. If you want newer data than what there are dumps of, please contact me.

No public api access is given to the database. This is due to the amount of data and number of possible queries that won't be possible to handle on the server. Please use the dumps and your own database.

The GEOJSON files used to draw the TTNmapper maps are also publicly available at http://ttnmapper.org/geojson.

I want you to remove my gateway or measurement points from your map (privacy, etc)

If you change your gateway's location to another one more than 100m away, any old measurements for your gateway will be hidden automatically.

In any other circumstance, contact me.

Is TTN Mapper opensource?

The plan is to open source some parts of the code base. We are working hard to get the code for these parts in a state that is possible to opensource. The source code for the parts that are already open source can be found at: https://github.com/ttnmapper

My question is not answered here