Update doc for DISTANCE_DISPLAY_UNITS.

Part of a large doc update. Add doc for new supported value range
APIs. For be backward compatible with older VHAL clients still
using deprecated fields, we still require the old fields to be
populated.

Test: None
Bug: 383184445
Flag: EXEMPT no code change
Change-Id: I5806c09ab5062e9605c5881c4ff2e59e308949e1