User Tools

Site Tools


map_suite_gps_tracking_server_web_services_reference_guide

This is an old revision of the document!


Map Suite GPS Tracking Server Web Services Reference Guide

This is a complete list of the methods exposed in the Map Suite GPS Tracking Server web portal web services. These services allow you to manipulate your Map Suite GPS Tracking Server web portal accounts, users, departments, devices and more.

The web service APIs are divided into two groups: Account APIs and Installation APIs. The scope of the Account APIs is a single account within your Map Suite GPS Tracking Server system; these allow you to manipulate that account's devices, users, departments and so on. The Installation APIs, by contrast, have a scope encompassing the entire GPS Tracking Server system. These give you access to creation and deletion of accounts and frontend language packs on the server.

Account Web Service APIs

WSOrganizationManager Web Service

GetOrganizationsForAccount method

	Parameters:
	
	{| class="wikitable" cellpadding="3"
		|-
			|<tt>securityKey</tt>
			|Required, user ID
		|-
			|<tt>accountID</tt>
			|Required, Account ID
	|}
	
	Return value: String
	
	Function description: Gets an organization from an account.

GetAllOrganizationForAccount method

	Parameters:
	
	{| class="wikitable" cellpadding="3"
		|-
			|<tt>userName</tt>
			|Required, user name for authentication
		|-
			|<tt>password</tt>
			|Required, password for authentication
		|-
			|<tt>accountID</tt>
			|Required, Account ID
	|}
	
	Return value: String
	
	Function description: Gets all organizations from an account.

GetOrganization method

	Parameters:
	
	{| class="wikitable" cellpadding="3"
		|-
			|<tt>userName</tt>
			|Required, user name for authentication
		|-
			|<tt>password</tt>
			|Required, password for authentication
		|-
			|<tt>orgID</tt>
			|Required, Organization ID
	|}
	
	Return value: String
	
	Function description: Gets an organization.

CreateOrganization method

	Parameters:
	
	{| class="wikitable" cellpadding="3"
		|-
			|<tt>userName</tt>
			|Required, user name for authentication
		|-
			|<tt>password</tt>
			|Required, password for authentication
		|-
			|<tt>accountID</tt>
			|Required, account ID
		|-
			|<tt>orgName</tt>
			|Required, organization name
		|-
			|<tt>Description</tt>
			|Organization description
		|-
			|<tt>mapDataID</tt>
			|Required, map Data ID
		|-
			|<tt>timeZone</tt>
			|Required, time zone of the organization's location
		|-
			|<tt>metric</tt>
			|Required, selects whether the organization's unit system is metric or imperial
		|-
			|<tt>status</tt>
			|Required, organization status, must be ACTIVE or INACTIVE, default is ACTIVE
		|-
			|<tt>externalID</tt>
			|Reserved field
	|}
	
	Return value: OrganizationID
	
	Function description: Creates an organization.

EditOrganization method

	Parameters:
	
	{| class="wikitable" cellpadding="3"
		|-
			|<tt>userName</tt>
			|Required, user name for authentication
		|-
			|<tt>password</tt>
			|Required, password for authentication
		|-
			|<tt>accountID</tt>
			|Required, account ID
		|-
			|<tt>orgID</tt>
			|Required, organization ID
		|-
			|<tt>orgName</tt>
			|Required, organization name
		|-
			|<tt>description</tt>
			|Organization description
		|-
			|<tt>manager</tt>
			|Manager of the organization
		|-
			|<tt>imageName</tt>
			|The path of the organization image
		|-
			|<tt>mapDataID</tt>
			|Required, map data ID
		|-
			|<tt>timeZone</tt>
			|Required, time zone of the organization's location
		|-
			|<tt>metric</tt>
			|Required, selects whether the organization's unit system is metric or imperial
		|-
			|<tt>status</tt>
			|Required, organization status, must be ACTIVE or INACTIVE, default is ACTIVE
		|-
			|<tt>externalID</tt>
			|Reserved field
	|}
	
	Return value: String
	
	Function description: Edits an organization.

DeleteOrganization method

	Parameters:
	
	{| class="wikitable" cellpadding="3"
		|-
			|<tt>userName</tt>
			|Required, user name for authentication
		|-
			|<tt>password</tt>
			|Required, password for authentication
		|-
			|<tt>orgID</tt>
			|Required, organization ID
	|}
	     	
	Return value: String
	
	Function description: Deletes an organization in the system.

OrganizationAddDevice method

	Parameters:
	
	{| class="wikitable" cellpadding="3"
		|-
			|<tt>userName</tt>
			|Required, user name for authentication
		|-
			|<tt>userName</tt>
			|Required, user name for authentication
		|-
			|<tt>password</tt>
			|Required, password for authentication
		|-
			|<tt>orgID</tt>
			|Required, organization ID
		|-
			|<tt>deviceID</tt>
			|Required, device ID
	|}
	
	Return value: String
	
	Function description: Adds a device to an organization.

OrganizationAddCarrier method

	Parameters:
	
	{| class="wikitable" cellpadding="3"
		|-
			|<tt>userName</tt>
			|Required, user name for authentication
		|-
			|<tt>password</tt>
			|Required, password for authentication
		|-
			|<tt>orgID</tt>
			|Required, organization ID
		|-
			|<tt>carrierID</tt>
			|Required, carrier ID
	|}
	
	Return value: String
	
	Function description: Adds a carrier to an organization.

OrganizationAddMonitor method

	Parameters:
	
	{| class="wikitable" cellpadding="3"
		|-
			|<tt>userName</tt>
			|Required, user name for authentication
		|-
			|<tt>password</tt>
			|Required, password for authentication
		|-
			|<tt>orgID</tt>
			|Required, organization ID
		|-
			|<tt>monitorID</tt>
			|Required, monitor ID
	|}
	
	Return value: String
	
	Function description: Adds a monitor to an organization.

GetCarriersForOrganization method

	Parameters:
	
	{| class="wikitable" cellpadding="3"
		|-
			|<tt>userName</tt>
			|Required, user name for authentication
		|-
			|<tt>password</tt>
			|Required, password for authentication
		|-
			|<tt>orgID</tt>
			|Required, organization ID
	|}
	
	Return value: String
	
	Function description: Gets the carriers in an organization.

GetDevicesForOrganization method

	Parameters:
	
	{| class="wikitable" cellpadding="3"
		|-
			|<tt>userName</tt>
			|Required, user name for authentication
		|-
			|<tt>password</tt>
			|Required, password for authentication
		|-
			|<tt>orgID</tt>
			|Required, organization ID
	|}
	
	Return value: String
	
	Function description: Gets the devices in an organization.

GetMonitorsForOrganization method

	Parameters:
	
	{| class="wikitable" cellpadding="3"
		|-
			|<tt>userName</tt>
			|Required, user name for authentication
		|-
			|<tt>password</tt>
			|Required, password for authentication
		|-
			|<tt>orgID</tt>
			|Required, organization ID
	|}
	
	Return value: String
	
	Function description: Gets the monitors in an organization.

DeleteOrganizationCarrier method

	Parameters:
	
	{| class="wikitable" cellpadding="3"
		|-
			|<tt>userName</tt>
			|Required, user name for authentication
		|-
			|<tt>password</tt>
			|Required, password for authentication
		|-
			|<tt>orgID</tt>
			|Required, organization ID
		|-
			|<tt>carrierID</tt>
			|Required, carrier ID
	|}
	
	Return value: String
	
	Function description: Deletes a carrier from an organization.

DeleteOrganizationDevice method

	Parameters:
	
	{| class="wikitable" cellpadding="3"
		|-
			|<tt>userName</tt>
			|Required, user name for authentication
		|-
			|<tt>password</tt>
			|Required, password for authentication
		|-
			|<tt>orgID</tt>
			|Required, Organization ID
		|-
			|<tt>deviceID</tt>
			|Required, device ID
	|}
	
	Return value: String
	
	Function description: Deletes a device from an organization.

DeleteOrganizationMonitor method

	Parameters:
	
	{| class="wikitable" cellpadding="3"
		|-
			|<tt>userName</tt>
			|Required, user name for authentication
		|-
			|<tt>password</tt>
			|Required, password for authentication
		|-
			|<tt>orgID</tt>
			|Required, organization ID
		|-
			|<tt>monitorID</tt>
			|Required, monitor ID
	|}
	
	Return value: String
	
	Function description: Deletes a monitor from an organization.

GetAllMapDataForAccount method

	Parameters:
	
	{| class="wikitable" cellpadding="3"
		|-
			|<tt>userName</tt>
			|Required, user name for authentication
		|-
			|<tt>password</tt>
			|Required, password for authentication
		|-
			|<tt>accountID</tt>
			|Required, account ID
	|}
	
	Return value: String
	
	Function description: Gets all available map data for an account.

WSMonitorManager Web Service

CreateMonitor method

	Parameters:
	
	{| class="wikitable" cellpadding="3"
		|-
			|<tt>adminUserName</tt>
			|Required, admin user name for authentication
		|-
			|<tt>adminUserName</tt>
			|Required, admin password for authentication
		|-
			|<tt>accountID</tt>
			|Required, account ID
		|-
			|<tt>name</tt>
			|Required, Monitor name
		|-
			|<tt>description</tt>
			|Monitor description
		|-
			|<tt>userName</tt>
			|Required, user name
		|-
			|<tt>password</tt>
			|Required, password
		|-
			|<tt>entryReference</tt>
			|Required, selects which page is the default entry page - Dashboard or Map Area
		|-
			|<tt>status</tt>
			|Required, monitor status, must be ACTIVE or INACTIVE, default is ACTIVE
		|-
			|<tt>externalID</tt>
			|Reserved field
	|}
	
	Return value: MonitorID
	
	Function description: Creates a monitor.

EditMonitor method

	Parameters
	
	{| class="wikitable" cellpadding="3"
		|-
			|<tt>adminUserName</tt>
			|Required, admin user name for authentication
		|-
			|<tt>adminPassword</tt>
			|Required, admin password for authentication
		|-
			|<tt>accountID</tt>
			|Required, account ID
		|-
			|<tt>monitorID</tt>
			|Monitor ID
		|-
			|<tt>name</tt>
			|Required, monitor name
		|-
			|<tt>description</tt>
			|Monitor description
		|-
			|<tt>userName</tt>
			|Required, user name
		|-
			|<tt>password</tt>
			|Required, password
		|-
			|<tt>entryReference</tt>
			|Required, selects which page is the default entry page - Dashboard or Map Area
		|-
			|<tt>status</tt>
			|Required, monitor status, must be ACTIVE or INACTIVE, default is ACTIVE
		|-
			|<tt>externalID</tt>
			|Reserved field
	|}
	
	Return value: String
	
	Function description: Edits a monitor.

DeleteMonitor method

	Parameters:
	
	{| class="wikitable" cellpadding="3"
		|-
			|<tt>adminUserName</tt>
			|Required, admin user name for authentication
		|-
			|<tt>adminUserName</tt>
			|Required, admin user name for authentication
		|-
			|<tt>adminPassword</tt>
			|Required, admin password for authentication
		|-
			|<tt>MonitorID</tt>
			|Required, monitor ID
	|}
	
	Return value: String
	
	Function description: Deletes a monitor from the system.

GetMonitor method

	Parameters:
	
	{| class="wikitable" cellpadding="3"
		|-
			|<tt>adminUserName</tt>
			|Required, admin user name for authentication
		|-
			|<tt>adminPassword</tt>
			|Required, admin password for authentication
		|-
			|<tt>MonitorID</tt>
			|Required, monitor ID
	|}
	
	Return value: String
	
	Function description: Gets a monitor.

GetMonitorsForAccount method

	Parameters:
	
	{| class="wikitable" cellpadding="3"
		|-
			|<tt>adminUserName</tt>
			|Required, admin user name for authentication
		|-
			|<tt>adminPassword</tt>
			|Required, admin password for authentication
		|-
			|<tt>accountID</tt>
			|Required, account ID
	|}
	            
	Return value: String
	
	Function description: Gets monitors from an account.

GetMonitorsForOrganization method

	Parameters:
	
	{| class="wikitable" cellpadding="3"
		|-
			|<tt>adminUserName</tt>
			|Required, admin user name for authentication
		|-
			|<tt>adminPassword</tt>
			|Required, admin password for authentication
		|-
			|<tt>orgID</tt>
			|Required, Organization ID
	|}
	
	Return value: String
	
	Function description: Gets monitors from an organization.

WSUserManager Web Service

GetUsersForAccount method

	Parameters:
	
	{| class="wikitable" cellpadding="3"
		|-
			|<tt>adminUserName</tt>
			|Required, admin user name for authentication
		|-
			|<tt>adminPassword</tt>
			|Required, admin password for authentication
		|-
			|<tt>accountID</tt>
			|Required, account ID
	|}
	
	Return value: String
	
	Function description: Gets users from an account.

GetUser method

	Parameters:
	
	{| class="wikitable" cellpadding="3"
		|-
			|<tt>adminUserName</tt>
			|Required, admin user name for authentication
		|-
			|<tt>adminPassword</tt>
			|Required, admin password for authentication
		|-
			|<tt>userID</tt>
			|Required, user ID
	|}
	
	Return value: String
	
	Function description: Gets a user.

CreateUser method

	Parameters:
	
	{| class="wikitable" cellpadding="3"
		|-
			|<tt>adminUserName</tt>
			|Required, admin user name for authentication
		|-
			|<tt>adminPassword</tt>
			|Required, admin password for authentication
		|-
			|<tt>accountID</tt>
			|Required, account ID
		|-
			|<tt>userName</tt>
			|Required, user name
		|-
			|<tt>password</tt>
			|Required, password
		|-
			|<tt>status</tt>
			|Required, user status, must be ACTIVE or INACTIVE, default is ACTIVE
		|-
			|<tt>externalID</tt>
			|Reserved field
		|-
			|<tt>entryReference</tt>
			|Required, selects which page is the default entry page - Dashboard or Map Area
		|-
			|<tt>firstName</tt>
			|First name
		|-
			|<tt>lastName</tt>
			|Last name
		|-
			|<tt>emailAddress</tt>
			|Email address
		|-
			|<tt>activateDate</tt>
			|Activation date
		|-
			|<tt>deactiveDate</tt>
			|Deactivation date
		|-
			|<tt>allowMultipleSessions</tt>
			|Whether to enable multiple sessions, which allow the same user to be logged in more than once simultaneously
		|-
			|<tt>checkMessageInterval</tt>
			|Check message interval
	|}
	
	Return value: UserID
	
	Function description: Creates a user.

EditUser method

	Parameters:
	
	{| class="wikitable" cellpadding="3"
		|-
			|<tt>adminUserName</tt>
			|Required, admin user name for authentication
		|-
			|<tt>adminPassword</tt>
			|Required, admin password for authentication
		|-
			|<tt>accountID</tt>
			|Required, account ID
		|-
			|<tt>userID</tt>
			|Required, user ID
		|-
			|<tt>userName</tt>
			|Required, user name
		|-
			|<tt>password</tt>
			|Required, password
		|-
			|<tt>status</tt>
			|Required, user status, must be ACTIVE or INACTIVE, default is ACTIVE
		|-
			|<tt>externalID</tt>
			|Reserved field
		|-
			|<tt>entryReference</tt>
			|Required, selects which page is the default entry page - Dashboard or Map Area
		|-
			|<tt>firstName</tt>
			|First name
		|-
			|<tt>lastName</tt>
			|Last name
		|-
			|<tt>emailAddress</tt>
			|Email address
		|-
			|<tt>activateDate</tt>
			|Activation date
		|-
			|<tt>deactiveDate</tt>
			|Deactivation date
		|-
			|<tt>allowMultipleSessions</tt>
			|Whether to enable multiple sessions, which allow the same user to be logged in more than once simultaneously
		|-
			|<tt>checkMessageInterval</tt>
			|Check message interval
	|}
	
	Return value: String
	
	Function description: Edits a user.

DeleteUser method

	Parameters
	
	{| class="wikitable" cellpadding="3"
		|-
			|<tt>adminUserName</tt>
			|Required, admin user name for authentication
		|-
			|<tt>adminPassword</tt>
			|Required, admin password for authentication
		|-
			|<tt>userID</tt>
			|Required, user ID
	|}
	
	Return value: String
	
	Function description: Deletes a user from the system.

ChangeUserPassword method

	Parameters
	
	{| class="wikitable" cellpadding="3"
		|-
			|<tt>adminUserName</tt>
			|Required, admin user name for authentication
		|-
			|<tt>adminPassword</tt>
			|Required, admin password for authentication
		|-
			|<tt>userName</tt>
			|Required, user name
		|-
			|<tt>newPassword</tt>
			|Required, new password
	|}
	
	Return value: String
	
	Function description: Change a user's password.

IsUserNameInUse method

	Parameters:
	
	{| class="wikitable" cellpadding="3"
		|-
			|<tt>username</tt>
			|Required, the user name to check for
	|}
	                   
	Return value: bool
	
	Function description: Checks whether a specified username is in use.

IsEmailInUse method

	Parameters:
	
	{| class="wikitable" cellpadding="3"
		|-
			|<tt>emailAddress</tt>
			|Required, the email address to check for
	|}
	
	Return value: bool
	
	Function description: Checks whether a specified user email address is in use.

WSDeviceManager Web Service

GetDevicesForOrganization method

	Parameters:
	
	{| class="wikitable" cellpadding="3"
		|-
			|<tt>securityKey</tt>
			|Required, user ID
		|-
			|<tt>organizationID</tt>
			|Required, organization ID
	|}
	
	Return value: String
	
	Function description: Gets the devices from an organization.

GetDevicesForAccount method

	Parameters:
	
	{| class="wikitable" cellpadding="3"
		|-
			|<tt>userName</tt>
			|Required, user name for authentication
		|-
			|<tt>password</tt>
			|Required, password for authentication
		|-
			|<tt>accountid</tt>
			|Required, account ID
	|}
	  
	Return value: String
	
	Function description: Gets the devices from an account.

GetAllDevicesForOrganization method

	Parameters:
	
	{| class="wikitable" cellpadding="3"
		|-
			|<tt>userName</tt>
			|Required, user name for authentication
		|-
			|<tt>password</tt>
			|Required, password for authentication
		|-
			|<tt>orgID</tt>
			|Required, organization ID
	|}
	
	Return value: String
	
	Function description: Gets all devices from an organization.

GetDeviceCategories method

	Parameters:
	
	{| class="wikitable" cellpadding="3"
		|-
			|<tt>userName</tt>
			|Required, user name for authentication
		|-
			|<tt>password</tt>
			|Required, password for authentication
		|-
			|<tt>accountID</tt>
			|Required, account ID
	|}
	
	Return value: String
	
	Function description: Gets the device categories.

GetDevice method

	Parameters:
	
	{| class="wikitable" cellpadding="3"
		|-
			|<tt>userName</tt>
			|Required, user name for authentication
		|-
			|<tt>password</tt>
			|Required, password for authentication
		|-
			|<tt>deviceID</tt>
			|Required, device ID
	|}
	
	Return value: String
	
	Function description: Gets a device.

CreateDevice method

	Parameters:
	
	{| class="wikitable" cellpadding="3"
		|-
			|<tt>userName</tt>
			|Required, user name for authentication
		|-
			|<tt>password</tt>
			|Required, password for authentication
		|-
			|<tt>accountID</tt>
			|Required, account ID
		|-
			|<tt>deviceName</tt>
			|Required, device name
		|-
			|<tt>description</tt>
			|Device description
		|-
			|<tt>topSpeed</tt>
			|Required, top speed
		|-
			|<tt>status</tt>
			|Required, device status, must be ACTIVE or INACTIVE, default is ACTIVE
		|-
			|<tt>externalID</tt>
			|Reserved field
		|-
			|<tt>imei</tt>
			|Required, International Mobile Equipment Identifier (IMEI) or Electronic Identifier (EID) of the wireless modem
		|-
			|<tt>cannedMessage</tt>
			|Required, specifies whether or not the device supports two-way communication
		|-
			|<tt>deviceCategoryID</tt>
			|Device category ID
		|-
			|<tt>colorCode</tt>
			|Choose a color to associate with the device, default is a random color
	|}
	
	Return value: DeviceID
	
	Function description: Creates a device.

EditDevice method

	Parameters:
	
	{| class="wikitable" cellpadding="3"
		|-
			|<tt>userName</tt>
			|Required, user name for authentication
		|-
			|<tt>password</tt>
			|Required, password for authentication
		|-
			|<tt>accountID</tt>
			|Required, account ID
		|-
			|<tt>DeviceID</tt>
			|Required, device ID
		|-
			|<tt>deviceName</tt>
			|Required, device name
		|-
			|<tt>description</tt>
			|Device description
		|-
			|<tt>topSpeed</tt>
			|Required, top speed
		|-
			|<tt>status</tt>
			|Required, device status, must be ACTIVE or INACTIVE, default is ACTIVE
		|-
			|<tt>externalID</tt>
			|Reserved field
		|-
			|<tt>imei</tt>
			|Required, International Mobile Equipment Identifier (IMEI) or Electronic Identifier (EID) of the wireless modem
		|-
			|<tt>cannedMessage</tt>
			|Required, specifies whether or not the device supports two-way communication
		|-
			|<tt>deviceCategoryID</tt>
			|Device category ID
		|-
			|<tt>colorCode</tt>
			|Choose a color to associate with the device, default is a random color
	|}
	
	Return value: String
	
	Function description: Edits a carrier.

DeleteDevice method

	Parameters:
	
	{| class="wikitable" cellpadding="3"
		|-
			|<tt>userName</tt>
			|Required, user name for authentication
		|-
			|<tt>password</tt>
			|Required, password for authentication
		|-
			|<tt>deviceID</tt>
			|Required, device ID
	|}
	
	Return value: String
	
	Function description: Delete a device from the system.

WSCarrierManager Web Service

GetCarriersForAccount method

	Parameters:
	
	{| class="wikitable" cellpadding="3"
		|-
			|<tt>userName</tt>
			|Required, user name for authentication
		|-
			|<tt>password</tt>
			|Required, password for authentication
		|-
			|<tt>accountID</tt>
			|Required, account ID
	|}
	
	Return value: String
	
	Function description: Gets the carriers from an account.

GetCarriersForOrganization method

	Parameters:
	
	{| class="wikitable" cellpadding="3"
		|-
			|<tt>userName</tt>
			|Required, user name for authentication
		|-
			|<tt>password</tt>
			|Required, password for authentication
		|-
			|<tt>orgID</tt>
			|Required, organization ID
	|}
	
	Return value: String
	
	Function description: Gets the carriers from an organization.

GetCarriersDevice method

	Parameters:
	
	{| class="wikitable" cellpadding="3"
		|-
			|<tt>userName</tt>
			|Required, user name for authentication
		|-
			|<tt>password</tt>
			|Required, password for authentication
		|-
			|<tt>carrierID</tt>
			|Required, carrier ID
	|}
	
	Return value: String
	
	Function description: Gets a carrier's device.

GetCarriers method

	Parameters:
	
	{| class="wikitable" cellpadding="3"
		|-
			|<tt>userName</tt>
			|Required, user name for authentication
		|-
			|<tt>password</tt>
			|Required, password for authentication
		|-
			|<tt>carrierID</tt>
			|Required, carrier ID
	|}
	
	Return value: String
	
	Function description: Gets a carrier.

CreateCarrier method

	Parameters:
	
	{| class="wikitable" cellpadding="3"
		|-
			|<tt>userName</tt>
			|Required, user name for authentication
		|-
			|<tt>password</tt>
			|Required, password for authentication
		|-
			|<tt>accountID</tt>
			|Required, account ID
		|-
			|<tt>carrierName</tt>
			|Required, carrier name
		|-
			|<tt>carrierPin</tt>
			|Carrier's personal identification number, the default value is 0000
		|-
			|<tt>status</tt>
			|Required, carrier status, must be ACTIVE or INACTIVE, default is ACTIVE
		|-
			|<tt>externalID</tt>
			|Reserved field
		|-
			|<tt>colorCode</tt>
			|Choose a color to associate with the device, default is a random color
	|}
	
	Return value: CarrierID
	
	Function description: Creates a carrier.

EditCarrier method

	Parameters:
	
	{| class="wikitable" cellpadding="3"
		|-
			|<tt>userName</tt>
			|Required, user name for authentication
		|-
			|<tt>password</tt>
			|Required, password for authentication
		|-
			|<tt>accountID</tt>
			|Required, account ID
		|-
			|<tt>carrierID</tt>
			|Required, carrier ID
		|-
			|<tt>carrierName</tt>
			|Required, carrier name
		|-
			|<tt>description</tt>
			|Required, description of the carrier
		|-
			|<tt>otherInformation</tt>
			|Other information about the carrier, HTML supported.  Will be displayed in a popup bubble on the tracking screen.
		|-
			|<tt>carrierPin</tt>
			|Carrier's personal identification number, the default value is 0000
		|-
			|<tt>status</tt>
			|Required, carrier status, must be ACTIVE or INACTIVE, default is ACTIVE
		|-
			|<tt>externalID</tt>
			|Reserved field
		|-
			|<tt>colorCode</tt>
			|Choose a color to associate with the device, default is a random color
	|}
	
	Return value: String
	
	Function description: Edits a carrier.

DeleteCarrier method

	Parameters:
	
	{| class="wikitable" cellpadding="3"
		|-
			|<tt>userName</tt>
			|Required, user name for authentication
		|-
			|<tt>password</tt>
			|Required, password for authentication
		|-
			|<tt>carrierID</tt>
			|Required, carrier ID
	|}
	
	Return value: String
	
	Function description: Deletes a carrier from the system.

CarrierAddDevice method

	Parameters:
	
	{| class="wikitable" cellpadding="3"
		|-
			|<tt>userName</tt>
			|Required, user name for authentication
		|-
			|<tt>password</tt>
			|Required, password for authentication
		|-
			|<tt>carrierID</tt>
			|Required, carrier ID
		|-
			|<tt>deviceID</tt>
			|Required, device ID
	|}
	
	Return value: String
	
	Function description: Assigns a device to a carrier.

CarrierDeleteDevice method

	Parameters:
	
	{| class="wikitable" cellpadding="3"
		|-
			|<tt>userName</tt>
			|Required, user name for authentication
		|-
			|<tt>password</tt>
			|Required, password for authentication
		|-
			|<tt>carrierID</tt>
			|Required, carrier ID
		|-
			|<tt>deviceID</tt>
			|Required, device ID
	|}
	
	Return value: String
	
	Function description: Disassociates a device from a carrier.

WSAlertManager Web Service

LoadEventResponseForAccount method

	Parameters:
	
	{| class="wikitable" cellpadding="3"
		|-
			|<tt>userName</tt>
			|Required, user name for authentication
		|-
			|<tt>password</tt>
			|Required, password for authentication
		|-
			|<tt>accountID</tt>
			|Required, account ID
		|-
			|<tt>serverity</tt>
			|Required, serverity level
	|}
	
	Return value: String
	
	Function description: Loads an event response for an account.

LoadEventResponseForOrganization method

	Parameters:
	
	{| class="wikitable" cellpadding="3"
		|-
			|<tt>userName</tt>
			|Required, user name for authentication
		|-
			|<tt>password</tt>
			|Required, password for authentication
		|-
			|<tt>organizationID</tt>
			|Required, organization ID
		|-
			|<tt>serverity</tt>
			|Required, serverity
	|}
	
	Return value: String
	
	Function description: Loads an event response for an organization.

EditEventResponseForAccount method

	Parameters:
	
	{| class="wikitable" cellpadding="3"
		|-
			|<tt>userName</tt>
			|Required, user name for authentication
		|-
			|<tt>password</tt>
			|Required, password for authentication
		|-
			|<tt>accountID</tt>
			|Required, account ID
		|-
			|<tt>serverity</tt>
			|Required, serverity
		|-
			|<tt>additionalEmailAddresses</tt>
			|Required
		|-
			|<tt>alertPopupAction</tt>
			|Required, popup action
		|-
			|<tt>alertThreshold</tt>
			|Required, alert threshold
		|-
			|<tt>friendlyName</tt>
			|Required, friendly name
		|-
			|<tt>iconPath</tt>
			|Required
		|-
			|<tt>noisePath</tt>
			|Required
		|-
			|<tt>overridden</tt>
			|Required
		|-
			|<tt>overrides</tt>
			|Required
		|-
			|<tt>repeat</tt>
			|Required
		|-
			|<tt>sendEmail</tt>
			|Required
		|-
			|<tt>severityColor</tt>
			|Required
	|}
	
	Return value: String
	
	Function description: Edits an event response for an account.

EditEventResponseFor Organization method

	Parameters:
	
	{| class="wikitable" cellpadding="3"
		|-
			|<tt>userName</tt>
			|Required, user name for authentication
		|-
			|<tt>password</tt>
			|Required, password for authentication
		|-
			|<tt>organizationID</tt>
			|Required, organization ID
		|-
			|<tt>serverity</tt>
			|Required, serverity
		|-
			|<tt>additionalEmailAddresses</tt>
			|Required
		|-
			|<tt>alertPopupAction</tt>
			|Required, popup action
		|-
			|<tt>alertThreshold</tt>
			|Required, alert threshold
		|-
			|<tt>friendlyName</tt>
			|Required, friendly name
		|-
			|<tt>iconPath</tt>
			|Required
		|-
			|<tt>noisePath</tt>
			|Required
		|-
			|<tt>overridden</tt>
			|Required
		|-
			|<tt>overrides</tt>
			|Required
		|-
			|<tt>repeat</tt>
			|Required
		|-
			|<tt>sendEmail</tt>
			|Required
		|-
			|<tt>severityColor</tt>
			|Required
	|}
	
	Return value: String
	
	Function description: Edits an event response for an organization.

WSLocationManager Web Service

CreateLocation method

	Parameters:
	
	{| class="wikitable" cellpadding="3"
		|-
			|<tt>adminUserName</tt>
			|Required, user name for authentication
		|-
			|<tt>adminPassword</tt>
			|Required, password for authentication
		|-
			|<tt>IMEI</tt>
			|Required, Device IMEI
		|-
			|<tt>locationID</tt>
			|Required, New Guid
		|-
			|<tt>logTime</tt>
			|Required, GPS date time of message
		|-
			|<tt>yPoint</tt>
			|Required, Latitude
		|-
			|<tt>xPoint</tt>
			|Required, Longitude
		|-
			|<tt>altitude</tt>
			|Required, altitude
		|-
			|<tt>speed</tt>
			|Required, device speed
		|-
			|<tt>travelDirection</tt>
			|Required, Travel Direction
		|-
			|<tt>speedUncertainty</tt>
			|Required, Speed Uncertainty or not
		|-
			|<tt>responseCode</tt>
			|Required
		|-
			|<tt>assistanceUsed</tt>
			|Required
	|}
	
	Return value: LocationID
	
	Function description: Create a location for device.

GetCurrentLocationByDevice method

	Parameters:
	
	{| class="wikitable" cellpadding="3"
		|-
			|<tt>userName</tt>
			|Required, user name for authentication
		|-
			|<tt>password</tt>
			|Required, password for authentication
		|-
			|<tt>deviceID</tt>
			|Required
	|}
	
	Return value: String
	
	Function description: Get current location for the device.

GetLocationBySession method

	Parameters:
	
	{| class="wikitable" cellpadding="3"
		|-
			|<tt>userName</tt>
			|Required, user name for authentication
		|-
			|<tt>password</tt>
			|Required, password for authentication
		|-
			|<tt>lsessionD</tt>
			|Required
	|}
	
	Return value: String
	
	Function description: Get locations for the session.

Installation Web Service APIs

WSAccountManager Web Service

CreateAccount method

		Parameters:
		
		{| class="wikitable" cellpadding="3"
			|-
				|<tt>installUserName</tt>
				|Required, installer user name for authentication
			|-
				|<tt>installPassword</tt>
				|Required, installer password for authentication
			|-
				|<tt>adminUserName</tt>
				|Required, admin user name for the account
			|-
				|<tt>adminPassword</tt>
				|Required, admin password
			|-
				|<tt>accountName</tt>
				|Required, account name
			|-
				|<tt>externalID</tt>
				|Reserved field
			|-
				|<tt>status</tt>
				|Required, account status, must be ACTIVE or INACTIVE, default is ACTIVE
			|-
				|<tt>activateDate</tt>
				|Account activation date
			|-
				|<tt>deactivateDate</tt>
				|Account deactivation date
			|-
				|<tt>manageSecurity</tt>
				|Can manage security or not
			|-
				|<tt>manageBrand</tt>
				|Can manage brand or not
			|-
				|<tt>processLocationInfo</tt>
				|Can process LocationInformation of map or not in account level
			|-
				|<tt>termsOfUse</tt>
				|Can use terms of use or not
			|-
				|<tt>orgLimit</tt>
				|Organization limit, default is -1 (unlimited)
			|-
				|<tt>monitorLimit</tt>
				|Monitor limit, default is -1 (unlimited)
			|-
				|<tt>carrierLimit</tt>
				|Carrier limit, default is -1 (unlimited)
			|-
				|<tt>deviceLimit</tt>
				|Device limit, default is -1 (unlimited)
			|-
				|<tt>targetLimit</tt>
				|Target limit, default is -1 (unlimited)
			|-
				|<tt>areaLimit</tt>
				|Area limit, default is -1 (unlimited)
			|-
				|<tt>securityPath</tt>
				|If Two-Factor Authentication is enabled in Account General Settings, the security binary path will be used to judge whether or not this account is TwoFactorSecurity Valid when a user logs in.
		|}
		
		Return value: AccountID
		
		Function description: Creates an account at the installer level.

GetAccount method

		Parameters:
		
		{| class="wikitable" cellpadding="3"
			|-
				|<tt>installUserName</tt>
				|Required, installer user name for authentication
			|-
				|<tt>installPassword</tt>
				|Required, installer password for authentication
			|-
				|<tt>accountID</tt>
				|Required, account ID
		|}
		
		Return value: String
		
		Function description: Checks to see whether the account exists in the system.
		
		

GetAllAccounts method

		Parameters:
		
		{| class="wikitable" cellpadding="3"
			|-
				|<tt>installUserName</tt>
				|Required, installer user name for authentication
			|-
				|<tt>installPassword</tt>
				|Required, installer password for authentication
		|}
		          
		Return value: String
		
		Function description: Gets all of the accounts under this installation.

EditAccount method

		Parameters:
		
		{| class="wikitable" cellpadding="3"
			|-
				|<tt>installUserName</tt>
				|Required, installer user name for authentication
			|-
				|<tt>installPassword</tt>
				|Required, installer password for authentication
			|-
				|<tt>accountID</tt>
				|Required, account ID
			|-
				|<tt>accountName</tt>
				|Required, account name
			|-
				|<tt>externalID</tt>
				|Reserved field
			|-
				|<tt>status</tt>
				|Required, account status, must be ACTIVE or INACTIVE, default is ACTIVE
			|-
				|<tt>activateDate</tt>
				|Account activation date
			|-
				|<tt>deactivateDate</tt>
				|Account deactivation date
			|-
				|<tt>manageSecurity</tt>
				|Can manage security or not
			|-
				|<tt>manageBrand</tt>
				|Can manage branding or not
			|-
				|<tt>processLocationInfo</tt>
				|Can process LocationInformation of the map at the account level or not
			|-
				|<tt>termsOfUse</tt>
				|Can apply Terms of Use or not
			|-
				|<tt>orgLimit</tt>
				|Organization limit, default is -1 (unlimited)
			|-
				|<tt>monitorLimit</tt>
				|Monitor limit, default is -1 (unlimited)
			|-
				|<tt>carrierLimit</tt>
				|Carrier limit, default is -1 (unlimited)
			|-
				|<tt>deviceLimit</tt>
				|Device limit, default is -1 (unlimited)
			|-
				|<tt>targetLimit</tt>
				|Target limit, default is -1 (unlimited)
			|-
				|<tt>areaLimit</tt>
				|Area limit, default is -1 (unlimited)
			|-
				|<tt>securityPath</tt>
				|If Two-Factor Authentication is enabled in Account General Settings, the security binary path will be used to judge whether or not this account is TwoFactorSecurity Valid when a user logs in.
		|}
		
		Return value: AccountID
		
		Function description: Edits an account at the installer level.

DeleteAccount method

		Parameters:
		
		{| class="wikitable" cellpadding="3"
			|-
				|<tt>installUserName</tt>
				|Required, installer user name for authentication
			|-
				|<tt>installPassword</tt>
				|Required, installer password for authentication
			|-
				|<tt>accountID</tt>
				|Required, Account ID
		|}
		
		Return value: String
		
		Function description: Deletes an account in the system at the installer level.

WSLanguageManager Web Service

GetLanguageList method

		Parameters:
		
		{| class="wikitable" cellpadding="3"
			|-
				|<tt>installUserName</tt>
				|Required, installer user name for authentication
			|-
				|<tt>installPassword</tt>
				|Required, installer password for authentication
		|}
		
		Return value: String
		
		Function description: Gets a list of languages available in the installation.

GetLanguage method

		Parameters:
		
		{| class="wikitable" cellpadding="3"
			|-
				|<tt>installUserName</tt>
				|Required, installer user name for authentication
			|-
				|<tt>installPassword</tt>
				|Required, installer password for authentication
			|-
				|<tt>languageID</tt>
				|Required, language ID
		|}
		
		Return value: String
		
		Function description: Gets a language.

GetSystemLanguageList method

		Parameters:
		
		{| class="wikitable" cellpadding="3"
			|-
				|<tt>installUserName</tt>
				|Required, installer user name for authentication
			|-
				|<tt>installPassword</tt>
				|Required, installer password for authentication
		|}
		
		Return value: String
		
		Function description: Gets a list of the available system languages.

LanguageDelete method

		Parameters:
		
		{| class="wikitable" cellpadding="3"
			|-
				|<tt>installUserName</tt>
				|Required, installer user name for authentication
			|-
				|<tt>installPassword</tt>
				|Required, installer password for authentication
			|-
				|<tt>languageID</tt>
				|Required, language ID
		|}
		
		Return value: String
		
		Function description: Deletes a language.

CreateLanguage method

		Parameters:
		
		{| class="wikitable" cellpadding="3"
			|-
				|<tt>installUserName</tt>
				|Required, installer user name for authentication
			|-
				|<tt>installPassword</tt>
				|Required, installer password for authentication
			|-
				|<tt>languageName</tt>
				|Required, language name
			|-
				|<tt>isSystem</tt>
				|Required
			|-
				|<tt>Status</tt>
				|Required, status
		|}
		
		Return value: String
		
		Function description: Creates a new language.

EditLanguage method

		Parameters:
		
		{| class="wikitable" cellpadding="3"
			|-
				|<tt>installUserName</tt>
				|Required, installer user name for authentication
			|-
				|<tt>installPassword</tt>
				|Required, installer password for authentication
			|-
				|<tt>languageID</tt>
				|Required, language ID
			|-
				|<tt>languageName</tt>
				|Required, language name
			|-
				|<tt>isSystem</tt>
				|Required
			|-
				|<tt>Status</tt>
				|Required, status
		|}
		
		Return value: String
		
		Function description: Edits a language.

SetLanguageForUser method

		Parameters:
		
		{| class="wikitable" cellpadding="3"
			|-
				|<tt>installUserName</tt>
				|Required, installer user name for authentication
			|-
				|<tt>installPassword</tt>
				|Required, installer password for authentication
			|-
				|<tt>languageID</tt>
				|Required, language ID
			|-
				|<tt>accountID</tt>
				|Required, account ID
		|}
		
		Return value: String
		
		Function description: Sets the language for a user.

Map Suite GPS Tracking Server GPS Tracking ASP.NET .NET

map_suite_gps_tracking_server_web_services_reference_guide.1441873485.txt.gz · Last modified: 2015/09/10 08:24 by admin