New()

Description:

The New method creates an empty landmark or landmark category item. You can use the new item as a template.

This is a synchronous method.

Syntax:

New(parameters:Object):Object

Arguments:

parameters:

This is an object that specifies the type of item to create. The following table describes the properties of this object.

**Table:** Parameters object properties
Property	Description	Value
`parameters.Type`	This is a text string that specifies the type of item to create.	Possible values: `"Landmark"` `"Category"`

Return value:

The New method returns an object that contains the empty item that it created, an error code, and an error message.

**Table:** Return value properties for New
Property	Description	Value
`ReturnValue`	This is an object that contains the empty landmark or landmark category item.	See Landmark or Landmark category, depending on which type of item was created.
`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.

Example code:

The following sample code illustrates how to create a new landmark object:

import com.nokia.lib.Service;
var landmark = new Service("Service.Landmarks", "IDataSource");
var inParams = {Type:"Landmark"};
var outParams = landmark.New(inParams);
var landmarkTemplate = outParams.ReturnValue;
var Id = txtoutput.text = landmarkTemplate.id;