RangeFinder for iPhone and iPad

RangeFinder combines camera instruments, map measurements, offline maps, waypoints, a map compass, and field astronomy in one app. This guide explains how to choose the right instrument, obtain a result, assess its quality, save the evidence, and continue working when a sensor or network is unavailable.

Important: RangeFinder is a field measurement aid. Results can be affected by target dimensions, camera alignment, calibration, reflective surfaces, sensor quality, device motion, location accuracy, and map data. Confirm important measurements with an independent instrument.

Start with the task

I want to… Start here What RangeFinder uses
Estimate the distance to an object of known height Known Height Camera intrinsics, zoom, two shutters, known height
Estimate the height of an object at a known distance Known Distance Camera intrinsics, zoom, two shutters, known distance
Measure direct distance with supported depth hardware LiDAR LiDAR depth samples inside the target
Measure to a detected wall or surface Surface AR tracking and a detected surface
Read heading, inclination, and roll Angle Motion and heading sensors
Measure the direction change from A to B Angle A–B Two recorded orientations
Estimate a target with an angular reticle Angle Survey Camera calibration and a vector angular scale
Measure between map points Map Measurements Coordinates and map geometry
Find a saved place from the camera Waypoints mode Current/remembered location, heading, and waypoint coordinates
Follow selected waypoints around a dial Map Compass Heading, location, and waypoint coordinates
Work without a network Offline Maps Previously downloaded raster/vector tiles
Review Sun, Moon, planets, and twilight events Astronomy Time, location, and astronomy calculations

If you are unsure, use the Quick Start decision guide.

The four workspaces

RangeFinder is organized into four tabs:

  1. Range — Known Size, Waypoints, LiDAR and Surface when supported, plus access to Angle and Angle Survey.
  2. Map — map sources, position, waypoints, coordinate tools, measurements, offline-area selection, tracking, and Map Compass.
  3. Map Items — Waypoints, Measurements, Offline Areas, and Map Sources.
  4. Settings — shared preferences, instrument options, storage, Astronomy, onboarding, What’s New, and support.

RangeFinder tab bar identifying Range, Map, Map Items, and Settings.
RangeFinder tab bar identifying Range, Map, Map Items, and Settings.

  1. Complete onboarding and request each permission from its explanatory page.
  2. Wait for a valid location and heading on a physical device.
  3. Open Range and perform the Known Height example in Measure with Known Size.
  4. Open Map, add a test waypoint, and check it in the Waypoints list.
  5. Select Waypoints in Range to see its camera label and distance.
  6. Download a small offline area on a supported map source.
  7. Save one photo and one observation, then confirm where each is stored.

Guide chapters

Camera instruments

Maps and field data

Reference

Device feature availability

Known Size, Waypoints, Angle, Angle Survey, maps, offline areas, map measurements, Map Compass, and Astronomy are designed for supported iPhones and iPads. LiDAR and Surface appear in the Range mode selector only when compatible LiDAR hardware is available. If LiDAR is absent, Range shows Known Size and Waypoints; the app does not display a nonfunctional LiDAR or Surface mode.

Camera, location, heading, motion, photo-library, and microphone behavior must be tested on a physical device. Simulator layouts are useful for learning the controls, but Simulator does not provide a real camera, LiDAR stream, or normal field sensor evidence.

Measurement result language

The app deliberately distinguishes:

  • Acquiring — the instrument does not yet have enough valid data.
  • Estimate — the result was calculated from camera geometry and user input.
  • Stable — supported direct or surface sampling has reached a usable state.
  • Medium quality / Use with caution — a result exists but conditions reduce confidence.
  • Unavailable — a requirement is missing or the capture session cannot provide a valid result.

Do not record the placeholder dash as a measurement. Wait for a numeric result and read its status and guidance together.

Support

For help that is not resolved by the troubleshooting chapter, contact support2026@lifewaresolutions.com. Include the app version, iOS/iPadOS version, device model, selected instrument, and the exact message shown. Never send API keys or private location/media unless you deliberately choose to share them.

Quick Start

Use this chapter to choose an instrument and prepare a trustworthy first measurement.

1. Complete permissions at the right time

On first launch, RangeFinder explains each permission on its own onboarding page. The system request should appear only when that page is selected and you press its primary action.

  • Location supports the current coordinate, map position, waypoint distance, camera waypoint projection, Map Compass, and location-based Astronomy.
  • Camera supports Range, Angle, Angle Survey, instrument photos, and photo-based workflows.
  • Photos lets you save instrument captures and choose an existing image when creating a waypoint from EXIF metadata.
  • Microphone is requested when you choose to add a voice recording to a waypoint, not during basic measurement.

If you decline a permission, you can continue using unrelated features. To change the decision later, open iOS Settings → Apps → RangeFinder.

RangeFinder Welcome page with a single Next button.
RangeFinder Welcome page with a single Next button.

Onboarding page explaining why RangeFinder needs location.
Onboarding page explaining why RangeFinder needs location.

Onboarding page explaining why RangeFinder needs camera access.
Onboarding page explaining why RangeFinder needs camera access.

Onboarding page explaining image selection and saving.
Onboarding page explaining image selection and saving.

Final RangeFinder onboarding page inviting the user to begin measuring.
Final RangeFinder onboarding page inviting the user to begin measuring.

2. Choose the measurement method

Situation Use Required input or hardware Result
Target height is known Known Size → Known Height Trusted height and visible top/bottom Estimated distance
Target distance is known Known Size → Known Distance Trusted distance and visible top/bottom Estimated height
Supported LiDAR device; solid target LiDAR LiDAR depth camera Direct slant range
Supported LiDAR device; tracked wall/surface Surface AR tracking and detected geometry Surface raycast range
Saved geographic target Waypoints Location, heading, selected visible waypoint Geodesic distance and camera label
Two map positions Map → Measurement Two or more coordinates Map distance/shape result
Angular orientation or direction change Angle Motion/heading sensor Heading, inclination, roll, A–B
Target subtends a known angular scale Angle Survey Calibrated camera/reticle and valid field method Manual estimate

Selection rules

  • Prefer LiDAR for a nearby, solid, single-surface target when compatible hardware is available.
  • Prefer Known Height only when the height is more trustworthy than the distance.
  • Prefer Known Distance only when the distance is more trustworthy than the height.
  • Use a map measurement for geographic points; it is not a camera line-of-sight measurement.
  • Use Waypoints for navigation context; its distance is based on coordinates, not camera depth.
  • Do not substitute one method silently when another is unavailable. The app preserves this distinction in its method status and saved provenance.

3. Read the Range screen

The Range screen places the live camera behind:

  • the selected vector reticle;
  • two draggable shutters in Known Size;
  • a method and quality capsule;
  • the result panel;
  • the mode selector and measurement controls;
  • Photo and Settings buttons at the top right;
  • a sensor rail showing available coordinate, altitude, heading, horizon, inclination, and timestamp information.

Annotated Range screen identifying its camera measurement controls.
Annotated Range screen identifying its camera measurement controls.

The sensor rail describes context; it does not make an invalid range valid. A remembered last good coordinate may be shown when the current location is poor. The warning indicator tells you it is retained data. Do not present it as a fresh fix.

4. First Known Height measurement

This example estimates the distance to a building whose visible height is known to be 18 m.

  1. Open Range.
  2. Choose Known Size.
  3. Open the input-mode menu and choose Known Height.
  4. Choose the Medium band and metric units.
  5. Enter 18 in the value field.
  6. Hold the device steady and keep the camera face as square to the building as practical.
  7. Drag the upper shutter to the top of the 18 m section.
  8. Drag the lower shutter to its bottom.
  9. Confirm that the result panel shows ESTIMATE, a numeric distance, the known height, and an angular size.
  10. Repeat the alignment. Large variation between repetitions indicates weak geometry, uncertain endpoints, or an incorrect known height.

See Estimate distance with Known Height for a complete worked example and accuracy notes.

5. Save a result or a photo

The two save actions serve different purposes:

  • Save Observation stores the validated measurement, method, time, sensor snapshot, provenance, name, note, and any attached capture in RangeFinder’s measurement history.
  • Photo creates an image using the composition selected in Range Settings: Camera + Reticle, Camera + Reticle + Measurement, or Whole Screen. The review screen can then save it to Photos or share it.

A photo is not automatically a saved observation, and an observation does not automatically enter the Photos library.

6. Field checklist

Before accepting a result:

  • use a clean lens;
  • confirm the correct camera and zoom;
  • verify the known height/distance and its units;
  • keep both shutters on the same physical target;
  • avoid glass, mirrors, water, thin edges, or mixed surfaces for LiDAR;
  • wait for the status to become numeric and usable;
  • hold the device still;
  • repeat the measurement;
  • save the observation with a meaningful name and note;
  • independently verify any important result.

7. If no result appears

  1. Read the guidance line under the result.
  2. Confirm that the selected method is available on the device.
  3. For Known Size, confirm that the input is positive and the lower shutter is below the upper shutter.
  4. For LiDAR, place the complete target on one matte, solid surface.
  5. For Surface, move the device slowly until AR tracking detects geometry.
  6. Check Camera and Location access in iOS Settings.
  7. Let the device cool if thermal pressure interrupted the camera.
  8. Leave and reopen the instrument if the camera session was interrupted.

RangeFinder does not replace missing or low-quality data with a fabricated numeric value.

Range and Known Size

The Range workspace combines several measurement methods behind one camera interface. This chapter explains the common screen and the Known Size method, which is available without LiDAR.

Range screen anatomy

Annotated Range screen identifying its camera measurement controls.
Annotated Range screen identifying its camera measurement controls.

  1. Mode selectorKnown Size, Waypoints, and, on compatible devices, LiDAR and Surface.
  2. Method status — the selected method and its current quality color.
  3. Reticle — the selected vector reticle from the shared library.
  4. Known Size shutters — draggable horizontal lines defining the visible angular height.
  5. Result panel — primary result, known or calculated secondary value, angular size, quality, and guidance.
  6. Known Size controls — Known Height/Distance, numeric input, unit, band, and slider.
  7. Zoom controls — 1×, 2×, and 4× where supported by the active standard camera. LiDAR uses its selected depth camera at fixed measurement zoom.
  8. Save Observation — stores the current validated measurement.
  9. Photo — immediately captures using the composition selected in Settings.
  10. Range Settings — display, compass/horizon calibration, sensors, LiDAR, cameras, ranging, reticle, lens filter, and photo options.
  11. Sensor rail — coordinate, altitude, heading, horizon, inclination, and timestamp state when available.

On a device without LiDAR, only Known Size and Waypoints appear in the Range method selector. Surface is hidden with LiDAR because it requires the supported AR/depth workflow.

How Known Size works

Known Size measures the angular separation between the upper and lower shutters using the active camera’s delivered intrinsics and zoom configuration.

For a known physical height (H) and measured angular height (\theta), the distance is:

[ D = \frac{H}{2\tan(\theta/2)} ]

For a known distance (D), the calculated height is:

[ H = 2D\tan(\theta/2) ]

The app performs this calculation from the two shutter rays. You do not need to calculate the angle yourself. The formulas explain why endpoint placement, camera configuration, and the trusted input value matter.

Known Size is an estimate, not direct depth. The result panel identifies it as ESTIMATE and includes the measured angular size.

Estimate distance with Known Height

Result

Calculate the distance to an object when its visible physical height is known.

Before you start

You need:

  • a target with a trustworthy vertical height;
  • a clear view of both endpoints of that height;
  • Camera permission;
  • the correct unit system and range band;
  • a steady position with the device not strongly rolled or tilted relative to the target.

Use the height of the exact section bounded by the shutters. Do not enter the full building height if a roof, basement, slope, or hidden section is outside the shutter endpoints.

Steps

  1. Open Range.
  2. Choose Known Size.
  3. Tap the input-mode menu and choose Known Height.
  4. Select Small, Medium, or Large for convenient slider units.
  5. Enter the target height in the numeric field or move the value slider.
  6. Aim at the target and choose a supported standard-camera zoom.
  7. Drag the upper shutter until it touches the top endpoint.
  8. Drag the lower shutter until it touches the bottom endpoint.
  9. Read the primary distance in the result panel.
  10. Confirm that the secondary line shows the height you entered and that an angular value is present.
  11. Repeat the alignment at least twice.
  12. If the result is important, tap Save Observation, enter a name and note, and tap Save.

Worked example: 18 m building section

Assume:

  • trusted height: 18.0 m;
  • angular height measured from the shutters: approximately 11.36°.

The corresponding calculation is approximately:

[ D = \frac{18}{2\tan(11.36^\circ/2)} \approx 90.5\ \text{m} ]

The exact app result may differ because it uses the delivered camera intrinsics and the actual shutter rays rather than a rounded example angle.

Verify

A usable Known Height result shows:

  • ESTIMATE rather than Acquiring or Unavailable;
  • a numeric primary distance;
  • the entered height as the secondary value;
  • an angular size;
  • guidance referring to camera intrinsics and active zoom.

Move one shutter slightly, realign it, and confirm that the result changes smoothly. A large jump from a tiny movement means the target occupies too little of the frame or the endpoint is ambiguous.

Accuracy and limitations

The largest error sources are:

  • incorrect or approximate known height;
  • placing a shutter on the wrong physical endpoint;
  • perspective when the top and bottom are not in a plane suited to the model;
  • camera roll, severe inclination, motion, or unstable framing;
  • target occupying too few pixels;
  • changing camera/zoom while aligning;
  • an unverified camera configuration;
  • measuring a partially hidden target.

Move closer or use a supported optical/active-camera zoom when the target is too small, but realign both shutters after any camera or zoom change.

Estimate height with Known Distance

Result

Calculate the physical height of a visible object when the camera-to-target distance is known.

Before you start

You need a trustworthy distance that corresponds to the geometry being measured. A map distance to the building footprint may not equal the camera line-of-sight distance. For important work, measure the reference distance with an appropriate independent tool.

Steps

  1. Open Range and choose Known Size.
  2. Choose Known Distance from the input-mode menu.
  3. Select a band whose units suit the reference distance.
  4. Enter the distance.
  5. Keep the device at the position from which that distance was established.
  6. Drag the upper and lower shutters to the object’s visible endpoints.
  7. Read the calculated height as the primary result.
  8. Confirm that the secondary line shows the distance you entered.
  9. Repeat the shutter placement and compare results.
  10. Save the observation with the source of the reference distance in its note.

Worked example: target 50 m away

Assume:

  • trusted distance: 50.0 m;
  • measured angular height: approximately 3.44°.

Then:

[ H = 2(50)\tan(3.44^\circ/2) \approx 3.0\ \text{m} ]

The exact app value uses the current shutter rays and camera configuration.

Verify

A usable Known Distance result shows:

  • ESTIMATE;
  • a numeric primary height;
  • the entered distance as the secondary value;
  • the measured angular size.

If you move forward or backward after establishing the known distance, the input is no longer valid. Update the distance or return to the reference point.

Accuracy and limitations

Known Distance inherits uncertainty from both the reference distance and shutter placement. The calculated height can be misleading when:

  • the reference distance is horizontal map distance but the target requires slant distance;
  • the camera moved after the distance was measured;
  • the target top and bottom are not the intended endpoints;
  • only part of the target is visible;
  • the target is very small in the image.

Choose Small, Medium, or Large

The band changes the input unit, slider range, and slider step. It does not change the measurement formula or impose a hard limit on manually entered values.

Band Metric Imperial Typical use
Small 1–500 cm, step 1 cm 1–200 in, step 1 in people, doors, signs, small structures
Medium 1–2,000 m, step 1 m 1–6,500 ft, step 1 ft buildings, fields, nearby terrain
Large 1–100 km, step 0.1 km 1–60 mi, step 0.1 mi distant landmarks and long references

Values outside the slider range

The text field accepts a positive manual value outside the selected band’s slider range. The app preserves the value and displays Manual value preserved outside the … slider range. The slider remains clamped to its convenient range; it does not overwrite the manual value until you move it.

While editing, the field may be temporarily empty. The last valid numeric value is retained until you enter a new positive value. Use the current locale’s decimal separator.

Place and reset the shutters

The upper and lower shutters are independent horizontal controls. Their positions persist between sessions.

  • Drag anywhere on the 44-point handle to improve touch sensitivity.
  • Keep the upper shutter above the lower shutter.
  • Align to repeatable edges, not shadows or soft foliage.
  • After rotating the device or changing zoom, verify both endpoints again.
  • To restore the initial symmetric positions, open Range Settings → Ranging and tap Reset Known Size Sliders.

The default positions are symmetrical around the center of the measurement area.

Use zoom correctly

Known Size and Waypoints can use standard-camera zoom where supported.

  1. Establish your framing.
  2. Choose 1×, 2×, or 4×.
  3. Wait for the camera configuration to settle.
  4. Realign both shutters.
  5. Record the result only after the panel returns to a usable state.

Do not compare a 1× shutter position directly with a 2× position; zoom changes the visible field of view. The app includes the active zoom in its calculation.

LiDAR does not show these manual zoom buttons because the selected depth camera uses its fixed measurement zoom.

Understand result quality

State Meaning Action
Acquiring Valid camera geometry or sensor data is not ready Hold steady and follow the guidance
Estimate Known Size produced a calculated result Verify input, endpoints, zoom, and repeatability
Stable Direct/surface sampling reached a usable state Keep the target on one surface and record if needed
Medium quality A result exists with reduced confidence Repeat and use caution
Low quality Geometry, motion, target, or calibration is weak Change conditions; do not rely on the value
Unavailable Permission, camera, sensor, session, or hardware is unavailable Correct the stated requirement

Status color is supporting information, not a guarantee of field accuracy. Always interpret the status, number, guidance, and physical setup together.

Save an observation

Save Observation becomes available for a validated Known Size, LiDAR, or Surface result.

  1. Tap the Save Observation icon in the lower control panel.
  2. Enter a concise Name.
  3. Add Notes describing the target, known-value source, camera position, environmental conditions, or independent reference.
  4. Review Method, Distance, and whether a Capture is attached.
  5. Tap Save.

The implemented Measurement History detail view can include distance, height, angular size, sensor snapshot, note, recorded time, calibration provenance, and overlay-capture state.

Measurement History with saved Known Size and LiDAR observations.
Measurement History with saved Known Size and LiDAR observations.

Saved Range observation showing result, sensor snapshot, note, and provenance.
Saved Range observation showing result, sensor snapshot, note, and provenance.

Deleting an observation does not delete an original image that you separately saved to Photos.

Open the gear button at the top right of Range.

  • Appearance — Reduce Liquid Glass and Prevent Device Rotation.
  • Compass — horizon/inclination calibration shared with instrument context.
  • Sensors — horizontal and vertical reticle zero; Reset Zero.
  • LiDAR — depth camera, reference distance, calibration and reset, when available.
  • Cameras — standard rear-camera selection and supported zoom range.
  • Ranging — Method, Units, Range Band, Reset Known Size Sliders.
  • Reticle — reticle library, calibration status, angular spacing, labels, black contrast outline, line width, opacity, and color.
  • Lens Filter — clear or color overlay.
  • Photo — the composition used immediately when Photo is pressed.

Ranging Guidance explaining the difference between LiDAR and Known Size results.
Ranging Guidance explaining the difference between LiDAR and Known Size results.

The Ranging Guidance sheet explains that LiDAR is a direct depth result while Known Size depends on target input, shutter placement, active camera intrinsics, zoom, and calibration. An unavailable method is not silently replaced with another measurement.

Troubleshooting Known Size

The primary value is a dash

  • Confirm Camera permission.
  • Confirm the input is a positive number.
  • Make sure the lower shutter is below the upper shutter.
  • Wait for the camera configuration.
  • Increase the target’s size in the frame.
  • Return to a supported camera zoom.

The result changes too much

  • Use a tripod or brace the device.
  • Choose harder, repeatable endpoints.
  • Increase the target’s image size.
  • Confirm that the known value covers exactly the measured section.
  • Repeat without moving the camera.

The input looks wrong after changing bands

The underlying input is stored in meters and converted to the selected band. Check the unit symbol. A manual value outside the new slider range remains valid and is not discarded.

The shutters moved after changing orientation

Confirm whether Prevent Device Rotation is enabled. Even when the interface is locked, physical camera geometry changes as the device moves; recheck the endpoints before saving.

LiDAR and Surface

LiDAR and Surface appear in Range only on compatible devices. They use related hardware but produce different results:

  • LiDAR samples direct depth inside the central target.
  • Surface raycasts from the center of the camera through AR world tracking to detected geometry.

Neither mode is a substitute for a certified laser rangefinder or a life-safety instrument.

Device availability

On a non-LiDAR device, Range shows Known Size and Waypoints. LiDAR and Surface are hidden rather than disabled. On compatible hardware, the selector adds LiDAR and Surface after those two modes.

LiDAR and Surface require a physical device. Simulator can show layout fixtures but cannot provide valid depth or AR measurement evidence.

Measure direct range with LiDAR

Result

Obtain the slant range from the active depth camera to one continuous target surface.

Before you start

  • Clean the camera/depth-sensor area.
  • Choose an opaque, matte, solid target large enough to fill the sampling region.
  • Avoid glass, mirrors, water, highly reflective metal, smoke, and thin edges.
  • Keep the device within a practical range for its depth hardware.
  • Let an overheated device cool before measuring.

Steps

  1. Open Range.
  2. Choose LiDAR.
  3. Place the central target entirely on one surface.
  4. Keep wall/floor boundaries and foreground objects outside the target.
  5. Hold still while the status is Acquiring.
  6. Read the distance only after a numeric Stable or usable Medium Quality result appears.
  7. Repeat from the same position.
  8. Tap Save Observation to retain the method, result, sensor snapshot, and provenance.

Example: 3.000 m reference board

  1. Place a flat board at an independently measured 3.000 m reference distance.
  2. Keep the board perpendicular enough to provide one broad surface.
  3. Aim at its center and obtain several stable readings.
  4. Repeat at approximately 1 m, 3 m, and a practical longer distance.
  5. Record the observed spread and conditions.

Use the measured 3.000 m value as a calibration reference only when the setup itself is trustworthy.

Result details

The primary value is slant range. When available, the secondary MAD value is the median absolute deviation of recent accepted samples. A smaller spread usually indicates a more consistent sample window, but it does not prove the target distance is correct.

Understand LiDAR quality

State Meaning Response
Acquiring Not enough accepted depth samples Hold still and keep the target on one surface
Stable Recent samples are sufficiently consistent Repeat, then save if needed
Medium Quality A usable result has more spread Improve aim and repeat
Low Coverage Too little of the sample region has valid depth Use a larger/closer surface
Mixed Surfaces Samples contain separated depth groups Move away from edges or obstructions
Unstable Recent ranges vary too much Brace the device and use a static target
Excessive Motion Device movement invalidates sampling Stop moving and wait
Unavailable Hardware, permission, depth, session, or thermal state is unavailable Follow the displayed recovery guidance

Reflective or transparent targets can return missing, unstable, or misleading depth. The correct response is to change the target or use a different measurement method—not to record the first number.

LiDAR camera and fixed zoom

Open Range Settings → LiDAR to see the selected depth camera. LiDAR uses that camera at fixed measurement zoom, so the 1×, 2×, and 4× standard-camera buttons are hidden in LiDAR mode.

Standard rear-camera selection is separate under Cameras and applies to Known Size, Waypoints, Angle, and Angle Survey as appropriate.

Calibrate a LiDAR result

Calibration compensates a repeatable device/configuration offset; it cannot fix mixed surfaces, bad reference geometry, motion, or unsuitable material.

  1. Establish a reference distance with an independent tool.
  2. Aim LiDAR at one stable surface at that distance.
  3. Wait for a stable result.
  4. Open Range Settings → LiDAR.
  5. Enter the reference distance in meters.
  6. Tap Calibrate Current Result.
  7. Confirm that calibration was saved for the active camera, format, and zoom.
  8. Recheck at several distances.

Use Reset Active Calibration to discard the profile for the active configuration. A stable current LiDAR result is required to calibrate.

Measure a detected surface

Result

Obtain the distance along the center camera ray to geometry detected by AR world tracking.

How Surface differs from LiDAR

LiDAR direct mode summarizes depth samples in its target. Surface uses an AR raycast against detected geometry. A wall can therefore be measurable after AR has built enough geometry even though the result is not the same sampling pipeline as direct LiDAR.

Steps

  1. Open Range and choose Surface.
  2. Move the device slowly so AR can detect the room or outdoor surface.
  3. Point the central target at the desired location.
  4. Wait while the guidance says to move slowly or detect surfaces.
  5. When a numeric result appears, hold on the same detected surface.
  6. Repeat without targeting an edge.
  7. Save the observation if required.

Wall example

Aim first near the center of a broad wall. Then aim at the wall/floor boundary. The boundary is less reliable because a small pointing change can move the raycast between two different surfaces.

Avoid moving subjects, featureless regions, reflective/transparent material, abrupt edges, and interrupted tracking.

Troubleshooting

LiDAR or Surface is not in the selector

The device did not report compatible LiDAR hardware. Use Known Size, Waypoints, Angle, Angle Survey, or map measurement instead.

LiDAR never becomes stable

  • fill the target with one matte surface;
  • move closer within practical sensor range;
  • stop device/subject movement;
  • remove foreground edges;
  • clean the sensor area;
  • let the device cool;
  • leave and reopen Range after an interruption.

Surface keeps asking you to move

Move slowly across visible texture and corners so AR can establish tracking. Return the target to the desired point only after geometry is detected.

Camera is black or interrupted

Check Camera permission, bring the app to the foreground, close another app using the camera, allow the device to cool, and reopen the instrument. The app must show Unavailable rather than inventing a range while the capture session is interrupted.

Angle and A–B measurement

Angle is a camera instrument for live heading, inclination, and roll. It also records two directions, A and B, and calculates their spatial separation.

Open Angle

From Range, use the dedicated Angle switch button. The Angle screen includes:

  • a centered heading scale;
  • a vertical inclination scale;
  • an arced roll scale with an orange indicator;
  • a horizon/reticle overlay;
  • orange pointers directed toward their scales;
  • live or held numeric values;
  • heading-reference and sensor-quality context;
  • Zero, Hold/Release, and A/B controls;
  • Photo and Settings at the top right.

Annotate Angle hero: heading, inclination, roll, reticle, values, A/B status, controls, zoom, photo/settings.
Annotate Angle hero: heading, inclination, roll, reticle, values, A/B status, controls, zoom, photo/settings.

The horizon line rotates opposite device roll so that it continues to represent the physical horizon while the phone rotates.

Read heading, inclination, and roll

  • Heading is the direction around the horizon, expressed in degrees from the active north reference.
  • Inclination is the camera’s up/down angle.
  • Roll is rotation around the viewing axis.

Keep the device away from magnets, speakers, steel structures, magnetic cases, and strong electrical fields. Compare the heading with a known direction when accuracy matters.

Set a relative Zero

Zero captures the current fresh direction as a relative reference.

  1. Aim at the reference direction.
  2. Wait for valid heading and motion.
  3. Tap Zero.
  4. Rotate or tilt to read the change relative to that reference.
  5. Tap Zero again to clear the relative reference.

The status indicates ZERO ACTIVE while the reference is applied. Zero does not recalibrate the device compass; it changes the instrument’s reporting reference.

Hold a reading

  1. Wait for fresh valid heading and motion data.
  2. Tap Hold.
  3. Inspect or photograph the frozen values.
  4. Tap Release to resume live updates.

Hold freezes the displayed reading; it does not stop the camera or permanently save an observation.

Measure the angle from A to B

Result

Record two viewing directions from one position and calculate their spatial angular separation and component changes.

Before you start

  • Use a physical device with fresh heading and motion data.
  • Choose two repeatable visual points.
  • Stand in one place and rotate the device without translating it.
  • Keep magnetic interference low.

Steps

  1. Open Angle.
  2. Start the A/B workflow.
  3. Aim the reticle at the first point.
  4. Hold steady and capture A.
  5. Rotate/tilt toward the second point without changing your standing position.
  6. Use the persistent A marker to understand the stored first direction. If A leaves the camera view, its marker remains on the appropriate screen edge.
  7. Aim precisely at the second point and capture B.
  8. Read the spatial A–B angle.
  9. Compare the heading, inclination, and roll components when shown.
  10. Reset the workflow before starting another pair.

Example: roof corners

Stand at one marked position. Capture A at the left roof corner and B at the right roof corner. The spatial A–B value describes the angle between those viewing directions.

Do not walk sideways between A and B. Translating the device changes the geometry and means the two rays no longer originate from the same point.

Interpret A–B values

Do not confuse:

  • heading change, a horizontal/azimuth component;
  • inclination change, a vertical component;
  • roll, device rotation around the view axis;
  • spatial A–B angle, the three-dimensional angular separation between the stored direction vectors.

The spatial value is not necessarily the arithmetic sum of the component changes.

Angle Settings

Angle uses the common instrument settings pattern:

  • Appearance — Reduce Liquid Glass and Prevent Device Rotation.
  • Compass — horizon/inclination calibration.
  • Sensors — reference/zero controls where exposed.
  • Cameras — standard camera selection.
  • Reticle — shared library, spacing, labels, outline, line width, opacity, and color.
  • Lens Filter.
  • Photo — saved photo composition.

Angle Settings with Display, Compass, Sensors, Cameras, Reticle, and Photo Button sections.
Angle Settings with Display, Compass, Sensors, Cameras, Reticle, and Photo Button sections.

Prevent Device Rotation keeps the interface in its current orientation until you leave Range, Angle, or Angle Survey. The live horizon and sensor angles still respond to physical motion.

Accuracy and recovery

  • Wait for a fresh reading before Zero, Hold, A, or B.
  • Repeat A and B in both directions to assess consistency.
  • Recalibrate the system compass if iOS indicates poor heading accuracy.
  • Use horizon calibration only from a known level reference.
  • Keep the phone in one physical position for A–B.
  • Treat remembered or stale sensor context as a warning.
  • If orientation changes, confirm the interface and horizon remain aligned before recording.

Reticles and Angle Survey

Range, Angle, and Angle Survey use one shared vector reticle library. Vector marks remain sharp at different screen and photo resolutions. Calibrated marks use active camera intrinsics/configuration; an approximate preview is for layout selection only.

Angle Survey is a manual optical instrument. It does not silently infer a distance from camera or motion sensors.

Open Angle Survey

From Range, tap the dedicated Angle Survey switch button. The screen contains:

  • the selected vector reticle;
  • live camera and supported zoom;
  • Photo and Angle Survey Settings at the top right;
  • camera-calibration status;
  • a compact measurement panel when the selected reticle supports it.

Annotated Angle Survey hero.
Annotated Angle Survey hero.

Angle Survey Settings without blank space; cameras, angular calibration, library, appearance, capture.
Angle Survey Settings without blank space; cameras, angular calibration, library, appearance, capture.

Included reticles

The first ten reticles are available by default:

Reticle Intended use
Classic Survey General center alignment and angular comparison
Fine Cross Precise unobstructed center alignment
Open Center Keep a small target visible at the optical center
Circle Dot Center a compact subject with a clear reference ring
Bold-to-Fine Cross Acquire quickly, then refine at the thin center
Angular Dot Grid Compare horizontal and vertical angular offsets
Angular Hash Grid Count labeled angular intervals
Horizon Scale Leveling and horizontal angular comparison
Object Brackets Compare a subject against symmetric bounds
Polar Grid Radial angle and direction comparison around center

Reticle Library showing all 10 included styles and no Premium/Photography section.
Reticle Library showing all 10 included styles and no Premium/Photography section.

Capture bonus reticles

After the first successful instrument photo, six additional reticles unlock:

  1. Concentric Circles.
  2. Center Ruler.
  3. Quadrant Scale.
  4. Double Circle Cross.
  5. Split Axis.
  6. Vertical Angle Ladder.

Library Access before first instrument photo; explain six-style bonus.
Library Access before first instrument photo; explain six-style bonus.

The bonus is earned after a successful rendered capture, not merely by opening the camera. Premium/Photography packs remain hidden in this release and are not part of the published selector.

State after first successful capture; bonus styles visible.
State after first successful capture; bonus styles visible.

Favorites and Recently Used

Use Favorites for reticles needed repeatedly in the field. Recently Used reduces the need to search the full visible library. Both sections refer to the same shared reticle definitions, so a selection is consistent across instruments that support it.

Star two styles, select one, reopen; show Favorites/Recently Used behavior.
Star two styles, select one, reopen; show Favorites/Recently Used behavior.

Angular spacing

Supported spacing choices are:

  • 15 arcminutes (15′);
  • 30 arcminutes (30′);
  • 1 degree ();
  • 2 degrees ();
  • 5 degrees ().

Spacing defines the intended angular interval between calibrated marks for reticles that use the common angular grid. Larger spacing must not cause labels to overwrite dashes; labels sit beside their corresponding marks.

Camera Calibrated and Approximate Preview

Camera Calibrated means the reticle renderer has valid active camera intrinsics and configuration, including the visible aperture, zoom, and orientation used to map angular intervals to pixels.

Approximate Preview means the library can show the reticle’s shape but cannot claim that the marks currently represent their labeled angles. Do not take measurements from an approximate preview.

Simulator status row showing Approximate Preview and warning copy.
Simulator status row showing Approximate Preview and warning copy.

Changing camera, zoom, orientation, or capture configuration can change the calibrated pixel spacing. Wait for the new configuration and verify the status.

Appearance controls

The shared library provides:

  • Show Scale Labels;
  • Black Reticle Outline for contrast on bright or similarly colored backgrounds;
  • Line Width;
  • Opacity;
  • actual color-selection swatches;
  • lens filters;
  • Favorites and Recently Used.

Settings showing actual color circles plus line-width and opacity sliders.
Settings showing actual color circles plus line-width and opacity sliders.

Use a black outline with bright reticle colors over sky, snow, water, or light walls. Reduce opacity only enough to reveal the target; marks must remain readable in the saved image.

Example: Angular Hash Grid at 1°

  1. Open Angle Survey Settings.
  2. Select Angular Hash Grid.
  3. Set Angular Spacing to .
  4. Enable Show Scale Labels.
  5. Confirm Camera Calibrated.
  6. Center the first subject on the optical center.
  7. Count full and partial intervals to the second subject.
  8. Record the angular separation and active zoom.

Labels describe angular marks; they are not ballistic or weapon-specific data. The library is intended for optical surveying, alignment, composition, and angular comparison.

Manual range from angular size

If a target’s physical size (S) and measured angular size (\theta) are known, a manual estimate can use:

[ D = \frac{S}{2\tan(\theta/2)} ]

Use consistent units. For small angles, the common approximation (D \approx S/\theta) requires (\theta) in radians, but the exact relationship is preferred.

Example: a 2.0 m object spanning 2° is approximately:

[ D = \frac{2.0}{2\tan(1^\circ)} \approx 57.3\ \text{m} ]

Uncertainty in object size and interval reading directly affects the result.

Reticle limitations

  • Calibration is strongest near the intended visible camera geometry.
  • Lens distortion and cropping make edge interpretation more sensitive.
  • Digital screenshots of approximate previews are not calibration evidence.
  • A reticle cannot determine the real physical size of an unknown target.
  • Changing zoom requires recalculated spacing.
  • A thick line can conceal a small endpoint.
  • A 5° circle/grid must remain a valid geometric circle/scale, not a stretched decorative shape.
  • Never infer unsupported precision from a labeled interval.

Photos and observations

RangeFinder separates a saved measurement record from an exported image.

  • Save Observation stores structured measurement data inside the app.
  • Photo immediately renders the composition selected in instrument settings.
  • Save to Photos copies the reviewed image into the system photo library.
  • Share exports the rendered image through the system share sheet.

Choose saved photo content

Open the relevant Range, Angle, or Angle Survey settings and select Saved Photo Content:

Composition Contents
Camera + Reticle Camera image, lens filter, and reticle
Camera + Reticle + Measurement Camera/reticle plus the measurement overlay
Whole Screen Complete instrument interface as displayed

The setting is shared by the instrument capture workflow. Pressing Photo does not open a mode menu; it performs the selected composition immediately.

Settings → Range & Camera → Saved Photo Content with all three options.
Settings → Range & Camera → Saved Photo Content with all three options.

Capture and save a photo

  1. Prepare a valid instrument state.
  2. Tap Photo once at the top right.
  3. Wait for the Range Capture review.
  4. Inspect reticle scale, measurement overlay, orientation, and crop.
  5. Tap Save to Photos or Share.
  6. After a successful Photos save, dismiss the blue-tinted OK confirmation.
  7. Tap Done to close review.

Reticles and measurements are rendered at photo scale so they retain the same visual prominence as the instrument rather than becoming two or three times smaller.

Photos permission

RangeFinder requests photo-library access from the onboarding Photos page or when the related action requires it. If saving fails because access is denied:

  1. Tap Open Settings in the recovery alert.
  2. Allow the required Photos access for RangeFinder.
  3. Return to the app.
  4. Retry Save to Photos from a newly rendered capture if the previous review is no longer available.

The app must show a clear error instead of crashing when the photo library is unavailable.

Save an observation

A validated Known Size, LiDAR, or Surface result can be stored as an observation.

  1. Tap Save Observation.
  2. Enter a meaningful Name.
  3. Add Notes describing the target, reference source, camera position, conditions, and independent verification.
  4. Review method, distance, and capture attachment state.
  5. Tap Save.

An observation may contain:

  • method and result;
  • Known Size height/distance and angular size;
  • timestamp;
  • coordinate, heading, inclination, and other available sensor snapshot;
  • calibration/profile provenance;
  • note;
  • a reference to an instrument capture.

Measurement History with saved Known Size and LiDAR observations.
Measurement History with saved Known Size and LiDAR observations.

Saved Range observation showing result, sensor snapshot, note, and provenance.
Saved Range observation showing result, sensor snapshot, note, and provenance.

Observation and Photos independence

Saving an observation does not automatically add an image to Photos. Saving an image to Photos does not automatically create a structured observation. Deleting an observation does not delete a separately saved Photos image.

Measurement History navigation requirement

The current code contains Measurement History list and detail screens, but the shipping navigation must expose a visible entry before this guide publishes a user path to them. Until that app gap is resolved, screenshots may be captured with a Debug guide scenario only and the public guide must not claim an inaccessible path.

Capture troubleshooting

Capture image file is not available

  • wait for the live camera before pressing Photo;
  • ensure the app is foreground active;
  • close another app using the camera;
  • leave and reopen the instrument after interruption;
  • allow the device to cool;
  • use a composition supported by the active instrument.

Whole Screen is blank

Retry only after the camera frame and interface are visible. The complete screen capture must composite a valid camera frame with the current UI before the review is presented.

Saved drawing is too small

Verify that the current build renders the reticle and measurement using the captured photo’s pixel dimensions rather than reusing unscaled screen points.

Camera becomes black

Camera sessions can be interrupted by backgrounding, another camera client, system pressure, thermal pressure, configuration changes, or unavailable hardware. RangeFinder should suspend and resume deliberately and show a useful Unavailable state while recovery is in progress.

Maps, sources, and coordinates

The Map workspace combines navigation, map-source selection, waypoints, coordinate tools, measurements, offline-area selection, waypoint tracking, and Map Compass. Raster, vector, and Apple renderers keep the same product workflows while preserving renderer-specific pan, zoom, and rotation behavior.

Map controls

The tool column provides:

  1. Add Waypoint at the current map center.
  2. Measurements to create and edit map geometry.
  3. Show/Hide Downloaded Areas.
  4. Coordinate Inspector with a fixed center crosshair.
  5. Coordinate Search.
  6. Waypoint Tracking distances and lines.
  7. Return to Current Location when the location arrow is outside the visible region.
  8. Download Area when the selected source supports it.
  9. Map Compass.
  10. Zoom In/Out.

Annotate every map control and the blue location arrow.
Annotate every map control and the blue location arrow.

Pan with one finger, pinch to zoom, and rotate with the standard map gesture. When the map is rotated, use the north/rotation control to return to north-up.

Current location

The current coordinate is drawn with the standard blue directional arrow. When it leaves the visible region, a return-to-location control appears. Tap it to center the map on the best current user coordinate.

Pan away from fixture location; show return-to-current-location blue arrow control.
Pan away from fixture location; show return-to-current-location blue arrow control.

If current location quality becomes poor after a good fix, the app can retain the last good coordinate for continuity. A warning indicator distinguishes remembered data from a fresh fix. Never describe the remembered coordinate as current.

In Map Compass mode, the compass presentation supplies its own current-location context, so the normal location indicator is not duplicated inside the compass map.

Choose a map source

Open Map Items → Map Sources or the corresponding Maps & Offline settings entry. Tap a row to select it. Each row identifies:

  • Apple, Raster, or Vector renderer;
  • supported zoom range;
  • online-only or offline availability;
  • selection checkmark.

Map Sources with visible release categories; no Premium accounts.
Map Sources with visible release categories; no Premium accounts.

Sources visible in this release

The following table reflects the current provider catalog. Provider endpoints and terms must be rechecked immediately before publishing the guide.

Category Source Renderer Zoom Offline
Apple Apple Standard Apple z0–20 Online only
Apple Apple Satellite Apple z0–20 Online only
Apple Apple Hybrid Apple z0–20 Online only
Apple Apple Terrain Apple z0–20 Online only
OSM OSM Vector Vector z0–19 Available
OSM OSM Legacy Raster z0–19 Available when current source policy permits
Google Google Roadmap Raster z0–22 Online only in this release
Google Google Satellite Raster z0–22 Online only in this release
Google Google Terrain Raster z0–22 Online only in this release
Google Google Hybrid Raster z0–22 Online only in this release
Cycling CyclOSM Raster z0–20 Available
Hiking Freemap.sk Outdoor Raster z0–20 Available
Hiking OpenTopoMap Raster z0–17 Available
Hiking Kompass OSM Raster z0–20 Available
OSM OSM Humanitarian Raster z0–19 Available
Streets Carto Positron Raster z0–19 Available
Streets Carto Dark Raster z0–19 Available
Streets Carto Voyager Raster z0–19 Available
Satellite Esri Imagery Raster z0–20 Available
Nautical OpenSeaMap Raster overlay z0–17 Available
Satellite NASA City Lights Raster z0–8 Available
Legacy Legacy USGS Topo Raster z0–20 Available
Legacy Legacy USGS Imagery Only Raster z0–20 Available
FAA FAA VFR Sectional Raster z8–12 Available
FAA FAA VFR Terminal Area Raster z10–12 Available
FAA FAA IFR Low Raster z7–12 Available
FAA FAA IFR High Raster z5–9 Available

“Available” means the app is configured for user-initiated offline storage. Actual downloads remain subject to provider response, current policy, source caps, storage quota, network availability, and free device space.

Special source behavior

  • OSM Vector is rendered by MapLibre and permits map scale through zoom 19.
  • OpenSeaMap contains transparent nautical seamarks. It is drawn over OSM Legacy, not over the Apple default map. Empty seamark tiles remain transparent.
  • NASA City Lights is a low-zoom research/satellite layer and ends at z8.
  • FAA charts have deliberately restricted zoom ranges matching their services.
  • Apple sources cannot be downloaded by RangeFinder.
  • Google downloads are hidden/unavailable in this release.
  • MapTiler and MapBox account/source rows are premium-only implementation and must remain absent while premium features are hidden.

OSM Vector at high zoom with vector details.
OSM Vector at high zoom with vector details.

Comparable raster source at the same region/zoom.
Comparable raster source at the same region/zoom.

Coastal fixture with seamarks over OSM base, not Apple map.
Coastal fixture with seamarks over OSM base, not Apple map.

Attribution and limitations

Map-source rows no longer include a separate Attribution settings section, but provider attribution and terms remain part of the source configuration and must be respected in the map and published documentation. Aeronautical, nautical, satellite, and research layers are informational and may be stale, incomplete, unavailable, or unsuitable for safety-critical navigation.

Inspect the map-center coordinate

  1. Tap Coordinate Inspector.
  2. Move the map under the fixed center crosshair.
  3. Read the center coordinate card.
  4. Use text selection or the Share button for an individual format.
  5. Share the complete set or open/share the generated Google Maps link.
  6. Tap the inspector control again to close it.

Fixed center crosshair and coordinate card.
Fixed center crosshair and coordinate card.

The preferred coordinate format appears first, followed by the other supported representations.

Search for a coordinate

  1. Tap Coordinate Search.
  2. Enter one of:
    • decimal latitude/longitude;
    • degrees, minutes, seconds (DMS);
    • UTM;
    • MGRS;
    • Plus Code;
    • GeoHash.
  3. Review the parsed result and alternate representations.
  4. Tap Show or the result row.
  5. The map centers on the coordinate and opens the inspector.

Search form with a valid coordinate and parsed result.
Search form with a valid coordinate and parsed result.

An unrecognized value shows Coordinate Not Recognized instead of guessing. The result sheet can also open the coordinate in Google Maps without changing the selected RangeFinder base map.

Preferred coordinate representation

Open Settings → Units & Coordinates and choose the preferred format. The choice affects inspector, search-result ordering, waypoint fields/readouts, and other coordinate displays. Internally stored latitude/longitude does not lose precision merely because a different display format is selected.

Rotate the map with Map Compass

Normal map rotation follows touch gestures. In Map Compass, Rotate map with compass continuously aligns the map with changing device heading while preserving the current zoom. Disable it for a stable north-up map beneath the dial.

Rotate map; show standard rotation/north-reset icon.
Rotate map; show standard rotation/north-reset icon.

Map recovery

If restoring a source fails, the recovery alert can:

  • Retry;
  • use Apple Maps;
  • choose another Map Source;
  • open Offline Areas;
  • cancel and retain the current context.

Choose another source when a provider endpoint is unavailable. Do not clear all offline data merely to recover one online provider.

Recoverable map error with Retry, Use Apple Maps, Choose Map Source, Open Offline Areas.
Recoverable map error with Retry, Use Apple Maps, Choose Map Source, Open Offline Areas.

Offline maps

Offline Areas save supported vector resources or raster tiles for a selected map region. Apple sources and Google sources are online-only in this release.

Before downloading

  • Select an offline-capable source.
  • Use Wi-Fi for a large area when practical.
  • Confirm sufficient RangeFinder quota and at least the required free device space.
  • Start with the smallest useful region and maximum zoom.
  • Read the provider notice.

Save an area

  1. Open Map.
  2. Select an offline-capable map source.
  3. Tap Download Area.
  4. Pan to position the selection rectangle.
  5. Drag/resize the selection as needed.
  6. Choose the maximum zoom.
  7. Review tile/resource count, estimated size, source, bounds, and notice.
  8. Confirm the download.
  9. The app opens Offline Areas.
  10. Monitor progress; pause or resume when available.

OSM selection rectangle with all four handles and underlying map visible.
OSM selection rectangle with all four handles and underlying map visible.

Maximum Zoom controls, tile/resource count, estimated bytes, source name.
Maximum Zoom controls, tile/resource count, estimated bytes, source name.

Higher zoom increases resources rapidly because every additional zoom level can subdivide each visible tile into four children.

Example: Interlaken fixture

Use OSM Vector near 46.686300, 7.863200.

  1. Frame the town and one nearby trail.
  2. Compare a maximum zoom of 13 with a higher value.
  3. Reduce the bounds if the high-zoom resource estimate is unnecessary.
  4. Download.
  5. Turn on airplane mode and verify the saved area at every zoom you intend to use.

Storage and tile limits

State Offline quota Per-area tile limit
Initial 512 MiB 8,000 tiles
After first completed offline map bonus 1 GiB total 16,000 tiles

RangeFinder also preserves a 2 GiB free-space reserve on the device. A source-specific request cap may lower the effective tile limit.

Settings → Storage before bonus: 512 MB and gift outline.
Settings → Storage before bonus: 512 MB and gift outline.

Area exceeding tile/quota limit with actionable correction.
Area exceeding tile/quota limit with actionable correction.

When the first area completes successfully, RangeFinder awards an additional 512 MiB and raises the per-area limit from 8,000 to 16,000. The bonus alert explains the new total and has a standard blue-tinted OK action.

After first completed area: 1 GB, filled gift, 16,000-tile explanation.
After first completed area: 1 GB, filled gift, 16,000-tile explanation.

Offline Areas list

Open Map Items → Offline Areas or Settings → Maps & Offline → Offline. Each saved item uses its actual area thumbnail and can show:

  • name;
  • provider;
  • geographic bounds;
  • minimum and maximum zoom;
  • raster tile count or vector-resource progress;
  • estimated and actual bytes where available;
  • downloading, paused, complete, or failed state.

Saved raster and vector areas with distinct thumbnails.
Saved raster and vector areas with distinct thumbnails.

Manage an area

Open an area to:

  • rename it;
  • inspect source, bounds, zoom, and progress;
  • pause/resume an active raster download;
  • show its center on the map;
  • retry after failure;
  • delete it.

Active download with completed/total resources and state.
Active download with completed/total resources and state.

Paused area with Resume.
Paused area with Resume.

Area bounds, zoom range, attribution, Show Center, Rename, Delete.
Area bounds, zoom range, attribution, Show Center, Rename, Delete.

Failed offline download with retry path.
Failed offline download with retry path.

Deleting a saved area removes its area record and resources that are no longer shared. Shared raster tiles required by another saved area must remain available.

Show downloaded-area outlines

Use the downloaded-area visibility control on Map to show or hide saved bounds for the selected provider.

Return to Map with downloaded-area overlay visible, then derived comparison with it hidden.
Return to Map with downloaded-area overlay visible, then derived comparison with it hidden.

The overlay is a planning aid; it does not prove that every tile/resource inside the bounds finished successfully. Confirm the item state and test offline.

Clear tile cache

Offline settings can clear downloaded raster tiles. This is destructive: saved raster area records may remain but require download again. It does not mean that Apple or Google content becomes available offline.

Troubleshooting

Download button is absent

The selected source is online-only or hidden by release policy. Choose an offline-capable source.

The estimate exceeds the limit

  • shrink the area;
  • reduce maximum zoom;
  • choose a source with a smaller resource requirement;
  • complete the first small area to earn the documented bonus;
  • delete unneeded offline data.

The renderer should retain the currently displayed tile until a replacement is ready. If flashing persists, record provider, zoom, device, and whether the tile was online, transiently cached, or downloaded.

An area works online but not in airplane mode

The visible online map may include transient resources outside the saved area or beyond its maximum zoom. Return online, inspect the area state, retry failures, and test within its exact bounds/zoom range.

Provider stops working

Provider endpoints and policies can change. Retry, choose another source, and preserve existing offline data until the issue is understood.

Waypoints

A waypoint stores a geographic coordinate with a name, note, optional altitude, icon, visibility, optional A/B role, and media attachments. The same selected icon is used on the map, list, Range camera, and Map Compass.

Create a waypoint

RangeFinder provides five creation/import paths:

  1. Long-press the map.
  2. Tap Add Waypoint to use the current map center.
  3. Open Map Items → Waypoints → Add → New Waypoint.
  4. Open Map Items → Waypoints → Add → Create From Photo.
  5. Import GPX from the Waypoints transfer menu.

Long-press map at fixture coordinate and show new waypoint editor.
Long-press map at fixture coordinate and show new waypoint editor.

Edit waypoint fields

The editor includes:

  • Name;
  • Notes;
  • latitude and longitude;
  • optional altitude;
  • quick icon choices;
  • More icon grid;
  • A/B measurement role;
  • visible-on-map state;
  • attachments.

Complete editor with name, note, coordinate, altitude, icon, role, visibility.
Complete editor with name, note, coordinate, altitude, icon, role, visibility.

Enter a descriptive name that will remain recognizable in a camera or compass label. Verify coordinates before saving.

Choose an icon

Seven quick icons are available in the editor. Tap More to browse the full asset-catalog-backed waypoint icon library.

Seven quick icons.
Seven quick icons.

More icon grid with selected icon/checkmark.
More icon grid with selected icon/checkmark.

Icon selection is not merely decorative: it provides visual identity wherever the waypoint is presented.

Control visibility with checkmarks

Open Map Items → Waypoints. Tap the circle/checkmark beside a row:

  • checked: visible on the map and eligible for Waypoints camera mode;
  • unchecked: hidden from those presentations.

List with visible and hidden checkmarks, icons, A/B badges, search.
List with visible and hidden checkmarks, icons, A/B badges, search.

Map Compass applies an additional selection layer: a waypoint must first be checked in this main list, then included in Compass Settings.

Manage the list

Use the waypoint list to:

  • search;
  • sort by updated time, name, or distance;
  • duplicate;
  • show on map;
  • edit;
  • delete with confirmation;
  • import/export GPX.

More menu with sort, GPX import, GPX export preparation.
More menu with sort, GPX import, GPX export preparation.

Open an existing waypoint and choose Show on Map to center the map on it.

Edit existing waypoint and use Show on Map.
Edit existing waypoint and use Show on Map.

Create from a photo

  1. Open Map Items → Waypoints.
  2. Tap Add → Create From Photo.
  3. Choose an image.
  4. RangeFinder reads available metadata locally:
    • GPS latitude/longitude;
    • altitude;
    • capture date/time;
    • image direction.
  5. Review the prefilled waypoint.
  6. Edit name, note, coordinate, altitude, or icon.
  7. Save.

The photo is attached to the waypoint after the draft is confirmed.

Create From Photo with GPS source, date, direction, altitude, attached thumbnail.
Create From Photo with GPS source, date, direction, altitude, attached thumbnail.

Photo without GPS

RangeFinder must not invent a coordinate. The fallback offers appropriate choices such as:

  • current or remembered location, clearly identified;
  • current map center;
  • choose another photo;
  • cancel.

No-location dialog with Current Location, Map Center, Choose Another, Cancel.
No-location dialog with Current Location, Map Center, Choose Another, Cancel.

Add photo attachments

In the waypoint editor/attachments section:

  • Choose Photo selects from Photos;
  • Take Photo uses the camera;
  • photo-file import accepts a compatible local file;
  • tapping an attachment opens its viewer;
  • Remove deletes the local waypoint attachment after confirmation.

Editor attachment section: choose, take, record, import file.
Editor attachment section: choose, take, record, import file.

Add a voice message

  1. Tap Record Voice Message.
  2. Grant microphone access if requested.
  3. Record; pause and resume as needed.
  4. Review duration/state.
  5. Save the recording.
  6. Tap the attachment to play it.

Audio-file import can add an existing compatible file. If microphone access is denied, open iOS Settings and allow it before recording again.

See waypoints through the camera

Result

Display checked waypoints as augmented camera labels containing icon, name, and coordinate-based distance.

  1. Create/import the waypoints.
  2. Check the desired rows in Map Items → Waypoints.
  3. Open Range.
  4. Choose Waypoints.
  5. Turn toward a target.
  6. Read its name and geodesic distance.
  7. Tilt the phone; labels move vertically with the projected camera horizon.
  8. If a target leaves the field of view, follow its dot and label on the screen border.

Camera waypoints use the current location and heading when valid. If a current fix becomes poor, the last good coordinate may be retained with a warning so labels do not disappear abruptly. The distance is geographic, not optical camera depth.

Standard-camera zoom remains available in Waypoints mode where supported.

Track waypoints on the map

  1. Check the desired waypoint rows.
  2. Open Map.
  3. Tap Waypoint Tracking.
  4. Observe lines and distance labels.
  5. Pan, zoom, or rotate the map.
  6. Confirm lines and labels redraw immediately without shifting.
  7. Tap the control again to hide tracking.

Annotated map tracking view identifying the origin, waypoint icons, lines, and distance labels.
Annotated map tracking view identifying the origin, waypoint icons, lines, and distance labels.

Only checked waypoints participate. The origin is the best available current or remembered coordinate, with map-center fallback only where the UI explicitly uses it. Distances are geodesic. Raster and vector renderers must present the same tracking behavior even though their projection code differs.

Transfer and privacy

GPX import/export transfers supported geographic waypoint fields. Media attachments remain local unless explicitly exported/shared by a supported workflow. Review exported files before sharing because names, notes, times, and coordinates can reveal sensitive locations.

Map measurements

Map measurements store coordinate geometry independently of the selected map renderer. Checked measurements are visible; unchecked measurements remain saved but hidden.

Start an editor

  1. Open Map.
  2. Tap Measurements.
  3. Choose a measurement kind.
  4. Add points by tapping/long-pressing the map or adding the current map center, according to the active editor.
  5. Drag a handle to refine a point.
  6. Use Undo, Redo, Clear, and color selection as needed.
  7. Save when the geometry is valid.

Handles use an enlarged touch target and haptic feedback to make endpoint adjustment responsive.

Measurement editor expanded with type selector, color, add, undo, redo, clear, save.
Measurement editor expanded with type selector, color, add, undo, redo, clear, save.

Line

A Line uses two points.

  1. Add the trailhead.
  2. Add the bridge.
  3. Drag each endpoint to the intended coordinate.
  4. Read length and initial/final bearing.
  5. Save.

Two-point line with endpoints, length, bearing.
Two-point line with endpoints, length, bearing.

Polyline

A Polyline uses two or more connected points.

  1. Add points along the trail in travel order.
  2. Add enough points to represent bends without tracing insignificant map noise.
  3. Read total length and segment values.
  4. Save.

Four-point path and total distance.
Four-point path and total distance.

Angle: A–Center–B

The map Angle uses exactly three points in this order:

  1. C — center/vertex;
  2. A — first radius endpoint;
  3. B — second radius endpoint.

RangeFinder draws:

  • radius C–A;
  • radius C–B;
  • a thin reference circle whose radius updates whenever A or B changes;
  • a thick minor arc;
  • C, A, and B handles/labels.

It reports bearing to A, bearing to B, both radii, and ∠A–C–B.

Angle after adding only center C.
Angle after adding only center C.

C and A with radius/reference circle.
C and A with radius/reference circle.

C/A/B, both radii, thin circle, thick arc, angle readout.
C/A/B, both radii, thin circle, thick arc, angle readout.

Drag A or B and confirm the circle/arc and angle update immediately.

Rectangle

A Rectangle uses two opposing corners. The renderer derives the other corners.

  1. Add one property corner.
  2. Add the opposite corner.
  3. Drag any corner handle to refine the bounds.
  4. Read perimeter and area.
  5. Save.

Opposing handles, derived rectangle, area/perimeter.
Opposing handles, derived rectangle, area/perimeter.

Polygon

A Polygon requires at least three points.

  1. Add field corners in boundary order.
  2. Avoid crossing the polygon over itself.
  3. Read spherical area and perimeter.
  4. Save.

Field polygon with at least five points.
Field polygon with at least five points.

Circle

A Circle uses:

  1. center;
  2. radius point.

The map draws the center-to-radius line and circumference. Read radius, diameter, circumference, and area.

Center/radius point, circle, radius/diameter/circumference/area.
Center/radius point, circle, radius/diameter/circumference/area.

Editor controls

Control Action
Add at Center Adds the current map-center coordinate
Undo Removes/reverts the latest editor change
Redo Reapplies an undone change
Clear Removes draft points after confirmation where required
Color Shows real color circles and selects geometry color
Save Persists only valid geometry

Color list with actual colored circles.
Color list with actual colored circles.

The renderer must not create an empty multipoint/polyline. A line is drawn only after the geometry has the minimum required vertices.

When you drag an endpoint, the geometry and result update continuously. A haptic confirms the completed drag.

Drag an endpoint; static before/after pair, caption notes haptic feedback.
Drag an endpoint; static before/after pair, caption notes haptic feedback.

Manage saved measurements

Open Map Items → Measurements.

  • Tap the checkmark/circle to show or hide an item.
  • Search the list.
  • Open detail readouts.
  • Rename or edit note/color where exposed.
  • Delete with confirmation.
  • Use Transfer for import/export.

Measurement list with checked/unchecked items.
Measurement list with checked/unchecked items.

Detail readouts vary by kind and can include:

  • total distance;
  • segment distances;
  • initial/final bearing;
  • area/perimeter;
  • radius/diameter/circumference;
  • A/B bearings and radii;
  • A–Center–B angle.

Angle detail with A/B bearings, radii, and angle result.
Angle detail with A/B bearings, radii, and angle result.

Transfer formats

Format Typical use
GeoJSON General GIS geometry and properties
KML Earth/map applications
GPX Route/track/point exchange
CSV Tabular inspection and spreadsheet workflows

Export format selector for GeoJSON/KML/GPX/CSV.
Export format selector for GeoJSON/KML/GPX/CSV.

Imports may be partial when a source contains unsupported geometry or invalid records. Review the import summary rather than assuming every item was accepted. Exports use the selected unit/coordinate presentation where applicable but retain the geometry needed by the target format.

Accuracy and limitations

  • Results follow the coordinates placed on the map, not camera depth.
  • Map imagery may be offset from surveyed ground truth.
  • Area and distance calculations cannot correct a wrongly placed point.
  • Use sufficient vertices for a curved route or irregular boundary.
  • Avoid claiming cadastral/survey accuracy without authoritative data.
  • Repeat with a different map source when imagery alignment is uncertain.

Map Compass

Map Compass places a rotating vector compass dial over the selected map and combines heading, selected waypoints, current/remembered location quality, and optional astronomy markers.

Open Map Compass

Tap the compass button on Map. The workspace contains:

  • rotating dial and cardinal marks;
  • north/south needle;
  • heading and north-reference readout;
  • selected waypoint icons around the dial;
  • optional waypoint name/distance callouts;
  • optional Sun, Moon, sunrise, sunset, moonrise, and moonset markers;
  • the active map inside the compass;
  • central location marker;
  • plus/minus map zoom;
  • Back and Settings controls.

Annotate Map Compass hero: heading, dial, map, waypoint markers, astronomy markers, zoom, settings.
Annotate Map Compass hero: heading, dial, map, waypoint markers, astronomy markers, zoom, settings.

The dial and its waypoint/astronomy markers rotate continuously with heading. Its labels use a smaller system font to remain readable without dominating the map.

Select waypoints

Waypoint selection has two stages:

  1. Open Map Items → Waypoints and check each waypoint that may appear.
  2. Open Map Compass → Settings → Waypoints to Show and include/exclude each available waypoint.

Compass Settings list with mixed selected/unselected waypoints and icons.
Compass Settings list with mixed selected/unselected waypoints and icons.

Use Show All or Hide All for the currently available checked waypoints. An unchecked main-list waypoint is not offered to Compass Settings.

Selected dial waypoints are not limited to the visible map viewport. They remain arranged by bearing around the dial.

Show names and distances

Enable Show waypoint names and distance. Each selected dial icon receives a callout with its waypoint name and geodesic distance from the current or remembered origin.

Disable the switch for a cleaner dial while retaining the selected icons.

Names/distance off while waypoint icons remain.
Names/distance off while waypoint icons remain.

Show waypoints on the map

Show selected waypoints on map controls only the underlying map layer.

  • On: selected waypoints appear on both dial and map.
  • Off: selected waypoints remain on the dial but are hidden from the map.

Show selected waypoints on map off; waypoints remain on dial only.
Show selected waypoints on map off; waypoints remain on dial only.

Same state with map switch on.
Same state with map switch on.

Rotate the map with heading

Enable Rotate map with compass to continuously align the underlying map with device heading. The update changes bearing without changing map zoom.

Disable it to reset the map to north-up. The dial still rotates with heading.

Choose true or magnetic north

Tap the heading/reference readout or use Compass Settings:

  • True North uses location-dependent correction when available.
  • Magnetic North reports magnetic heading.

If true north cannot be produced, the UI states that magnetic north is being used. Heading accuracy is shown as ±…° when available.

Astronomy markers

Compass Settings can independently show:

  • Sun;
  • Moon;
  • Sunrise & Sunset;
  • Moonrise & Moonset.

Sun, Moon, sunrise/sunset, moonrise/moonset toggles.
Sun, Moon, sunrise/sunset, moonrise/moonset toggles.

These are directional planning markers calculated for the current location and time. They are not safety-navigation instructions.

Zoom

Use the dedicated plus/minus buttons to change the map background scale. Zoom does not change waypoint bearing or the compass dial’s angular layout.

Coordinate quality

The central location icon indicates the origin. A red dot means the app is using remembered last-good location rather than a fresh valid coordinate. Waypoint distance and astronomy direction inherit that limitation.

Calibrate horizon and inclination

Open Compass Settings → Sensors:

  1. Place the device against a known level/reference orientation.
  2. Wait for motion data.
  3. Tap Calibrate Horizon and Inclination.
  4. Verify the displayed zero.

Use Reset Calibration to remove the offset. Use Restart Sensors to reconnect motion, heading, and location updates without discarding calibration.

Calibration changes the displayed zero; it does not physically recalibrate the sensor hardware or correct magnetic interference.

Prevent device rotation

Prevent Device Rotation is on by default and keeps Compass/Map Compass in their current interface orientation until you leave the screen. Heading and map rotation continue to respond to sensor changes.

Troubleshooting

Waypoint is missing

  • check it in the main Waypoints list;
  • include it in Compass Settings;
  • obtain a current or remembered coordinate;
  • confirm the waypoint has valid coordinates.

Map rotates but changes scale

Continuous heading updates must change only map bearing. Record a reproducible screen/video if zoom changes without using pinch or plus/minus.

Heading is wrong

Move away from magnetic interference, remove magnetic accessories, switch north reference deliberately, restart sensors, and compare with a known direction.

Astronomy

Astronomy calculates Sun, Moon, planetary positions, and light/twilight events for the current or remembered coordinate. It remains available while Weather is hidden in this release.

Astronomy and map directions support planning and photography. They are not navigation or life-safety predictions.

Open Astronomy

Open Settings → Astronomy. The screen uses the current/remembered location, altitude when available, selected date/time context, and on-device astronomy calculations.

Astronomy using remembered coordinate with visible quality label.
Astronomy using remembered coordinate with visible quality label.

A warning indicates when the coordinate is remembered or otherwise lower quality.

Sun and light events

Events are displayed by their calculated start time. The complete event set is:

  1. Astronomical Twilight · Morning.
  2. Nautical Twilight · Morning.
  3. Civil Twilight · Morning.
  4. Morning Blue Hour.
  5. Morning Golden Hour.
  6. Sunrise.
  7. Solar Noon.
  8. Evening Golden Hour.
  9. Sunset.
  10. Civil Twilight · Evening.
  11. Evening Blue Hour.
  12. Nautical Twilight · Evening.
  13. Astronomical Twilight · Evening.

Complete chronological Sun & Light card.
Complete chronological Sun & Light card.

Blue/golden hours overlap civil-light intervals, so their relative row order can vary when two intervals begin at the same or nearly the same time. Read the times rather than assuming a fixed semantic order.

An interval shows start–end; a single event such as sunrise shows one time. A dash means the event cannot be produced for the current date/location state.

Moon

The Moon card shows:

  • phase name and matching planetary-symbol asset;
  • illuminated percentage;
  • age in days;
  • moonrise and moonset interval when available.

Moon phase symbol, illumination, age, rise/set.
Moon phase symbol, illumination, age, rise/set.

Sky positions

The Sky Positions list includes:

  • Sun;
  • Moon;
  • Mercury;
  • Venus;
  • Mars;
  • Jupiter;
  • Saturn;
  • Uranus;
  • Neptune;
  • Pluto.

Each row shows azimuth and apparent altitude. Imported planetary symbols adapt to the current light/dark color scheme. A body below the horizon is presented with secondary emphasis.

Sky Positions with all planetary symbols and azimuth/altitude.
Sky Positions with all planetary symbols and azimuth/altitude.

Polar and missing-event states

At high latitudes, the Sun may not rise or set on a selected date. Astronomy identifies non-normal solar states such as polar day, polar night, or a transition instead of manufacturing missing times.

Polar-day or polar-night explanatory state.
Polar-day or polar-night explanatory state.

Photography planning example

  1. Set or visit the planned viewpoint so RangeFinder has its coordinate.
  2. Open Astronomy.
  3. Find the desired morning/evening golden or blue hour.
  4. Note sunrise/sunset time.
  5. Open Map → Map Compass.
  6. In Compass Settings, enable Sun and Sunrise & Sunset.
  7. Compare the marker direction with selected photo waypoints.
  8. Arrive early enough to account for terrain, buildings, and weather.

Two-panel Astronomy golden-hour time and Map Compass Sun direction.
Two-panel Astronomy golden-hour time and Map Compass Sun direction.

Astronomical horizon calculations do not know that a mountain or building blocks the local horizon. Use terrain/site knowledge.

Refresh and recovery

Astronomy refreshes when its requested coordinate/date context changes and can periodically refresh while Map Compass remains open.

If Astronomy is unavailable:

  • wait for current or remembered location;
  • verify Location permission;
  • restart sensor/location services;
  • try a valid non-polar date/location;
  • reopen the screen;
  • report the coordinate quality, date, device, and app version if the problem persists.

Weather API availability does not control Astronomy in this release.

Settings reference

The main Settings screen groups preferences in a stable order so related instrument settings are easier to find.

Complete Settings hierarchy in current order.
Complete Settings hierarchy in current order.

Appearance

Default Reduce Liquid Glass and rotation locks on; Keep Awake/Haptics visible.
Default Reduce Liquid Glass and rotation locks on; Keep Awake/Haptics visible.

Reduce Liquid Glass

On by default. Uses darker, more opaque camera-instrument controls with less blur/refraction for stronger contrast. Range-screen button text and icons remain white.

Prevent Device Rotation

Separate switches, both on by default:

  • Range, Angle & Survey;
  • Compass & Map Compass.

Each keeps the current interface orientation until the screen is left. Sensor angles and compass heading still update.

Device behavior

  • Keep Screen Awake prevents Auto-Lock while RangeFinder is active.
  • Haptic Feedback controls confirmation, selection, and measurement vibrations; it has no effect on unsupported hardware.

Units & Formats

Automatic/Metric/Imperial and coordinate format.
Automatic/Metric/Imperial and coordinate format.

Measurement System

  • Automatic;
  • Metric;
  • Imperial.

Automatic resolves from the current locale. The preference is shared by Range, Compass, Measurements, Maps, Astronomy, and formatters used by hidden Weather implementation.

Preferred Coordinate

Choose the primary coordinate representation. It appears first where all representations are available. GPX, GeoJSON, KML, and CSV retain the interchange representation their format requires.

Range & Camera

Photo composition, outline, Reticle Library.
Photo composition, outline, Reticle Library.

  • Saved Photo Content — Camera + Reticle, Camera + Reticle + Measurement, or Whole Screen.
  • Black Reticle Outline.
  • Reticle Library — access state, Recently Used, categories, search, default selection, Favorites.

Camera and LiDAR device choices remain inside each instrument because formats, zoom limits, depth support, and active capture sessions are instrument-specific.

Compass & Sensors

Compass & Sensors sections.
Compass & Sensors sections.

Appearance

  • Sun;
  • Moon;
  • Sunrise & Sunset;
  • Moonrise & Moonset;
  • Prevent Device Rotation.

Compass

  • North Reference;
  • Rotate map with compass;
  • live Heading;
  • Accuracy.

Waypoints to Show

  • Show selected waypoints on map;
  • Show waypoint names and distance;
  • per-waypoint selection;
  • Show All/Hide All.

Only waypoints checked in the main Waypoints list are available.

Sensors

  • live Horizon and Inclination;
  • Calibrate Horizon and Inclination;
  • Reset Calibration;
  • Restart Sensors.

Maps & Offline

Map Sources and Offline links.
Map Sources and Offline links.

  • Map Sources opens the categorized renderer/source list.
  • Offline opens the thumbnail-based Offline Areas workspace.

Privacy & Permissions

Mixed permission states plus Open System Settings and data-handling text.
Mixed permission states plus Open System Settings and data-handling text.

Shows current authorization state for:

  • Location;
  • Camera;
  • Photos.

Use Open System Settings to change denied/restricted access. Microphone access is requested in the waypoint voice workflow and is covered by the local data summary.

Storage

Offline quota/bonus and transient cache section.
Offline quota/bonus and transient cache section.

Offline maps

Shows current storage limit and bonus state:

  • initial 512 MiB;
  • first completed map adds 512 MiB and increases the per-area limit to 16,000 tiles.

Transient network cache

Shows temporary network-cache size. Clear Transient Network Cache removes temporary responses but does not delete offline map areas, waypoints, measurements, photos, voice messages, or saved captures.

About

Welcome Tour, What’s New, Astronomy, version/compatibility.
Welcome Tour, What’s New, Astronomy, version/compatibility.

  • Welcome Tour reopens onboarding.
  • What’s New opens release information without a redundant Continue button.
  • Astronomy.
  • Compatibility.
  • Version/build display.

Premium and Weather controls remain hidden in this release.

Support

Support email and website.
Support email and website.

Support is the final Settings group:

  • email: support2026@lifewaresolutions.com;
  • RangeFinder website.

Include app version, iOS/iPadOS version, device, selected instrument/source, and exact error text. Do not send keys or private media/location unless deliberately needed.

Instrument-local settings

Range, Angle, and Angle Survey use a common order where applicable:

  1. Appearance.
  2. Compass/horizon calibration.
  3. Sensors.
  4. LiDAR.
  5. Cameras.
  6. Ranging/measurement controls.
  7. Reticle.
  8. Lens filter.
  9. Photo.

Unavailable sections should collapse rather than leave large blank spaces under headings such as Camera Calibrated or Back LiDAR Camera.

Accuracy, field technique, privacy, and storage

Direct, calculated, and geographic results

Result Basis
LiDAR Direct depth samples in the target
Surface AR raycast to detected geometry
Known Size Camera rays/intrinsics plus known physical input
Waypoint distance Geodesic coordinate distance
Map measurement User-placed coordinate geometry
Angle A–B Two sensor-derived viewing directions
Angle Survey Calibrated angular marks interpreted by the user

Do not compare methods as if they measure identical geometry. A geodesic map distance is not camera slant range; a screenshot of a value is not proof that the underlying calibration was correct.

Camera technique

  • Clean the lens/sensors.
  • Use a tripod or brace when endpoint placement matters.
  • Record active camera and zoom.
  • Realign after camera, zoom, or orientation changes.
  • Make the target large enough in the frame.
  • Avoid assuming a person/object dimension.
  • Keep Known Size endpoints on the exact trusted dimension.
  • Repeat and record spread.

Perspective and target plane

Known Size assumes the input dimension and shutter rays correspond to the intended target geometry. A slanted facade, hidden bottom, roof depth, or horizontal map distance can introduce systematic error.

LiDAR and Surface

  • Keep the sample target on one continuous opaque surface.
  • Avoid edges and mixed depths.
  • Reflective, transparent, wet, thin, or moving targets are unreliable.
  • Surface requires stable AR tracking and detected geometry.
  • Calibration cannot repair a bad target/reference.
  • Thermal/system pressure may interrupt the camera.

Heading and A–B

  • Avoid magnetic cases, vehicles, structural steel, speakers, and power equipment.
  • Verify true/magnetic north selection.
  • Hold one physical origin for both A and B.
  • Use known points and repeat in reverse.
  • Horizon calibration changes displayed zero, not magnetic accuracy.

Location and maps

  • Read horizontal accuracy and current/remembered quality.
  • A remembered coordinate supports continuity but is not a current fix.
  • Map imagery can be offset or outdated.
  • Provider projections/zoom ranges differ.
  • Aeronautical/nautical/research layers are informational.
  • Confirm important positions with authoritative data and instruments.

What is stored locally

RangeFinder keeps field data in app storage unless a user explicitly exports or shares it:

  • waypoints;
  • measurement geometry;
  • offline area records/resources;
  • waypoint photo/audio attachments;
  • range observations and capture references;
  • preferences and calibration data.

Camera/depth processing, EXIF extraction for photo waypoints, and astronomy calculation are performed on-device by the app’s local workflows.

Network disclosure

Selecting an online map or downloading an offline area sends tile/style/region requests to the selected provider. Providers can receive normal network metadata such as IP address and requested resources. RangeFinder cannot make Apple or Google maps offline outside their allowed product behavior.

Photos, EXIF, and audio

  • Photo metadata is read locally to propose a waypoint.
  • Missing GPS is not silently fabricated.
  • Attachments remain local until explicitly shared/exported.
  • Saving to Photos creates a separate system-library copy.
  • Deleting an observation does not delete that Photos copy.
  • Microphone access is used only for recording a waypoint voice message.

Cache and deletion

Clearing transient network cache does not delete saved field data or offline areas. Clearing downloaded raster tiles is a separate destructive operation. Shared tiles/attachments must be reference-aware so deleting one record does not break another record still using the same resource.

Exports

GPX, GeoJSON, KML, CSV, images, and shared media can reveal coordinates, names, times, notes, and field activity. Review before sharing.

No user account is required in this release. Premium-account settings and Weather are hidden.

Troubleshooting

Start with the exact status/guidance shown. RangeFinder should prefer an Unavailable state over a fabricated result.

Camera is black or interrupted

Likely causes: another camera client, app backgrounding, capture reconfiguration, system/thermal pressure, permission, or unavailable hardware.

Recover:

  1. Return the app to foreground.
  2. Close another app using the camera.
  3. Verify Camera permission.
  4. Leave and reopen the instrument.
  5. Let the device cool.
  6. Restart the app/device if the capture service cannot reconnect.

Contact support with device, OS, mode, camera, and exact interruption message if it repeats.

Camera permission is denied

Open iOS Settings → Apps → RangeFinder → Camera, enable access, return, and reopen the instrument.

Photo capture is unavailable

Wait for the live camera, use a supported capture composition, ensure the app is foreground active, and retry after interruption/thermal recovery.

Saving to Photos fails

Use the alert’s Open Settings, allow Photos access, and retry from a valid capture review. RangeFinder should show an error—not crash.

LiDAR or Surface is missing

The device did not report compatible LiDAR hardware. Use Known Size, Waypoints, Angle, Angle Survey, or map measurement.

LiDAR stays Acquiring/Low

Use one large matte surface, remove edges/foreground objects, stop moving, move within practical range, clean the sensor, and let the device cool.

Known Size has no result

Confirm a positive input, valid camera, supported zoom, lower shutter below upper shutter, and a target large enough in the frame.

Known Size input is empty/outside the slider

An empty field is allowed while editing and retains the last valid value. Enter a positive localized number. A manual value outside the band is preserved until the slider is moved.

Angle A/B controls are unavailable

Wait for fresh heading and motion, reduce movement, move away from magnetic interference, restart sensors, and retry.

Heading is wrong or low accuracy

Remove magnetic accessories, move away from metal/electrical equipment, verify true/magnetic north, restart sensors, and compare with a known direction.

Coordinate is red/remembered

RangeFinder retained the last good location because the current fix is poor. Move to open sky, verify Location permission/Precise Location, and wait. Treat the displayed coordinate as remembered until the warning clears.

Waypoints do not appear in camera

  • check them in Map Items → Waypoints;
  • obtain current/remembered location and heading;
  • select Range → Waypoints;
  • follow border indicators for off-screen targets;
  • verify waypoint coordinates.

Waypoints do not appear on Map Compass

Check them in the main list, then include them in Compass Settings. The map switch affects only the underlying map, not dial selection.

Map source does not load

Retry, confirm network, check the provider’s zoom/coverage, select another source, or use Apple Standard fallback. Do not delete offline data first.

OpenSeaMap seamarks are missing

Confirm OpenSeaMap is selected, zoom is z17 or lower, the location has seamark coverage, and OSM Legacy base tiles load. Empty overlay tiles are intentionally transparent.

Download button is unavailable

The source is online-only or hidden by release policy. Apple and Google are not downloadable in this release.

Area exceeds tile/storage limit

Shrink bounds, lower maximum zoom, choose another source, clear unneeded offline data, or complete a first small area to unlock the documented bonus.

Download is paused or failed

Open Offline Areas, inspect the item, confirm network/free space/provider availability, and Resume/Retry. Preserve the item until the failure is understood.

Offline map is absent without network

Confirm the area completed, selected provider matches, current bounds and zoom are inside the saved request, and test again in airplane mode after retrying failed resources.

Measurement cannot be saved

Meet the geometry minimum: Line/Circle/Rectangle two points, Angle C/A/B, Polygon three or more, Polyline two or more. Empty multipoint geometry is invalid.

Photo has no GPS metadata

Choose current/remembered location, map center, another photo, or cancel. Review the proposed coordinate; no coordinate should be fabricated.

Astronomy is unavailable

Obtain location, verify permission, restart sensors, reopen Astronomy, and test a normal coordinate/date. Weather availability is unrelated.

UI rotates unexpectedly

Enable the appropriate Prevent Device Rotation switch in Appearance or the instrument/Compass settings. Leave and reenter the screen after changing it.

Device becomes warm

Long camera sessions, high-resolution capture, reticle rendering, map rendering, LiDAR/AR, motion updates, and repeated compositing consume energy.

  • stop camera instruments when leaving them;
  • reduce unnecessary prolonged live use;
  • avoid simultaneous screen recording;
  • pause in direct sun or charging heat;
  • let iOS thermal state recover;
  • report reproducible high CPU with instrument, camera, reticle, zoom, and duration.

Contact support

Email support2026@lifewaresolutions.com with:

  • app version/build;
  • iOS/iPadOS version;
  • device;
  • selected mode/source;
  • exact message;
  • reproducible steps;
  • a non-sensitive screenshot if useful.

Glossary and quick reference

Measurement terms

Angular size
Angle between viewing rays to two subject endpoints.

A–B angle
Spatial angular separation between two stored viewing directions. In a map Angle, ∠A–C–B has center C and endpoints A/B.

Azimuth / heading
Direction around the horizon relative to true or magnetic north.

Bearing
Direction from one coordinate to another, usually expressed clockwise from north.

Camera intrinsics
Camera calibration values mapping pixels to viewing rays, including focal length and optical center for the active image dimensions.

Geodesic distance
Distance between geographic coordinates along the Earth model. It is not camera slant range.

Inclination
Up/down viewing angle.

LiDAR
Depth-sensing hardware used for direct sampled range and supported AR geometry.

Raycast
Intersection test from a camera/viewing ray to detected geometry.

Reticle
Vector sight/scale over the camera used for alignment or angular comparison.

Roll
Rotation around the viewing axis.

Slant range
Straight line-of-sight distance from sensor/camera origin to target.

True / magnetic north
True north points toward geographic north; magnetic north follows the local magnetic field.

Map terms

Offline area
Saved bounds and zoom/resource range for an offline-capable provider.

Raster map
Map rendered from image tiles.

Vector map
Map rendered from vector style/resources and geometry.

Remembered coordinate
Last good location retained when the current fix is unusable; shown with a warning.

Transfer formats

CSV — comma-separated tabular data.
GeoJSON — JSON geographic features and geometry.
GPX — GPS exchange format for points/routes/tracks.
KML — geographic markup used by Earth/map applications.

Quick method reference

Need Method
Distance from trusted height Known Height
Height from trusted distance Known Distance
Direct depth on supported hardware LiDAR
AR intersection with detected wall/surface Surface
Saved geographic target in camera Waypoints
Heading, inclination, roll, direction pair Angle
Manual angular comparison Angle Survey
Coordinate distance/area/angle Map Measurements

Quick settings paths

Setting Path
Units/coordinate format Settings → Units & Formats
Default photo composition Settings → Range & Camera
Reticle library Settings → Range & Camera → Reticle Library
Rotation locks Settings → Appearance
Map source Map Items → Map Sources
Offline areas Map Items → Offline Areas
Compass waypoint/astronomy options Map Compass → Settings
Permissions Settings → Privacy & Permissions
Storage bonus/cache Settings → Storage
Support Settings → Support