< back

Add / Edit Site API

The Add / Edit Sites API allows you to make changes to a Site (Tower location) using the site ID.

Account / API Key

You can locate your Account ID and API Key in the API section of your account settings. Your Account ID can also be found within the iframe of your Multi Coverage.


Tower Site ID

The Site ID can be obtained via API to get your entire list or you can open the site within your TowerCoverage.com account and the ID is located at the end of the URL. If you leave this value blank, it will create a New Site in your account.


Tower Height

This value is required and must be a whole number value in meters.


Latitude / Longitude

These fields are in decimal degrees. If you are in the northern hemisphere the Latitude value will be positive. If you are located in the southern hemisphere the Latitude value will be negative. Likewise, the Longitude value will be positive if you are in the eastern hemisphere and the value will be negative if you are in the western hemisphere.


Description / Group / Site Name

Description and group are not required. Site name is not required if you provide an ID for updating.


Pin style

This will default to a value of 1 but can be set to 1-4 for the different colors of pins.

These fields are not required unless you wish to change the current value.

Code Examples

SOAP 1.1

Request


POST /towercoverage.asmx HTTP/1.1
Host: api.towercoverage.com
Content-Type: text/xml; charset=utf-8
Content-Length: length
SOAPAction: "http://tempuri.org/SitesAPI"

<?xml version="1.0" encoding="utf-8"?>
<soap:Envelope 
 xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" 
 xmlns:xsd="http://www.w3.org/2001/XMLSchema" 
 xmlns:soap="http://schemas.xmlsoap.org/soap/envelope/">
  <soap:Body>
    <SitesAPI 
 xmlns="http://tempuri.org/">
      <Account>string</Account>
      <Sitename>string</Sitename>
      <Siteid>string</Siteid>
         <height>string</height>
      <Latitude>string</Latitude>
      <Longitude>string</Longitude>
      <Description>string</Description>
      <Group>string</Group>
         <Pinstyle></Pinstyle>
      <key>string</key>
    </SitesAPI>
  </soap:Body>
</soap:Envelope>

Response


HTTP/1.1 200 OK
Content-Type: text/xml; charset=utf-8
Content-Length: length

<?xml version="1.0" encoding="utf-8"?>
<soap:Envelope 
 xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" 
 xmlns:xsd="http://www.w3.org/2001/XMLSchema" 
 xmlns:soap="http://schemas.xmlsoap.org/soap/envelope/">
  <soap:Body>
    <SitesAPIResponse 
 xmlns="http://tempuri.org/">
      <SitesAPIResult>string</SitesAPIResult>
    </SitesAPIResponse>
  </soap:Body>
</soap:Envelope>

SOAP 1.2

Request


POST /towercoverage.asmx HTTP/1.1
Host: api.towercoverage.com
Content-Type: application/soap+xml; charset=utf-8
Content-Length: length

<?xml version="1.0" encoding="utf-8"?>
<soap12:Envelope 
 xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" 
 xmlns:xsd="http://www.w3.org/2001/XMLSchema" 
 xmlns:soap12="http://www.w3.org/2003/05/soap-envelope">
  <soap12:Body>
    <SitesAPI 
 xmlns="http://tempuri.org/">
      <Account>string</Account>
      <Sitename>string</Sitename>
      <Siteid>string</Siteid>
         <height>string</height>
      <Latitude>string</Latitude>
      <Longitude>string</Longitude>
      <Description>string</Description>
      <Group>string</Group>
         <Pinstyle>string</Pinstyle>
      <key>string</key>
    </SitesAPI>
  </soap12:Body>
</soap12:Envelope>

Response


HTTP/1.1 200 OK
Content-Type: application/soap+xml; charset=utf-8
Content-Length: length

<?xml version="1.0" encoding="utf-8"?>
<soap12:Envelope 
 xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" 
 xmlns:xsd="http://www.w3.org/2001/XMLSchema" 
 xmlns:soap12="http://www.w3.org/2003/05/soap-envelope">
  <soap12:Body>
    <SitesAPIResponse 
 xmlns="http://tempuri.org/">
      <SitesAPIResult>string</SitesAPIResult>
    </SitesAPIResponse>
  </soap12:Body>
</soap12:Envelope>  

HTTP Get

Request


GET /towercoverage.asmx/SitesAPI?Account=string& 
Sitename=string& 
Siteid=string& 
height=string&
Latitude=string& 
Longitude=string& 
Description=string& 
Group=string&
Pinstyle=string& 
key=string HTTP/1.1
Host: api.towercoverage.com

Response


HTTP/1.1 200 OK
Content-Type: text/xml; charset=utf-8
Content-Length: length

<?xml version="1.0" encoding="utf-8"?>
<string 
xmlns="http://tempuri.org/">string</string> 

HTTP Post

Request


POST /towercoverage.asmx/SitesAPI HTTP/1.1
Host: api.towercoverage.com
Content-Type: application/x-www-form-urlencoded
Content-Length: length

Account=string& 
Sitename=string& 
Siteid=string&
height=string& 
Latitude=string& 
Longitude=string& 
Description=string& 
Group=string&
Pinstyle=string&
key=string

Response


HTTP/1.1 200 OK
Content-Type: text/xml; charset=utf-8
Content-Length: length

<?xml version="1.0" encoding="utf-8"?>
<string 
xmlns="http://tempuri.org/">string</string>