IDataSource.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:

result = so.IDataSource.New(criteria);

Arguments:

criteria:

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

**Table:** Criteria object properties
Property	Description	Value
`criteria.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
`result.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.
`result.ErrorCode`	This is a number that specifies a predefined error code.	See Service API error codes.
`result.ErrorMessage`	This is a text string that describes the error.	See Landmarks Service API error messages.

Example code:

For the complete source of a sample widget that demonstrates how to use this Service API, see the full example.