ArcGIS Pro 3.8 API Reference Guide
ArcGIS.Core.OCR Namespace / OCRExtensions Class / ExtractTraverseFromDeedAsync Method / ExtractTraverseFromDeedAsync(OCRManager,String,SpatialReference,CancellationToken) Method
The OCRManager.
The deed image. pdf, tif, tiff, jpg, jpeg, png and bmp extensions are supported.
The spatial reference to use for the traverse objects.
A System.Threading.CancellationToken used to control cancellation behavior for the returned task.
Example

In This Topic
    ExtractTraverseFromDeedAsync(OCRManager,String,SpatialReference,CancellationToken) Method
    In This Topic
    Extracts a set of ArcGIS.Desktop.Editing.COGO.Traverse objects from a deed image. This method must be called on the MCT. Use QueuedTask.Run.
    Syntax

    Parameters

    OCRManager
    The OCRManager.
    deedFileName
    The deed image. pdf, tif, tiff, jpg, jpeg, png and bmp extensions are supported.
    spatialReference
    The spatial reference to use for the traverse objects.
    cancellationToken
    A System.Threading.CancellationToken used to control cancellation behavior for the returned task.

    Return Value

    A IReadOnlyList of Traverse objects. Null cann be returned if no traverse data can be extracted.
    Exceptions
    ExceptionDescription
    deedFileName or spatialReference is null.
    The deed image could not be found or has an invalid extension for OCR.
    An error occurred within the OCR engine.
    The operation was canceled.
    This method or property must be called within the lambda passed to QueuedTask.Run.
    Remarks
    A typical deed contains multiple courses depicting the boundaries of a parcel or the boundaries of more than one parcel. Boundaries start from a well established point-of-beginning and loop back to the same point-of-beginning. Optical Character Recognition (OCR) technology is used to extract text from the deed image and convert it to numerical values for COGO dimensions for the parcel courses.

    Text extraction and character recognition will be dependent on the quality and content of the image. There might also be difficulty in extracting text from complex legal descriptions.

    This method uses the OCROutputType.TSV output type to obtain information from the deed. Headers and footers (which often interfere with COGO course extraction) and vertical lines are removed when processing the OCR output.

    Example
    Extract a traverse from a deed
    {
      string deedFileName = "c:\\MyTraverseFileFolder\\MyTraverseDeed.pdf";
    
      var traverseList = await OCRManager.Instance.ExtractTraverseFromDeedAsync(deedFileName, spatialReference);
    
      // or extract from a specific page
      //int pageIdx = 1;
      //var traverseList = await OCRManager.Instance.ExtractTraverseFromDeedAsync(deedFileName, pageIdx, spatialReference);
    
      foreach (var trav in traverseList)
      {
        // iterate thorugh the courses
        foreach (var course in trav.Courses)
        {
          // ...
        }
      }
    }
    Requirements

    Target Platforms: Windows 11 Home, Pro, Enterprise (64 bit)

    ArcGIS Pro version: 3.8 or higher.
    See Also