Check Location entry

To obtain a list of my alerts changes for a user location you will need to call the CheckLocationEntry method. This method is available to developers from the Transaction.asmx Web Service. 

Parameters

 

uid

mandatory

This is the unique user id for the user as stored in the My Alerts database.

xmandatoryThis is the X coordinate for the location. These can be derived from the AstunLocationLookup table.
ymandatoryThis is the Y coordinate for the location. These can be derived from the AstunLocationLookup table.
distancemandatoryThis is the distance in metres.  If a change falls within this range, a user will receive an alert.

locationID

mandatory

This is the unique id for the Location.

mapSourceID

mandatory

This is the unique id for the MapSource.

layerGroupIdmandatoryThis is the unique id for the Layer Group.
uniqueIDmandatoryThis corresponds with the UniqueId on the AstunLocationLookup table.
bWriteCachemandatoryThis a boolean that determines if cache is written or not "True" or "False" respectively.

Name

Requirement

Description

 

Returns

Syntax
<CheckLocationEntryResult>
	<BaseChangeDefinition>
          <MyHouseUrl>string</MyHouseUrl>
          <LocationName>string</LocationName>
          <LayerGroupName>string</LayerGroupName>
          <LayerName>string</LayerName>
          <ConfigChange>boolean</ConfigChange>
          <OriginalContent>string</OriginalContent>
          <ChangedContent>string</ChangedContent>
          <Description>string</Description>
          <Title>string</Title>
          <Details>string</Details>
          <OldCache>string</OldCache>
          <NewCache>string</NewCache>
   </BaseChangeDefinition>
   <BaseChangeDefinition>
          <MyHouseUrl>string</MyHouseUrl>
          <LocationName>string</LocationName>
          <LayerGroupName>string</LayerGroupName>
          <LayerName>string</LayerName>
          <ConfigChange>boolean</ConfigChange>
          <OriginalContent>string</OriginalContent>
          <ChangedContent>string</ChangedContent>
          <Description>string</Description>
          <Title>string</Title>
          <Details>string</Details>
          <OldCache>string</OldCache>
          <NewCache>string</NewCache>
   </BaseChangeDefinition>
</CheckLocationEntryResult>

BaseChangeDefinition

A BaseChangeDefinition will be returned for each Location with the following details:

MyHouseUrl

URL Specific to a Users Location and Map Source.

LocationName

Common location name, i.e. Address.

LayerGroupName

Name of Layer Group, e.g. planning.

LayerName

Name of Layer, e.g. Determined applications.

ConfigChange

Whether it is a configuration change that has cause this change.

OriginalContent

Original Record.

ChangedContent

Changed Record.

Description

Description of the change.

Title

What type of change it is, e.g. Number of layers changed.

Details

Not populated.

OldCache

Old Cache Text.

NewCache

New Cache Text.