ENH: Add distance with point ids in itkPointsLocator

[PranjalSahu]

PR Checklist

• [ ] No API changes were made (or the changes have been approved)
• [ ] No major design changes were made (or the changes have been approved)
• [X] Added test (or behavior not changed)
• [X] Updated API documentation (or API not changed)
• [ ] Added license to new files (if any)
• [ ] Added Python wrapping to new files (if any) as described in ITK Software Guide Section 9.5
• [ ] Added ITK examples for all new major features (if any)

Refer to the ITK Software Guide for further development details if necessary.

[jhlegarreta]

Also, please add a relevant commit message body that explains the rationale of the changes. Thanks.

[PranjalSahu]

@jhlegarreta Yes, I will do the suggested changes. I am checking if one of the functions can be removed from the codebase.

[PranjalSahu]

@jhlegarreta I am adding a commit message regarding the removal of the Search method. That is important and should be present for future reference.

[dzenanz]

As you are adding code, and 2 commits later removing some, it makes sense to squash these into a single commit. Less changes to look at that way.

Also, you should update the commit message to explain a little the reasoning behind changes.