feat(map): control ghost pin movement speed

tests/test_map_view_api.py

@@ -35,6 +35,7 @@ def test_default_map_view_matches_the_canonical_foundry_scene_and_cache_policy()
     assert document.view.cache_intent.enabled is True
     assert document.view.cache_intent.no_overwrite is True
     assert document.view.ghost_pins.count == 12
+    assert document.view.ghost_pins.maximum_speed_meters_per_second == 18
     assert document.view.ghost_pins.positions == []
     assert document.view.ghost_pins.presentation.stem_height_meters == 1_500
 
@@ -96,6 +97,27 @@ def test_selection_inspector_requires_real_stable_subject() -> None:
     assert selected.selected_subject_id == "map.moving_object/device-006"
 
 
+def test_ghost_pin_speed_cannot_exceed_configured_maximum() -> None:
+    with pytest.raises(ValidationError, match="speed exceeds configured maximum"):
+        MapViewContent.model_validate(
+            {
+                "ghost_pins": {
+                    "maximum_speed_meters_per_second": 5,
+                    "positions": [
+                        {
+                            "id": "ghost-fast-1",
+                            "label": "123456",
+                            "longitude": 37.618423,
+                            "latitude": 55.751244,
+                            "heading_degrees": 90,
+                            "speed_meters_per_second": 6,
+                        }
+                    ],
+                }
+            }
+        )
+
+
 def test_persisted_document_contains_no_runtime_or_credential_material(
     tmp_path: Path,
 ) -> None: