Tighten the point-navigation doc comments and state note

This commit is contained in:
German Khokhlov committed 2026-11-18 16:38:25 +04:00
1 parent 6e70793f66
commit ed586a40a1
3 files changed
+7 -7

No files matched your search

+3 -3
View File
@@ -2867,9 +2867,9 @@ while `_clearLayersOutsideContextMode` switches the layer off): the user
switching CCTV off inside Contacts closes the panel as anywhere else. A panel opened by hand while the layer is off stays open, and its
meta line reads the catalog count, not the last active camera.
The CCTV layer control `focusNearestToPoint(lat, lon, options)` selects the
nearest catalog camera to a valid WGS84 point and optionally flies to it.
`focus: false` selects without flying; no current UI action calls this method.
The CCTV control `focusNearestToPoint(lat, lon, options)` selects the catalog
camera nearest a WGS84 point and flies to it unless `focus: false`. No UI action
calls it yet.
## UI disposal
+2 -2
View File
@@ -336,13 +336,13 @@ export function createControls({ state: layerState, services, parts, source }) {
},
/**
* Selects the camera nearest an explicit WGS84 point and optionally flies.
* Selects the camera nearest a WGS84 point and optionally flies to it.
* @param {number} lat Latitude in degrees.
* @param {number} lon Longitude in degrees.
* @param {Object} [options={}]
* @param {boolean} [options.focus=true] Whether to fly after selection.
* @param {number} [options.durationSec] Fly-to duration in seconds.
* @returns {string|null} The nearest camera ID, or null if none found.
* @returns {string|null} Camera ID, or null (invalid point, empty catalog).
*/
focusNearestToPoint(lat, lon, options = {}) {
const nearest = parts.navigation.nearestCameraIdToPoint(lat, lon);
+2 -2
View File
@@ -9,10 +9,10 @@ export function createNavigation({
source,
}) {
/**
* Find the catalog camera nearest one WGS84 point.
* Nearest catalog camera to a WGS84 point.
* @param {number} lat Latitude in degrees.
* @param {number} lon Longitude in degrees.
* @returns {string|null} Camera ID of the nearest camera, or null.
* @returns {string|null} Camera ID, or null (invalid point, empty catalog).
*/
function nearestCameraIdToPoint(lat, lon) {
const latitude = Number(lat);