Namespace: Autodesk.Revit.DB Class: Document

Document.AcquireCoordinates

Method

Description:
Acquires coordinates from the specified link instance.

Remarks:

When you acquire coordinates from the linked model, the shared coordinates of the linked model become the shared coordinates of the host model, based on the position of the linked model instance in the host model. There is no change to the host model's internal coordinates.

The host model also acquires True North from the linked model. The origin of the linked model's shared coordinates becomes the origin of the host model's shared coordinates.

When a Revit model acquires coordinates from a linked DWG file, the World Coordinate System (WCS) of the selected linked DWG file becomes the shared coordinate system of the host Revit model, based on the position of the linked DWG instance. The Y axis of the DWG becomes True North, and the origin of the DWG becomes the origin of the shared coordinate system of the Revit model.

On acquiring coordinates from a geo-referenced model, the geolocation information will be pulled from the linked model to the host model.

Unlike UI operation Acquire Coordinates, calling the API would always overwrite the geolocation information in the host model even if it is different from the one in the linked model, or the linked model has empty geolocation information (in which case the geolocation information in the host model would be removed).

Syntax

public void AcquireCoordinates(
	ElementId linkInstanceId
)

Public Sub AcquireCoordinates ( 
	linkInstanceId As ElementId
)

public:
void AcquireCoordinates(
	ElementId^ linkInstanceId
)

member AcquireCoordinates : 
        linkInstanceId : ElementId -> unit

Parameters

Parameter	Type	Description
linkInstanceId	ElementId	The <span class="noLink">ElementId</span> of the link instance (such as <span class="noLink">RevitLinkInstance</span> or <span class="noLink">ImportInstance</span>) from which the coordinates would be acquired.

Return Value

Exceptions

Exception	Condition
ArgumentException	The element linkInstanceId does not exist in the document
ArgumentNullException	A non-optional argument was null
InvalidOperationException	This Document is not a project document. -or- This Document is in an edit mode. -or- The coordinate system of the selected model are the same as the host model. -or- Cannot acquire coordinates from a model placed multiple times. -or- Failed to acquire coordinates from the link instance.
ModificationForbiddenException	The document is in failure mode: an operation has failed, and Revit requires the user to either cancel the operation or fix the problem (usually by deleting certain elements). -or- The document is being loaded, or is in the midst of another sensitive process.
ModificationOutsideTransactionException	The document has no open transaction.