Network Coverages

Preview

This schema is currently in preview and might change in the future.

We’re excited to hear your feedback and ideas. Please send an email to support@gigs.com to share your thoughts.

Properties

Name
object
Type
string
Description
Type of object is always networkCoverage.
Allowed values: networkCoverage
Name
coverage
Type
array
Description
A list of coverage details for the plans in the project.
Name
location
Type
object
Description
The location for which coverage information is provided.
Name
latitude
Type
number
Description
The latitude coordinate for which coverage information is provided.
Example: 40.7831
Name
longitude
Type
number
Description
The longitude coordinate for which coverage information is provided.
Example: -73.9712

Example

{
  "object": "networkCoverage",
  "coverage": [
    {
      "plan": "pln_0SNlurA049MEWV3V0q7gjQbM4EVo",
      "provider": "p11",
      "strength": "excellent",
      "minDecibelMilliwatts": -100
    }
  ],
  "location": {
    "latitude": 40.7831,
    "longitude": -73.9712
  }
}

POST/projects/{project}/networkCoverage/lookup

Lookup network coverage by coordinates

Looks up network coverage information based on geographic coordinates (latitude/longitude). Returns network coverage data only for US coordinates.

Preview

This endpoint is currently in preview and might change in the future.

We’re excited to hear your feedback and ideas. Please send an email to support@gigs.com to share your thoughts.

Body

Name
latitude
Type
number
required
Description
The latitude coordinate for coverage lookup. Must be between -90 and 90.
Example: 40.7831
Name
longitude
Type
number
required
Description
The longitude coordinate for coverage lookup. Must be between -180 and 180.
Example: -73.9712

Path Parameters

Name
project
Type
string
required
Description
The unique identifier for the project.
Example: "gigs"

Responses

Returns the network coverage data with coordinates.

Name
object
Type
string
Description
Type of object is always networkCoverage.
Allowed values: networkCoverage
Name
coverage
Type
array
Description
A list of coverage details for the plans in the project.
Name
location
Type
object
Description
The location for which coverage information is provided.
Name
latitude
Type
number
Description
The latitude coordinate for which coverage information is provided.
Example: 40.7831
Name
longitude
Type
number
Description
The longitude coordinate for which coverage information is provided.
Example: -73.9712

Request

POST

/projects/{project}/networkCoverage/lookup

curl https://api.gigs.com/projects/${GIGS_PROJECT}/networkCoverage/lookup \
-X POST \
-H "Content-Type: application/json" \
-H "Authorization: Bearer ${GIGS_TOKEN}" \
-H "Accept: application/json" \
-d '{
  "latitude": 40.7831,
  "longitude": -73.9712
}'

Response

{
  "object": "networkCoverage",
  "coverage": [
    {
      "plan": "pln_0SNlurA049MEWV3V0q7gjQbM4EVo",
      "provider": "p11",
      "strength": "excellent",
      "minDecibelMilliwatts": -100
    }
  ],
  "location": {
    "latitude": 40.7831,
    "longitude": -73.9712
  }
}