CustomerDataService Class

CustomerDataService Class

Contains the methods to programmatically upload the points of interest data to the MapPoint servers.

Public Class CustomerDataService Inherits System.Web.Services.Protocols.SoapHttpClientProtocol


[C#]
public class CustomerDataService : System.Web.Services.Protocols.SoapHttpClientProtocol

Public Constructors

Name	Description
CustomerDataService Constructor	Initializes a new instance of the CustomerDataService class.

Public Methods

Name	Description
CopyDataSource	Enables you to move your data between the staging and production environments. This method returns a unique job ID that can be used in subsequent calls.
DeleteDataSource	Enables you to delete custom data sources from the production or staging environment. This method returns a unique job ID that can be used in subsequent calls.
FinishUpload	Marks the data upload job represented by the job ID as complete and submits the uploaded data for geocoding.
GetDownloadFileURL	Returns a URL that can be used to access the data file for a given job.
GetJobState	Returns the state of the data upload job represented by the jobID parameter.
StartBatchGeocode	Starts a batch geocoding job. This method returns a unique job ID that can be used in subsequent calls.
StartDownload	Starts a location data download job. This method returns a unique job ID that should be used in subsequent calls.
StartUpload	Starts a location data upload job. This method returns a unique job ID that should be used in subsequent calls.
UploadData	Uploads the point-of-interest data. You can use this method to upload data in multiple chunks. This method returns the number of bytes that were uploaded in the current call.

Example

[Visual Basic]

'Create an instance of the customer data service proxy.
Dim custDataService As CustomerDataService = New CustomerDataService
'Assign your credentials.
custDataService.Credentials = _
        New NetworkCredential(myUserName, mySecurePassword, myDomainName)

'Set PreAuthenticate to True
custDataService.PreAuthenticate = True

Try
    'Define an upload specification object
    'and assign all required fields.
    Dim uploadSpec As UploadSpecification = New UploadSpecification
    uploadSpec.DataSourceName = myDataSourceName
    uploadSpec.EntityTypeName = myEntityTypeName
    uploadSpec.Environment = LocationDataEnvironment.Staging
    uploadSpec.MaximumGeocodingLevel = GeocodingLevel.City
    uploadSpec.RejectAmbiguousGeocodes = False
    'Start an upload job and obtain the job ID.
    Dim jobID As String = custDataService.StartUpload(uploadSpec)
Catch e As Exception
    Dim message As String = e.Message
    'Do your exception handling here.
End Try



[C#]

 //Create an instance of the customer data service proxy.
   CustomerDataService cds = new CustomerDataService();
   //Assign your credentials.
   cds.Credentials = new System.Net.NetworkCredential(myUserName, 
           mySecurePassword, myDomainName);

   //Set PreAuthenticate to true
   cds.PreAuthenticate = true;

   try
   {
    //Define an upload specification object
    //and assign all required fields.
    UploadSpecification uploadspec = new UploadSpecification();
    uploadspec.DataSourceName = myDataSourceName;
    uploadspec.EntityTypeName = myEntityTypeName;
    uploadspec.Environment = LocationDataEnvironment.Staging;
    uploadspec.MaximumGeocodingLevel = GeocodingLevel.City;
    uploadspec.RejectAmbiguousGeocodes = false;
    //Start an upload job and obtain the job ID.
    string jobID = cds.StartUpload(uploadspec);
   }
   catch(Exception ex)
   {
    string message = ex.Message;
    //Do your exception handling here.
   }

See Also

  UploadSpecification Class   |   JobState Enumeration