< back

Add / Edit Site API

Purpose

This API allows you to make changes to a Site (Tower location) using the site ID.

Fields

Account / API Key

You can locate your Account ID and API Key in the API Tab 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 by to an API to GET you 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 must be whole number value in meters and is required.


Latitude / Longitude

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


Description / Group / Site Name

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


Pin style

This field is not required and will take a value of 1 if left blank, but can be set to 1 for red, 2 for blue, 3 for orange or 4 for green pin colors.

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>