Import()

Description:

The Import method imports a set of landmarks to a landmark database.

This is a synchronous method.

Syntax:

Import(parameters:Object):Object

Arguments:

  • parameters:

    This is an object that specifies the set of landmarks to import and optionally the target database. For more information about the object properties and how to define them, see section Parameters for importing landmarks.

Return value:

The Import method returns an object that contains the imported landmarks, an error code, and an error message.

Table: Return value properties for Import

Property

Description

Value

ReturnValue

This is an iterator that contains the imported landmarks. Each object in the iterator is a landmark object, which contains the information for a single landmark.

 

ErrorCode

This is a number that specifies a predefined error code.

See Service API error codes.

ErrorMessage

This is a text string that describes the error.

Remarks:

  • If no landmark database is specified, Import is performed on the default database. If the default database does not exist, it is created and set active. The default database is file://c:eposlm.ldb.

  • For more information about landmarks, landmark categories, and landmark databases, see the Landmarks Service overview page.

Example code:

The following sample code illustrates how to import a landmark:

import com.nokia.lib.Service;
var landmark = new Service("Service.Landmarks", "IDataSource");
var inputData = {SourceFile:"c:\\sample.lmx", MimeType:"application/vnd.nokia.landmarkcollection+xml"};
var inParams = {Type:"Landmark", Data:inputData};
var outParams = landmark.Import(inParams);
var outList = outParams.ReturnValue;
var outputEntry = null;
do {
    outputEntry = outList.next();
    if (null != outputEntry) {
        var landmarkId = outputEntry.id;
    } else {
        break;
    }
} while (true);