Helpful

API

Global Coverage API

An API request is available to obtain coverage estimations for any location in the world. This request takes geographical coordinates as an input and returns coverage level estimations.

Through this API endpoint, Sigfox coverage information can be integrated into third party business applications such as online coverage checkers.

Multiple locations

Please note that when using coverage API endpoints with multiple locations, i.e. using the Retrieve coverage predictions for any batch of locations endpoint, Sigfox recommends to:

  • not request more than 200 locations at a time
  • wait for the result to be returned before requesting again (avoid multithreading)

Failing to comply with these recommendations may cause the result to contain errors.

Margin explanation

Margin is the reception margin, in dB, between the Base Station actual sensitivity and the estimated RSSI at a given position.

When Margin is positive, it means that the signal strength is enough for the Base station to receive an uplink message in outdoor conditions. Please be advised that the margin is always computed for outdoor conditions.

For other conditions, here below are the usual values used to simulate the signal penetration loss:

  • Incar : 10dB
  • Indoor : 20dB
  • Deep indoor/underground : 30dB+

The formula is as follows:

Margin = simulated RSSI (dBm) - theoretical sensitivity (dBm) - Environmental Loss (dB)

Example:

Margin = -100 - (-142) - 5 = 37 dB

Where theoretical sensitivity is:

-142dBm for 100bps protocol (ETSI)

-134dBm for 600bps protocol (FCC)

As a reminder, the simulated RSSI is the estimated signal power strength received by the BS for a class 0U (except stated otherwise) transmitting at the given position.

The actual application margin on the field also depends on device emission performances (Product class).
Product class attenuation is available at https://support.sigfox.com/docs/sigfox-service-map

For instance, for RC1, a 2U class device requires adding up a 11dB attenuation penalty.

Radius

The Global Coverage endpoint (/coverage/global/predictions) has a default radius of 300m, averaging the given result for the area. This parameter can be modified from 200 to 500m. Note that the Redundancy endpoint (/coverage/operators/redundancy) returns the Base Station redundancy for the exact provided position (equivalent to radius=0).

Documentation

In order to obtain further details, please check the coverage API documentation.

Can't find what you're looking for ?

Have questions? Our worldwide Community of expert fans can answer them.
Have answers? Join the Community and help!

slack logo

Ask the community >