Add / Edit MultiCoverage API

Purpose

The MultiCoverage API allows you to create or edit MultiCoverages using the API. If you provide a MultiCoverage ID, it will only change the values of the existing MultiCoverage.

Account / API Key

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

mapId:

The mapId value is a string. It is optional if creating a new map but required if you want to update an existing map.

mapName:

The mapName value is a string. It is optional if creating a new map but required if you want to update an existing map.

coverageIds:

This parameter is a string that contains a list of Coverage IDs separated by a comma. It is only Required if it is a new map with no fiber coverage IDs. The Coverage ID can be located in the URL when you open any individual Coverage.

fiberCovIds:

This parameter is a string that contains a list of Fiber Coverage IDs separated by a comma. It is only Required if it is a new map with no coverage IDs. The Fiber Coverage ID can be located in the URL when you open any individual Coverage.

displayPins:

The displayPins value is optional. This value displays pins to represent the tower placement on a MultiCoverage. Valid values include “true” or “false” or “1” or “0”. By default the value will be set to false.

eusDataCollection:

The eusDataCollection value is optional. Activating this value turns on the data collection form inside the Iframe. Valid values include “true” or “false” or “1” or “0”. By default the value will be set to false.

displayFiberOnIframe:

The displayFiberOnIframe value is optional. Activating this value allows fiber polygons to display in the MultiCoverage. Valid values include “true” or “false” or “1” or “0”. By default the value will be set to false.

publicMap:

The publicMap value is optional. Activating this value will set the map to display publicly in the public maps section of TowerCoverage.com. Valid values include “true” or “false” or “1” or “0”. By default the value will be set to false.

zoomLevel:

The zoomLevel value is optional. Making adjustments to this value changes the Zoom level on the MultiCoverage. The Value is numerical and by default the value is set to 10.

centerLatitude:

Center Latitude is not a required field. It is used to help center the map but if a value is not provided it will default to the closest approximation it can find with the data provided.

centerLongitude:

Center Longitude is not a required field. It is used to help center the map but if a value is not provided it will default to the closest approximation it can find with the data provided.

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/MultiCoverageAPI"

<?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>
    <MultiCoverageAPI xmlns="http://tempuri.org/">
      <accountId>string</accountId>
      <mapId>string</mapId>
      <mapName>string</mapName>
      <coverageIds>string</coverageIds>
      <fiberCovIds>string</fiberCovIds>
      <displayPins>string</displayPins>
      <eusDataCollection>string</eusDataCollection>
      <displayFiberOnIframe>string</displayFiberOnIframe>
      <publicMap>string</publicMap>
      <zoomLevel>string</zoomLevel>
      <centerLatitude>string</centerLatitude>
      <centerLongitude>string</centerLongitude>
      <key>string</key>
    </MultiCoverageAPI>
  </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>
    <MultiCoverageAPIResponse xmlns="http://tempuri.org/">
      <MultiCoverageAPIResult>string</MultiCoverageAPIResult>
    </MultiCoverageAPIResponse>
  </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>
    <MultiCoverageAPI xmlns="http://tempuri.org/">
      <accountId>string</accountId>
      <mapId>string</mapId>
      <mapName>string</mapName>
      <coverageIds>string</coverageIds>
      <fiberCovIds>string</fiberCovIds>
      <displayPins>string</displayPins>
      <eusDataCollection>string</eusDataCollection>
      <displayFiberOnIframe>string</displayFiberOnIframe>
      <publicMap>string</publicMap>
      <zoomLevel>string</zoomLevel>
      <centerLatitude>string</centerLatitude>
      <centerLongitude>string</centerLongitude>
      <key>string</key>
    </MultiCoverageAPI>
  </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>
    <MultiCoverageAPIResponse xmlns="http://tempuri.org/">
      <MultiCoverageAPIResult>string</MultiCoverageAPIResult>
    </MultiCoverageAPIResponse>
  </soap12:Body>
</soap12:Envelope>

HTTP Get

Request

GET /towercoverage.asmx/MultiCoverageAPI?accountId=string&mapId=string&mapName=string&coverageIds=string&fiberCovIds=string&displayPins=string&eusDataCollection=string&displayFiberOnIframe=string&publicMap=string&zoomLevel=string&centerLatitude=string&centerLongitude=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/MultiCoverageAPI HTTP/1.1
Host: api.towercoverage.com
Content-Type: application/x-www-form-urlencoded
Content-Length: length

accountId=string&mapId=string&mapName=string&coverageIds=string&fiberCovIds=string&displayPins=string&eusDataCollection=string&displayFiberOnIframe=string&publicMap=string&zoomLevel=string&centerLatitude=string&centerLongitude=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>