Get Landmark Details
getLandmarkDetails
This web service returns a Landmark object containing information pertaining to a specified landmark. Identification of the desired landmark may be accomplished in one of two ways: specifying the landmark's name or alias.
Landmark getLandmarkDetails(string companyId, string landmarkName, string landmarkAlias) throws WSException
- companyId: (optional) A string, maximum length 10, specifying the unique company identifier.
NOTE: If no companyId is specified, the company of the authorized user making the call will be used. - landmarkName: (optional) A string, maximum length 25, specifying the unique name of the landmark whose details are to be retrieved.
- landmarkAlias: (optional) A string, maximum length 25, specifying the unique alias of the landmark whose details are to be retrieved. This parameter is ignored if a landmarkName is specified.
Returns a null string on exceptions; otherwise returns a Landmark object.
Authorization Requirements
The credentials supplied with this method call (as specified in the accompanying WS-Security header) must be authorized to the following application(s) and their associated role-based permissions.
Required Application Licenses
- Remote Integration
Required User Permissions
- Can use GeoServices
Customer integrators are authorized to their own company's data only.
Sample XML Request
Only the SOAP body is shown. To see a sample SOAP Envelope and Header, click here.
|
Sample XML Response
|
Exceptions
001 Unknown Error.
003 Company not authorized for integration.
004 User not authorized.
005 User cannot retrieve details for specified company.
006 Landmark name or alias must be specified.
007 Landmark cannot be found with specified information.